[html5] r6982 - [giow] (0) Add some of DASH's values to AudioTrack.kind and VideoTrack.kind. Fix [...]

whatwg at whatwg.org whatwg at whatwg.org
Wed Feb 8 16:20:35 PST 2012


Author: ianh
Date: 2012-02-08 16:20:34 -0800 (Wed, 08 Feb 2012)
New Revision: 6982

Modified:
   complete.html
   index
   source
Log:
[giow] (0) Add some of DASH's values to AudioTrack.kind and VideoTrack.kind.
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=12544
Affected topics: HTML, Video and Audio

Modified: complete.html
===================================================================
--- complete.html	2012-02-08 23:18:44 UTC (rev 6981)
+++ complete.html	2012-02-09 00:20:34 UTC (rev 6982)
@@ -240,7 +240,7 @@
 
   <header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
    <hgroup><h1 class=allcaps>HTML</h1>
-    <h2 class="no-num no-toc">Living Standard — Last Updated 8 February 2012</h2>
+    <h2 class="no-num no-toc">Living Standard — Last Updated 9 February 2012</h2>
    </hgroup><dl><dt><strong>Web developer edition:</strong></dt>
     <dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
     <dt>Multiple-page version:</dt>
@@ -30954,16 +30954,19 @@
   of the table below that is the most appropriate for the track based
   on the definitions in the table's second and third columns, as
   determined by the metadata included in the track in the <a href=#media-resource>media
-  resource</a>. For Ogg files, the Role header of the track gives
-  the relevant metadata. The cell in the third column of a row says
-  what the category given in the cell in the first column of that row
-  applies to; a category is only appropriate for an audio track if it
-  applies to audio tracks, and a category is only appropriate for
-  video tracks if it applies to video tracks. Categories must only be
-  returned for <code><a href=#audiotrack>AudioTrack</a></code> objects if they are appropriate
-  for audio, and must only be returned for <code><a href=#videotrack>VideoTrack</a></code>
-  objects if they are appropriate for video.</p>
+  resource</a>. The cell in the third column of a row says what the
+  category given in the cell in the first column of that row applies
+  to; a category is only appropriate for an audio track if it applies
+  to audio tracks, and a category is only appropriate for video tracks
+  if it applies to video tracks. Categories must only be returned for
+  <code><a href=#audiotrack>AudioTrack</a></code> objects if they are appropriate for audio,
+  and must only be returned for <code><a href=#videotrack>VideoTrack</a></code> objects if
+  they are appropriate for video.</p>
 
+  <p>For Ogg files, the Role header of the track gives the relevant
+  metadata. For DASH media resources, the <code title="">Role</code>
+  element conveys the information. For WebM, only the <code title="">FlagDefault</code> element currently maps to a value. <a href=#refsOGGROLE>[OGGROLE]</a> <a href=#refsDASH>[DASH]</a> <a href=#refsWEBMCG>[WEBMCG]</a></p>
+
   </div>
 
   <table id=dom-TrackList-getKind-categories><caption>Return values for <code title=dom-AudioTrack-kind><a href=#dom-audiotrack-kind>AudioTrack.kind()</a></code> and <code title=dom-VideoTrack-kind><a href=#dom-videotrack-kind>VideoTrack.kind()</a></code></caption>
@@ -30974,7 +30977,7 @@
    <tbody><tr><td>"<dfn id=value-track-kind-alternate title=value-track-kind-alternate><code>alternative</code></dfn>"
      <td>A possible alternative to the main track, e.g. a different take of a song (audio), or a different angle (video).
      <td>Audio and video.
-     <td>Ogg: "audio/alternate" or "video/alternate".
+     <td>Ogg: "audio/alternate" or "video/alternate"; DASH: "alternate".
 
     <tr><td>"<dfn id=value-track-kind-description title=value-track-kind-description><code>description</code></dfn>"
      <td>An audio description of a video track.
@@ -30984,7 +30987,7 @@
     <tr><td>"<dfn id=value-track-kind-main title=value-track-kind-main><code>main</code></dfn>"
      <td>The primary audio or video track.
      <td>Audio and video.
