[html5] r7835 - [giow] (3) Make adding a cue, or changing its timings, work when the video is pa [...]

whatwg at whatwg.org whatwg at whatwg.org
Mon Apr 15 11:15:36 PDT 2013


Author: ianh
Date: 2013-04-15 11:15:34 -0700 (Mon, 15 Apr 2013)
New Revision: 7835

Modified:
   complete.html
   index
   source
Log:
[giow] (3) Make adding a cue, or changing its timings, work when the video is paused.
Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=16920
Affected topics: HTML, Video Text Tracks, Video and Audio

Modified: complete.html
===================================================================
--- complete.html	2013-04-14 23:15:22 UTC (rev 7834)
+++ complete.html	2013-04-15 18:15:34 UTC (rev 7835)
@@ -248,7 +248,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 14 April 2013</h2>
+    <h2 class="no-num no-toc">Living Standard — Last Updated 15 April 2013</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>
@@ -28959,13 +28959,15 @@
   <a href=#media-element>media element</a>'s <a href=#list-of-newly-introduced-cues>list of newly introduced cues</a>.</p>
 
   <p>When the <a href=#current-playback-position>current playback position</a> of a <a href=#media-element>media element</a> changes (e.g.
-  due to playback or seeking), the user agent must run the following steps. If the <a href=#current-playback-position>current
-  playback position</a> changes while the steps are running, then the user agent must wait for
-  the steps to complete, and then must immediately rerun the steps. (These steps are thus run as
-  often as possible or needed — if one iteration takes a long time, this can cause certain
-  <a href=#text-track-cue title="text track cue">cues</a> to be skipped over as the user agent rushes ahead to
-  "catch up".) </p>
+  due to playback or seeking), the user agent must run the <i><a href=#time-marches-on>time marches on</a></i> steps. If the
+  <a href=#current-playback-position>current playback position</a> changes while the steps are running, then the user agent
+  must wait for the steps to complete, and then must immediately rerun the steps. (These steps are
+  thus run as often as possible or needed — if one iteration takes a long time, this can cause
+  certain <a href=#text-track-cue title="text track cue">cues</a> to be skipped over as the user agent rushes ahead
+  to "catch up".)</p>
 
+  <p>The <dfn id=time-marches-on><i>time marches on</i></dfn> steps are as follows:</p>
+
   <ol><li><p>Let <var title="">current cues</var> be a list of <a href=#text-track-cue title="text track
    cue">cues</a>, initialized to contain all the <a href=#text-track-cue title="text track cue">cues</a> of all
    the <a href=#text-track-hidden title="text track hidden">hidden</a> or <a href=#text-track-showing title="text track
@@ -31426,8 +31428,6 @@
 
   <ol><li>
 
-   <li>
-
     <p>Create a new <code><a href=#texttrack>TextTrack</a></code> object.</p>
 
    </li>
@@ -31569,6 +31569,10 @@
    <li><p>Add <var title="">cue</var> to the method's <code><a href=#texttrack>TextTrack</a></code> object's <a href=#text-track>text
    track</a>'s <a href=#text-track-list-of-cues>text track list of cues</a>.</li>
 
+   <li><p>If the <code>TextTrack object's <a href=#text-track>text track</a> is in a <a href=#media-element>media
+   element</a>'s <a href=#list-of-text-tracks>list of text tracks</a>, run the <i><a href=#time-marches-on>time marches on</a></i> steps for that
+   <a href=#media-element>media element</a>.</code></li>
+
   </ol><p>The <dfn id=dom-texttrack-removecue title=dom-TextTrack-removeCue><code>removeCue(<var title="">cue</var>)</code></dfn>
   method of <code><a href=#texttrack>TextTrack</a></code> objects, when invoked, must run the following steps:</p>
 
@@ -31723,12 +31727,20 @@
   <p>The <dfn id=dom-texttrackcue-starttime title=dom-TextTrackCue-startTime><code>startTime</code></dfn> attribute, on getting,
   must return the <a href=#text-track-cue-start-time>text track cue start time</a> of the <a href=#text-track-cue>text track cue</a> that the
   <code><a href=#texttrackcue>TextTrackCue</a></code> object represents, in seconds. On setting, the <a href=#text-track-cue-start-time>text track cue
