TransOgg Page - Revision history

Xiphmont: /* Syncpoints / Keyframes */

2012-09-20T00:35:17Z

Syncpoints / Keyframes

← Older revision		Revision as of 00:35, 20 September 2012
Line 244:		Line 244:
	Streams in which not every frame serves as a syncpoint may place only		Streams in which not every frame serves as a syncpoint may place only
	one syncpoint (keyframe) packet per page. The syncpoint packet must		one syncpoint (keyframe) packet per page. The syncpoint packet must
	be the first packet completed on the page (if any).		be the first packet begun (the first segment) and the first packet
			completed on the page (if any).

	= More Information =		= More Information =

	* [[TransOgg]]: Toplevel transOgg page		* [[TransOgg]]: Toplevel transOgg page

Xiphmont: /* flags */

2012-09-19T23:38:42Z

flags

← Older revision		Revision as of 23:38, 19 September 2012
Line 70:		Line 70:
	unset == backreference field not present; interpretation		unset == backreference field not present; interpretation
	subject to SUBR field		subject to SUBR field
	4 SUBR: set == If BREF also set: ~~relative~~ backreference distances		4 SUBR: set == If BREF also set: explicit backreference distances
	are encoded for each packet		are encoded for each packet. The page
			must not contain a syncpoint.
	If BREF unset: all packets on the page are at max		If BREF unset: all packets on the page are at max
	backreference distance (ie, max preroll)		backreference distance, ie, max preroll.
			Intra-only stream types should use this flag
			combination for all pages along with with a
			preroll value of zero.
	unset == If BREF set: all packets on this page share the		unset == If BREF set: all packets on this page share the
	single backreference value.		single encoded backreference value.
	If BREF also unset: first packet is a syncpoint		If BREF also unset: first packet is a syncpoint.
			(implicit backreference value of zero).
	5 SEQ : set == sequence field is present		5 SEQ : set == sequence field is present
	6 DURA: set == full raw duration encoding present		6 DURA: set == full raw duration encoding present

Xiphmont: /* transOgg Page Primitive */

2012-09-19T23:21:51Z

transOgg Page Primitive

← Older revision		Revision as of 23:21, 19 September 2012
Line 8:		Line 8:
	01234567 01234567 01234567 01234567		01234567 01234567 01234567 01234567
	0 1 2 3		0 1 2 3
	-- \|-------- -------- -------- --------\|		-- \|-------- -------- -------- --------\| --
	0\| capture pattern \|3		^ 0\| capture pattern \|3 ^
	\|--------\|-------- -------- --------\|		\| \|--------\|-------- -------- --------\| \|
	4\| sgmnts \| stream identification \|7		\| 4\| sgmnts \| stream identification \|7 \|
	\|------\|-\|--------\|-------- --------\|		\| \|------\|-\|--------\|-------- --------\| \|
	20 8\| flag \| hbytes \| dbytes \|11		20 8\| flag \| hbytes \| dbytes \|11 \|
	\|------\|- --------\|-------- --------\|		\| \|------\|- --------\|-------- --------\| \|
	12\| 32 bit checksum \|15		\| 12\| 32 bit checksum \|15 \|
	\|-------- -------- -------- --------\|		\| \|-------- -------- -------- --------\| \|
	16\| DTS [low] word \|19		V 16\| DTS [low] word \|19 \|
	-- \|-------- -------- -------- --------\|		-- \|-------- -------- -------- --------\| \|
	20? DTS high word \|		20? DTS high word \| sgmnts+
	\|-------- -------- -------- --------		\|-------- -------- -------- -------- hbytes+
	? sequence...		? sequence... 19
	\|--------		\|-------- \|
	~~hbytes~~ ? distance...		? distance... \|
	\|--------		\|-------- \|
	? segment table...		? segment table... \|
	\|--------		\|-------- \|
	? pp-reldistance?...		? pp-reldistance?... \|
	? pp-delay?...		? pp-delay?... \|
	? pp-duration?...		? pp-duration?... \|
	? pp-ppflags?...		? pp-ppflags?... V
	-- \|--------		-- \|-------- --
			^ ?
			\| ?
	dbytes ? data payloads...		dbytes ? data payloads...
			\| ?
			V ?
	-- \|--------		-- \|--------

Xiphmont: /* header variable fields bytes */

2012-09-19T23:17:28Z

header variable fields bytes

