[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