[html5] r6032 - [giow] (0) add getKind() since WebM does have something like this, and MPEG is a [...]
whatwg at whatwg.org
whatwg at whatwg.org
Tue Apr 26 14:22:15 PDT 2011
Author: ianh
Date: 2011-04-26 14:22:14 -0700 (Tue, 26 Apr 2011)
New Revision: 6032
Modified:
complete.html
index
source
Log:
[giow] (0) add getKind() since WebM does have something like this, and MPEG is apparently planning to add it, so that (with Ogg) means three of the oft-supported formats have something relevant here.
Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=12544
Modified: complete.html
===================================================================
--- complete.html 2011-04-26 19:31:42 UTC (rev 6031)
+++ complete.html 2011-04-26 21:22:14 UTC (rev 6032)
@@ -28661,8 +28661,8 @@
<pre class=idl>interface <dfn id=tracklist>TrackList</dfn> {
readonly attribute unsigned long <a href=#dom-tracklist-length title=dom-TrackList-length>length</a>;
- DOMString <a href=#dom-tracklist-getid title=dom-TrackList-getID>getID</a>(in unsigned long index);<!--
- DOMString <span title="dom-TrackList-getKind">getKind</span>(in unsigned long index);-->
+ DOMString <a href=#dom-tracklist-getid title=dom-TrackList-getID>getID</a>(in unsigned long index);
+ DOMString <a href=#dom-tracklist-getkind title=dom-TrackList-getKind>getKind</a>(in unsigned long index);
DOMString <a href=#dom-tracklist-getlabel title=dom-TrackList-getLabel>getLabel</a>(in unsigned long index);
DOMString <a href=#dom-tracklist-getlanguage title=dom-TrackList-getLanguage>getLanguage</a>(in unsigned long index);
@@ -28697,15 +28697,15 @@
<cite>Media Fragments URI</cite> syntax. <a href=#hrefMEDIAFRAG>[MEDIAFRAG]</a></p>
</dd>
-<!--
- <dt><var title="">kind</var> = <var title="">tracks</var> . <code title="dom-TrackList-getKind">getKind</code>( <var title="">index</var> )</dt>
+ <dt><var title="">kind</var> = <var title="">tracks</var> . <code title=dom-TrackList-getKind><a href=#dom-tracklist-getkind>getKind</a></code>( <var title="">index</var> )</dt>
+
<dd>
- <p>Returns the category the given track falls into. The <a href="#dom-TrackList-getKind-categories">possible track categories</a> are given below.</p>
+ <p>Returns the category the given track falls into. The <a href=#dom-TrackList-getKind-categories>possible track categories</a> are given below.</p>
</dd>
--->
+
<dt><var title="">label</var> = <var title="">tracks</var> . <code title=dom-TrackList-getLabel><a href=#dom-tracklist-getlabel>getLabel</a></code>( <var title="">index</var> )</dt>
<dd>
@@ -28786,18 +28786,16 @@
if used as the name of a track in the track dimension of such a
fragment identifier. <a href=#refsMEDIAFRAG>[MEDIAFRAG]</a></p>
-<!--
- <p>The <dfn title="dom-TrackList-getKind"><code>getKind(<var
- title="">index</var>)</code></dfn> method must return the category
+ <p>The <dfn id=dom-tracklist-getkind title=dom-TrackList-getKind><code>getKind(<var title="">index</var>)</code></dfn> method must return the category
of the track with index <var title="">index</var>, if there is one.
If there is no such track, then the method must instead throw an
- <code>INDEX_SIZE_ERR</code> exception.</p>
+ <code><a href=#index_size_err>INDEX_SIZE_ERR</a></code> exception.</p>
<p>The category of a track is the string given in the first column
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
+ 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
@@ -28806,57 +28804,43 @@
</div>
- <table id="dom-TrackList-getKind-categories">
- <caption>Return values for <code title="dom-TrackList-getKind">getKind()</code></caption>
- <thead>
- <tr>
- <th>Category
+ <table id=dom-TrackList-getKind-categories><caption>Return values for <code title=dom-TrackList-getKind><a href=#dom-tracklist-getkind>getKind()</a></code></caption>
+ <thead><tr><th>Category
<th>Definition
<th>Applies to...</th>
<th>Examples
- <tbody>
-
- <tr>
- <td>"<dfn title="dom-TrackList-getKind-alternate"><code>alternative</code></dfn>"
+ <tbody><tr><td>"<dfn id=dom-tracklist-getkind-alternate title=dom-TrackList-getKind-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/alterate" or "video/alternate".
- <tr>
- <td>"<dfn title="dom-TrackList-getKind-description"><code>description</code></dfn>"
+ <tr><td>"<dfn id=dom-tracklist-getkind-description title=dom-TrackList-getKind-description><code>description</code></dfn>"
<td>An audio description of a video track.
<td>Audio only.
<td>Ogg: "audio/audiodesc".
- <tr>
- <td>"<dfn title="dom-TrackList-getKind-main"><code>main</code></dfn>"
+ <tr><td>"<dfn id=dom-tracklist-getkind-main title=dom-TrackList-getKind-main><code>main</code></dfn>"
<td>The primary audio or video track.
<td>Audio and video.
- <td>Ogg: "audio/main" or "video/main".
+ <td>Ogg: "audio/main" or "video/main"; WebM: the "FlagDefault" element is set.
- <tr>
- <td>"<dfn title="dom-TrackList-getKind-sign"><code>sign</code></dfn>"
+ <tr><td>"<dfn id=dom-tracklist-getkind-sign title=dom-TrackList-getKind-sign><code>sign</code></dfn>"
<td>A sign-language interpretation of an audio track.
<td>Video only.
<td>Ogg: "video/sign".
- <tr>
- <td>"<dfn title="dom-TrackList-getKind-translation"><code>translation</code></dfn>"
+ <tr><td>"<dfn id=dom-tracklist-getkind-translation title=dom-TrackList-getKind-translation><code>translation</code></dfn>"
<td>A translated version of the main track.
<td>Audio only.
<td>Ogg: "audio/dub".
- <tr>
- <td>"<dfn title="dom-TrackList-getKind-none"><code></code></dfn>" (empty string)
+ <tr><td>"<dfn id=dom-tracklist-getkind-none title=dom-TrackList-getKind-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.
<td>Audio and video.
<td>Any other track type or track role.
- </table>
+ </table><div class=impl>
- <div class="impl">
--->
-
<p>The <dfn id=dom-tracklist-getlabel title=dom-TrackList-getLabel><code>getLabel(<var title="">index</var>)</code></dfn> method must return the label of
the track with index <var title="">index</var>, if there is one and
it has a label. If there is no such track, then the method must
Modified: index
===================================================================
--- index 2011-04-26 19:31:42 UTC (rev 6031)
+++ index 2011-04-26 21:22:14 UTC (rev 6032)
@@ -28684,8 +28684,8 @@
<pre class=idl>interface <dfn id=tracklist>TrackList</dfn> {
readonly attribute unsigned long <a href=#dom-tracklist-length title=dom-TrackList-length>length</a>;
- DOMString <a href=#dom-tracklist-getid title=dom-TrackList-getID>getID</a>(in unsigned long index);<!--
- DOMString <span title="dom-TrackList-getKind">getKind</span>(in unsigned long index);-->
+ DOMString <a href=#dom-tracklist-getid title=dom-TrackList-getID>getID</a>(in unsigned long index);
+ DOMString <a href=#dom-tracklist-getkind title=dom-TrackList-getKind>getKind</a>(in unsigned long index);
DOMString <a href=#dom-tracklist-getlabel title=dom-TrackList-getLabel>getLabel</a>(in unsigned long index);
DOMString <a href=#dom-tracklist-getlanguage title=dom-TrackList-getLanguage>getLanguage</a>(in unsigned long index);
@@ -28720,15 +28720,15 @@
<cite>Media Fragments URI</cite> syntax. <a href=#hrefMEDIAFRAG>[MEDIAFRAG]</a></p>
</dd>
-<!--
- <dt><var title="">kind</var> = <var title="">tracks</var> . <code title="dom-TrackList-getKind">getKind</code>( <var title="">index</var> )</dt>
+ <dt><var title="">kind</var> = <var title="">tracks</var> . <code title=dom-TrackList-getKind><a href=#dom-tracklist-getkind>getKind</a></code>( <var title="">index</var> )</dt>
+
<dd>
- <p>Returns the category the given track falls into. The <a href="#dom-TrackList-getKind-categories">possible track categories</a> are given below.</p>
+ <p>Returns the category the given track falls into. The <a href=#dom-TrackList-getKind-categories>possible track categories</a> are given below.</p>
</dd>
--->
+
<dt><var title="">label</var> = <var title="">tracks</var> . <code title=dom-TrackList-getLabel><a href=#dom-tracklist-getlabel>getLabel</a></code>( <var title="">index</var> )</dt>
<dd>
@@ -28809,18 +28809,16 @@
if used as the name of a track in the track dimension of such a
fragment identifier. <a href=#refsMEDIAFRAG>[MEDIAFRAG]</a></p>
-<!--
- <p>The <dfn title="dom-TrackList-getKind"><code>getKind(<var
- title="">index</var>)</code></dfn> method must return the category
+ <p>The <dfn id=dom-tracklist-getkind title=dom-TrackList-getKind><code>getKind(<var title="">index</var>)</code></dfn> method must return the category
of the track with index <var title="">index</var>, if there is one.
If there is no such track, then the method must instead throw an
- <code>INDEX_SIZE_ERR</code> exception.</p>
+ <code><a href=#index_size_err>INDEX_SIZE_ERR</a></code> exception.</p>
<p>The category of a track is the string given in the first column
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
+ 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
@@ -28829,57 +28827,43 @@
</div>
- <table id="dom-TrackList-getKind-categories">
- <caption>Return values for <code title="dom-TrackList-getKind">getKind()</code></caption>
- <thead>
- <tr>
- <th>Category
+ <table id=dom-TrackList-getKind-categories><caption>Return values for <code title=dom-TrackList-getKind><a href=#dom-tracklist-getkind>getKind()</a></code></caption>
+ <thead><tr><th>Category
<th>Definition
<th>Applies to...</th>
<th>Examples
- <tbody>
-
- <tr>
- <td>"<dfn title="dom-TrackList-getKind-alternate"><code>alternative</code></dfn>"
+ <tbody><tr><td>"<dfn id=dom-tracklist-getkind-alternate title=dom-TrackList-getKind-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/alterate" or "video/alternate".
- <tr>
- <td>"<dfn title="dom-TrackList-getKind-description"><code>description</code></dfn>"
+ <tr><td>"<dfn id=dom-tracklist-getkind-description title=dom-TrackList-getKind-description><code>description</code></dfn>"
<td>An audio description of a video track.
<td>Audio only.
<td>Ogg: "audio/audiodesc".
- <tr>
- <td>"<dfn title="dom-TrackList-getKind-main"><code>main</code></dfn>"
+ <tr><td>"<dfn id=dom-tracklist-getkind-main title=dom-TrackList-getKind-main><code>main</code></dfn>"
<td>The primary audio or video track.
<td>Audio and video.
- <td>Ogg: "audio/main" or "video/main".
+ <td>Ogg: "audio/main" or "video/main"; WebM: the "FlagDefault" element is set.
- <tr>
- <td>"<dfn title="dom-TrackList-getKind-sign"><code>sign</code></dfn>"
+ <tr><td>"<dfn id=dom-tracklist-getkind-sign title=dom-TrackList-getKind-sign><code>sign</code></dfn>"
<td>A sign-language interpretation of an audio track.
<td>Video only.
<td>Ogg: "video/sign".
- <tr>
- <td>"<dfn title="dom-TrackList-getKind-translation"><code>translation</code></dfn>"
+ <tr><td>"<dfn id=dom-tracklist-getkind-translation title=dom-TrackList-getKind-translation><code>translation</code></dfn>"
<td>A translated version of the main track.
<td>Audio only.
<td>Ogg: "audio/dub".
- <tr>
- <td>"<dfn title="dom-TrackList-getKind-none"><code></code></dfn>" (empty string)
+ <tr><td>"<dfn id=dom-tracklist-getkind-none title=dom-TrackList-getKind-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.
<td>Audio and video.
<td>Any other track type or track role.
- </table>
+ </table><div class=impl>
- <div class="impl">
--->
-
<p>The <dfn id=dom-tracklist-getlabel title=dom-TrackList-getLabel><code>getLabel(<var title="">index</var>)</code></dfn> method must return the label of
the track with index <var title="">index</var>, if there is one and
it has a label. If there is no such track, then the method must
Modified: source
===================================================================
--- source 2011-04-26 19:31:42 UTC (rev 6031)
+++ source 2011-04-26 21:22:14 UTC (rev 6032)
@@ -31252,8 +31252,8 @@
<pre class="idl">interface <dfn>TrackList</dfn> {
readonly attribute unsigned long <span title="dom-TrackList-length">length</span>;
- DOMString <span title="dom-TrackList-getID">getID</span>(in unsigned long index);<!--
- DOMString <span title="dom-TrackList-getKind">getKind</span>(in unsigned long index);-->
+ DOMString <span title="dom-TrackList-getID">getID</span>(in unsigned long index);
+ DOMString <span title="dom-TrackList-getKind">getKind</span>(in unsigned long index);
DOMString <span title="dom-TrackList-getLabel">getLabel</span>(in unsigned long index);
DOMString <span title="dom-TrackList-getLanguage">getLanguage</span>(in unsigned long index);
@@ -31291,7 +31291,7 @@
href="#hrefMEDIAFRAG">[MEDIAFRAG]</a></p>
</dd>
-<!--
+
<dt><var title="">kind</var> = <var title="">tracks</var> . <code title="dom-TrackList-getKind">getKind</code>( <var title="">index</var> )</dt>
<dd>
@@ -31299,7 +31299,7 @@
<p>Returns the category the given track falls into. The <a href="#dom-TrackList-getKind-categories">possible track categories</a> are given below.</p>
</dd>
--->
+
<dt><var title="">label</var> = <var title="">tracks</var> . <code title="dom-TrackList-getLabel">getLabel</code>( <var title="">index</var> )</dt>
<dd>
@@ -31383,7 +31383,6 @@
if used as the name of a track in the track dimension of such a
fragment identifier. <a href="#refsMEDIAFRAG">[MEDIAFRAG]</a></p>
-<!--
<p>The <dfn title="dom-TrackList-getKind"><code>getKind(<var
title="">index</var>)</code></dfn> method must return the category
of the track with index <var title="">index</var>, if there is one.
@@ -31429,7 +31428,7 @@
<td>"<dfn title="dom-TrackList-getKind-main"><code>main</code></dfn>"
<td>The primary audio or video track.
<td>Audio and video.
- <td>Ogg: "audio/main" or "video/main".
+ <td>Ogg: "audio/main" or "video/main"; WebM: the "FlagDefault" element is set.
<tr>
<td>"<dfn title="dom-TrackList-getKind-sign"><code>sign</code></dfn>"
@@ -31452,7 +31451,6 @@
</table>
<div class="impl">
--->
<p>The <dfn title="dom-TrackList-getLabel"><code>getLabel(<var
title="">index</var>)</code></dfn> method must return the label of
More information about the Commit-Watchers
mailing list