hixie: Captions - Stage 2: the IDL additions. (whatwg r5071)

hixie: Captions - Stage 2: the IDL additions. (whatwg r5071)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.4072&r2=1.4073&f=h
http://html5.org/tools/web-apps-tracker?from=5070&to=5071

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.4072
retrieving revision 1.4073
diff -u -d -r1.4072 -r1.4073
--- Overview.html 4 May 2010 04:21:05 -0000 1.4072
+++ Overview.html 4 May 2010 07:36:44 -0000 1.4073
@@ -685,8 +685,9 @@
        <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="#in-band-timed-tracks"><span class="secno">4.8.10.10.2 </span>In-band timed tracks</a></li>
-         <li><a href="#websrt"><span class="secno">4.8.10.10.3 </span>WebSRT</a></ol></li>
+         <li><a href="#event-definitions"><span class="secno">4.8.10.10.2 </span>Event definitions</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"><span class="secno">4.8.10.10.4 </span>WebSRT</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>
@@ -924,7 +925,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"><span class="secno">5.5.9.1 </span>Event definitions</a></ol></li>
+       <li><a href="#event-definitions-0"><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>
@@ -20312,6 +20313,8 @@
            attribute DOMString <a href="#dom-track-label" title="dom-track-label">label</a>;
            attribute DOMString <a href="#dom-track-src" title="dom-track-src">src</a>;
            attribute DOMString <a href="#dom-track-srclang" title="dom-track-srclang">srclang</a>;
+
+  readonly attribute <a href="#mediatrack">MediaTrack</a> <span title="dom-track-track">track</span>;
 };</pre>
    </dd>
   </dl><p>The <code><a href="#the-track-element">track</a></code> element allows authors to specify explicit
@@ -20353,7 +20356,9 @@
   state, whose <code title="attr-track-srclang"><a href="#attr-track-srclang">srclang</a></code>
   attributes are both missing or have values that represent the same
   language, and whose <code title="attr-track-label"><a href="#attr-track-label">label</a></code>
-  attributes are again both missing or both have the same value.<div class="impl">
+  attributes are again both missing or both have the same value.<p class="XXX">domintro for track.track<div class="impl">
+
+  <p class="XXX">track.track</p>
 
   <p>The IDL attributes <dfn id="dom-track-kind" title="dom-track-kind"><code>kind</code></dfn>, <dfn id="dom-track-label" title="dom-track-label"><code>label</code></dfn>, <dfn id="dom-track-src" title="dom-track-src"><code>src</code></dfn>, and <dfn id="dom-track-srclang" title="dom-track-srclang"><code>srclang</code></dfn> must
   <a href="#reflect">reflect</a> the respective content attributes of the same
@@ -20408,7 +20413,59 @@
            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>;
-};</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
+
+  // 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"&gt;(in <a href="#mediacue">MediaCue</a> cue);
+ void <span title="dom-MutableMediaTrack-removeCue">removeCue"&gt;(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 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-direction">direction</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>();
+};</span></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
     * hasAudio, hasVideo, hasCaptions, etc
@@ -22349,11 +22406,70 @@
   <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><p class="XXX">processing model for timed tracks<h6 id="timed-track-model"><span class="secno">4.8.10.10.1 </span>Timed track model</h6><p class="XXX">...
+  </div><h5 id="timed-tracks"><span class="secno">4.8.10.10 </span>Timed tracks</h5><p class="XXX">processing model for timed tracks</p><!--
+  // 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);
 
-  <h6 id="in-band-timed-tracks"><span class="secno">4.8.10.10.2 </span>In-band timed tracks</h6><p class="XXX">...
+interface <dfn>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>;
 
-  <h6 id="websrt"><span class="secno">4.8.10.10.3 </span>WebSRT</h6><p class="XXX">...
+  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 <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>;
+};
+
+interface <dfn>MutableMediaTrack</dfn> : <span>MediaTrack</span> {
+ void <span title="dom-MutableMediaTrack-addCue">addCue">(in <span>MediaCue</span> cue);
+ void <span title="dom-MutableMediaTrack-removeCue">removeCue">(in <span>MediaCue</span> cue);
+};
+
+interface <dfn>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);
+};
+
+[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>;
+  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 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-direction">direction</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>();
+  <span>DocumentFragment</span> <span title="dom-MediaCue-getCueAsHTML()">getCueAsHTML</span>();
+};
+--><h6 id="timed-track-model"><span class="secno">4.8.10.10.1 </span>Timed track model</h6><p class="XXX">...
+
+  <h6 id="event-definitions"><span class="secno">4.8.10.10.2 </span>Event definitions</h6><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p class="XXX">...
+
+<!-- XXX
+CueEvent
+ readonly attribute MediaCue cue;
+-->
+
+  <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"><span class="secno">4.8.10.10.4 </span>WebSRT</h6><p class="XXX">...
 
 
   <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>
@@ -43782,7 +43898,7 @@
   <a href="#dom-manipulation-task-source">DOM manipulation task source</a>.</p>
 
 
-  <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>
+  <h5 id="event-definitions-0"><span class="secno">5.5.9.1 </span>Event definitions</h5>
 
   </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 07:37:27 UTC