[html5] r5145 - [giow] (0) Captions - Stage 20.7: the last of the API.

whatwg at whatwg.org whatwg at whatwg.org
Thu Jul 8 17:24:04 PDT 2010


Author: ianh
Date: 2010-07-08 17:24:02 -0700 (Thu, 08 Jul 2010)
New Revision: 5145

Modified:
   complete.html
   index
   source
Log:
[giow] (0) Captions - Stage 20.7: the last of the API.

Modified: complete.html
===================================================================
--- complete.html	2010-07-08 22:03:19 UTC (rev 5144)
+++ complete.html	2010-07-09 00:24:02 UTC (rev 5145)
@@ -209,7 +209,7 @@
 
   <header class=head id=head><p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG src=/images/logo></a></p>
    <hgroup><h1>Web Applications 1.0</h1>
-    <h2 class="no-num no-toc">Draft Standard — 8 July 2010</h2>
+    <h2 class="no-num no-toc">Draft Standard — 9 July 2010</h2>
    </hgroup><p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
    <p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
    <!--<p class="impl"><strong>Implementors!</strong> We have a <a href="http://www.whatwg.org/mailing-list#implementors">mailing list</a> for you too!</p>-->
@@ -27362,9 +27362,34 @@
   <p>The <dfn id=dom-timedtrackcue-lineposition title=dom-TimedTrackCue-linePosition><code>linePosition</code></dfn>
   attribute must return the <a href=#timed-track-cue-line-position>timed track cue line position</a>
   of the <a href=#timed-track-cue>timed track cue</a> that the
-  <code><a href=#timedtrackcue>TimedTrackCue</a></code> object represents. <span class=XXX>...auto case...</span></p>
+  <code><a href=#timedtrackcue>TimedTrackCue</a></code> object represents, if that value is
+  numeric. Otherwise, the value is the special value <a href=#timed-track-cue-automatic-line-position title="timed track cue automatic line position">auto</a>; if the
+  <a href=#timed-track-cue-snap-to-lines-flag>timed track cue snap-to-lines flag</a> of the <a href=#timed-track-cue>timed
+  track cue</a> that the <code><a href=#timedtrackcue>TimedTrackCue</a></code> object
+  represents is not set, the attribute must return the value 100;
+  otherwise, it must return the value returned by the following
+  algorithm:</p>
 
-  <p>The <dfn id=dom-timedtrackcue-textposition title=dom-TimedTrackCue-textPosition><code>textPosition</code></dfn>
+  <ol><li><p>Let <var title="">cue</var> be the <a href=#timed-track-cue>timed track
+   cue</a> that the <code><a href=#timedtrackcue>TimedTrackCue</a></code> object
+   represents.</li>
+
+   <li><p>If <var title="">cue</var> is not associated with a
+   <a href=#timed-track>timed track</a>, return −1 and abort these
+   steps.</li>
+
+   <li><p>Let <var title="">track</var> be the <a href=#timed-track>timed
+   track</a> that the <var title="">cue</var> is associated
+   with.</li>
+
+   <li><p>Let <var title="">n</var> be the number of <a href=#timed-track title="timed track">timed tracks</a> whose <a href=#timed-track-mode>timed track
+   mode</a> is <a href=#timed-track-showing title="timed track showing">showing</a> and
+   that are in the <a href=#media-element>media element</a>'s <a href=#list-of-timed-tracks>list of timed
+   tracks</a> before <var title="">track</var>.</li>
+
+   <li><p>Return <var title="">n</var>.</li>
+
+  </ol><p>The <dfn id=dom-timedtrackcue-textposition title=dom-TimedTrackCue-textPosition><code>textPosition</code></dfn>
   attribute must return the <a href=#timed-track-cue-text-position>timed track cue text position</a>
   of the <a href=#timed-track-cue>timed track cue</a> that the
   <code><a href=#timedtrackcue>TimedTrackCue</a></code> object represents.</p>
@@ -27384,11 +27409,16 @@
   identifier</a> of the <a href=#timed-track-cue>timed track cue</a> that the
   <code><a href=#timedtrackcue>TimedTrackCue</a></code> object represents.</p>
 
-  <p class=XXX>The <dfn id=dom-timedtrackcue-getcueassource() title=dom-TimedTrackCue-getCueAsSource()><code>getCueAsSource()</code></dfn>
-  method must...</p>
+  <p>The <dfn id=dom-timedtrackcue-getcueassource() title=dom-TimedTrackCue-getCueAsSource()><code>getCueAsSource()</code></dfn>
+  method must return the raw <a href=#timed-track-cue-text>timed track cue text</a>.</p>
 
