[xiph-commits] r12923 - trunk/vorbis/doc
lu_zero at svn.xiph.org
lu_zero at svn.xiph.org
Mon May 7 13:54:03 PDT 2007
Author: lu_zero
Date: 2007-05-07 13:54:02 -0700 (Mon, 07 May 2007)
New Revision: 12923
Modified:
trunk/vorbis/doc/draft-ietf-avt-rtp-vorbis-04.txt
trunk/vorbis/doc/draft-ietf-avt-rtp-vorbis-04.xml
Log:
Headers packing changes as requested by rillian
Modified: trunk/vorbis/doc/draft-ietf-avt-rtp-vorbis-04.txt
===================================================================
--- trunk/vorbis/doc/draft-ietf-avt-rtp-vorbis-04.txt 2007-05-06 14:16:55 UTC (rev 12922)
+++ trunk/vorbis/doc/draft-ietf-avt-rtp-vorbis-04.txt 2007-05-07 20:54:02 UTC (rev 12923)
@@ -75,12 +75,12 @@
3. Configuration Headers . . . . . . . . . . . . . . . . . . . . 8
3.1. In-band Header Transmission . . . . . . . . . . . . . . . 9
3.1.1. Packed Configuration . . . . . . . . . . . . . . . . . 9
- 3.2. Out of Band Transmission . . . . . . . . . . . . . . . . . 10
+ 3.2. Out of Band Transmission . . . . . . . . . . . . . . . . . 11
3.2.1. Packed Headers . . . . . . . . . . . . . . . . . . . . 11
3.3. Loss of Configuration Headers . . . . . . . . . . . . . . 12
4. Comment Headers . . . . . . . . . . . . . . . . . . . . . . . 12
5. Frame Packetization . . . . . . . . . . . . . . . . . . . . . 13
- 5.1. Example Fragmented Vorbis Packet . . . . . . . . . . . . . 13
+ 5.1. Example Fragmented Vorbis Packet . . . . . . . . . . . . . 14
5.2. Packet Loss . . . . . . . . . . . . . . . . . . . . . . . 16
6. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 17
6.1. Packed Headers IANA Considerations . . . . . . . . . . . . 19
@@ -464,9 +464,15 @@
A Vorbis Packed Configuration is indicated with the Vorbis Data Type
field set to 1. Of the three headers, defined in the Vorbis I
specification [12], the identification and the setup MUST be packed
- together, while the comment header MUST be completely suppressed. It
- is up to the client to provide a minimal size comment header to the
- decoder if required by the implementation.
+ together as they are, while the comment header MAY be replaced with a
+ dummy one. The packed configuration follows a generic way to store
+ xiph codec configurations: the first byte stores the number of
+ following packets minus one, the next bytes represent the size of the
+ packets, every byte set to 0xff means that the next byte has to be
+ add to the current sum in order to have the complete size; the
+ headers immediately follows the list of sizes. The headers are
+ packed in the same order they are present in ogg: identification,
+ comment, setup.
@@ -494,12 +500,6 @@
-
-
-
-
-
-
Barbato Expires November 5, 2007 [Page 9]
Internet-Draft draft-ietf-avt-rtp-vorbis-04 May 2007
@@ -520,19 +520,29 @@
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Ident | 0 | 1 | 1|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
- | length | Identification ..
+ | length | n. of headers | length1 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ | length2 | Identification ..
+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
.. Identification ..
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
.. Identification ..
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
.. Identification ..
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
- .. | Setup ..
+ .. Identification | Comment ..
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ .. Comment ..
+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ .. Comment ..
+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ .. Comment ..
+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ .. Comment | Setup ..
+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
.. Setup ..
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
- .. Setup |
+ .. Setup ..
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
Figure 5: Packed Configuration Figure
@@ -542,25 +552,23 @@
set to 0 since the packet bears the full Packed configuration, the
number of packet is set to 1.
-3.2. Out of Band Transmission
- This section, as stated above, does not cover all the possible out-
- of-band delivery methods since they rely on different protocols and
- are linked to specific applications. The following packet definition
- SHOULD be used in out-of-band delivery and MUST be used when
- Configuration is inlined in the SDP.
-
-
-
-
Barbato Expires November 5, 2007 [Page 10]
Internet-Draft draft-ietf-avt-rtp-vorbis-04 May 2007
+3.2. Out of Band Transmission
+
+ This section, as stated above, does not cover all the possible out-
+ of-band delivery methods since they rely on different protocols and
+ are linked to specific applications. The following packet definition
+ SHOULD be used in out-of-band delivery and MUST be used when
+ Configuration is inlined in the SDP.
+
3.2.1. Packed Headers
As mentioned above the RECOMMENDED delivery vector for Vorbis
@@ -588,15 +596,44 @@
length there is only a 2 byte length tag to define the length of the
packed headers.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Barbato Expires November 5, 2007 [Page 11]
+
+Internet-Draft draft-ietf-avt-rtp-vorbis-04 May 2007
+
+
0 1 2 3
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
- | Ident | ..
+ | Ident | length1 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
- .. length | Identification Header ..
+ | 0xff | length2 | Identification Header ..
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ .................................................................
+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
.. Identification Header |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ | Configuration Header ..
+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ .................................................................
+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ .. Configuration Header |
+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Setup Header ..
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
.. Setup Header |
@@ -605,18 +642,9 @@
Figure 7: Packed Headers Detail
The key difference between the in-band format and this one, is there
- is no need for the payload header octet.
+ is no need for the payload header octet. In this figure the comment
+ has a size bigger than 255 bytes.
-
-
-
-
-
-Barbato Expires November 5, 2007 [Page 11]
-
-Internet-Draft draft-ietf-avt-rtp-vorbis-04 May 2007
-
-
3.3. Loss of Configuration Headers
Unlike the loss of raw Vorbis payload data, loss of a configuration
@@ -636,6 +664,15 @@
ignore it completely. The details on the format of the comments can
be found in the Vorbis documentation [12].
+
+
+
+
+Barbato Expires November 5, 2007 [Page 12]
+
+Internet-Draft draft-ietf-avt-rtp-vorbis-04 May 2007
+
+
0 1 2 3
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
@@ -664,15 +701,6 @@
fragmented.
-
-
-
-
-Barbato Expires November 5, 2007 [Page 12]
-
-Internet-Draft draft-ietf-avt-rtp-vorbis-04 May 2007
-
-
5. Frame Packetization
Each RTP packet contains either one Vorbis packet fragment, or an
@@ -693,6 +721,14 @@
correct sequence for fragmented packet reception the timestamp field
of fragmented packets MUST be the same as the first packet sent, with
the sequence number incremented as normal for the subsequent RTP
+
+
+
+Barbato Expires November 5, 2007 [Page 13]
+
+Internet-Draft draft-ietf-avt-rtp-vorbis-04 May 2007
+
+
packets. The length field shows the fragment length.
5.1. Example Fragmented Vorbis Packet
@@ -701,34 +737,6 @@
packets. Each packet contains the standard RTP headers as well as
the 4 octets Vorbis headers.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-Barbato Expires November 5, 2007 [Page 13]
-
-Internet-Draft draft-ietf-avt-rtp-vorbis-04 May 2007
-
-
Packet 1:
0 1 2 3
@@ -772,14 +780,6 @@
-
-
-
-
-
-
-
-
Barbato Expires November 5, 2007 [Page 14]
Internet-Draft draft-ietf-avt-rtp-vorbis-04 May 2007
Modified: trunk/vorbis/doc/draft-ietf-avt-rtp-vorbis-04.xml
===================================================================
--- trunk/vorbis/doc/draft-ietf-avt-rtp-vorbis-04.xml 2007-05-06 14:16:55 UTC (rev 12922)
+++ trunk/vorbis/doc/draft-ietf-avt-rtp-vorbis-04.xml 2007-05-07 20:54:02 UTC (rev 12923)
@@ -438,9 +438,8 @@
A Vorbis Packed Configuration is indicated with the Vorbis Data Type field set
to 1. Of the three headers, defined in the
<xref target="vorbis-spec-ref">Vorbis I specification</xref>, the
-identification and the setup MUST be packed together, while the comment header
-MUST be completely suppressed. It is up to the client to provide a minimal size
-comment header to the decoder if required by the implementation.
+identification and the setup MUST be packed together as they are, while the comment header MAY be replaced with a dummy one.
+The packed configuration follows a generic way to store xiph codec configurations: the first byte stores the number of following packets minus one, the next bytes represent the size of the packets, every byte set to 0xff means that the next byte has to be add to the current sum in order to have the complete size; the headers immediately follows the list of sizes. The headers are packed in the same order they are present in ogg: identification, comment, setup.
</t>
<figure anchor="Packed Configuration Figure" title="Packed Configuration Figure">
@@ -460,19 +459,29 @@
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Ident | 0 | 1 | 1|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
- | length | Identification ..
+ | length | n. of headers | length1 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ | length2 | Identification ..
+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
.. Identification ..
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
.. Identification ..
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
.. Identification ..
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
- .. | Setup ..
+ .. Identification | Comment ..
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ .. Comment ..
+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ .. Comment ..
+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ .. Comment ..
+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ .. Comment | Setup ..
+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
.. Setup ..
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
- .. Setup |
+ .. Setup ..
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
]]></artwork>
</figure>
@@ -485,7 +494,6 @@
<section anchor="Out of Band Transmission" title="Out of Band Transmission">
-
<t>
This section, as stated above, does not cover all the possible out-of-band
delivery methods since they rely on different protocols and are linked to
@@ -529,12 +537,20 @@
0 1 2 3
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
- | Ident | ..
+ | Ident | length1 |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
- .. length | Identification Header ..
+ | 0xff | length2 | Identification Header ..
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ .................................................................
+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
.. Identification Header |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ | Configuration Header ..
+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ .................................................................
+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
+ .. Configuration Header |
+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Setup Header ..
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
.. Setup Header |
@@ -543,7 +559,7 @@
</figure>
<t>
The key difference between the in-band format and this one, is there is no need
-for the payload header octet.
+for the payload header octet. In this figure the comment has a size bigger than 255 bytes.
</t>
</section>
More information about the commits
mailing list