← Older revision		Revision as of 23:17, 19 September 2012
Line 77:		Line 77:

	== header variable fields bytes ==		== header variable fields bytes ==
	'hbytes' (bit 7 of byte 8 and bits 0-7 of byte 9 for 9 bits total, 0-511) ~~indicates~~ the number of bytes spanned by		'hbytes' (bit 7 of byte 8 and bits 0-7 of byte 9 for 9 bits total, 0-511) encodes the number of bytes spanned bythe variable-length header fields (DTS high word, sequence, distance, lacing, and per-packet fields). The actual number of header bytes is computed as (19 + segments + hbytes); this computed value serves as a direct byte offset to the page data, as measured from the first byte of the page.
	~~the~~ variable-length header fields (DTS high word, sequence,
	distance, lacing, and per-packet fields)

	== data payload bytes ==		== data payload bytes ==

Xiphmont: Undo revision 13684 by Xiphmont (talk)

2012-09-19T23:14:51Z

Undo revision 13684 by Xiphmont (talk)

← Older revision		Revision as of 23:14, 19 September 2012
Line 75:		Line 75:
	5 SEQ : set == sequence field is present		5 SEQ : set == sequence field is present
	6 DURA: set == full raw duration encoding present		6 DURA: set == full raw duration encoding present
	~~7 EVIL: as specified in RFC 3514~~

	== header variable fields bytes ==		== header variable fields bytes ==

Xiphmont: Undo revision 13685 by Xiphmont (talk)

2012-09-19T23:13:07Z

Undo revision 13685 by Xiphmont (talk)

← Older revision		Revision as of 23:13, 19 September 2012
Line 12:		Line 12:
	\|--------\|-------- -------- --------\|		\|--------\|-------- -------- --------\|
	4\| sgmnts \| stream identification \|7		4\| sgmnts \| stream identification \|7
	\|--------\|--------\|-------- --------\|		\|------\|-\|--------\|-------- --------\|
	20 8\| flag \| hbytes \| dbytes \|11		20 8\| flag \| hbytes \| dbytes \|11
	\|--------\| -------\|-------- --------\|		\|------\|- --------\|-------- --------\|
	12\| 32 bit checksum \|15		12\| 32 bit checksum \|15
	\|-------- -------- -------- --------\|		\|-------- -------- -------- --------\|

Xiphmont: /* transOgg Page Primitive */

2012-09-19T23:04:56Z

transOgg Page Primitive

← Older revision		Revision as of 23:04, 19 September 2012
Line 12:		Line 12:
	\|--------\|-------- -------- --------\|		\|--------\|-------- -------- --------\|
	4\| sgmnts \| stream identification \|7		4\| sgmnts \| stream identification \|7
	\|------\|-\|--------\|-------- --------\|		\|--------\|--------\|-------- --------\|
	20 8\| flag \| hbytes \| dbytes \|11		20 8\| flag \| hbytes \| dbytes \|11
	\|------\|- --------\|-------- --------\|		\|--------\| -------\|-------- --------\|
	12\| 32 bit checksum \|15		12\| 32 bit checksum \|15
	\|-------- -------- -------- --------\|		\|-------- -------- -------- --------\|

Xiphmont: /* flags */

2012-09-19T23:04:16Z

flags

← Older revision		Revision as of 23:04, 19 September 2012
Line 75:		Line 75:
	5 SEQ : set == sequence field is present		5 SEQ : set == sequence field is present
	6 DURA: set == full raw duration encoding present		6 DURA: set == full raw duration encoding present
			7 EVIL: as specified in RFC 3514

	== header variable fields bytes ==		== header variable fields bytes ==

Xiphmont: Undo revision 13682 by Xiphmont (talk)

2012-09-19T23:04:04Z

Undo revision 13682 by Xiphmont (talk)

← Older revision		Revision as of 23:04, 19 September 2012
Line 27:		Line 27:
	? segment table...		? segment table...
	\|--------		\|--------
	? delay... duration... ppflags...		? pp-reldistance?...
			? pp-delay?...
			? pp-duration?...
			? pp-ppflags?...
	-- \|--------		-- \|--------
	dbytes ? data payloads...		dbytes ? data payloads...
Line 33:		Line 36:

	== capture pattern ==		== capture pattern ==
	the capture pattern consists of four ASCII 7-bit clean bytes: '~~tOgS~~'		the capture pattern consists of four ASCII 7-bit clean bytes: 'Og2S'
	(~~0x74,~~ 0x4F, 0x47, 0x53 in order)		(0x4F, 0x47, 0x32, 0x53 in order)

	== segment count ==		== segment count ==
