hixie: video: Remove the cue range API. (whatwg r3639)

hixie: video: Remove the cue range API. (whatwg r3639)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.2824&r2=1.2825&f=h
http://html5.org/tools/web-apps-tracker?from=3638&to=3639

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.2824
retrieving revision 1.2825
diff -u -d -r1.2824 -r1.2825
--- Overview.html 16 Aug 2009 11:24:05 -0000 1.2824
+++ Overview.html 16 Aug 2009 11:42:10 -0000 1.2825
@@ -563,13 +563,12 @@
        <li><a href="#loading-the-media-resource"><span class="secno">4.8.10.5 </span>Loading the media resource</a></li>
        <li><a href="#offsets-into-the-media-resource"><span class="secno">4.8.10.6 </span>Offsets into the media resource</a></li>
        <li><a href="#the-ready-states"><span class="secno">4.8.10.7 </span>The ready states</a></li>
-       <li><a href="#cue-ranges"><span class="secno">4.8.10.8 </span>Cue ranges</a></li>
-       <li><a href="#playing-the-media-resource"><span class="secno">4.8.10.9 </span>Playing the media resource</a></li>
-       <li><a href="#seeking"><span class="secno">4.8.10.10 </span>Seeking</a></li>
-       <li><a href="#user-interface"><span class="secno">4.8.10.11 </span>User interface</a></li>
-       <li><a href="#time-ranges"><span class="secno">4.8.10.12 </span>Time ranges</a></li>
-       <li><a href="#mediaevents"><span class="secno">4.8.10.13 </span>Event summary</a></li>
-       <li><a href="#security-and-privacy-considerations"><span class="secno">4.8.10.14 </span>Security and privacy considerations</a></ol></li>
+       <li><a href="#playing-the-media-resource"><span class="secno">4.8.10.8 </span>Playing the media resource</a></li>
+       <li><a href="#seeking"><span class="secno">4.8.10.9 </span>Seeking</a></li>
+       <li><a href="#user-interface"><span class="secno">4.8.10.10 </span>User interface</a></li>
+       <li><a href="#time-ranges"><span class="secno">4.8.10.11 </span>Time ranges</a></li>
+       <li><a href="#mediaevents"><span class="secno">4.8.10.12 </span>Event summary</a></li>
+       <li><a href="#security-and-privacy-considerations"><span class="secno">4.8.10.13 </span>Security and privacy considerations</a></ol></li>
      <li><a href="#the-canvas-element"><span class="secno">4.8.11 </span>The <code>canvas</code> element</a>
       <ol>
        <li><a href="#the-2d-context"><span class="secno">4.8.11.1 </span>The 2D context</a>
@@ -17727,20 +17726,22 @@
   void <a href="#dom-media-play" title="dom-media-play">play</a>();
   void <a href="#dom-media-pause" title="dom-media-pause">pause</a>();
 
+<!--v2CUERANGE
   // cue ranges
-  void <a href="#dom-media-addcuerange" title="dom-media-addCueRange">addCueRange</a>(in DOMString className, in DOMString id, in float start, in float end, in boolean pauseOnExit, in <a href="#cuerangecallback">CueRangeCallback</a> enterCallback, in <a href="#cuerangecallback">CueRangeCallback</a> exitCallback);
-  void <a href="#dom-media-removecueranges" title="dom-media-removeCueRanges">removeCueRanges</a>(in DOMString className);
+  void <span title="dom-media-addCueRange">addCueRange</span>(in DOMString className, in DOMString id, in float start, in float end, in boolean pauseOnExit, in <span>CueRangeCallback</span> enterCallback, in <span>CueRangeCallback</span> exitCallback);
+  void <span title="dom-media-removeCueRanges">removeCueRanges</span>(in DOMString className);
+-->
 
   // controls
            attribute boolean <a href="#dom-media-controls" title="dom-media-controls">controls</a>;
            attribute float <a href="#dom-media-volume" title="dom-media-volume">volume</a>;
            attribute boolean <a href="#dom-media-muted" title="dom-media-muted">muted</a>;
-};
+};<!--v2CUERANGE
 
 [Callback=FunctionOnly, NoInterfaceObject]
