[html5] r5071 - [giow] (0) Captions - Stage 2: the IDL additions.

whatwg at whatwg.org whatwg at whatwg.org
Tue May 4 00:36:59 PDT 2010


Author: ianh
Date: 2010-05-04 00:36:58 -0700 (Tue, 04 May 2010)
New Revision: 5071

Modified:
   complete.html
   index
   source
Log:
[giow] (0) Captions - Stage 2: the IDL additions.

Modified: complete.html
===================================================================
--- complete.html	2010-05-04 04:21:19 UTC (rev 5070)
+++ complete.html	2010-05-04 07:36:58 UTC (rev 5071)
@@ -530,8 +530,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>
@@ -827,7 +828,7 @@
      <li><a href=#scroll-to-fragid><span class=secno>6.5.8 </span>Navigating to a fragment identifier</a></li>
      <li><a href=#history-traversal><span class=secno>6.5.9 </span>History traversal</a>
       <ol>
-       <li><a href=#event-definitions><span class=secno>6.5.9.1 </span>Event definitions</a></ol></li>
+       <li><a href=#event-definitions-0><span class=secno>6.5.9.1 </span>Event definitions</a></ol></li>
      <li><a href=#unloading-documents><span class=secno>6.5.10 </span>Unloading documents</a>
       <ol>
        <li><a href=#event-definition><span class=secno>6.5.10.1 </span>Event definition</a></ol></li>
@@ -971,7 +972,7 @@
      <li><a href=#worker-locations><span class=secno>9.3.5 </span>Worker locations</a></ol></ol></li>
  <li><a href=#comms><span class=secno>10 </span>Communication</a>
   <ol>
-   <li><a href=#event-definitions-0><span class=secno>10.1 </span>Event definitions</a></li>
+   <li><a href=#event-definitions-1><span class=secno>10.1 </span>Event definitions</a></li>
    <li><a href=#server-sent-events><span class=secno>10.2 </span>Server-sent events</a>
     <ol>
      <li><a href=#server-sent-events-intro><span class=secno>10.2.1 </span>Introduction</a></li>
@@ -992,7 +993,7 @@
      <li><a href=#the-websocket-interface><span class=secno>10.3.2 </span>The <code>WebSocket</code> interface</a></li>
      <li><a href=#feedback-from-the-protocol><span class=secno>10.3.3 </span>Feedback from the protocol</a>
       <ol>
-       <li><a href=#event-definitions-1><span class=secno>10.3.3.1 </span>Event definitions</a></li>
+       <li><a href=#event-definitions-2><span class=secno>10.3.3.1 </span>Event definitions</a></li>
        <li><a href=#garbage-collection-1><span class=secno>10.3.3.2 </span>Garbage collection</a></ol></li>
      <li><a href=#websocket-protocol title="The WebSocket protocol enables
   two-way communication between a user agent running untrusted code
@@ -23552,6 +23553,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
@@ -23607,8 +23610,12 @@
   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.</p>
 
+  <p class=XXX>domintro for track.track</p>
+
   <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
   name.</p>
@@ -23670,8 +23677,60 @@
            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>
 
+  // 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">(in <a href=#mediacue>MediaCue</a> cue);
+ void <span title=dom-MutableMediaTrack-removeCue>removeCue">(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>
 
@@ -25732,19 +25791,82 @@
 
   <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);
+
+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>;
+
+  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=in-band-timed-tracks><span class=secno>4.8.10.10.2 </span>In-band timed tracks</h6>
+  <h6 id=event-definitions><span class=secno>4.8.10.10.2 </span>Event definitions</h6>
 
   <p class=XXX>...
 
-  <h6 id=websrt><span class=secno>4.8.10.10.3 </span>WebSRT</h6>
+<!-- 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>The <dfn id=attr-media-controls title=attr-media-controls><code>controls</code></dfn>
@@ -56954,7 +57076,7 @@
   <a href=#dom-manipulation-task-source>DOM manipulation task source</a>.</p>
 
 
-  <h5 id=event-definitions><span class=secno>6.5.9.1 </span>Event definitions</h5>
+  <h5 id=event-definitions-0><span class=secno>6.5.9.1 </span>Event definitions</h5>
 
   </div>
 
@@ -67729,7 +67851,7 @@
 
 
 
-  <h3 id=event-definitions-0><span class=secno>10.1 </span>Event definitions</h3>
+  <h3 id=event-definitions-1><span class=secno>10.1 </span>Event definitions</h3>
 
   <p>Messages in <a href=#server-sent-events>server-sent events</a>, <a href=#network>Web
   sockets</a>, <a href=#crossDocumentMessages>cross-document messaging</a>, and
@@ -68945,7 +69067,7 @@
   source</dfn>.</p>
 
 
-  <h5 id=event-definitions-1><span class=secno>10.3.3.1 </span>Event definitions</h5>
+  <h5 id=event-definitions-2><span class=secno>10.3.3.1 </span>Event definitions</h5>
 
   <pre class=idl>interface <dfn id=closeevent>CloseEvent</dfn> : <a href=#event>Event</a> {
   readonly attribute boolean <a href=#dom-closeevent-wasclean title=dom-CloseEvent-wasClean>wasClean</a>;

