Skip to content
Permalink
Browse files

[giow] (0) Captions - Stage 12: Some guidelines for handling non-WebS…

…RT formats.

git-svn-id: http://svn.whatwg.org/webapps@5124 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information...
Hixie committed Jun 30, 2010
1 parent c1748de commit 6193721ff93312dbbf7ca2562a58089942d79a08
Showing with 206 additions and 16 deletions.
  1. +68 −6 complete.html
  2. +68 −6 index
  3. +70 −4 source

<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 &mdash; 29 June 2010</h2>
<h2 class="no-num no-toc">Draft Standard &mdash; 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>-->
<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>
<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>
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>
74 index
@@ -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 &mdash; 29 June 2010</h2>
<h2 class="no-num no-toc">Draft Standard &mdash; 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>-->
<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>
<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>
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>
74 source
<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>
<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>

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>

0 comments on commit 6193721

Please sign in to comment.
You can’t perform that action at this time.