-interface <dfn id="cuerangecallback">CueRangeCallback</dfn> {
+interface <dfn>CueRangeCallback</dfn> {
   void <span title="dom-CueRangeCallback-handleEvent">handleEvent</span>(in DOMString id);
-};</pre><p>The <dfn id="media-element-attributes">media element attributes</dfn>, <code title="attr-media-src"><a href="#attr-media-src">src</a></code>, <code title="attr-media-autobuffer"><a href="#attr-media-autobuffer">autobuffer</a></code>, <code title="attr-media-autoplay"><a href="#attr-media-autoplay">autoplay</a></code>, <code title="attr-media-loop"><a href="#attr-media-loop">loop</a></code>, and <code title="attr-media-controls"><a href="#attr-media-controls">controls</a></code>, apply to all <a href="#media-element" title="media element">media elements</a>. They are defined in
+};--></pre><p>The <dfn id="media-element-attributes">media element attributes</dfn>, <code title="attr-media-src"><a href="#attr-media-src">src</a></code>, <code title="attr-media-autobuffer"><a href="#attr-media-autobuffer">autobuffer</a></code>, <code title="attr-media-autoplay"><a href="#attr-media-autoplay">autoplay</a></code>, <code title="attr-media-loop"><a href="#attr-media-loop">loop</a></code>, and <code title="attr-media-controls"><a href="#attr-media-controls">controls</a></code>, apply to all <a href="#media-element" title="media element">media elements</a>. They are defined in
   this section.</p><!-- proposed v2 (actually v3!) features:
     * frame forward / backwards / step(n) while paused
     * hasAudio, hasVideo, hasCaptions, etc
@@ -19064,13 +19065,18 @@
   DOM attribute must <a href="#reflect">reflect</a> the content attribute of the
   same name.</p>
 
-  </div><h5 id="cue-ranges"><span class="secno">4.8.10.8 </span>Cue ranges</h5><dl class="domintro"><dt><var title="">media</var> . <code title="dom-media-addCueRange"><a href="#dom-media-addcuerange">addCueRange</a></code>(<var title="">className</var>, <var title="">id</var>, <var title="">start</var>, <var title="">end</var>, <var title="">pauseOnExit</var>, <var title="">enterCallback</var>, <var title="">exitCallback</var>)</dt>
+  </div><!--v2CUERANGE
+  <h5>Cue ranges</h5>
+
+  <dl class="domintro">
+
+   <dt><var title="">media</var> . <code title="dom-media-addCueRange">addCueRange</code>(<var title="">className</var>, <var title="">id</var>, <var title="">start</var>, <var title="">end</var>, <var title="">pauseOnExit</var>, <var title="">enterCallback</var>, <var title="">exitCallback</var>)</dt>
 
    <dd>
 
     <p>Registers a range of time, given in seconds, and a pair of
     callbacks, the first of which will be invoked when the
-    <a href="#current-playback-position">current playback position</a> enters the range, and the
+    <span>current playback position</span> enters the range, and the
     second of which will be invoked when it exits the range. The
     callbacks are invoked with the given ID as their argument.</p>
 
@@ -19089,54 +19095,72 @@
 
    </dd>
 
-  </dl><div class="impl">
+  </dl>
 
-  <p><a href="#media-element" title="media element">Media elements</a> have a set of
-  <dfn id="cue-range" title="cue range">cue ranges</dfn>. Each cue range is made up
+  <div class="impl">
+
+  <p><span title="media element">Media elements</span> have a set of
+  <dfn title="cue range">cue ranges</dfn>. Each cue range is made up
   of the following information:</p>
 
-  <dl><dt>A class name</dt>
+  <dl>
+
+   <dt>A class name</dt>
    <dd>A group of related ranges can be given the same class name so
    that they can all be removed at the same time.</dd>
 
    <dt>An identifier<dt>
-   </dt><dd>A string can be assigned to each cue range for identification
+   <dd>A string can be assigned to each cue range for identification
    by script. The string need not be unique and can contain any
    value.</dd>
 
    <dt>A start time</dt>
    <dt>An end time</dt>
    <dd>The actual time range, using the same timeline as the
-   <a href="#media-resource">media resource</a> itself.</dd>
+   <span>media resource</span> itself.</dd>
 
    <dt>A "pause" boolean</dt>
    <dd>A flag indicating whether to pause playback on exit.</dd>
 
    <dt>An "enter" callback</dt>
-   <dd>A callback that is called when the <a href="#current-playback-position">current playback
-   position</a> enters the range.</dd>
+   <dd>A callback that is called when the <span>current playback
+   position</span> enters the range.</dd>
 
    <dt>An "exit" callback</dt>
