W3C home > Mailing lists > Public > public-html-commits@w3.org > May 2010

html5/spec Overview.html,1.4077,1.4078

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Wed, 05 May 2010 00:59:47 +0000
To: public-html-commits@w3.org
Message-Id: <E1O9Sxn-0003ji-Tx@lionel-hutz.w3.org>
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv14348

Modified Files:
	Overview.html 
Log Message:
Captions - Stage 6: ground work for loading tracks dynamically. (whatwg r5076)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.4077
retrieving revision 1.4078
diff -u -d -r1.4077 -r1.4078
--- Overview.html	5 May 2010 00:06:21 -0000	1.4077
+++ Overview.html	5 May 2010 00:59:44 -0000	1.4078
@@ -685,11 +685,10 @@
        <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-processing-model"><span class="secno">4.8.10.10.2 </span>Timed track processing model</a></li>
-         <li><a href="#sourcing-in-band-timed-tracks"><span class="secno">4.8.10.10.3 </span>Sourcing in-band timed tracks</a></li>
-         <li><a href="#sourcing-websrt-timed-tracks"><span class="secno">4.8.10.10.4 </span>Sourcing WebSRT timed tracks</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="#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-api"><span class="secno">4.8.10.10.4 </span>Timed track API</a></li>
+         <li><a href="#cue-events"><span class="secno">4.8.10.10.5 </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>
@@ -20423,54 +20422,6 @@
   // timed tracks
   readonly attribute <a href="#mediatrack">MediaTrack</a>[] <span title="dom-media-tracks">tracks</span>;
   <a href="#mutablemediatrack">MutableMediaTrack</a> <span title="dom-media-addTrack">addTrack</span>(in DOMString label, in DOMString kind, in DOMString language);
-};
-
-interface <dfn id="mediatrack">MediaTrack</dfn> {
-  readonly attribute DOMString <span title="dom-MediaTrack-kind">kind</span>;
-  readonly attribute DOMString <span title="dom-MediaTrack-label">label</span>;
-  readonly attribute DOMString <span title="dom-MediaTrack-language">language</span>;
-
-  const unsigned short <span title="dom-MediaTrack-TRACK_OFF">TRACK_OFF</span> = 0;
-  const unsigned short <span title="dom-MediaTrack-TRACK_HIDDEN">TRACK_HIDDEN</span> = 1;
-  const unsigned short <span title="dom-MediaTrack-TRACK_SHOWING">TRACK_SHOWING</span> = 2;
-  readonly attribute unsigned short <span title="dom-MediaTrack-mode">mode</span>;
-
-  readonly attribute <a href="#mediacuelist">MediaCueList</a> <span title="dom-MediaTrack-cues">cues</span>;
-  readonly attribute <a href="#mediacuelist">MediaCueList</a> <span title="dom-MediaTrack-activeCues">activeCues</span>;
-  readonly attribute <a href="#function">Function</a> <span title="dom-MediaTrack-onentercue">onentercue</span>;
-  readonly attribute <a href="#function">Function</a> <span title="dom-MediaTrack-onexitcue">onexitcue</span>;
-};
-
-interface <dfn id="mutablemediatrack">MutableMediaTrack</dfn> : <a href="#mediatrack">MediaTrack</a> {
- void <span title="dom-MutableMediaTrack-addCue">addCue</span>(in <a href="#mediacue">MediaCue</a> cue);
- void <span title="dom-MutableMediaTrack-removeCue">removeCue</span>(in <a href="#mediacue">MediaCue</a> cue);
-};
-
-interface <dfn id="mediacuelist">MediaCueList</dfn> {
-  readonly attribute unsigned long <span title="dom-MediaCueList-length">length</span>;
-  getter <a href="#mediacue">MediaCue</a> (in unsigned long index);
-  <a href="#mediacue">MediaCue</a> getCueById(in DOMString id);
-};
-
-[Constructor(in DOMString id, in float startTime, in float endTime, in DOMString settings, in DOMString text, in optional boolean pauseOnExit)]
-interface <dfn id="mediacue">MediaCue</dfn> {
-  readonly attribute <a href="#mediatrack">MediaTrack</a> <span title="dom-MediaCue-track">track</span>;
-  readonly attribute DOMString <span title="dom-MediaCue-id">id</span>;
-
-  readonly attribute float <span title="dom-MediaCue-startTime">startTime</span>;
-  readonly attribute float <span title="dom-MediaCue-endTime">endTime</span>;
-  readonly attribute boolean <span title="dom-MediaCue-pauseOnExit">pauseOnExit</span>;
-
-  readonly attribute DOMString <span title="dom-MediaCue-direction">direction</span>;
-  readonly attribute boolean <span title="dom-MediaCue-snapToLines">snapToLines</span>;
-  readonly attribute long <span title="dom-MediaCue-linePosition">linePosition</span>;
-  readonly attribute long <span title="dom-MediaCue-textPosition">textPosition</span>;
-  readonly attribute long <span title="dom-MediaCue-size">size</span>;
-  readonly attribute DOMString <span title="dom-MediaCue-alignment">alignment</span>;
-
-  readonly attribute DOMString <span title="dom-MediaCue-voice">voice</span>;
-  DOMString <span title="dom-MediaCue-getCueAsSource()">getCueAsSource</span>();
-  <a href="#documentfragment">DocumentFragment</a> <span title="dom-MediaCue-getCueAsHTML()">getCueAsHTML</span>();
 };</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-preload"><a href="#attr-media-preload">preload</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