-  <p class=XXX>The <dfn id=dom-timedtrackcue-getcueashtml() title=dom-TimedTrackCue-getCueAsHTML()><code>getCueAsHTML()</code></dfn>
-  method must...</p>
+  <p>The <dfn id=dom-timedtrackcue-getcueashtml() title=dom-TimedTrackCue-getCueAsHTML()><code>getCueAsHTML()</code></dfn>
+  method must convert the <a href=#timed-track-cue-text>timed track cue text</a> to a
+  <code><a href=#documentfragment>DocumentFragment</a></code> for the <a href=#media-element>media element</a>'s
+  <code><a href=#document>Document</a></code>, using the appropriate rules for doing
+  so. (For example, for <a href=#websrt>WebSRT</a>, those rules are the
+  <a href=#websrt-cue-text-parsing-rules>WebSRT cue text parsing rules</a> and the <a href=#websrt-cue-text-dom-construction-rules>WebSRT cue
+  text DOM construction rules</a>.)</p>
 
   </div>
 

Modified: index
===================================================================
--- index	2010-07-08 22:03:19 UTC (rev 5144)
+++ index	2010-07-09 00:24:02 UTC (rev 5145)
@@ -213,7 +213,7 @@
 
   <header class=head id=head><p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG src=/images/logo></a></p>
    <hgroup><h1>HTML5 (including next generation additions still in development)</h1>
-    <h2 class="no-num no-toc">Draft Standard — 8 July 2010</h2>
+    <h2 class="no-num no-toc">Draft Standard — 9 July 2010</h2>
    </hgroup><p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
    <p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
    <!--<p class="impl"><strong>Implementors!</strong> We have a <a href="http://www.whatwg.org/mailing-list#implementors">mailing list</a> for you too!</p>-->
@@ -27289,9 +27289,34 @@
   <p>The <dfn id=dom-timedtrackcue-lineposition title=dom-TimedTrackCue-linePosition><code>linePosition</code></dfn>
   attribute must return the <a href=#timed-track-cue-line-position>timed track cue line position</a>
   of the <a href=#timed-track-cue>timed track cue</a> that the
-  <code><a href=#timedtrackcue>TimedTrackCue</a></code> object represents. <span class=XXX>...auto case...</span></p>
+  <code><a href=#timedtrackcue>TimedTrackCue</a></code> object represents, if that value is
+  numeric. Otherwise, the value is the special value <a href=#timed-track-cue-automatic-line-position title="timed track cue automatic line position">auto</a>; if the
+  <a href=#timed-track-cue-snap-to-lines-flag>timed track cue snap-to-lines flag</a> of the <a href=#timed-track-cue>timed
+  track cue</a> that the <code><a href=#timedtrackcue>TimedTrackCue</a></code> object
+  represents is not set, the attribute must return the value 100;
+  otherwise, it must return the value returned by the following
+  algorithm:</p>
 
-  <p>The <dfn id=dom-timedtrackcue-textposition title=dom-TimedTrackCue-textPosition><code>textPosition</code></dfn>
+  <ol><li><p>Let <var title="">cue</var> be the <a href=#timed-track-cue>timed track
+   cue</a> that the <code><a href=#timedtrackcue>TimedTrackCue</a></code> object
+   represents.</li>
+
+   <li><p>If <var title="">cue</var> is not associated with a
+   <a href=#timed-track>timed track</a>, return −1 and abort these
+   steps.</li>
+
+   <li><p>Let <var title="">track</var> be the <a href=#timed-track>timed
+   track</a> that the <var title="">cue</var> is associated
+   with.</li>
+
+   <li><p>Let <var title="">n</var> be the number of <a href=#timed-track title="timed track">timed tracks</a> whose <a href=#timed-track-mode>timed track
+   mode</a> is <a href=#timed-track-showing title="timed track showing">showing</a> and
+   that are in the <a href=#media-element>media element</a>'s <a href=#list-of-timed-tracks>list of timed
+   tracks</a> before <var title="">track</var>.</li>
+
+   <li><p>Return <var title="">n</var>.</li>
+
+  </ol><p>The <dfn id=dom-timedtrackcue-textposition title=dom-TimedTrackCue-textPosition><code>textPosition</code></dfn>
   attribute must return the <a href=#timed-track-cue-text-position>timed track cue text position</a>
   of the <a href=#timed-track-cue>timed track cue</a> that the
   <code><a href=#timedtrackcue>TimedTrackCue</a></code> object represents.</p>
@@ -27311,11 +27336,16 @@
   identifier</a> of the <a href=#timed-track-cue>timed track cue</a> that the
   <code><a href=#timedtrackcue>TimedTrackCue</a></code> object represents.</p>
 