-     <td>Ogg: "audio/main" or "video/main"; WebM: the "FlagDefault" element is set.
+     <td>Ogg: "audio/main" or "video/main"; WebM: the "FlagDefault" element is set; DASH: "main" role.
 
     <tr><td>"<dfn id=value-track-kind-sign title=value-track-kind-sign><code>sign</code></dfn>"
      <td>A sign-language interpretation of an audio track.
@@ -30994,12 +30997,12 @@
     <tr><td>"<dfn id=value-track-kind-translation title=value-track-kind-translation><code>translation</code></dfn>"
      <td>A translated version of the main track.
      <td>Audio only.
-     <td>Ogg: "audio/dub".
+     <td>Ogg: "audio/dub". DASH: "dub" role.
 
-    <tr><!-- added because of the volume of use cases, but we should remove it if none of the formats start supporting it --><td>"<dfn id=value-track-kind-commentary title=value-track-kind-commentary><code>commentary</code></dfn>"
+    <tr><td>"<dfn id=value-track-kind-commentary title=value-track-kind-commentary><code>commentary</code></dfn>"
      <td>Commentary on the primary audio or video track, e.g. a director's commentary.
      <td>Audio and video.
-     <td>No known formats expose this category at this time.
+     <td>DASH: "commentary" role.
 
     <tr><td>"<dfn id=value-track-kind-none title=value-track-kind-none><code></code></dfn>" (empty string)
      <td>No explicit kind, or the kind given by the track's metadata is not recognised by the user agent.
@@ -97636,6 +97639,9 @@
    <dd><cite><a href=http://dev.w3.org/csswg/css3-ui/>CSS3 Basic User
    Interface Module</a></cite>, T. Çelik. W3C.</dd>
 
+   <dt id=refsDASH>[DASH]</dt>
+   <dd><cite><a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=57623">Dynamic adaptive streaming over HTTP (DASH)</a></cite>. ISO.</dd>
+
    <dt id=refsDOMCORE>[DOMCORE]</dt>
    <dd><cite><a href=http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html>Web DOM Core</a></cite>, A. van Kesteren. W3C.</dd>
 
@@ -97786,6 +97792,9 @@
    <dd>(Non-normative) <cite><a href=https://developer.mozilla.org/en/Gecko_Plugin_API_Reference>Gecko
    Plugin API Reference</a></cite>. Mozilla.</dd>
 
+   <dt id=refsOGGROLE>[OGGROLE]</dt>
+   <dd><cite><a href=http://wiki.xiph.org/SkeletonHeaders>SkeletonHeaders</a></cite>. Xiph.Org.</dd>
+
    <dt id=refsOPENSEARCH>[OPENSEARCH]</dt>
    <dd><cite><a href=http://www.opensearch.org/Specifications/OpenSearch/1.1#Autodiscovery_in_HTML.2FXHTML>Autodiscovery
    in HTML/XHTML</a></cite>. In <cite>OpenSearch 1.1 Draft 4</cite>,
@@ -98068,6 +98077,9 @@
    <dd><cite><a href=http://tools.ietf.org/html/rfc5988>Web
    Linking</a></cite>, M. Nottingham. IETF.</dd>
 
+   <dt id=refsWEBMCG>[WEBMCG]</dt>
+   <dd><cite><a href=http://www.webmproject.org/code/specs/container/>WebM Container Guidelines</a></cite>. The WebM Project.</dd>
+
    <dt id=refsWEBVTT>[WEBVTT]</dt>
    <dd><cite><a href=http://dev.w3.org/html5/webvtt/>WebVTT</a></cite>, I. Hickson. W3C.</dd>
 

Modified: index
===================================================================
--- index	2012-02-08 23:18:44 UTC (rev 6981)
+++ index	2012-02-09 00:20:34 UTC (rev 6982)
@@ -240,7 +240,7 @@
 
   <header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
    <hgroup><h1 class=allcaps>HTML</h1>
-    <h2 class="no-num no-toc">Living Standard — Last Updated 8 February 2012</h2>
+    <h2 class="no-num no-toc">Living Standard — Last Updated 9 February 2012</h2>
    </hgroup><dl><dt><strong>Web developer edition:</strong></dt>
     <dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
     <dt>Multiple-page version:</dt>