-  start time</a> must be set to the new value, interpreted in seconds.</p>
+  start time</a> must be set to the new value, interpreted in seconds; then, if the
+  <code><a href=#texttrackcue>TextTrackCue</a></code> object's <a href=#text-track-cue>text track cue</a> is in a <a href=#text-track>text track</a>'s
+  <a href=#text-track-list-of-cues title="text track list of cues">list of cues</a>, and that <a href=#text-track>text track</a> is in
+  a <a href=#media-element>media element</a>'s <a href=#list-of-text-tracks>list of text tracks</a>, then run the <i><a href=#time-marches-on>time marches
+  on</a></i> steps for that <a href=#media-element>media element</a>.</p>
 
   <p>The <dfn id=dom-texttrackcue-endtime title=dom-TextTrackCue-endTime><code>endTime</code></dfn> attribute, on getting,
   must return the <a href=#text-track-cue-end-time>text track cue end time</a> of the <a href=#text-track-cue>text track cue</a> that the
   <code><a href=#texttrackcue>TextTrackCue</a></code> object represents, in seconds. On setting, the <a href=#text-track-cue-end-time>text track cue end
-  time</a> must be set to the new value, interpreted in seconds.</p>
+  time</a> must be set to the new value, interpreted in seconds; then, if the
+  <code><a href=#texttrackcue>TextTrackCue</a></code> object's <a href=#text-track-cue>text track cue</a> is in a <a href=#text-track>text track</a>'s
+  <a href=#text-track-list-of-cues title="text track list of cues">list of cues</a>, and that <a href=#text-track>text track</a> is in
+  a <a href=#media-element>media element</a>'s <a href=#list-of-text-tracks>list of text tracks</a>, then run the <i><a href=#time-marches-on>time marches
+  on</a></i> steps for that <a href=#media-element>media element</a>.</p>
 
   <p>The <dfn id=dom-texttrackcue-pauseonexit title=dom-TextTrackCue-pauseOnExit><code>pauseOnExit</code></dfn> attribute, on
   getting, must return true if the <a href=#text-track-cue-pause-on-exit-flag>text track cue pause-on-exit flag</a> of the <a href=#text-track-cue>text

Modified: index
===================================================================
--- index	2013-04-14 23:15:22 UTC (rev 7834)
+++ index	2013-04-15 18:15:34 UTC (rev 7835)
@@ -248,7 +248,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 14 April 2013</h2>
+    <h2 class="no-num no-toc">Living Standard — Last Updated 15 April 2013</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>
@@ -28959,13 +28959,15 @@
   <a href=#media-element>media element</a>'s <a href=#list-of-newly-introduced-cues>list of newly introduced cues</a>.</p>
 
   <p>When the <a href=#current-playback-position>current playback position</a> of a <a href=#media-element>media element</a> changes (e.g.
-  due to playback or seeking), the user agent must run the following steps. If the <a href=#current-playback-position>current
-  playback position</a> changes while the steps are running, then the user agent must wait for
-  the steps to complete, and then must immediately rerun the steps. (These steps are thus run as
-  often as possible or needed — if one iteration takes a long time, this can cause certain
-  <a href=#text-track-cue title="text track cue">cues</a> to be skipped over as the user agent rushes ahead to
-  "catch up".) </p>
+  due to playback or seeking), the user agent must run the <i><a href=#time-marches-on>time marches on</a></i> steps. If the
+  <a href=#current-playback-position>current playback position</a> changes while the steps are running, then the user agent
+  must wait for the steps to complete, and then must immediately rerun the steps. (These steps are
+  thus run as often as possible or needed — if one iteration takes a long time, this can cause
+  certain <a href=#text-track-cue title="text track cue">cues</a> to be skipped over as the user agent rushes ahead
+  to "catch up".)</p>
 
+  <p>The <dfn id=time-marches-on><i>time marches on</i></dfn> steps are as follows:</p>
+
   <ol><li><p>Let <var title="">current cues</var> be a list of <a href=#text-track-cue title="text track
    cue">cues</a>, initialized to contain all the <a href=#text-track-cue title="text track cue">cues</a> of all
    the <a href=#text-track-hidden title="text track hidden">hidden</a> or <a href=#text-track-showing title="text track
