Skip to content

Commit

Permalink
[giow] (0) Captions - Stage 2: the IDL additions.
Browse files Browse the repository at this point in the history 
git-svn-id: http://svn.whatwg.org/webapps@5071 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information
@Hixie
Hixie committed May 4, 2010
1 parent 2cb1f5c commit 9ed60b7
Show file tree
Hide file tree
Showing 3 changed files with 385 additions and 20 deletions.
144 changes: 133 additions & 11 deletions complete.html
View file
Expand Up @@ -530,8 +530,9 @@ <h2 class="no-num no-toc" id=contents>Table of contents</h2>
<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>
Expand Down Expand Up @@ -827,7 +828,7 @@ <h2 class="no-num no-toc" id=contents>Table of contents</h2>
<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>
Expand Down Expand Up @@ -971,7 +972,7 @@ <h2 class="no-num no-toc" id=contents>Table of contents</h2>
<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>
Expand All @@ -992,7 +993,7 @@ <h2 class="no-num no-toc" id=contents>Table of contents</h2>
<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
Expand Down Expand Up @@ -23552,6 +23553,8 @@ <h4 id=the-track-element><span class=secno>4.8.9 </span>The <dfn><code>track</co
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
Expand Down Expand Up @@ -23607,8 +23610,12 @@ <h4 id=the-track-element><span class=secno>4.8.9 </span>The <dfn><code>track</co
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>
Expand Down Expand Up @@ -23670,7 +23677,59 @@ <h4 id=media-elements><span class=secno>4.8.10 </span>Media elements</h4>
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"&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>
Expand Down Expand Up @@ -25732,15 +25791,78 @@ <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);

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>...

<!-- 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.3 </span>WebSRT</h6>
<h6 id=websrt><span class=secno>4.8.10.10.4 </span>WebSRT</h6>

<p class=XXX>...

Expand Down Expand Up @@ -56954,7 +57076,7 @@ <h4 id=history-traversal><span class=secno>6.5.9 </span>History traversal</h4> <
<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>

Expand Down Expand Up @@ -67729,7 +67851,7 @@ <h2 id=comms><span class=secno>10 </span>Communication</h2>



<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
Expand Down Expand Up @@ -68945,7 +69067,7 @@ <h4 id=the-websocket-interface><span class=secno>10.3.2 </span>The <code><a href
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>;
Expand Down

0 comments on commit 9ed60b7

Please sign in to comment.