Modified: index
===================================================================
--- index	2010-05-04 04:21:19 UTC (rev 5070)
+++ index	2010-05-04 07:36:58 UTC (rev 5071)
@@ -539,8 +539,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>
@@ -836,7 +837,7 @@
      <li><a href=#scroll-to-fragid><span class=secno>6.5.8 </span>Navigating to a fragment identifier</a></li>
      <li><a href=#history-traversal><span class=secno>6.5.9 </span>History traversal</a>
       <ol>
-       <li><a href=#event-definitions><span class=secno>6.5.9.1 </span>Event definitions</a></ol></li>
+       <li><a href=#event-definitions-0><span class=secno>6.5.9.1 </span>Event definitions</a></ol></li>
      <li><a href=#unloading-documents><span class=secno>6.5.10 </span>Unloading documents</a>
       <ol>
        <li><a href=#event-definition><span class=secno>6.5.10.1 </span>Event definition</a></ol></li>
@@ -942,7 +943,7 @@
    <li><a href=#editing-apis><span class=secno>8.11 </span>Editing APIs</a></ol></li>
  <li><a href=#comms><span class=secno>9 </span>Communication</a>
   <ol>
-   <li><a href=#event-definitions-0><span class=secno>9.1 </span>Event definitions</a></li>
+   <li><a href=#event-definitions-1><span class=secno>9.1 </span>Event definitions</a></li>
    <li><a href=#crossDocumentMessages><span class=secno>9.2 </span>Cross-document messaging</a>
     <ol>
      <li><a href=#introduction-6><span class=secno>9.2.1 </span>Introduction</a></li>
@@ -23453,6 +23454,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
@@ -23508,8 +23511,12 @@
   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.</p>
 
+  <p class=XXX>domintro for track.track</p>
+
   <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
   name.</p>
@@ -23571,8 +23578,60 @@
            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>
 
+  // 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">(in <a href=#mediacue>MediaCue</a> cue);
+ void <span title=dom-MutableMediaTrack-removeCue>removeCue">(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>
 
@@ -25633,19 +25692,82 @@
 
   <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);
+
+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>;
+
+  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=in-band-timed-tracks><span class=secno>4.8.10.10.2 </span>In-band timed tracks</h6>
+  <h6 id=event-definitions><span class=secno>4.8.10.10.2 </span>Event definitions</h6>
 
   <p class=XXX>...
 
-  <h6 id=websrt><span class=secno>4.8.10.10.3 </span>WebSRT</h6>
+<!-- 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>The <dfn id=attr-media-controls title=attr-media-controls><code>controls</code></dfn>
@@ -56855,7 +56977,7 @@
   <a href=#dom-manipulation-task-source>DOM manipulation task source</a>.</p>
 
 
-  <h5 id=event-definitions><span class=secno>6.5.9.1 </span>Event definitions</h5>
+  <h5 id=event-definitions-0><span class=secno>6.5.9.1 </span>Event definitions</h5>
 
   </div>
 
@@ -65488,7 +65610,7 @@
 
 
 
-  <h3 id=event-definitions-0><span class=secno>9.1 </span>Event definitions</h3>
+  <h3 id=event-definitions-1><span class=secno>9.1 </span>Event definitions</h3>
 
   <p>Messages in <span>server-sent events</span>, <span>Web
   sockets</span>, <a href=#crossDocumentMessages>cross-document messaging</a>, and

Modified: source
===================================================================
--- source	2010-05-04 04:21:19 UTC (rev 5070)
+++ source	2010-05-04 07:36:58 UTC (rev 5071)
@@ -25187,6 +25187,8 @@
            attribute DOMString <span title="dom-track-label">label</span>;
            attribute DOMString <span title="dom-track-src">src</span>;
            attribute DOMString <span title="dom-track-srclang">srclang</span>;
+
+  readonly attribute <span>MediaTrack</span> <span title="dom-track-track">track</span>;
 };</pre>
    </dd>
   </dl>
@@ -25257,8 +25259,12 @@
   language, and whose <code title="attr-track-label">label</code>
   attributes are again both missing or both have the same value.</p>
 
+  <p class="XXX">domintro for track.track</p>
+
   <div class="impl">
 
+  <p class="XXX">track.track</p>
+
   <p>The IDL attributes <dfn
   title="dom-track-kind"><code>kind</code></dfn>, <dfn
   title="dom-track-label"><code>label</code></dfn>, <dfn
@@ -25324,6 +25330,58 @@
            attribute boolean <span title="dom-media-controls">controls</span>;
            attribute float <span title="dom-media-volume">volume</span>;
            attribute boolean <span title="dom-media-muted">muted</span>;
+
+  // 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> {
+  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 <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>();
 };</pre>
 
   <p>The <dfn>media element attributes</dfn>, <code
@@ -27803,10 +27861,73 @@
 
   <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);
+
+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>;
+
+  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>Timed track model</h6>
 
   <p class="XXX">...
 
+  <h6>Event definitions</h6>
+
+  <p class="XXX">...
+
+<!-- XXX
+CueEvent
+ readonly attribute MediaCue cue;
+-->
+
   <h6>In-band timed tracks</h6>
 
   <p class="XXX">...




More information about the Commit-Watchers mailing list