@@ -22497,6 +22448,114 @@
 
    </dd>
 
+   <dt><dfn id="timed-track-readiness-state" title="timed track readiness state">A readiness state</dfn>
+
+   <dd>
+
+    <p>One of the following:</p>
+
+    <dl><dt><dfn id="timed-track-not-loaded" title="timed track not loaded">Not loaded</dfn>
+
+     <dd>
+
+      <p>Indicates that the timed track is known to exist (e.g. it has
+      been declared with a <code><a href="#the-track-element">track</a></code> element), but its cues
+      have not been obtained.</p>
+
+     </dd>
+
+     <dt><dfn id="timed-track-loading" title="timed track loading">Loading</dfn>
+
+     <dd>
+
+      <p>Indicates that the timed track is loading and there have been
+      no fatal errors encountered so far. Further cues might still be
+      added to the track.</p>
+
+     </dd>
+
+     <dt><dfn id="timed-track-loaded" title="timed track loaded">Loaded</dfn>
+
+     <dd>
+
+      <p>Indicates that the timed track has been loaded with no fatal
+      errors. No new cues will be added to the track except if the
+      <a href="#timed-track">timed track</a> corresponds to a
+      <code>MutableTimedTrack</code> object.</p>
+
+     </dd>
+
+     <dt><dfn id="timed-track-failed-to-load" title="timed track failed to load">Failed to load</dfn>
+
+     <dd>
+
+      <p>Indicates that the timed track was enabled, but when the user
+      agent attempted to obtain it, this failed in some way
+      (e.g. <a href="#url">URL</a> could not be <a href="#resolve-a-url" title="resolve a
+      url">resolved</a>, network error, unknown timed track
+      format). Some or all of the cues are likely missing and will not
+      be obtained.</p>
+
+     </dd>
+
+    </dl><p>The <a href="#timed-track-readiness-state" title="timed track readiness state">readiness
+    state</a> of a <a href="#timed-track">timed track</a> changes dynamically as
+    the track is obtained.</p>
+
+   </dd>
+
+   <dt><dfn id="timed-track-mode" title="timed track mode">A mode</dfn>
+
+   <dd>
+
+    <p>One of the following:</p>
+
+    <dl><dt><dfn id="timed-track-disabled" title="timed track disabled">Disabled</dfn>
+
+     <dd>
+
+      <p>Indicates that the timed track is not active. Other than for
+      the purposes of exposing the track in the DOM, the user agent is
+      ignoring the timed track. No cues are active, no events are
+      fired, and the user agent will not attempt to obtain the track's
+      cues.</p>
+
+     </dd>
+
+     <dt><dfn id="timed-track-hidden" title="timed track hidden">Hidden</dfn>
+
+     <dd>
+
+      <p>Indicates that the timed track is active, but that the user
+      agent is not actively displaying the cues. If no attempt has yet
+      been made to obtain the track's cues, the user will perform such
+      an attempt momentarily. The user agent is maintaining a list of
+      which cues are active, and events are being fired
+      accordingly.</p>
+
+     </dd>
+
+     <dt><dfn id="timed-track-showing" title="timed track showing">Showing</dfn>
+
+     <dd>
+
+      <p>Indicates that the timed track is active. If no attempt has
+      yet been made to obtain the track's cues, the user will perform
+      such an attempt momentarily. The user agent is maintaining a
+      list of which cues are active, and events are being fired
+      accordingly. In addition, for timed tracks whose <a href="#timed-track-kind" title="timed track kind">kind</a> is <code title="dom-mediatrack-kind-subtitles"><a href="#dom-mediatrack-kind-subtitles">subtitles</a></code> or <code title="dom-mediatrack-kind-captions"><a href="#dom-mediatrack-kind-captions">captions</a></code>, the cues
+      are being displayed over the video as appropriate; for timed
+      tracks whose <a href="#timed-track-kind" title="timed track kind">kind</a> is <code title="dom-mediatrack-kind-descriptions"><a href="#dom-mediatrack-kind-descriptions">descriptions</a></code>,
+      the user agent is making the cues available to the user in a
+      non-visual fashion; and for timed tracks whose <a href="#timed-track-kind" title="timed track kind">kind</a> is <code title="dom-mediatrack-kind-chapters"><a href="#dom-mediatrack-kind-chapters">chapters</a></code>, the user
+      agent is making available to the user a mechanism by which the
+      user can navigate to any point in the <a href="#media-resource">media
+      resource</a> by selecting a cue.</p>
+
+     </dd>
+
+    </dl></dd>
+
    <dt><dfn id="timed-track-list-of-cues" title="timed track list of cues">A list of zero or more cues</dfn>
 
    <dd>