Line 59:		Line 62:
	2 CRC : set == checksum applies to header and data		2 CRC : set == checksum applies to header and data
	unset == checksum applies to header fields only		unset == checksum applies to header fields only
	3 ~~SYNC~~: set == ~~payload data begins with~~ a syncpoint~~/keyframe~~		3 BREF: set == backreference field present; no packets on this page
	~~note~~: ~~always~~ set for ~~keyframeless codecs~~		represent a syncpoint
	~~note~~: set if a ~~keyframe/~~syncpoint ~~packet is continued~~		unset == backreference field not present; interpretation
	~~onto the current page~~		subject to SUBR field
	4 SEQ : set == sequence field is present		4 SUBR: set == If BREF also set: relative backreference distances
	5 DURA: set == full raw duration encoding present		are encoded for each packet
	~~6 EVIL: as specified in RFC 3514~~		If BREF unset: all packets on the page are at max
			backreference distance (ie, max preroll)
			unset == If BREF set: all packets on this page share the
			single backreference value.
			If BREF also unset: first packet is a syncpoint
			5 SEQ : set == sequence field is present
			6 DURA: set == full raw duration encoding present

	== header variable fields bytes ==		== header variable fields bytes ==
	'hbytes' (bit 7 of byte 8 and bits 0-7 of byte 9 for 9 bits total, 0-511) indicates the number of bytes spanned by		'hbytes' (bit 7 of byte 8 and bits 0-7 of byte 9 for 9 bits total, 0-511) indicates the number of bytes spanned by
	the variable-length header fields (DTS high word, sequence,		the variable-length header fields (DTS high word, sequence,
	distance, lacing, and ~~delay/duration/ppflags~~ fields)		distance, lacing, and per-packet fields)

	== data payload bytes ==		== data payload bytes ==