@@ -30954,16 +30954,19 @@
   of the table below that is the most appropriate for the track based
   on the definitions in the table's second and third columns, as
   determined by the metadata included in the track in the <a href=#media-resource>media
-  resource</a>. For Ogg files, the Role header of the track gives
-  the relevant metadata. The cell in the third column of a row says
-  what the category given in the cell in the first column of that row
-  applies to; a category is only appropriate for an audio track if it
-  applies to audio tracks, and a category is only appropriate for
-  video tracks if it applies to video tracks. Categories must only be
-  returned for <code><a href=#audiotrack>AudioTrack</a></code> objects if they are appropriate
-  for audio, and must only be returned for <code><a href=#videotrack>VideoTrack</a></code>
-  objects if they are appropriate for video.</p>
+  resource</a>. The cell in the third column of a row says what the
+  category given in the cell in the first column of that row applies
+  to; a category is only appropriate for an audio track if it applies
+  to audio tracks, and a category is only appropriate for video tracks
+  if it applies to video tracks. Categories must only be returned for
+  <code><a href=#audiotrack>AudioTrack</a></code> objects if they are appropriate for audio,
+  and must only be returned for <code><a href=#videotrack>VideoTrack</a></code> objects if
+  they are appropriate for video.</p>
 
+  <p>For Ogg files, the Role header of the track gives the relevant
+  metadata. For DASH media resources, the <code title="">Role</code>
+  element conveys the information. For WebM, only the <code title="">FlagDefault</code> element currently maps to a value. <a href=#refsOGGROLE>[OGGROLE]</a> <a href=#refsDASH>[DASH]</a> <a href=#refsWEBMCG>[WEBMCG]</a></p>
+
   </div>
 
   <table id=dom-TrackList-getKind-categories><caption>Return values for <code title=dom-AudioTrack-kind><a href=#dom-audiotrack-kind>AudioTrack.kind()</a></code> and <code title=dom-VideoTrack-kind><a href=#dom-videotrack-kind>VideoTrack.kind()</a></code></caption>
@@ -30974,7 +30977,7 @@
    <tbody><tr><td>"<dfn id=value-track-kind-alternate title=value-track-kind-alternate><code>alternative</code></dfn>"
      <td>A possible alternative to the main track, e.g. a different take of a song (audio), or a different angle (video).
      <td>Audio and video.
-     <td>Ogg: "audio/alternate" or "video/alternate".
+     <td>Ogg: "audio/alternate" or "video/alternate"; DASH: "alternate".
 
     <tr><td>"<dfn id=value-track-kind-description title=value-track-kind-description><code>description</code></dfn>"
      <td>An audio description of a video track.
@@ -30984,7 +30987,7 @@
     <tr><td>"<dfn id=value-track-kind-main title=value-track-kind-main><code>main</code></dfn>"
      <td>The primary audio or video track.
      <td>Audio and video.
-     <td>Ogg: "audio/main" or "video/main"; WebM: the "FlagDefault" element is set.
+     <td>Ogg: "audio/main" or "video/main"; WebM: the "FlagDefault" element is set; DASH: "main" role.
 
     <tr><td>"<dfn id=value-track-kind-sign title=value-track-kind-sign><code>sign</code></dfn>"
      <td>A sign-language interpretation of an audio track.
@@ -30994,12 +30997,12 @@
     <tr><td>"<dfn id=value-track-kind-translation title=value-track-kind-translation><code>translation</code></dfn>"
      <td>A translated version of the main track.
      <td>Audio only.
-     <td>Ogg: "audio/dub".
+     <td>Ogg: "audio/dub". DASH: "dub" role.
 
-    <tr><!-- added because of the volume of use cases, but we should remove it if none of the formats start supporting it --><td>"<dfn id=value-track-kind-commentary title=value-track-kind-commentary><code>commentary</code></dfn>"
+    <tr><td>"<dfn id=value-track-kind-commentary title=value-track-kind-commentary><code>commentary</code></dfn>"
      <td>Commentary on the primary audio or video track, e.g. a director's commentary.
      <td>Audio and video.