-   <dd>A callback that is called when the <a href="#current-playback-position">current playback
-   position</a> exits the range.</dd>
+   <dd>A callback that is called when the <span>current playback
+   position</span> exits the range.</dd>
 
    <dt>An "active" boolean</dt>
    <dd>A flag indicating whether the range is active or not.</dd>
 
-  </dl><p>The <dfn id="dom-media-addcuerange" title="dom-media-addCueRange"><code>addCueRange(<var title="">className</var>, <var title="">id</var>, <var title="">start</var>, <var title="">end</var>, <var title="">pauseOnExit</var>, <var title="">enterCallback</var>, <var title="">exitCallback</var>)</code></dfn> method must, when called,
-  add a <a href="#cue-range">cue range</a> to the <a href="#media-element">media element</a>, that
+  </dl>
+
+  <p>The <dfn title="dom-media-addCueRange"><code>addCueRange(<var
+  title="">className</var>, <var title="">id</var>, <var
+  title="">start</var>, <var title="">end</var>, <var
+  title="">pauseOnExit</var>, <var title="">enterCallback</var>, <var
+  title="">exitCallback</var>)</code></dfn> method must, when called,
+  add a <span>cue range</span> to the <span>media element</span>, that
   cue range having the class name <var title="">className</var>, the
-  identifier <var title="">id</var>, the start time <var title="">start</var> (in seconds), the end time <var title="">end</var> (in seconds), the "pause" boolean with the same
-  value as <var title="">pauseOnExit</var>, the "enter" callback <var title="">enterCallback</var>, the "exit" callback <var title="">exitCallback</var>, and an "active" boolean that is true if
-  the <a href="#current-playback-position">current playback position</a> is equal to or greater
+  identifier <var title="">id</var>, the start time <var
+  title="">start</var> (in seconds), the end time <var
+  title="">end</var> (in seconds), the "pause" boolean with the same
+  value as <var title="">pauseOnExit</var>, the "enter" callback <var
+  title="">enterCallback</var>, the "exit" callback <var
+  title="">exitCallback</var>, and an "active" boolean that is true if
+  the <span>current playback position</span> is equal to or greater
   than the start time and less than the end time, and false
   otherwise.</p>
 
-  <p>The <dfn id="dom-media-removecueranges" title="dom-media-removeCueRanges"><code>removeCueRanges(<var title="">className</var>)</code></dfn> method must, when called,
-  remove all the <a href="#cue-range" title="cue range">cue ranges</a> of the
-  <a href="#media-element">media element</a> which have the class name <var title="">className</var>.</p>
+  <p>The <dfn
+  title="dom-media-removeCueRanges"><code>removeCueRanges(<var
+  title="">className</var>)</code></dfn> method must, when called,
+  remove all the <span title="cue range">cue ranges</span> of the
+  <span>media element</span> which have the class name <var
+  title="">className</var>.</p>
 
-  </div><h5 id="playing-the-media-resource"><span class="secno">4.8.10.9 </span>Playing the media resource</h5><dl class="domintro"><dt><var title="">media</var> . <code title="dom-media-paused"><a href="#dom-media-paused">paused</a></code></dt>
+  </div>
+--><h5 id="playing-the-media-resource"><span class="secno">4.8.10.8 </span>Playing the media resource</h5><dl class="domintro"><dt><var title="">media</var> . <code title="dom-media-paused"><a href="#dom-media-paused">paused</a></code></dt>
 
    <dd>
 
@@ -19481,21 +19505,22 @@
   certain ranges to be skipped over as the user agent rushes ahead to
   "catch up".)</p>
 
-  <ol><li><p>Let <var title="">current ranges</var> be an ordered list of
-   <a href="#cue-range" title="cue range">cue ranges</a>, initialized to contain
-   all the <a href="#cue-range" title="cue range">cue ranges</a> of the
-   <a href="#media-element">media element</a> whose start times are less than or equal
-   to the <a href="#current-playback-position">current playback position</a> and whose end times
-   are greater than the <a href="#current-playback-position">current playback position</a>, in the
-   order they were added to the element.</li>
+  <ol><!--v2CUERANGE
+   <li><p>Let <var title="">current ranges</var> be an ordered list of
+   <span title="cue range">cue ranges</span>, initialized to contain
+   all the <span title="cue range">cue ranges</span> of the
+   <span>media element</span> whose start times are less than or equal
+   to the <span>current playback position</span> and whose end times
+   are greater than the <span>current playback position</span>, in the
+   order they were added to the element.</p></li>
 
    <li><p>Let <var title="">other ranges</var> be an ordered list of