@@ -22504,10 +22563,13 @@
     <p>A list of <a href="#timed-track-cue" title="timed track cue">timed track cues</a>.</p>
 
     <p>The <a href="#timed-track-list-of-cues" title="timed track list of cues">list of cues of a
-    timed track</a> can change dynamically, in the case of a
-    <a href="#timed-track">timed track</a> corresponding to a
-    <code>MutableTimedTrack</code> object: individual cues can be
-    added or removed dynamically.</p>
+    timed track</a> can change dynamically, either because the
+    <a href="#timed-track">timed track</a> has <a href="#timed-track-not-loaded" title="timed track not
+    loaded">not yet been loaded</a> or is still <a href="#timed-track-loading" title="timed
+    track loading">loading</a>, or in the case of a <a href="#timed-track">timed
+    track</a> corresponding to a <code>MutableTimedTrack</code>
+    object, where individual cues can be added or removed
+    dynamically using the API.</p>
 
    </dd>
 
@@ -22610,50 +22672,54 @@
     HTML.</p>
    </dd>
 
-  </dl><h6 id="timed-track-processing-model"><span class="secno">4.8.10.10.2 </span>Timed track processing model</h6><p class="XXX">...fetching timed tracks
-
-
-  <h6 id="sourcing-in-band-timed-tracks"><span class="secno">4.8.10.10.3 </span>Sourcing in-band timed tracks</h6><p>
+  </dl><p>A <a href="#timed-track-cue">timed track cue</a> is immutable.<h6 id="sourcing-in-band-timed-tracks"><span class="secno">4.8.10.10.2 </span>Sourcing in-band timed tracks</h6><p class="XXX">...
 
 
-  <h6 id="sourcing-websrt-timed-tracks"><span class="secno">4.8.10.10.4 </span>Sourcing WebSRT timed tracks</h6><p class="XXX">...
+  <h6 id="sourcing-websrt-timed-tracks"><span class="secno">4.8.10.10.3 </span>Sourcing WebSRT timed tracks</h6><p class="XXX">...fetching timed tracks
 
 
-  <h6 id="timed-track-api"><span class="secno">4.8.10.10.5 </span>Timed track API</h6><!--
-  // timed tracks on HTMLMediaElement:
+  <h6 id="timed-track-api"><span class="secno">4.8.10.10.4 </span>Timed track API</h6><!--
+  // timed tracks
   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);