@@ -31426,8 +31428,6 @@
 
   <ol><li>
 
-   <li>
-
     <p>Create a new <code><a href=#texttrack>TextTrack</a></code> object.</p>
 
    </li>
@@ -31569,6 +31569,10 @@
    <li><p>Add <var title="">cue</var> to the method's <code><a href=#texttrack>TextTrack</a></code> object's <a href=#text-track>text
    track</a>'s <a href=#text-track-list-of-cues>text track list of cues</a>.</li>
 
+   <li><p>If the <code>TextTrack object's <a href=#text-track>text track</a> is in a <a href=#media-element>media
+   element</a>'s <a href=#list-of-text-tracks>list of text tracks</a>, run the <i><a href=#time-marches-on>time marches on</a></i> steps for that
+   <a href=#media-element>media element</a>.</code></li>
+
   </ol><p>The <dfn id=dom-texttrack-removecue title=dom-TextTrack-removeCue><code>removeCue(<var title="">cue</var>)</code></dfn>
   method of <code><a href=#texttrack>TextTrack</a></code> objects, when invoked, must run the following steps:</p>
 
@@ -31723,12 +31727,20 @@
   <p>The <dfn id=dom-texttrackcue-starttime title=dom-TextTrackCue-startTime><code>startTime</code></dfn> attribute, on getting,
   must return the <a href=#text-track-cue-start-time>text track cue start time</a> of the <a href=#text-track-cue>text track cue</a> that the
   <code><a href=#texttrackcue>TextTrackCue</a></code> object represents, in seconds. On setting, the <a href=#text-track-cue-start-time>text track cue
-  start time</a> must be set to the new value, interpreted in seconds.</p>
+  start time</a> must be set to the new value, interpreted in seconds; then, if the
+  <code><a href=#texttrackcue>TextTrackCue</a></code> object's <a href=#text-track-cue>text track cue</a> is in a <a href=#text-track>text track</a>'s
+  <a href=#text-track-list-of-cues title="text track list of cues">list of cues</a>, and that <a href=#text-track>text track</a> is in
+  a <a href=#media-element>media element</a>'s <a href=#list-of-text-tracks>list of text tracks</a>, then run the <i><a href=#time-marches-on>time marches
+  on</a></i> steps for that <a href=#media-element>media element</a>.</p>
 
   <p>The <dfn id=dom-texttrackcue-endtime title=dom-TextTrackCue-endTime><code>endTime</code></dfn> attribute, on getting,
   must return the <a href=#text-track-cue-end-time>text track cue end time</a> of the <a href=#text-track-cue>text track cue</a> that the
   <code><a href=#texttrackcue>TextTrackCue</a></code> object represents, in seconds. On setting, the <a href=#text-track-cue-end-time>text track cue end
-  time</a> must be set to the new value, interpreted in seconds.</p>
+  time</a> must be set to the new value, interpreted in seconds; then, if the
+  <code><a href=#texttrackcue>TextTrackCue</a></code> object's <a href=#text-track-cue>text track cue</a> is in a <a href=#text-track>text track</a>'s
+  <a href=#text-track-list-of-cues title="text track list of cues">list of cues</a>, and that <a href=#text-track>text track</a> is in
+  a <a href=#media-element>media element</a>'s <a href=#list-of-text-tracks>list of text tracks</a>, then run the <i><a href=#time-marches-on>time marches
+  on</a></i> steps for that <a href=#media-element>media element</a>.</p>
 
   <p>The <dfn id=dom-texttrackcue-pauseonexit title=dom-TextTrackCue-pauseOnExit><code>pauseOnExit</code></dfn> attribute, on
   getting, must return true if the <a href=#text-track-cue-pause-on-exit-flag>text track cue pause-on-exit flag</a> of the <a href=#text-track-cue>text

