[xiph-commits] r10193 - trunk/vorbis/doc

lu_zero at svn.xiph.org lu_zero at svn.xiph.org
Tue Oct 18 16:15:37 PDT 2005


Author: lu_zero
Date: 2005-10-18 16:15:34 -0700 (Tue, 18 Oct 2005)
New Revision: 10193

Modified:
   trunk/vorbis/doc/draft-ietf-avt-vorbis-rtp-01.txt
   trunk/vorbis/doc/draft-ietf-avt-vorbis-rtp-01.xml
Log:
Caching paragraph removed (doesn't apply anymore)
Minor retouches


Modified: trunk/vorbis/doc/draft-ietf-avt-vorbis-rtp-01.txt
===================================================================
--- trunk/vorbis/doc/draft-ietf-avt-vorbis-rtp-01.txt	2005-10-18 16:51:38 UTC (rev 10192)
+++ trunk/vorbis/doc/draft-ietf-avt-vorbis-rtp-01.txt	2005-10-18 23:15:34 UTC (rev 10193)
@@ -1,6 +1,7 @@
 
 
 
+
 AVT Working Group                                             L. Barbato
 Internet-Draft                                                  Xiph.Org
 Expires: April 18, 2006                                 October 15, 2005
@@ -79,11 +80,10 @@
        3.1.1.  Packed Configuration . . . . . . . . . . . . . . . . .  9
      3.2.  Packed Headers Delivery  . . . . . . . . . . . . . . . . . 10
        3.2.1.  Packed Headers IANA Considerations . . . . . . . . . . 11
-     3.3.  Configuration Caching  . . . . . . . . . . . . . . . . . . 12
-     3.4.  Loss of Configuration Headers  . . . . . . . . . . . . . . 12
+     3.3.  Loss of Configuration Headers  . . . . . . . . . . . . . . 12
    4.  Comment Headers  . . . . . . . . . . . . . . . . . . . . . . . 12
    5.  Frame Packetizing  . . . . . . . . . . . . . . . . . . . . . . 13
-     5.1.  Example Fragmented Vorbis Packet . . . . . . . . . . . . . 14
+     5.1.  Example Fragmented Vorbis Packet . . . . . . . . . . . . . 13
      5.2.  Packet Loss  . . . . . . . . . . . . . . . . . . . . . . . 16
    6.  IANA Considerations  . . . . . . . . . . . . . . . . . . . . . 17
      6.1.  Mapping MIME Parameters into SDP . . . . . . . . . . . . . 18
@@ -108,6 +108,7 @@
 
 
 
+
 Barbato                  Expires April 18, 2006                 [Page 2]
 
 Internet-Draft        draft-ietf-avt-vorbis-rtp-01          October 2005
@@ -619,16 +620,8 @@
 
    Change controller: IETF AVT Working Group
 
-3.3.  Configuration Caching
+3.3.  Loss of Configuration Headers
 
-   Configuration caching allows clients that have previously connected
-   to a stream to re-use the associated configuration data.  When a
-   client receives a Packed Configuration packet it may store it locally
-   and can compare the Ident key with that of the new stream and begin
-   decoding before it has received any of the headers.
-
-3.4.  Loss of Configuration Headers
-
    Unlike the loss of raw Vorbis payload data, loss of a configuration
    header can lead to a situation where it will not be possible to
    successfully decode the stream.
@@ -644,35 +637,9 @@
    contain the comment metadata, such as artist name, track title and so
    on.  These metadata messages are not intended to be fully descriptive
    but to offer basic track/song information.  This packet SHOULD NOT be
-   sent and clients MAY ignore it completely.  During a session the
-   Details on the format of the comments can be found in the Vorbis
-   documentation [12].
+   sent and clients MAY ignore it completely.  The details on the format
+   of the comments can be found in the Vorbis documentation [12].
 
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-Barbato                  Expires April 18, 2006                [Page 12]
-
-Internet-Draft        draft-ietf-avt-vorbis-rtp-01          October 2005
-
-
        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
       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
@@ -701,6 +668,12 @@
    fragmented.
 
 
+
+Barbato                  Expires April 18, 2006                [Page 12]
+
+Internet-Draft        draft-ietf-avt-vorbis-rtp-01          October 2005
+
+
 5.  Frame Packetizing
 
    Each RTP packet contains either one Vorbis packet fragment, or an
@@ -711,30 +684,52 @@
    in the RTP packet with as many Vorbis packets as will fit, up to a
    maximum of 15.  Path MTU is detailed in [6] and [7].
 
-   If a Vorbis packet is larger than 65535 octets it MUST be fragmented.
-   A fragmented packet has a zero in the last four bits of the payload
-   header.  The first fragment will set the Fragment type to 1.  Each
-   fragment after the first will set the Fragment type to 2 in the
-   payload header.  The RTP packet containing the last fragment of the
-   Vorbis packet will have the Fragment type set to 3.  To maintain the
-   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
-   packets.
+   If a Vorbis packet, not only data but also Configuration and Comment,
+   is larger than 65535 octets it MUST be fragmented.  A fragmented
+   packet has a zero in the last four bits of the payload header.  The
+   first fragment will set the Fragment type to 1.  Each fragment after
+   the first will set the Fragment type to 2 in the payload header.  The
+   RTP packet containing the last fragment of the Vorbis packet will
+   have the Fragment type set to 3.  To maintain the 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 packets.
 
+5.1.  Example Fragmented Vorbis Packet
 
+   Here is an example fragmented Vorbis packet split over three RTP
+   packets.  Each packet contains the standard RTP headers as well as
+   the 4 octet Vorbis headers.
 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 Barbato                  Expires April 18, 2006                [Page 13]
 
 Internet-Draft        draft-ietf-avt-vorbis-rtp-01          October 2005
 
 
-5.1.  Example Fragmented Vorbis Packet
-
-   Here is an example fragmented Vorbis packet split over three RTP
-   packets.  Each packet contains the standard RTP headers as well as
-   the 4 octet Vorbis headers.
-
       Packet 1:
 
        0                   1                   2                   3
@@ -750,7 +745,7 @@
       |                              ...                              |
       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
-      |                      Ident                    | 1 | 0 |      0|
+      |                       Ident                   | 1 | 0 |      0|
       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
       |             length            |            vorbis data       ..
       +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
@@ -780,6 +775,12 @@
 
 
 
+
+
+
+
+
+
 Barbato                  Expires April 18, 2006                [Page 14]
 
 Internet-Draft        draft-ietf-avt-vorbis-rtp-01          October 2005
@@ -917,8 +918,9 @@
    Optional Parameters:
 
    configuration-uri: the URI of the configuration headers in case of
-   out of band transmission.  In the form of
-   proto://path/to/resource/Ident
+   out of band transmission.  In the form of proto://path/to/resource/
+   Depending on the specific method the single ident packet could be
+   retrived by their number, or aggregated in a single stream.
 
    Encoding considerations:
 
@@ -947,7 +949,6 @@
 
 
 
-
 Barbato                  Expires April 18, 2006                [Page 17]
 
 Internet-Draft        draft-ietf-avt-vorbis-rtp-01          October 2005
@@ -1012,14 +1013,14 @@
       a=delivery:out_band/http
       a=fmtp:98 delivery-method:inline,out_band/http;
       configuration=base16string1;
-      configuration-uri=http://path/to/the/resource/159
+      configuration-uri=http://path/to/the/resource
 
    Note that the payload format (encoding) names are commonly shown in
    upper case.  MIME subtypes are commonly shown in lower case.  These
    names are case-insensitive in both places.  Similarly, parameter
    names are case-insensitive both in MIME types and in the default
    mapping to the SDP a=fmtp attribute.  The exception regarding case
-   sensitivity is the configuration header URL which MUST be regarded as
+   sensitivity is the configuration-uri URI which MUST be regarded as
    being case sensitive.
 
    The answer to any offer, [8], MUST NOT change the URI specified in
@@ -1070,9 +1071,9 @@
    Hennequin, Ralph Giles, Tor-Einar Jarnbjo, Colin Law, John Lazzaro,
    Jack Moffitt, Christopher Montgomery, Colin Perkins, Barry Short,
    Mike Smith, Phil Kerr, Michael Sparks, Magnus Westerlund, David
-   Barrett, Politecnico di Torino (LS)^3/IMG Group in particular
-   Federico Ridolfo, Francesco Varano, Giampaolo Mancini, Juan Carlos De
-   Martin.
+   Barrett, Silvia Pfeiffer, Politecnico di Torino (LS)^3/IMG Group in
+   particular Federico Ridolfo, Francesco Varano, Giampaolo Mancini,
+   Juan Carlos De Martin.
 
 
 10.  References
@@ -1286,3 +1287,4 @@
 
 Barbato                  Expires April 18, 2006                [Page 23]
 
+

Modified: trunk/vorbis/doc/draft-ietf-avt-vorbis-rtp-01.xml
===================================================================
--- trunk/vorbis/doc/draft-ietf-avt-vorbis-rtp-01.xml	2005-10-18 16:51:38 UTC (rev 10192)
+++ trunk/vorbis/doc/draft-ietf-avt-vorbis-rtp-01.xml	2005-10-18 23:15:34 UTC (rev 10193)
@@ -242,8 +242,7 @@
 </figure>
 
 <t>
-Each Vorbis payload packet starts with a two octet length header, which is used to represent the size of the following 
-data payload, followed by the raw Vorbis data.
+Each Vorbis payload packet starts with a two octet length header, which is used to represent the size of the following data payload, followed by the raw Vorbis data.
 </t>
 
 <t>
@@ -508,14 +507,7 @@
 </section>
 </section>
 
-<section anchor="Configuration Caching" title="Configuration Caching"> 
 
-<t>
-Configuration caching allows clients that have previously connected to a stream to re-use the associated configuration data. When a client receives a Packed Configuration packet it may store it locally and can compare the Ident key with that of the new stream and begin decoding before it has received any of the headers.
-</t>
-
-</section>
-
 <section anchor="Loss of Configuration Headers" title="Loss of Configuration Headers"> 
 
 <t>
@@ -542,7 +534,7 @@
 <section anchor="Comment Headers" title="Comment Headers">
 
 <t>
-With the payload type flag set to 2, this indicates that the packet contain the comment metadata, such as artist name, track title and so on. These metadata messages are not intended to be fully descriptive but to offer basic track/song information. This packet SHOULD NOT be sent and clients MAY ignore it completely. During a session the Details on the format of the comments can be found in the <xref target="vorbis-spec-ref">Vorbis documentation</xref>.
+With the payload type flag set to 2, this indicates that the packet contain the comment metadata, such as artist name, track title and so on. These metadata messages are not intended to be fully descriptive but to offer basic track/song information. This packet SHOULD NOT be sent and clients MAY ignore it completely. The details on the format of the comments can be found in the <xref target="vorbis-spec-ref">Vorbis documentation</xref>.
 </t>
 <figure anchor="Comment Packet Figure" title="Comment Packet">
 <artwork><![CDATA[
@@ -584,14 +576,13 @@
 </t>
 
 <t>
-If a Vorbis packet is larger than 65535 octets it MUST be fragmented.  A fragmented packet has a zero in the last four bits of the payload header. The first fragment will set the Fragment type to 1. Each fragment after the first will set the Fragment type to 2 in the payload header.  The RTP packet containing the last fragment of the Vorbis packet will have the Fragment type set to 3.  To maintain the 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 packets.
+If a Vorbis packet, not only data but also Configuration and Comment, is larger than 65535 octets it MUST be fragmented. A fragmented packet has a zero in the last four bits of the payload header. The first fragment will set the Fragment type to 1. Each fragment after the first will set the Fragment type to 2 in the payload header.  The RTP packet containing the last fragment of the Vorbis packet will have the Fragment type set to 3.  To maintain the 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 packets.
 </t>
 
 <section anchor="Example Fragmented Vorbis Packet" title="Example Fragmented Vorbis Packet">
 
 <t>
-Here is an example fragmented Vorbis packet split over three RTP packets.  Each packet contains the standard RTP headers as 
-well as the 4 octet Vorbis headers.
+Here is an example fragmented Vorbis packet split over three RTP packets.  Each packet contains the standard RTP headers as well as the 4 octet Vorbis headers.
 </t>
 
 <figure anchor="Example Fragmented Packet (Packet 1)" title="Example Fragmented Packet (Packet 1)">
@@ -611,7 +602,7 @@
    |                              ...                              |
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
-   |                      Ident                    | 1 | 0 |      0|
+   |                       Ident                   | 1 | 0 |      0|
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
    |             length            |            vorbis data       ..
    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
@@ -722,7 +713,7 @@
 
 <t>
 Optional Parameters: </t><t>
-configuration-uri: the URI of the configuration headers in case of out of band transmission. In the form of proto://path/to/resource/Ident
+configuration-uri: the URI of the configuration headers in case of out of band transmission. In the form of proto://path/to/resource/ Depending on the specific method the single ident packet could be retrived by their number, or aggregated in a single stream.
 </t>
 
 <t>
@@ -812,14 +803,11 @@
 <t>m=audio  RTP/AVP 98</t>
 <t>a=rtpmap:98 VORBIS/44100/2</t>
 <t>a=delivery:out_band/http</t>
-<t>a=fmtp:98 delivery-method:inline,out_band/http; configuration=base16string1; configuration-uri=http://path/to/the/resource/159</t>
+<t>a=fmtp:98 delivery-method:inline,out_band/http; configuration=base16string1; configuration-uri=http://path/to/the/resource</t>
 </list>
 
 <t>
-Note that the payload format (encoding) names are commonly shown in upper case.  MIME subtypes are commonly shown in lower 
-case.  These names are case-insensitive in both places.  Similarly, parameter names are case-insensitive both in MIME types and 
-in the default mapping to the SDP a=fmtp attribute.  The exception regarding case sensitivity is the configuration header URL 
-which MUST be regarded as being case sensitive.
+Note that the payload format (encoding) names are commonly shown in upper case.  MIME subtypes are commonly shown in lower case. These names are case-insensitive in both places.  Similarly, parameter names are case-insensitive both in MIME types and in the default mapping to the SDP a=fmtp attribute.  The exception regarding case sensitivity is the configuration-uri URI which MUST be regarded as being case sensitive.
 </t>
 
 <t>
@@ -862,7 +850,7 @@
 </t>
 
 <t>
-Thanks to the AVT, Ogg Vorbis Communities / Xiph.org including Steve Casner, Aaron Colwell, Ross Finlayson, Fluendo, Ramon Garcia, Pascal Hennequin, Ralph Giles, Tor-Einar Jarnbjo, Colin Law, John Lazzaro, Jack Moffitt, Christopher Montgomery,  Colin Perkins, Barry Short, Mike Smith, Phil Kerr, Michael Sparks, Magnus Westerlund, David Barrett, Politecnico di Torino (LS)³/IMG Group in particular Federico Ridolfo, Francesco Varano, Giampaolo Mancini, Juan Carlos De Martin.
+Thanks to the AVT, Ogg Vorbis Communities / Xiph.org including Steve Casner, Aaron Colwell, Ross Finlayson, Fluendo, Ramon Garcia, Pascal Hennequin, Ralph Giles, Tor-Einar Jarnbjo, Colin Law, John Lazzaro, Jack Moffitt, Christopher Montgomery,  Colin Perkins, Barry Short, Mike Smith, Phil Kerr, Michael Sparks, Magnus Westerlund, David Barrett, Silvia Pfeiffer, Politecnico di Torino (LS)³/IMG Group in particular Federico Ridolfo, Francesco Varano, Giampaolo Mancini, Juan Carlos De Martin.
 </t>
 
 </section> 



More information about the commits mailing list