-
-interface <dfn>MediaTrack</dfn> {
+--><pre class="idl">interface <dfn id="mediatrack">MediaTrack</dfn> {
   readonly attribute DOMString <span title="dom-MediaTrack-kind">kind</span>;
   readonly attribute DOMString <span title="dom-MediaTrack-label">label</span>;
   readonly attribute DOMString <span title="dom-MediaTrack-language">language</span>;
 
-  const unsigned short <span title="dom-MediaTrack-TRACK_OFF">TRACK_OFF</span> = 0;
-  const unsigned short <span title="dom-MediaTrack-TRACK_HIDDEN">TRACK_HIDDEN</span> = 1;
-  const unsigned short <span title="dom-MediaTrack-TRACK_SHOWING">TRACK_SHOWING</span> = 2;
-  readonly attribute unsigned short <span title="dom-MediaTrack-mode">mode</span>;
+  const unsigned short <span title="dom-MediaTrack-NONE">NONE</span> = 0;
+  const unsigned short <span title="dom-MediaTrack-LOADING">LOADING</span> = 1;
+  const unsigned short <span title="dom-MediaTrack-LOADED">LOADED</span> = 2;
+  const unsigned short <span title="dom-MediaTrack-ERROR">ERROR</span> = 3;
+  readonly attribute unsigned short <span title="dom-MediaTrack-readyState">readyState</span>;
+  readonly attribute <a href="#function">Function</a> <span title="dom-MediaTrack-onload">onload</span>;
+  readonly attribute <a href="#function">Function</a> <span title="dom-MediaTrack-onerror">onerror</span>;
 
-  readonly attribute <span>MediaCueList</span> <span title="dom-MediaTrack-cues">cues</span>;
-  readonly attribute <Span>MediaCueList</span> <span title="dom-MediaTrack-activeCues">activeCues</span>;
-  readonly attribute <span>Function</span> <span title="dom-MediaTrack-onentercue">onentercue</span>;
-  readonly attribute <span>Function</span> <span title="dom-MediaTrack-onexitcue">onexitcue</span>;
+  const unsigned short <span title="dom-MediaTrack-OFF">OFF</span> = 0;
+  const unsigned short <span title="dom-MediaTrack-HIDDEN">HIDDEN</span> = 1;
+  const unsigned short <span title="dom-MediaTrack-SHOWING">SHOWING</span> = 2;
+           attribute unsigned short <span title="dom-MediaTrack-mode">mode</span>;
+
+  readonly attribute <a href="#mediacuelist">MediaCueList</a> <span title="dom-MediaTrack-cues">cues</span>;
+  readonly attribute <a href="#mediacuelist">MediaCueList</a> <span title="dom-MediaTrack-activeCues">activeCues</span>;
+  readonly attribute <a href="#function">Function</a> <span title="dom-MediaTrack-onentercue">onentercue</span>;
+  readonly attribute <a href="#function">Function</a> <span title="dom-MediaTrack-onexitcue">onexitcue</span>;
 };
 
-interface <dfn>MutableMediaTrack</dfn> : <span>MediaTrack</span> {
- void <span title="dom-MutableMediaTrack-addCue">addCue</span>(in <span>MediaCue</span> cue);
- void <span title="dom-MutableMediaTrack-removeCue">removeCue</span>(in <span>MediaCue</span> cue);
+interface <dfn id="mutablemediatrack">MutableMediaTrack</dfn> : <a href="#mediatrack">MediaTrack</a> {
+ void <span title="dom-MutableMediaTrack-addCue">addCue</span>(in <a href="#mediacue">MediaCue</a> cue);
+ void <span title="dom-MutableMediaTrack-removeCue">removeCue</span>(in <a href="#mediacue">MediaCue</a> cue);
 };
 
-interface <dfn>MediaCueList</dfn> {
+interface <dfn id="mediacuelist">MediaCueList</dfn> {
   readonly attribute unsigned long <span title="dom-MediaCueList-length">length</span>;
-  getter <span>MediaCue</span> (in unsigned long index);
-  <span>MediaCue</span> getCueById(in DOMString id);
+  getter <a href="#mediacue">MediaCue</a> (in unsigned long index);
+  <a href="#mediacue">MediaCue</a> getCueById(in DOMString id);
 };
 
 [Constructor(in DOMString id, in float startTime, in float endTime, in DOMString settings, in DOMString text, in optional boolean pauseOnExit)]
-interface <dfn>MediaCue</dfn> {
-  readonly attribute <span>MediaTrack</span> <span title="dom-MediaCue-track">track</span>;
+interface <dfn id="mediacue">MediaCue</dfn> {
+  readonly attribute <a href="#mediatrack">MediaTrack</a> <span title="dom-MediaCue-track">track</span>;
   readonly attribute DOMString <span title="dom-MediaCue-id">id</span>;
 
   readonly attribute float <span title="dom-MediaCue-startTime">startTime</span>;
@@ -22669,15 +22735,14 @@
 
   readonly attribute DOMString <span title="dom-MediaCue-voice">voice</span>;
   DOMString <span title="dom-MediaCue-getCueAsSource()">getCueAsSource</span>();
-  <span>DocumentFragment</span> <span title="dom-MediaCue-getCueAsHTML()">getCueAsHTML</span>();
-};
---><p class="XXX">domintro
+  <a href="#documentfragment">DocumentFragment</a> <span title="dom-MediaCue-getCueAsHTML()">getCueAsHTML</span>();
+};</pre><p class="XXX">domintro
 
   <div class="impl">
 
   <p class="XXX">...
 
-  </div><h6 id="cue-events"><span class="secno">4.8.10.10.6 </span>Event definitions</h6><p class="XXX">...
+  </div><h6 id="cue-events"><span class="secno">4.8.10.10.5 </span>Event definitions</h6><p class="XXX">...
 
 <!-- XXX
 CueEvent
Received on Wednesday, 5 May 2010 00:59:49 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 5 May 2010 00:59:52 GMT