Modified: source
===================================================================
--- source	2013-04-14 23:15:22 UTC (rev 7834)
+++ source	2013-04-15 18:15:34 UTC (rev 7835)
@@ -1,4 +1,4 @@
-<!-- EDITOR NOTES  -*- mode: Text; fill-column: 100 -*-
+ne<!-- EDITOR NOTES  -*- mode: Text; fill-column: 100 -*-
  !
  !   Adding a new element involves editing the following sections:
  !    - section for the element itself
@@ -30898,13 +30898,15 @@
   <span>media element</span>'s <span>list of newly introduced cues</span>.</p>
 
   <p>When the <span>current playback position</span> of a <span>media element</span> changes (e.g.
-  due to playback or seeking), the user agent must run the following steps. If the <span>current
-  playback position</span> changes while the steps are running, then the user agent must wait for
-  the steps to complete, and then must immediately rerun the steps. (These steps are thus run as
-  often as possible or needed — if one iteration takes a long time, this can cause certain
-  <span title="text track cue">cues</span> to be skipped over as the user agent rushes ahead to
-  "catch up".) </p>
+  due to playback or seeking), the user agent must run the <i>time marches on</i> steps. If the
+  <span>current playback position</span> changes while the steps are running, then the user agent
+  must wait for the steps to complete, and then must immediately rerun the steps. (These steps are
+  thus run as often as possible or needed — if one iteration takes a long time, this can cause
+  certain <span title="text track cue">cues</span> to be skipped over as the user agent rushes ahead
+  to "catch up".)</p>
 
+  <p>The <dfn><i>time marches on</i></dfn> steps are as follows:</p>
+
   <ol>
 
    <li><p>Let <var title="">current cues</var> be a list of <span title="text track
@@ -33759,8 +33761,6 @@
 
    <li>
 
-   <li>
-
     <p>Create a new <code>TextTrack</code> object.</p>
 
    </li>
@@ -33924,6 +33924,10 @@
    <li><p>Add <var title="">cue</var> to the method's <code>TextTrack</code> object's <span>text
    track</span>'s <span>text track list of cues</span>.</p></li>
 
+   <li><p>If the <code>TextTrack</span> object's <span>text track</span> is in a <span>media
+   element</span>'s <span>list of text tracks</span>, run the <i>time marches on</i> steps for that
+   <span>media element</span>.</p></li>
+
   </ol>
 
   <p>The <dfn title="dom-TextTrack-removeCue"><code>removeCue(<var title="">cue</var>)</code></dfn>
@@ -34100,12 +34104,20 @@
   <p>The <dfn title="dom-TextTrackCue-startTime"><code>startTime</code></dfn> attribute, on getting,
   must return the <span>text track cue start time</span> of the <span>text track cue</span> that the
   <code>TextTrackCue</code> object represents, in seconds. On setting, the <span>text track cue
-  start time</span> must be set to the new value, interpreted in seconds.</p>
+  start time</span> must be set to the new value, interpreted in seconds; then, if the
+  <code>TextTrackCue</code> object's <span>text track cue</span> is in a <span>text track</span>'s
+  <span title="text track list of cues">list of cues</span>, and that <span>text track</span> is in
+  a <span>media element</span>'s <span>list of text tracks</span>, then run the <i>time marches
+  on</i> steps for that <span>media element</span>.</p>
 
   <p>The <dfn title="dom-TextTrackCue-endTime"><code>endTime</code></dfn> attribute, on getting,
   must return the <span>text track cue end time</span> of the <span>text track cue</span> that the
   <code>TextTrackCue</code> object represents, in seconds. On setting, the <span>text track cue end
-  time</span> must be set to the new value, interpreted in seconds.</p>
+  time</span> must be set to the new value, interpreted in seconds; then, if the
+  <code>TextTrackCue</code> object's <span>text track cue</span> is in a <span>text track</span>'s
+  <span title="text track list of cues">list of cues</span>, and that <span>text track</span> is in
+  a <span>media element</span>'s <span>list of text tracks</span>, then run the <i>time marches
+  on</i> steps for that <span>media element</span>.</p>
 
   <p>The <dfn title="dom-TextTrackCue-pauseOnExit"><code>pauseOnExit</code></dfn> attribute, on
   getting, must return true if the <span>text track cue pause-on-exit flag</span> of the <span>text




More information about the Commit-Watchers mailing list