[html5] r5124 - [giow] (0) Captions - Stage 12: Some guidelines for handling non-WebSRT formats.
whatwg at whatwg.org
whatwg at whatwg.org
Wed Jun 30 12:25:35 PDT 2010
Author: ianh
Date: 2010-06-30 12:25:33 -0700 (Wed, 30 Jun 2010)
New Revision: 5124
Modified:
complete.html
index
source
Log:
[giow] (0) Captions - Stage 12: Some guidelines for handling non-WebSRT formats.
Modified: complete.html
===================================================================
--- complete.html 2010-06-29 23:09:47 UTC (rev 5123)
+++ complete.html 2010-06-30 19:25:33 UTC (rev 5124)
@@ -209,7 +209,7 @@
<header class=head id=head><p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG src=/images/logo></a></p>
<hgroup><h1>Web Applications 1.0</h1>
- <h2 class="no-num no-toc">Draft Standard — 29 June 2010</h2>
+ <h2 class="no-num no-toc">Draft Standard — 30 June 2010</h2>
</hgroup><p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
<p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
<!--<p class="impl"><strong>Implementors!</strong> We have a <a href="http://www.whatwg.org/mailing-list#implementors">mailing list</a> for you too!</p>-->
@@ -26238,8 +26238,7 @@
<dt><dfn id=timed-track-cue-text title="timed track cue text">The text of the cue</dfn>
<dd>
<p>The raw text of the cue, and rules for its interpretation,
- allowing the text to be converted to an equivalent fragment of
- HTML.</p>
+ allowing the text to be rendered and converted to a DOM fragment.</p>
</dd>
</dl><p>A <a href=#timed-track-cue>timed track cue</a> is immutable.</p>
@@ -26561,12 +26560,70 @@
<h6 id=guidelines-for-exposing-cues-in-various-formats-as-timed-track-cues><span class=secno>4.8.10.10.4 </span><dfn>Guidelines for exposing cues</dfn> in various formats as
<a href=#timed-track-cue title="timed track cue">timed track cues</a></h6>
- <p class=XXX>...also, how to handle discarding cues that are
- before startTime, for cues that are in-band</p>
+ <p>How a specific format's timed track cues are to be interpreted
+ for the purposes of processing by an HTML user agent is defined by
+ that format. In the absence of such a specification, this section
+ provides some constraints within which implementations can attempt
+ to consistently expose such formats.</p>
- </div>
+ <p>To support the <a href=#timed-track>timed track</a> model of HTML, each unit
+ of timed data is converted to a <a href=#timed-track-cue>timed track cue</a>. Where
+ the mapping of the format's features to the aspects of a <a href=#timed-track-cue>timed
+ track cue</a> as defined in this specification are not defined,
+ implementations must ensure that the mapping is consistent with the
+ definitions of the aspects of a <a href=#timed-track-cue>timed track cue</a> as
+ defined above, as well as with the following constraints:</p>
+ <dl><dt>The <a href=#timed-track-cue-identifier>timed track cue identifier</a>
+ <dd>
+ <p>Should be set to the empty string if the format has no
+ obvious analogue to a per-cue identifier.</p>
+ </dd>
+ <dt>The <a href=#timed-track-cue-pause-on-exit-flag>timed track cue pause-on-exit flag</a>
+ <dd>
+ <p>Should be set to false.</p>
+ </dd>
+
+ <dt>The <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a>
+ <dd>
+ <p>Should be set to <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing
+ direction">horizontal</a> if the concept of writing direction
+ doesn't really apply (e.g. the cue consists of a bitmap
+ image).</p>
+ </dd>
+
+ <dt>The <a href=#timed-track-cue-snap-to-lines-flag>timed track cue snap-to-lines flag</a>
+ <dd>
+ <p>Should be set to false unless the format uses a rendering and
+ positioning model for cues that is largely consistent with the
+ <a href=#websrt-cue-text-parsing-and-rendering-rules>WebSRT cue text parsing and rendering rules</a>.</p>
+ </dd>
+
+ <dt>The <a href=#timed-track-cue-line-position>timed track cue line position</a>
+ <dt>The <a href=#timed-track-cue-text-position>timed track cue text position</a>
+ <dt>The <a href=#timed-track-cue-size>timed track cue size</a>
+ <dt>The <a href=#timed-track-cue-alignment>timed track cue alignment</a>
+ </dt></dt></dt><dd>
+ <p>If the the format uses a rendering and positioning model for
+ cues that can be largely simulated using the <a href=#websrt-cue-text-parsing-and-rendering-rules>WebSRT cue text
+ parsing and rendering rules</a>, then these should be set to
+ the values that would give the same effect for <a href=#websrt>WebSRT</a>
+ cues. Otherwise, they should be set to zero.</p>
+ </dd>
+
+ <dt>The <a href=#timed-track-cue-voice-identifier>timed track cue voice identifier</a>
+ <dd>
+ <p>Should be set to the empty string if the format has no
+ obvious analogue to cue voices. The <a href=#timed-track-cue-voice-identifier>timed track cue voice
+ identifier</a> may be set to strings that cannot be expressed
+ using <a href=#websrt>WebSRT</a>, if the format supports voices that do
+ not correspond to the voices used by WebSRT.</p>
+ </dd>
+
+ </dl></div>
+
+
<h6 id=timed-track-api><span class=secno>4.8.10.10.5 </span>Timed track API</h6>
<!--
@@ -26641,6 +26698,11 @@
Make sure that .cues and .activeCues doesn't change while script is
running, except for addCue/removeCue and the removal of all cues in
the face of a dynamic track.src change.
+
+ <p>User agents must not expose cues whose start and end times are
+ entirely prior to the <span>media resource</span>'s <span>earliest
+ possible position</span>.</p>
+
-->
</div>
Modified: index
===================================================================
--- index 2010-06-29 23:09:47 UTC (rev 5123)
+++ index 2010-06-30 19:25:33 UTC (rev 5124)
@@ -213,7 +213,7 @@
<header class=head id=head><p><a class=logo href=http://www.whatwg.org/ rel=home><img alt=WHATWG src=/images/logo></a></p>
<hgroup><h1>HTML5 (including next generation additions still in development)</h1>
- <h2 class="no-num no-toc">Draft Standard — 29 June 2010</h2>
+ <h2 class="no-num no-toc">Draft Standard — 30 June 2010</h2>
</hgroup><p>You can take part in this work. <a href=http://www.whatwg.org/mailing-list>Join the working group's discussion list.</a></p>
<p><strong>Web designers!</strong> We have a <a href=http://blog.whatwg.org/faq/>FAQ</a>, a <a href=http://forums.whatwg.org/>forum</a>, and a <a href=http://www.whatwg.org/mailing-list#help>help mailing list</a> for you!</p>
<!--<p class="impl"><strong>Implementors!</strong> We have a <a href="http://www.whatwg.org/mailing-list#implementors">mailing list</a> for you too!</p>-->
@@ -26165,8 +26165,7 @@
<dt><dfn id=timed-track-cue-text title="timed track cue text">The text of the cue</dfn>
<dd>
<p>The raw text of the cue, and rules for its interpretation,
- allowing the text to be converted to an equivalent fragment of
- HTML.</p>
+ allowing the text to be rendered and converted to a DOM fragment.</p>
</dd>
</dl><p>A <a href=#timed-track-cue>timed track cue</a> is immutable.</p>
@@ -26488,12 +26487,70 @@
<h6 id=guidelines-for-exposing-cues-in-various-formats-as-timed-track-cues><span class=secno>4.8.10.10.4 </span><dfn>Guidelines for exposing cues</dfn> in various formats as
<a href=#timed-track-cue title="timed track cue">timed track cues</a></h6>
- <p class=XXX>...also, how to handle discarding cues that are
- before startTime, for cues that are in-band</p>
+ <p>How a specific format's timed track cues are to be interpreted
+ for the purposes of processing by an HTML user agent is defined by
+ that format. In the absence of such a specification, this section
+ provides some constraints within which implementations can attempt
+ to consistently expose such formats.</p>
- </div>
+ <p>To support the <a href=#timed-track>timed track</a> model of HTML, each unit
+ of timed data is converted to a <a href=#timed-track-cue>timed track cue</a>. Where
+ the mapping of the format's features to the aspects of a <a href=#timed-track-cue>timed
+ track cue</a> as defined in this specification are not defined,
+ implementations must ensure that the mapping is consistent with the
+ definitions of the aspects of a <a href=#timed-track-cue>timed track cue</a> as
+ defined above, as well as with the following constraints:</p>
+ <dl><dt>The <a href=#timed-track-cue-identifier>timed track cue identifier</a>
+ <dd>
+ <p>Should be set to the empty string if the format has no
+ obvious analogue to a per-cue identifier.</p>
+ </dd>
+ <dt>The <a href=#timed-track-cue-pause-on-exit-flag>timed track cue pause-on-exit flag</a>
+ <dd>
+ <p>Should be set to false.</p>
+ </dd>
+
+ <dt>The <a href=#timed-track-cue-writing-direction>timed track cue writing direction</a>
+ <dd>
+ <p>Should be set to <a href=#timed-track-cue-horizontal-writing-direction title="timed track cue horizontal writing
+ direction">horizontal</a> if the concept of writing direction
+ doesn't really apply (e.g. the cue consists of a bitmap
+ image).</p>
+ </dd>
+
+ <dt>The <a href=#timed-track-cue-snap-to-lines-flag>timed track cue snap-to-lines flag</a>
+ <dd>
+ <p>Should be set to false unless the format uses a rendering and
+ positioning model for cues that is largely consistent with the
+ <a href=#websrt-cue-text-parsing-and-rendering-rules>WebSRT cue text parsing and rendering rules</a>.</p>
+ </dd>
+
+ <dt>The <a href=#timed-track-cue-line-position>timed track cue line position</a>
+ <dt>The <a href=#timed-track-cue-text-position>timed track cue text position</a>
+ <dt>The <a href=#timed-track-cue-size>timed track cue size</a>
+ <dt>The <a href=#timed-track-cue-alignment>timed track cue alignment</a>
+ </dt></dt></dt><dd>
+ <p>If the the format uses a rendering and positioning model for
+ cues that can be largely simulated using the <a href=#websrt-cue-text-parsing-and-rendering-rules>WebSRT cue text
+ parsing and rendering rules</a>, then these should be set to
+ the values that would give the same effect for <a href=#websrt>WebSRT</a>
+ cues. Otherwise, they should be set to zero.</p>
+ </dd>
+
+ <dt>The <a href=#timed-track-cue-voice-identifier>timed track cue voice identifier</a>
+ <dd>
+ <p>Should be set to the empty string if the format has no
+ obvious analogue to cue voices. The <a href=#timed-track-cue-voice-identifier>timed track cue voice
+ identifier</a> may be set to strings that cannot be expressed
+ using <a href=#websrt>WebSRT</a>, if the format supports voices that do
+ not correspond to the voices used by WebSRT.</p>
+ </dd>
+
+ </dl></div>
+
+
<h6 id=timed-track-api><span class=secno>4.8.10.10.5 </span>Timed track API</h6>
<!--
@@ -26568,6 +26625,11 @@
Make sure that .cues and .activeCues doesn't change while script is
running, except for addCue/removeCue and the removal of all cues in
the face of a dynamic track.src change.
+
+ <p>User agents must not expose cues whose start and end times are
+ entirely prior to the <span>media resource</span>'s <span>earliest
+ possible position</span>.</p>
+
-->
</div>
Modified: source
===================================================================
--- source 2010-06-29 23:09:47 UTC (rev 5123)
+++ source 2010-06-30 19:25:33 UTC (rev 5124)
@@ -28383,8 +28383,7 @@
<dt><dfn title="timed track cue text">The text of the cue</dfn>
<dd>
<p>The raw text of the cue, and rules for its interpretation,
- allowing the text to be converted to an equivalent fragment of
- HTML.</p>
+ allowing the text to be rendered and converted to a DOM fragment.</p>
</dd>
</dl>
@@ -28759,9 +28758,71 @@
<h6><dfn>Guidelines for exposing cues</dfn> in various formats as
<span title="timed track cue">timed track cues</span></h6>
- <p class="XXX">...also, how to handle discarding cues that are
- before startTime, for cues that are in-band</p>
+ <p>How a specific format's timed track cues are to be interpreted
+ for the purposes of processing by an HTML user agent is defined by
+ that format. In the absence of such a specification, this section
+ provides some constraints within which implementations can attempt
+ to consistently expose such formats.</p>
+ <p>To support the <span>timed track</span> model of HTML, each unit
+ of timed data is converted to a <span>timed track cue</span>. Where
+ the mapping of the format's features to the aspects of a <span>timed
+ track cue</span> as defined in this specification are not defined,
+ implementations must ensure that the mapping is consistent with the
+ definitions of the aspects of a <span>timed track cue</span> as
+ defined above, as well as with the following constraints:</p>
+
+ <dl>
+
+ <dt>The <span>timed track cue identifier</span>
+ <dd>
+ <p>Should be set to the empty string if the format has no
+ obvious analogue to a per-cue identifier.</p>
+ </dd>
+
+ <dt>The <span>timed track cue pause-on-exit flag</span>
+ <dd>
+ <p>Should be set to false.</p>
+ </dd>
+
+ <dt>The <span>timed track cue writing direction</span>
+ <dd>
+ <p>Should be set to <span title="timed track cue horizontal writing
+ direction">horizontal</span> if the concept of writing direction
+ doesn't really apply (e.g. the cue consists of a bitmap
+ image).</p>
+ </dd>
+
+ <dt>The <span>timed track cue snap-to-lines flag</span>
+ <dd>
+ <p>Should be set to false unless the format uses a rendering and
+ positioning model for cues that is largely consistent with the
+ <span>WebSRT cue text parsing and rendering rules</span>.</p>
+ </dd>
+
+ <dt>The <span>timed track cue line position</span>
+ <dt>The <span>timed track cue text position</span>
+ <dt>The <span>timed track cue size</span>
+ <dt>The <span>timed track cue alignment</span>
+ <dd>
+ <p>If the the format uses a rendering and positioning model for
+ cues that can be largely simulated using the <span>WebSRT cue text
+ parsing and rendering rules</span>, then these should be set to
+ the values that would give the same effect for <span>WebSRT</span>
+ cues. Otherwise, they should be set to zero.</p>
+ </dd>
+
+ <dt>The <span>timed track cue voice identifier</span>
+ <dd>
+ <p>Should be set to the empty string if the format has no
+ obvious analogue to cue voices. The <span>timed track cue voice
+ identifier</span> may be set to strings that cannot be expressed
+ using <span>WebSRT</span>, if the format supports voices that do
+ not correspond to the voices used by WebSRT.</p>
+ </dd>
+
+ </dl>
+
</div>
@@ -28839,6 +28900,11 @@
Make sure that .cues and .activeCues doesn't change while script is
running, except for addCue/removeCue and the removal of all cues in
the face of a dynamic track.src change.
+
+ <p>User agents must not expose cues whose start and end times are
+ entirely prior to the <span>media resource</span>'s <span>earliest
+ possible position</span>.</p>
+
-->
</div>
More information about the Commit-Watchers
mailing list