Line 86:		Line 95:
	equivalent to the high bits of the granule position in the original		equivalent to the high bits of the granule position in the original
	Ogg container. The DTS value is encoded in [[#V32/64 format\|V32/64 format]] and is either 4 or 8 bytes in total.		Ogg container. The DTS value is encoded in [[#V32/64 format\|V32/64 format]] and is either 4 or 8 bytes in total.

			The DTS value for a page in a continuous stream is equal to the end-time of the data returned up to the last completed packet in the stream (the ending DTS of the last completed packet). When a continuous stream page contains no completed packets, the DTS is equal to the end-time of the last previously complete packet. oterwise, the DTS of the page is equal to the end-time of the last packet completed on the page.

			The DTS value for a page in a discontinuous stream is equal to the start time of the first packet begun on the page. ( more to write here on correct discont timing and packet spanning behavior )

	== sequence field ==		== sequence field ==

Xiphmont: Reverted edits by Xiphmont (talk) to last revision by Mvrable

2012-09-19T23:03:03Z

Reverted edits by Xiphmont (talk) to last revision by Mvrable

← Older revision		Revision as of 23:03, 19 September 2012
Line 27:		Line 27:
	? segment table...		? segment table...
	\|--------		\|--------
	? ~~pp-reldistance?...~~		? delay... duration... ppflags...
	~~? pp-~~delay?...
	~~? pp-~~duration?...
	~~? pp-~~ppflags?...
	-- \|--------		-- \|--------
	dbytes ? data payloads...		dbytes ? data payloads...
Line 36:		Line 33:

	== capture pattern ==		== capture pattern ==
	the capture pattern consists of four ASCII 7-bit clean bytes: '~~Og2S~~'		the capture pattern consists of four ASCII 7-bit clean bytes: 'tOgS'
	(0x4F, 0x47~~, 0x32~~, 0x53 in order)		(0x74, 0x4F, 0x47, 0x53 in order)

	== segment count ==		== segment count ==
Line 62:		Line 59:
	2 CRC : set == checksum applies to header and data		2 CRC : set == checksum applies to header and data
	unset == checksum applies to header fields only		unset == checksum applies to header fields only
	3 ~~BREF~~: set == ~~backreference field present; no packets on this page~~		3 SYNC: set == payload data begins with a syncpoint/keyframe
	~~represent~~ a syncpoint		note: always set for keyframeless codecs
	~~unset == backreference field not present; interpretation~~		note: set if a keyframe/syncpoint packet is continued
	~~subject to SUBR field~~		onto the current page
	~~4 SUBR~~: ~~set == If BREF also~~ set~~: relative backreference distances~~		4 SEQ : set == sequence field is present
	~~are encoded~~ for ~~each packet~~		5 DURA: set == full raw duration encoding present
	~~If BREF unset~~: ~~all packets on the page are at max~~		6 EVIL: as specified in RFC 3514
	~~backreference distance (ie, max preroll)~~
	~~unset == If BREF~~ set~~: all packets on this page share the~~
	~~single backreference value.~~
	~~If BREF also unset: first~~ packet is ~~a syncpoint~~
	5 SEQ : set == sequence field is present
	6 DURA: set == full raw duration encoding present

	== header variable fields bytes ==		== header variable fields bytes ==
	'hbytes' (bit 7 of byte 8 and bits 0-7 of byte 9 for 9 bits total, 0-511) indicates the number of bytes spanned by		'hbytes' (bit 7 of byte 8 and bits 0-7 of byte 9 for 9 bits total, 0-511) indicates the number of bytes spanned by
	the variable-length header fields (DTS high word, sequence,		the variable-length header fields (DTS high word, sequence,
	distance, lacing, and ~~per-packet~~ fields)		distance, lacing, and delay/duration/ppflags fields)

	== data payload bytes ==		== data payload bytes ==
Line 95:		Line 86:
	equivalent to the high bits of the granule position in the original		equivalent to the high bits of the granule position in the original
	Ogg container. The DTS value is encoded in [[#V32/64 format\|V32/64 format]] and is either 4 or 8 bytes in total.		Ogg container. The DTS value is encoded in [[#V32/64 format\|V32/64 format]] and is either 4 or 8 bytes in total.

	The DTS value for a page in a continuous stream is equal to the end-time of the data returned up to the last completed packet in the stream (the ending DTS of the last completed packet). When a continuous stream page contains no completed packets, the DTS is equal to the end-time of the last previously complete packet. oterwise, the DTS of the page is equal to the end-time of the last packet completed on the page.

	~~The DTS value for a page in a discontinuous stream is equal to the start time of the first packet begun on the page. ( more to write here on correct discont timing and packet spanning behavior )~~

	== sequence field ==		== sequence field ==

← Older revision		Revision as of 23:21, 19 September 2012
Line 8:		Line 8:
	01234567 01234567 01234567 01234567		01234567 01234567 01234567 01234567
	0 1 2 3		0 1 2 3
	-- \|-------- -------- -------- --------\|		-- \|-------- -------- -------- --------\| --
	0\| capture pattern \|3		^ 0\| capture pattern \|3 ^
	\|--------\|-------- -------- --------\|		\| \|--------\|-------- -------- --------\| \|
	4\| sgmnts \| stream identification \|7		\| 4\| sgmnts \| stream identification \|7 \|
	\|------\|-\|--------\|-------- --------\|		\| \|------\|-\|--------\|-------- --------\| \|
	20 8\| flag \| hbytes \| dbytes \|11		20 8\| flag \| hbytes \| dbytes \|11 \|
	\|------\|- --------\|-------- --------\|		\| \|------\|- --------\|-------- --------\| \|
	12\| 32 bit checksum \|15		\| 12\| 32 bit checksum \|15 \|
	\|-------- -------- -------- --------\|		\| \|-------- -------- -------- --------\| \|
	16\| DTS [low] word \|19		V 16\| DTS [low] word \|19 \|
	-- \|-------- -------- -------- --------\|		-- \|-------- -------- -------- --------\| \|
	20? DTS high word \|		20? DTS high word \| sgmnts+
	\|-------- -------- -------- --------		\|-------- -------- -------- -------- hbytes+
	? sequence...		? sequence... 19
	\|--------		\|-------- \|
	~~hbytes~~ ? distance...		? distance... \|
	\|--------		\|-------- \|
	? segment table...		? segment table... \|
	\|--------		\|-------- \|
	? pp-reldistance?...		? pp-reldistance?... \|
	? pp-delay?...		? pp-delay?... \|
	? pp-duration?...		? pp-duration?... \|
	? pp-ppflags?...		? pp-ppflags?... V
	-- \|--------		-- \|-------- --
			^ ?
			\| ?
	dbytes ? data payloads...		dbytes ? data payloads...
			\| ?
			V ?
	-- \|--------		-- \|--------

← Older revision		Revision as of 23:13, 19 September 2012
Line 12:		Line 12:
	\|--------\|-------- -------- --------\|		\|--------\|-------- -------- --------\|
	4\| sgmnts \| stream identification \|7		4\| sgmnts \| stream identification \|7
	\|--------\|--------\|-------- --------\|		\|------\|-\|--------\|-------- --------\|
	20 8\| flag \| hbytes \| dbytes \|11		20 8\| flag \| hbytes \| dbytes \|11
	\|--------\| -------\|-------- --------\|		\|------\|- --------\|-------- --------\|
	12\| 32 bit checksum \|15		12\| 32 bit checksum \|15
	\|-------- -------- -------- --------\|		\|-------- -------- -------- --------\|

← Older revision		Revision as of 23:04, 19 September 2012
Line 12:		Line 12:
	\|--------\|-------- -------- --------\|		\|--------\|-------- -------- --------\|
	4\| sgmnts \| stream identification \|7		4\| sgmnts \| stream identification \|7
	\|------\|-\|--------\|-------- --------\|		\|--------\|--------\|-------- --------\|
	20 8\| flag \| hbytes \| dbytes \|11		20 8\| flag \| hbytes \| dbytes \|11
	\|------\|- --------\|-------- --------\|		\|--------\| -------\|-------- --------\|
	12\| 32 bit checksum \|15		12\| 32 bit checksum \|15
	\|-------- -------- -------- --------\|		\|-------- -------- -------- --------\|