-     <td>No known formats expose this category at this time.
+     <td>DASH: "commentary" role.
 
     <tr><td>"<dfn id=value-track-kind-none title=value-track-kind-none><code></code></dfn>" (empty string)
      <td>No explicit kind, or the kind given by the track's metadata is not recognised by the user agent.
@@ -97636,6 +97639,9 @@
    <dd><cite><a href=http://dev.w3.org/csswg/css3-ui/>CSS3 Basic User
    Interface Module</a></cite>, T. Çelik. W3C.</dd>
 
+   <dt id=refsDASH>[DASH]</dt>
+   <dd><cite><a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=57623">Dynamic adaptive streaming over HTTP (DASH)</a></cite>. ISO.</dd>
+
    <dt id=refsDOMCORE>[DOMCORE]</dt>
    <dd><cite><a href=http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html>Web DOM Core</a></cite>, A. van Kesteren. W3C.</dd>
 
@@ -97786,6 +97792,9 @@
    <dd>(Non-normative) <cite><a href=https://developer.mozilla.org/en/Gecko_Plugin_API_Reference>Gecko
    Plugin API Reference</a></cite>. Mozilla.</dd>
 
+   <dt id=refsOGGROLE>[OGGROLE]</dt>
+   <dd><cite><a href=http://wiki.xiph.org/SkeletonHeaders>SkeletonHeaders</a></cite>. Xiph.Org.</dd>
+
    <dt id=refsOPENSEARCH>[OPENSEARCH]</dt>
    <dd><cite><a href=http://www.opensearch.org/Specifications/OpenSearch/1.1#Autodiscovery_in_HTML.2FXHTML>Autodiscovery
    in HTML/XHTML</a></cite>. In <cite>OpenSearch 1.1 Draft 4</cite>,
@@ -98068,6 +98077,9 @@
    <dd><cite><a href=http://tools.ietf.org/html/rfc5988>Web
    Linking</a></cite>, M. Nottingham. IETF.</dd>
 
+   <dt id=refsWEBMCG>[WEBMCG]</dt>
+   <dd><cite><a href=http://www.webmproject.org/code/specs/container/>WebM Container Guidelines</a></cite>. The WebM Project.</dd>
+
    <dt id=refsWEBVTT>[WEBVTT]</dt>
    <dd><cite><a href=http://dev.w3.org/html5/webvtt/>WebVTT</a></cite>, I. Hickson. W3C.</dd>
 

Modified: source
===================================================================
--- source	2012-02-08 23:18:44 UTC (rev 6981)
+++ source	2012-02-09 00:20:34 UTC (rev 6982)
@@ -33752,16 +33752,22 @@
   of the table below that is the most appropriate for the track based
   on the definitions in the table's second and third columns, as
   determined by the metadata included in the track in the <span>media
-  resource</span>. For Ogg files, the Role header of the track gives
-  the relevant metadata. The cell in the third column of a row says
-  what the category given in the cell in the first column of that row
-  applies to; a category is only appropriate for an audio track if it
-  applies to audio tracks, and a category is only appropriate for
-  video tracks if it applies to video tracks. Categories must only be
-  returned for <code>AudioTrack</code> objects if they are appropriate
-  for audio, and must only be returned for <code>VideoTrack</code>
-  objects if they are appropriate for video.</p>
+  resource</span>. The cell in the third column of a row says what the
+  category given in the cell in the first column of that row applies
+  to; a category is only appropriate for an audio track if it applies
+  to audio tracks, and a category is only appropriate for video tracks
+  if it applies to video tracks. Categories must only be returned for
+  <code>AudioTrack</code> objects if they are appropriate for audio,
+  and must only be returned for <code>VideoTrack</code> objects if
+  they are appropriate for video.</p>
 
+  <p>For Ogg files, the Role header of the track gives the relevant
+  metadata. For DASH media resources, the <code title="">Role</code>
+  element conveys the information. For WebM, only the <code
+  title="">FlagDefault</code> element currently maps to a value. <a
+  href="#refsOGGROLE">[OGGROLE]</a> <a href="#refsDASH">[DASH]</a> <a
+  href="#refsWEBMCG">[WEBMCG]</a></p>
+
   </div>
 
   <table id="dom-TrackList-getKind-categories">
