- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 04 May 2010 22:53:16 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec In directory hutz:/tmp/cvs-serv31328 Modified Files: Overview.html Log Message: Captions - Stage 4: preparing the ground for timed tracks updating during media playback. (whatwg r5073) Index: Overview.html =================================================================== RCS file: /sources/public/html5/spec/Overview.html,v retrieving revision 1.4074 retrieving revision 1.4075 diff -u -d -r1.4074 -r1.4075 --- Overview.html 4 May 2010 10:05:00 -0000 1.4074 +++ Overview.html 4 May 2010 22:53:12 -0000 1.4075 @@ -685,16 +685,19 @@ <li><a href="#timed-tracks"><span class="secno">4.8.10.10 </span>Timed tracks</a> <ol> <li><a href="#timed-track-model"><span class="secno">4.8.10.10.1 </span>Timed track model</a></li> - <li><a href="#timed-track-api"><span class="secno">4.8.10.10.2 </span>Timed track API</a></li> - <li><a href="#in-band-timed-tracks"><span class="secno">4.8.10.10.3 </span>In-band timed tracks</a></li> - <li><a href="#websrt-timed-tracks"><span class="secno">4.8.10.10.4 </span>WebSRT timed tracks</a></li> - <li><a href="#sourcing-timed-tracks"><span class="secno">4.8.10.10.5 </span>Sourcing timed tracks</a></li> - <li><a href="#timed-track-processing-model"><span class="secno">4.8.10.10.6 </span>Timed track processing model</a></li> - <li><a href="#event-definitions"><span class="secno">4.8.10.10.7 </span>Event definitions</a></ol></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="#sourcing-in-band-timed-tracks"><span class="secno">4.8.10.10.2 </span>Sourcing in-band timed tracks</a></li> + <li><a href="#sourcing-websrt-timed-tracks"><span class="secno">4.8.10.10.3 </span>Sourcing WebSRT timed tracks</a></li> + <li><a href="#timed-track-processing-model"><span class="secno">4.8.10.10.4 </span>Timed track processing model</a></li> + <li><a href="#timed-track-api"><span class="secno">4.8.10.10.5 </span>Timed track API</a></li> + <li><a href="#cue-events"><span class="secno">4.8.10.10.6 </span>Event definitions</a></ol></li> + <li><a href="#websrt"><span class="secno">4.8.10.11 </span>WebSRT</a> + <ol> + <li><a href="#syntax-0"><span class="secno">4.8.10.11.1 </span>Syntax</a></li> + <li><a href="#parsing-0"><span class="secno">4.8.10.11.2 </span>Parsing</a></ol></li> + <li><a href="#user-interface"><span class="secno">4.8.10.12 </span>User interface</a></li> + <li><a href="#time-ranges"><span class="secno">4.8.10.13 </span>Time ranges</a></li> + <li><a href="#mediaevents"><span class="secno">4.8.10.14 </span>Event summary</a></li> + <li><a href="#security-and-privacy-considerations"><span class="secno">4.8.10.15 </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="#color-spaces-and-color-correction"><span class="secno">4.8.11.1 </span>Color spaces and color correction</a></li> @@ -928,7 +931,7 @@ <li><a href="#scroll-to-fragid"><span class="secno">5.5.8 </span>Navigating to a fragment identifier</a></li> <li><a href="#history-traversal"><span class="secno">5.5.9 </span>History traversal</a> <ol> - <li><a href="#event-definitions-0"><span class="secno">5.5.9.1 </span>Event definitions</a></ol></li> + <li><a href="#event-definitions"><span class="secno">5.5.9.1 </span>Event definitions</a></ol></li> <li><a href="#unloading-documents"><span class="secno">5.5.10 </span>Unloading documents</a> <ol> <li><a href="#event-definition"><span class="secno">5.5.10.1 </span>Event definition</a></ol></li> @@ -20796,20 +20799,23 @@ <ol><li><p>If a fetching process is in progress for the <a href="#media-element">media element</a>, the user agent should stop it.</li> - <li>Set the <code title="dom-media-networkState"><a href="#dom-media-networkstate">networkState</a></code> attribute to - <a href="#dom-media-network_empty" title="dom-media-NETWORK_EMPTY">NETWORK_EMPTY</a>.</li> + <li><p>Set the <code title="dom-media-networkState"><a href="#dom-media-networkstate">networkState</a></code> attribute to + <code title="dom-media-NETWORK_EMPTY"><a href="#dom-media-network_empty">NETWORK_EMPTY</a></code>.</li> - <li>If <code title="dom-media-readyState"><a href="#dom-media-readystate">readyState</a></code> is + <li class="XXX"><p>remove all timed tracks</li> + + <li><p>If <code title="dom-media-readyState"><a href="#dom-media-readystate">readyState</a></code> is not set to <code title="dom-media-HAVE_NOTHING"><a href="#dom-media-have_nothing">HAVE_NOTHING</a></code>, then set it to that state.</li> - <li>If the <code title="dom-media-paused"><a href="#dom-media-paused">paused</a></code> attribute - is false, then set to true.</li> + <li><p>If the <code title="dom-media-paused"><a href="#dom-media-paused">paused</a></code> + attribute is false, then set to true.</li> - <li>If <code title="dom-media-seeking"><a href="#dom-media-seeking">seeking</a></code> is true, + <li><p>If <code title="dom-media-seeking"><a href="#dom-media-seeking">seeking</a></code> is true, set it to false.</li> - <li>Set the <a href="#current-playback-position">current playback position</a> to 0.</li> + <li><p>Set the <a href="#current-playback-position">current playback position</a> to + 0.</li> <li><p><a href="#queue-a-task">Queue a task</a> to <a href="#fire-a-simple-event">fire a simple event</a> named <code title="event-media-emptied"><a href="#event-media-emptied">emptied</a></code> at the <a href="#media-element">media @@ -20846,7 +20852,7 @@ the <a href="#event-loop">event loop</a> algorithm). Steps in such sections are marked with ⌛.</p> - <ol><li><p>Set the <code title="dom-media-networkState"><a href="#dom-media-networkstate">networkState</a></code> to <code title="dom-media-NETWORK_NO_SOURCE"><a href="#dom-media-network_no_source">NETWORK_NO_SOURCE</a></code>.</li> + <ol><!-- precondition: networkState == NETWORK_EMPTY at this point --><li><p>Set the <code title="dom-media-networkState"><a href="#dom-media-networkstate">networkState</a></code> to <code title="dom-media-NETWORK_NO_SOURCE"><a href="#dom-media-network_no_source">NETWORK_NO_SOURCE</a></code>.</li> <li><p>Asynchronously <a href="#await-a-stable-state">await a stable state</a>, allowing the <a href="#concept-task" title="concept-task">task</a> that invoked this @@ -20913,7 +20919,7 @@ <li><p><i>Failed</i>: Reaching this step indicates that the media resource failed to load or that the given <a href="#url">URL</a> could not be <a href="#resolve-a-url" title="resolve a url">resolved</a>. Set the <code title="dom-media-error"><a href="#dom-media-error">error</a></code> attribute to a new - <code><a href="#mediaerror">MediaError</a></code> object whose <code title="dom-MediaError-code"><a href="#dom-mediaerror-code">code</a></code> attribute is set to <code title="dom-MediaError-MEDIA_ERR_SRC_NOT_SUPPORTED"><a href="#dom-mediaerror-media_err_src_not_supported">MEDIA_ERR_SRC_NOT_SUPPORTED</a></code>.</li> + <code><a href="#mediaerror">MediaError</a></code> object whose <code title="dom-MediaError-code"><a href="#dom-mediaerror-code">code</a></code> attribute is set to <code title="dom-MediaError-MEDIA_ERR_SRC_NOT_SUPPORTED"><a href="#dom-mediaerror-media_err_src_not_supported">MEDIA_ERR_SRC_NOT_SUPPORTED</a></code>. <span class="XXX">remove all timed tracks</span></li> <li><p>Set the element's <code title="dom-media-networkState"><a href="#dom-media-networkstate">networkState</a></code> attribute to the <a href="#dom-media-network_no_source" title="dom-media-NETWORK_NO_SOURCE">NETWORK_NO_SOURCE</a> @@ -21020,7 +21026,8 @@ <a href="#fire-a-simple-event">fire a simple event</a> named <code title="event-error">error</code> at the <var title="">candidate</var> element, in the context of the <a href="#fetch" title="fetch">fetching process</a> that was used to try to obtain <var title="">candidate</var>'s corresponding <a href="#media-resource">media resource</a> in the <a href="#concept-media-load-resource" title="concept-media-load-resource">resource fetch - algorithm</a>.</li> + algorithm</a>. <span class="XXX">remove all timed + tracks</span></li> <li><p>Asynchronously <a href="#await-a-stable-state">await a stable state</a>. The <a href="#synchronous-section">synchronous section</a> consists of all the remaining @@ -21298,10 +21305,11 @@ at the <a href="#media-element">media element</a>.</li> <li><p>Set the element's <code title="dom-media-networkState"><a href="#dom-media-networkstate">networkState</a></code> attribute to - the <a href="#dom-media-network_empty" title="dom-media-NETWORK_EMPTY">NETWORK_EMPTY</a> + the <code title="dom-media-NETWORK_EMPTY"><a href="#dom-media-network_empty">NETWORK_EMPTY</a></code> value and <a href="#queue-a-task">queue a task</a> to <a href="#fire-a-simple-event">fire a simple - event</a> named <code title="event-media-emptied"><a href="#event-media-emptied">emptied</a></code> - at the element.</li> + event</a> named <code title="event-media-emptied"><a href="#event-media-emptied">emptied</a></code> at the + element.</li> <!-- XXX shouldn't this be _IDLE? see + aborted-by-user state below --> <li><p>Set the element's <a href="#delaying-the-load-event-flag">delaying-the-load-event flag</a> to false. This stops <a href="#delay-the-load-event" title="delay the load @@ -21334,10 +21342,11 @@ at the <a href="#media-element">media element</a>.</li> <li><p>Set the element's <code title="dom-media-networkState"><a href="#dom-media-networkstate">networkState</a></code> attribute to - the <a href="#dom-media-network_empty" title="dom-media-NETWORK_EMPTY">NETWORK_EMPTY</a> + the <code title="dom-media-NETWORK_EMPTY"><a href="#dom-media-network_empty">NETWORK_EMPTY</a></code> value and <a href="#queue-a-task">queue a task</a> to <a href="#fire-a-simple-event">fire a simple - event</a> named <code title="event-media-emptied"><a href="#event-media-emptied">emptied</a></code> - at the element.</li> + event</a> named <code title="event-media-emptied"><a href="#event-media-emptied">emptied</a></code> at the + element.</li> <!-- XXX shouldn't this be _IDLE? see + aborted-by-user case below --> <li><p>Set the element's <a href="#delaying-the-load-event-flag">delaying-the-load-event flag</a> to false. This stops <a href="#delay-the-load-event" title="delay the load @@ -21375,11 +21384,11 @@ <li><p>If the <a href="#media-element">media element</a>'s <code title="dom-media-readyState"><a href="#dom-media-readystate">readyState</a></code> attribute has a value equal to <code title="dom-media-HAVE_NOTHING"><a href="#dom-media-have_nothing">HAVE_NOTHING</a></code>, set the element's <code title="dom-media-networkState"><a href="#dom-media-networkstate">networkState</a></code> attribute to - the <a href="#dom-media-network_empty" title="dom-media-NETWORK_EMPTY">NETWORK_EMPTY</a> + the <code title="dom-media-NETWORK_EMPTY"><a href="#dom-media-network_empty">NETWORK_EMPTY</a></code> value and <a href="#queue-a-task">queue a task</a> to <a href="#fire-a-simple-event">fire a simple event</a> named <code title="event-media-emptied"><a href="#event-media-emptied">emptied</a></code> at the element. Otherwise, set the element's <code title="dom-media-networkState"><a href="#dom-media-networkstate">networkState</a></code> attribute to - the <a href="#dom-media-network_idle" title="dom-media-NETWORK_IDLE">NETWORK_IDLE</a> + the <code title="dom-media-NETWORK_IDLE"><a href="#dom-media-network_idle">NETWORK_IDLE</a></code> value.</li> <li><p>Set the element's <a href="#delaying-the-load-event-flag">delaying-the-load-event @@ -21408,6 +21417,15 @@ </dd> + + <dt class="XXX">timed tracks are found</dt> + + <dd> + + <p class="XXX">... + + </dd> + </dl><p>When the <a href="#networking-task-source">networking task source</a> has <a href="#queue-a-task" title="queue a task">queued</a> the last <a href="#concept-task" title="concept-task">task</a> as part of <a href="#fetch" title="fetch">fetching</a> the <a href="#media-resource">media resource</a> (i.e. once the download has completed), if the fetching process completes without errors, including decoding the media data, and @@ -21671,7 +21689,7 @@ available. No data for the <a href="#current-playback-position">current playback position</a> is available. <a href="#media-element" title="media element">Media elements</a> whose <code title="dom-media-networkState"><a href="#dom-media-networkstate">networkState</a></code> - attribute is <code title="dom-media-NETWORK_EMPTY"><a href="#dom-media-network_empty">NETWORK_EMPTY</a></code> are always in + attribute are set to <code title="dom-media-NETWORK_EMPTY"><a href="#dom-media-network_empty">NETWORK_EMPTY</a></code> are always in the <code title="dom-media-HAVE_NOTHING"><a href="#dom-media-have_nothing">HAVE_NOTHING</a></code> state.</dd> @@ -22409,7 +22427,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="timed-tracks"><span class="secno">4.8.10.10 </span>Timed tracks</h5><h6 id="timed-track-model"><span class="secno">4.8.10.10.1 </span>Timed track model</h6><p>A <a href="#media-element">media element</a> can have a group of associated <dfn id="timed-track" title="timed track">timed tracks</dfn>, known as the <a href="#media-element">media + </div><h5 id="timed-tracks"><span class="secno">4.8.10.10 </span>Timed tracks</h5><p class="XXX annotation"><b>Status: </b><i>Being edited right now</i><h6 id="timed-track-model"><span class="secno">4.8.10.10.1 </span>Timed track model</h6><p>A <a href="#media-element">media element</a> can have a group of associated <dfn id="timed-track" title="timed track">timed tracks</dfn>, known as the <a href="#media-element">media element</a>'s <dfn id="list-of-timed-tracks">list of timed tracks</dfn>. The <a href="#timed-track" title="timed track">timed tracks</a> are sorted as follows:<ol class="brief"><li>The <a href="#timed-track" title="timed track">timed tracks</a> corresponding to <code><a href="#the-track-element">track</a></code> element children of the <a href="#media-element">media element</a>, in <a href="#tree-order">tree order</a>.</li> @@ -22582,10 +22600,16 @@ HTML.</p> </dd> - </dl><p class="XXX">... + </dl><h6 id="sourcing-in-band-timed-tracks"><span class="secno">4.8.10.10.2 </span>Sourcing in-band timed tracks</h6><p> - <h6 id="timed-track-api"><span class="secno">4.8.10.10.2 </span>Timed track API</h6><!-- + <h6 id="sourcing-websrt-timed-tracks"><span class="secno">4.8.10.10.3 </span>Sourcing WebSRT timed tracks</h6><p class="XXX">... + + + <h6 id="timed-track-processing-model"><span class="secno">4.8.10.10.4 </span>Timed track processing model</h6><p class="XXX">... + + + <h6 id="timed-track-api"><span class="secno">4.8.10.10.5 </span>Timed track API</h6><!-- // timed tracks on HTMLMediaElement: readonly attribute <span>MediaTrack</span>[] <span title="dom-media-tracks">tracks</span>; <span>MutableMediaTrack</span> <span title="dom-media-addTrack">addTrack</span>(in DOMString label, in DOMString kind, in DOMString language); @@ -22643,19 +22667,7 @@ <p class="XXX">... - </div><h6 id="in-band-timed-tracks"><span class="secno">4.8.10.10.3 </span>In-band timed tracks</h6><p class="XXX">... - - - <h6 id="websrt-timed-tracks"><span class="secno">4.8.10.10.4 </span>WebSRT timed tracks</h6><p class="XXX">... - - - <h6 id="sourcing-timed-tracks"><span class="secno">4.8.10.10.5 </span>Sourcing timed tracks</h6><p class="XXX">... - - - <h6 id="timed-track-processing-model"><span class="secno">4.8.10.10.6 </span>Timed track processing model</h6><p class="XXX">... - - - <h6 id="event-definitions"><span class="secno">4.8.10.10.7 </span>Event definitions</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p class="XXX">... + </div><h6 id="cue-events"><span class="secno">4.8.10.10.6 </span>Event definitions</h6><p class="XXX">... <!-- XXX CueEvent @@ -22663,7 +22675,13 @@ --> - <h5 id="user-interface"><span class="secno">4.8.10.11 </span>User interface</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>The <dfn id="attr-media-controls" title="attr-media-controls"><code>controls</code></dfn> + <h5 id="websrt"><span class="secno">4.8.10.11 </span>WebSRT</h5><h6 id="syntax-0"><span class="secno">4.8.10.11.1 </span>Syntax</h6><p class="XXX">... + + <h6 id="parsing-0"><span class="secno">4.8.10.11.2 </span>Parsing</h6><p class="XXX">... + + + + <h5 id="user-interface"><span class="secno">4.8.10.12 </span>User interface</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><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"> @@ -22757,7 +22775,7 @@ event</a> named <code title="event-media-volumechange"><a href="#event-media-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 class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>Objects implementing the <code><a href="#timeranges">TimeRanges</a></code> interface + </div><h5 id="time-ranges"><span class="secno">4.8.10.13 </span>Time ranges</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><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); @@ -22826,7 +22844,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> IDL 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 class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p><i>This section is non-normative.</i><p>The following events fire on <a href="#media-element" title="media element">media + </div><h5 id="mediaevents"><span class="secno">4.8.10.14 </span>Event summary</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p><i>This section is non-normative.</i><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... @@ -22928,7 +22946,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><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> + <h5 id="security-and-privacy-considerations"><span class="secno">4.8.10.15 </span>Security and privacy considerations</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> <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 @@ -44089,7 +44107,7 @@ <a href="#dom-manipulation-task-source">DOM manipulation task source</a>.</p> - <h5 id="event-definitions-0"><span class="secno">5.5.9.1 </span>Event definitions</h5> + <h5 id="event-definitions"><span class="secno">5.5.9.1 </span>Event definitions</h5><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p> </div><p>The <dfn id="event-popstate" title="event-popstate"><code>popstate</code></dfn> event is fired when navigating to a <a href="#session-history-entry">session history entry</a>
Received on Tuesday, 4 May 2010 22:53:19 UTC