-   <a href="#cue-range" title="cue range">cue ranges</a>, initialized to contain
-   all the <a href="#cue-range" title="cue range">cue ranges</a> of the
-   <a href="#media-element">media element</a> that are not present in <var title="">current ranges</var>, in the order they were added to the
-   element.</li>
-
-   <li><p>If the time was reached through the usual monotonic increase
+   <span title="cue range">cue ranges</span>, initialized to contain
+   all the <span title="cue range">cue ranges</span> of the
+   <span>media element</span> that are not present in <var
+   title="">current ranges</var>, in the order they were added to the
+   element.</p></li>
+--><li><p>If the time was reached through the usual monotonic increase
    of the current playback position during normal playback, and if the
    user agent has not fired a <code title="event-timeupdate"><a href="#event-timeupdate">timeupdate</a></code> event at the element in
    the past 15 to 250ms, then the user agent must <a href="#queue-a-task">queue a
@@ -19510,44 +19535,47 @@
    cost of processing the event each time, so that the UI updates are
    not any more frequent than the user agent can comfortably handle
    while decoding the video.</li>
-
-   <li><p>If none of the <a href="#cue-range" title="cue range">cue ranges</a> in
+<!--v2CUERANGE [beware - - nested comments]
+   <li><p>If none of the <span title="cue range">cue ranges</span> in
    <var title="">current ranges</var> have their "active" boolean set
-   to "false" (inactive) and none of the <a href="#cue-range" title="cue range">cue
-   ranges</a> in <var title="">other ranges</var> have their
+   to "false" (inactive) and none of the <span title="cue range">cue
+   ranges</span> in <var title="">other ranges</var> have their
    "active" boolean set to "true" (active), then abort these
-   steps.</li>
+   steps.</p></li>
 
    <li><p>If the time was reached through the usual monotonic increase
    of the current playback position during normal playback, and there
-   are <a href="#cue-range" title="cue range">cue ranges</a> in <var title="">other ranges</var> that have both their "active" boolean
+   are <span title="cue range">cue ranges</span> in <var
+   title="">other ranges</var> that have both their "active" boolean
    and their "pause" boolean set to "true", then immediately act as if
-   the element's <code title="dom-media-pause"><a href="#dom-media-pause">pause()</a></code> method
-   had been invoked. <!-- pause() can in theory call load(), but never
+   the element's <code title="dom-media-pause">pause()</code> method
+   had been invoked. <!- - pause() can in theory call load(), but never
    can it do so as part of this invokation, since we wouldn't be in
    this algorithm if the media element was empty. So, no need to couch
-   all this in a task. --> (In the other cases, such as explicit
+   all this in a task. - -> (In the other cases, such as explicit
    seeks, playback is not paused by exiting a cue range, even if that
-   cue range has its "pause" boolean set to "true".)</li>
+   cue range has its "pause" boolean set to "true".)</p></li>
 
-   <li><p>For each non-null "exit" callback of the <a href="#cue-range" title="cue range">cue ranges</a> in <var title="">other
+   <li><p>For each non-null "exit" callback of the <span
+   title="cue range">cue ranges</span> in <var title="">other
    ranges</var> that have their "active" boolean set to "true"
-   (active), in list order, <a href="#queue-a-task">queue a task</a> that invokes the
+   (active), in list order, <span>queue a task</span> that invokes the
    callback, passing the cue range's identifier as the callback's only
-   argument.</li>
+   argument.</p></li>
 
-   <li><p>For each non-null "enter" callback of the <a href="#cue-range" title="cue
-   range">cue ranges</a> in <var title="">current ranges</var> that
+   <li><p>For each non-null "enter" callback of the <span title="cue
+   range">cue ranges</span> in <var title="">current ranges</var> that
    have their "active" boolean set to "false" (inactive), in list
-   order, <a href="#queue-a-task">queue a task</a> that invokes the callback, passing
+   order, <span>queue a task</span> that invokes the callback, passing
    the cue range's identifier as the callback's only
-   argument.</li>
-
-   <li><p>Set the "active" boolean of all the <a href="#cue-range" title="cue
-   range">cue ranges</a> in the <var title="">current ranges</var>
-   list to "true" (active), and the "active" boolean of all the <a href="#cue-range" title="cue range">cue ranges</a> in the <var title="">other
-   ranges</var> list to "false" (inactive).</li>
+   argument.</p></li>
 