-  <p class=XXX>The <dfn id=dom-timedtrackcue-getcueassource() title=dom-TimedTrackCue-getCueAsSource()><code>getCueAsSource()</code></dfn>
-  method must...</p>
+  <p>The <dfn id=dom-timedtrackcue-getcueassource() title=dom-TimedTrackCue-getCueAsSource()><code>getCueAsSource()</code></dfn>
+  method must return the raw <a href=#timed-track-cue-text>timed track cue text</a>.</p>
 
-  <p class=XXX>The <dfn id=dom-timedtrackcue-getcueashtml() title=dom-TimedTrackCue-getCueAsHTML()><code>getCueAsHTML()</code></dfn>
-  method must...</p>
+  <p>The <dfn id=dom-timedtrackcue-getcueashtml() title=dom-TimedTrackCue-getCueAsHTML()><code>getCueAsHTML()</code></dfn>
+  method must convert the <a href=#timed-track-cue-text>timed track cue text</a> to a
+  <code><a href=#documentfragment>DocumentFragment</a></code> for the <a href=#media-element>media element</a>'s
+  <code><a href=#document>Document</a></code>, using the appropriate rules for doing
+  so. (For example, for <a href=#websrt>WebSRT</a>, those rules are the
+  <a href=#websrt-cue-text-parsing-rules>WebSRT cue text parsing rules</a> and the <a href=#websrt-cue-text-dom-construction-rules>WebSRT cue
+  text DOM construction rules</a>.)</p>
 
   </div>
 

Modified: source
===================================================================
--- source	2010-07-08 22:03:19 UTC (rev 5144)
+++ source	2010-07-09 00:24:02 UTC (rev 5145)
@@ -29676,9 +29676,39 @@
   title="dom-TimedTrackCue-linePosition"><code>linePosition</code></dfn>
   attribute must return the <span>timed track cue line position</span>
   of the <span>timed track cue</span> that the
-  <code>TimedTrackCue</code> object represents. <span
-  class="XXX">...auto case...</span></p>
+  <code>TimedTrackCue</code> object represents, if that value is
+  numeric. Otherwise, the value is the special value <span
+  title="timed track cue automatic line position">auto</span>; if the
+  <span>timed track cue snap-to-lines flag</span> of the <span>timed
+  track cue</span> that the <code>TimedTrackCue</code> object
+  represents is not set, the attribute must return the value 100;
+  otherwise, it must return the value returned by the following
+  algorithm:</p>
 
+  <ol>
+
+   <li><p>Let <var title="">cue</var> be the <span>timed track
+   cue</span> that the <code>TimedTrackCue</code> object
+   represents.</p></li>
+
+   <li><p>If <var title="">cue</var> is not associated with a
+   <span>timed track</span>, return &#x2212;1 and abort these
+   steps.</p></li>
+
+   <li><p>Let <var title="">track</var> be the <span>timed
+   track</span> that the <var title="">cue</var> is associated
+   with.</p></li>
+
+   <li><p>Let <var title="">n</var> be the number of <span
+   title="timed track">timed tracks</span> whose <span>timed track
+   mode</span> is <span title="timed track showing">showing</span> and
+   that are in the <span>media element</span>'s <span>list of timed
+   tracks</span> before <var title="">track</var>.</p></li>
+
+   <li><p>Return <var title="">n</var>.</p></li>
+
+  </ol>
+
   <p>The <dfn
   title="dom-TimedTrackCue-textPosition"><code>textPosition</code></dfn>
   attribute must return the <span>timed track cue text position</span>
@@ -29701,13 +29731,18 @@
   identifier</span> of the <span>timed track cue</span> that the
   <code>TimedTrackCue</code> object represents.</p>
 
-  <p class="XXX">The <dfn
+  <p>The <dfn
   title="dom-TimedTrackCue-getCueAsSource()"><code>getCueAsSource()</code></dfn>
-  method must...</p>
+  method must return the raw <span>timed track cue text</span>.</p>
 
-  <p class="XXX">The <dfn
+  <p>The <dfn
   title="dom-TimedTrackCue-getCueAsHTML()"><code>getCueAsHTML()</code></dfn>
-  method must...</p>
+  method must convert the <span>timed track cue text</span> to a
+  <code>DocumentFragment</code> for the <span>media element</span>'s
+  <code>Document</code>, using the appropriate rules for doing
+  so. (For example, for <span>WebSRT</span>, those rules are the
+  <span>WebSRT cue text parsing rules</span> and the <span>WebSRT cue
+  text DOM construction rules</span>.)</p>
 
   </div>
 




More information about the Commit-Watchers mailing list