@@ -33778,7 +33784,7 @@
      <td>"<dfn title="value-track-kind-alternate"><code>alternative</code></dfn>"
      <td>A possible alternative to the main track, e.g. a different take of a song (audio), or a different angle (video).
      <td>Audio and video.
-     <td>Ogg: "audio/alternate" or "video/alternate".
+     <td>Ogg: "audio/alternate" or "video/alternate"; DASH: "alternate".
 
     <tr>
      <td>"<dfn title="value-track-kind-description"><code>description</code></dfn>"
@@ -33790,7 +33796,7 @@
      <td>"<dfn title="value-track-kind-main"><code>main</code></dfn>"
      <td>The primary audio or video track.
      <td>Audio and video.
-     <td>Ogg: "audio/main" or "video/main"; WebM: the "FlagDefault" element is set.
+     <td>Ogg: "audio/main" or "video/main"; WebM: the "FlagDefault" element is set; DASH: "main" role.
 
     <tr>
      <td>"<dfn title="value-track-kind-sign"><code>sign</code></dfn>"
@@ -33802,13 +33808,13 @@
      <td>"<dfn title="value-track-kind-translation"><code>translation</code></dfn>"
      <td>A translated version of the main track.
      <td>Audio only.
-     <td>Ogg: "audio/dub".
+     <td>Ogg: "audio/dub". DASH: "dub" role.
 
-    <tr> <!-- added because of the volume of use cases, but we should remove it if none of the formats start supporting it -->
+    <tr>
      <td>"<dfn title="value-track-kind-commentary"><code>commentary</code></dfn>"
      <td>Commentary on the primary audio or video track, e.g. a director's commentary.
      <td>Audio and video.
-     <td>No known formats expose this category at this time.
+     <td>DASH: "commentary" role.
 
     <tr>
      <td>"<dfn title="value-track-kind-none"><code></code></dfn>" (empty string)
@@ -114336,6 +114342,9 @@
    <dd><cite><a href="http://dev.w3.org/csswg/css3-values/">CSS3
    Values and Units</a></cite>, H. Lie, C. Lilley. W3C.</dd>
 
+   <dt id="refsDASH">[DASH]</dt>
+   <dd><cite><a href="http://www.iso.org/iso/iso_catalogue/catalogue_tc/catalogue_detail.htm?csnumber=57623">Dynamic adaptive streaming over HTTP (DASH)</a></cite>. ISO.</dd>
+
    <dt id="refsDOM2HTML">[DOM2HTML]</dt>
    <dd>(Non-normative) <cite><a
    href="http://www.w3.org/TR/DOM-Level-2-HTML/">Document Object Model
@@ -114565,6 +114574,9 @@
    Work in progress. <!--!-->
    </dd>
 
+   <dt id="refsOGGROLE">[OGGROLE]</dt>
+   <dd><cite><a href="http://wiki.xiph.org/SkeletonHeaders">SkeletonHeaders</a></cite>. Xiph.Org.</dd>
+
    <dt id="refsOPENSEARCH">[OPENSEARCH]</dt>
    <dd><cite><a
    href="http://www.opensearch.org/Specifications/OpenSearch/1.1#Autodiscovery_in_HTML.2FXHTML">Autodiscovery
@@ -114920,6 +114932,9 @@
    <dd><cite><a href="http://tools.ietf.org/html/rfc5988">Web
    Linking</a></cite>, M. Nottingham. IETF.</dd>
 
+   <dt id="refsWEBMCG">[WEBMCG]</dt>
+   <dd><cite><a href="http://www.webmproject.org/code/specs/container/">WebM Container Guidelines</a></cite>. The WebM Project.</dd>
+
    <dt id="refsWEBSOCKET">[WEBSOCKET]</dt>
    <dd><cite><a href="http://dev.w3.org/html5/websockets/">The WebSocket API</a></cite>, I. Hickson. W3C.</dd>
 




More information about the Commit-Watchers mailing list