+   <li><p>Set the "active" boolean of all the <span title="cue
+   range">cue ranges</span> in the <var title="">current ranges</var>
+   list to "true" (active), and the "active" boolean of all the <span
+   title="cue range">cue ranges</span> in the <var title="">other
+   ranges</var> list to "false" (inactive).</p></li>
+-->
   </ol><p>When a <a href="#media-element">media element</a> is <a href="#remove-an-element-from-a-document" title="remove an
   element from a document">removed from a
   <code>Document</code></a>, if the <a href="#media-element">media element</a>'s
@@ -19560,7 +19588,7 @@
   document, then the playback will <a href="#media-playback">stop</a>
   until the document is active again.</p>
 
-  </div><h5 id="seeking"><span class="secno">4.8.10.10 </span>Seeking</h5><dl class="domintro"><dt><var title="">media</var> . <code title="dom-media-seeking"><a href="#dom-media-seeking">seeking</a></code></dt>
+  </div><h5 id="seeking"><span class="secno">4.8.10.9 </span>Seeking</h5><dl class="domintro"><dt><var title="">media</var> . <code title="dom-media-seeking"><a href="#dom-media-seeking">seeking</a></code></dt>
 
    <dd>
 
@@ -19671,7 +19699,7 @@
   <a href="#current-playback-position">current playback position</a> changes in a discontinuous
   fashion (so that the relevant events fire).</p>
 
-  </div><h5 id="user-interface"><span class="secno">4.8.10.11 </span>User interface</h5><p>The <dfn id="attr-media-controls" title="attr-media-controls"><code>controls</code></dfn>
+  </div><h5 id="user-interface"><span class="secno">4.8.10.10 </span>User interface</h5><p>The <dfn id="attr-media-controls" title="attr-media-controls"><code>controls</code></dfn>
   attribute is a <a href="#boolean-attribute">boolean attribute</a>. If present, it
   indicates that the author has not provided a scripted controller and
   would like the user agent to provide its own set of controls.<div class="impl">
@@ -19767,7 +19795,7 @@
   event</a> called <code title="event-volumechange"><a href="#event-volumechange">volumechange</a></code> at the <a href="#media-element">media
   element</a>.</p>
 
-  </div><h5 id="time-ranges"><span class="secno">4.8.10.12 </span>Time ranges</h5><p>Objects implementing the <code><a href="#timeranges">TimeRanges</a></code> interface
+  </div><h5 id="time-ranges"><span class="secno">4.8.10.11 </span>Time ranges</h5><p>Objects implementing the <code><a href="#timeranges">TimeRanges</a></code> interface
   represent a list of ranges (periods) of time.<pre class="idl">interface <dfn id="timeranges">TimeRanges</dfn> {
   readonly attribute unsigned long <a href="#dom-timeranges-length" title="dom-TimeRanges-length">length</a>;
   float <a href="#dom-timeranges-start" title="dom-TimeRanges-start">start</a>(in unsigned long index);
@@ -19836,7 +19864,7 @@
   <p>The timelines used by the objects returned by the <code title="dom-media-buffered"><a href="#dom-media-buffered">buffered</a></code>, <code title="dom-media-seekable"><a href="#dom-media-seekable">seekable</a></code> and <code title="dom-media-played"><a href="#dom-media-played">played</a></code> DOM attributes of <a href="#media-element" title="media element">media elements</a> must be the same as that
   element's <a href="#media-resource">media resource</a>'s timeline.</p>
 
-  </div><h5 id="mediaevents"><span class="secno">4.8.10.13 </span>Event summary</h5><p>The following events fire on <a href="#media-element" title="media element">media
+  </div><h5 id="mediaevents"><span class="secno">4.8.10.12 </span>Event summary</h5><p>The following events fire on <a href="#media-element" title="media element">media
   elements</a> as part of the processing model described above:<table><thead><tr><th>Event name
      <th>Interface
      <th>Dispatched when...
@@ -19942,7 +19970,7 @@
      <td>
   </table><div class="impl">
 
-  <h5 id="security-and-privacy-considerations"><span class="secno">4.8.10.14 </span>Security and privacy considerations</h5>
+  <h5 id="security-and-privacy-considerations"><span class="secno">4.8.10.13 </span>Security and privacy considerations</h5>
 
   <p>The main security and privacy implications of the
   <code><a href="#video">video</a></code> and <code><a href="#audio">audio</a></code> elements come from the

Received on Sunday, 16 August 2009 11:43:10 UTC