- From: CVS User pjgenste <cvsmail@w3.org>
- Date: Tue, 28 Oct 2014 08:58:19 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/webvtt In directory roscoe:/tmp/cvs-serv25716 Modified Files: webvtt-staged-snapshot.html Log Message: Sync WebVTT with Git commit 325ad86752a0fa9f4f4b8ed65d0dc8f9d8a059b1 --- /sources/public/html5/webvtt/webvtt-staged-snapshot.html 2014/10/23 19:08:00 1.9 +++ /sources/public/html5/webvtt/webvtt-staged-snapshot.html 2014/10/28 08:58:19 1.10 @@ -3,7 +3,7 @@ <head> <title>WebVTT: The Web Video Text Tracks Format</title> <meta charset="utf-8"> - <meta name="revision" content="292135ff7a89d6c01c6d107b6536a8f496ee528b"> + <meta name="revision" content="325ad86752a0fa9f4f4b8ed65d0dc8f9d8a059b1"> @@ -347,11 +347,11 @@ </p> <h1 class="title p-name" id="title">WebVTT: The Web Video Text Tracks Format</h1> - <h2 id="w3c-first-public-working-draft-23-october-2014"><abbr title="World Wide Web Consortium">W3C</abbr> First Public Working Draft <time class="dt-published" datetime="2014-10-23">23 October 2014</time></h2> + <h2 id="w3c-first-public-working-draft-28-october-2014"><abbr title="World Wide Web Consortium">W3C</abbr> First Public Working Draft <time class="dt-published" datetime="2014-10-28">28 October 2014</time></h2> <dl> <dt>This version:</dt> - <dd><a class="u-url" href="http://www.w3.org/TR/2014/WD-webvtt1-20141023/">http://www.w3.org/TR/2014/WD-webvtt1-20141023/</a></dd> + <dd><a class="u-url" href="http://www.w3.org/TR/2014/WD-webvtt1-20141028/">http://www.w3.org/TR/2014/WD-webvtt1-20141028/</a></dd> <dt>Latest published version:</dt> <dd><a href="http://www.w3.org/TR/webvtt1/">http://www.w3.org/TR/webvtt1/</a></dd> @@ -423,8 +423,8 @@ </div> <div class="snapshot" hidden=""> <p>This is a Recommendation Track snapshot. For the latest updates, possibly including important - bug fixes, please see the <a href="http://dev.w3.org/html5/webvtt/">Living Standard</a>. - <button>Dismiss</button></p> + bug fixes, please see the <a href="http://dev.w3.org/html5/webvtt/">Draft Community Group + Report</a>. <button>Dismiss</button></p> </div> <section id="abstract" class="introductory"><h2 role="heading" id="h2_abstract">Abstract</h2> @@ -448,7 +448,8 @@ <p>Work on this specification is being undertaken both in the <a href="http://www.w3.org/community/texttracks/">Web Media Text Tracks Community Group</a> as well as in the <a href="http://www.w3.org/AudioVideo/TT/"><abbr title="World Wide Web Consortium">W3C</abbr> Timed Text Working Group</a>. The latter group works towards a <abbr title="World Wide Web Consortium">W3C</abbr> Recommendation for reference purposes with interoperability - requirements, while the earlier is as a Living Standard that continues to evolve.</p> + requirements, while the earlier is as a Draft Community Group Report that continues to + evolve.</p> <p> This document was published by the <a href="http://www.w3.org/AudioVideo/TT/"><abbr title="World Wide Web Consortium">W3C</abbr> Timed Text Working Group</a> as a First Public Working Draft. @@ -509,7 +510,7 @@ -</section><section id="toc"><h2 class="introductory" role="heading" id="h2_toc">Table of Contents</h2><ul class="toc" role="directory" id="respecContents"><li class="tocline"><a href="#introduction" class="tocxref"><span class="secno">1. </span>Introduction</a><ul class="toc"><li class="tocline"><a href="#cues-with-multiple-lines" class="tocxref"><span class="secno">1.1 </span>Cues with multiple lines</a></li><li class="tocline"><a href="#comments" class="tocxref"><span class="secno">1.2 </span>Comments</a></li><li class="tocline"><a href="#other-features" class="tocxref"><span class="secno">1.3 </span>Other features</a></li></ul></li><li class="tocline"><a href="#conformance" class="tocxref"><span class="secno">2. </span>Conformance</a><ul class="toc"><li class="tocline"><a href="#conformance-for-authors" class="tocxref"><span class="secno">2.1 </span>Conformance for authors</a></li><li class="tocline"><a href="#document-conformance" class="tocxref"><span class="secno">2.2 </span>Document conformance</a><li><li class="tocline"><a href="#dependencies" class="tocxref"><span class="secno">2.3 </span>Dependencies</a></li></ul></li><li class="tocline"><a href="#data-model" class="tocxref"><span class="secno">3. </span>Data model</a><ul class="toc"><li class="tocline"><a href="#text-track-cues" class="tocxref"><span class="secno">3.1 </span>Text track cues</a></li><li class="tocline"><a href="#text-track-regions" class="tocxref"><span class="secno">3.2 </span>Text track regions</a></li></ul></li><li class="tocline"><a href="#syntax" class="tocxref"><span class="secno">4. </span>Syntax</a><ul class="toc"><li class="tocline"><a href="#webvtt-file-structure" class="tocxref"><span class="secno">4.1 </span>WebVTT file structure</a></li><li class="tocline"><a href="#webvtt-comments" class="tocxref"><span class="secno">4.2 </span>WebVTT comments</a></li><li class="tocline"><a href="#types-of-webvtt-cue-payload" class="tocxref"><span class="secno">4.3 </span>Types of WebVTT cue payload</a><ul class="toc"><li class="toclie"><a href="#webvtt-metadata-text" class="tocxref"><span class="secno">4.3.1 </span>WebVTT metadata text</a></li><li class="tocline"><a href="#webvtt-cue-text" class="tocxref"><span class="secno">4.3.2 </span>WebVTT cue text</a></li></ul></li><li class="tocline"><a href="#webvtt-cue-settings" class="tocxref"><span class="secno">4.4 </span>WebVTT cue settings</a><ul class="toc"><li class="tocline"><a href="#webvtt-region-definition" class="tocxref"><span class="secno">4.4.1 </span>WebVTT region definition</a></li><li class="tocline"><a href="#webvtt-cue-settings-1" class="tocxref"><span class="secno">4.4.2 </span>WebVTT cue settings</a></li></ul></li><li class="tocline"><a href="#properties-of-cue-sequences" class="tocxref"><span class="secno">4.5 </span>Properties of cue sequences</a><ul class="toc"><li class="tocline"><a href="#webvtt-file-using-only-nested-cues" class="tocxref"><span class="secno">4.5.1 </span>WebVTT file using only nested cues</a></li></ul></li><li class="tocline"><a href="#types-of-webvt-files" class="tocxref"><span class="secno">4.6 </span>Types of WebVTT files</a><ul class="toc"><li class="tocline"><a href="#webvtt-file-using-metadata-content" class="tocxref"><span class="secno">4.6.1 </span>WebVTT file using metadata content</a></li><li class="tocline"><a href="#webvtt-file-using-chapter-title-text" class="tocxref"><span class="secno">4.6.2 </span>WebVTT file using chapter title text</a></li><li class="tocline"><a href="#webvtt-file-using-cue-text" class="tocxref"><span class="secno">4.6.3 </span>WebVTT file using cue text</a></li></ul></li></ul></li><li class="tocline"><a href="#parsing" class="tocxref"><span class="secno">5. </span>Parsing</a><ul class="toc"><li class="tocline"><a href="#webvtt-file-parsing" class="tocxref"><span class="secno">5.1 </span>WebVTT file parsing</a></li><li class="tocline"><a href="#webvtt-region-settings-parsing" class="tocxref"><span class="secno">5.2 </span>WebVTT region settings parsing</a></li><li class="tocline"><a href="#webvtt-cue-timings-and-settngs-parsing" class="tocxref"><span class="secno">5.3 </span>WebVTT cue timings and settings parsing</a></li><li class="tocline"><a href="#webvtt-cue-text-parsing-rules" class="tocxref"><span class="secno">5.4 </span><span>WebVTT cue text parsing rules</span></a></li><li class="tocline"><a href="#webvtt-cue-text-dom-construction-rules" class="tocxref"><span class="secno">5.5 </span><span>WebVTT cue text DOM construction rules</span></a></li></ul></li><li class="tocline"><a href="#rendering" class="tocxref"><span class="secno">6. </span>Rendering</a><ul class="toc"><li class="tocline"><a href="#cues-in-isolation" class="tocxref"><span class="secno">6.1 </span>Cues in isolation</a></li><li class="tocline"><a href="#cues-with-video" class="tocxref"><span class="secno">6.2 </span>Cues with video</a><ul class="toc"><li class="tocline"><a href="#processing-model" class="tocxref"><span class="secno">6.2.1 </span>Processing model</a></li><li class="tocline"><a href="#applying-css-properties-to-webvtt-node-objects" cass="tocxref"><span class="secno">6.2.2 </span>Applying CSS properties to <span title="WebVTT Node Object" class="formerLink">WebVTT Node Objects</span></a></li><li class="tocline"><a href="#css-extensions" class="tocxref"><span class="secno">6.2.3 </span>CSS extensions</a><ul class="toc"><li class="tocline"><a href="#the-cue-pseudo-element" class="tocxref"><span class="secno">6.2.3.1 </span>The '::cue' pseudo-element</a></li><li class="tocline"><a href="#the-past-and-future-pseudo-classes" class="tocxref"><span class="secno">6.2.3.2 </span>The ':past' and ':future' pseudo-classes</a></li><li class="tocline"><a href="#the-cue-region-pseudo-element" class="tocxref"><span class="secno">6.2.3.3 </span>The '::cue-region' pseudo-element</a></li></ul></li></ul></li></ul></li><li class="tocline"><a href="#api" class="tocxref"><span class="secno">7. </span>API</a><ul class="toc"><li class="tocline"><a href="#the-vttcue-interface" class="tocxref"><span class="secno">7.1 </span>The <span class="formerLink"><code>VTTCe</code></span> interface</a></li><li class="tocline"><a href="#the-vttregion-interface" class="tocxref"><span class="secno">7.2 </span>The <span class="formerLink"><code>VTTRegion</code></span> interface</a></li></ul></li><li class="tocline"><a href="#iana-considerations" class="tocxref"><span class="secno">8. </span>IANA considerations</a><ul class="toc"><li class="tocline"><a href="#text-vtt" class="tocxref"><span class="secno">8.1 </span><span><code>text/vtt</code></span></a></li></ul></li><li class="tocline"><a href="#acknowledgements" class="tocxref"><span class="secno">9. </span>Acknowledgements</a></li><li class="tocline"><a href="#references" class="tocxref"><span class="secno">A. </span>References</a><ul class="toc"><li class="tocline"><a href="#normative-references" class="tocxref"><span class="secno">A.1 </span>Normative references</a></li><li class="tocline"><a href="#informative-references" class="tocxref"><span class="secno">A.2 </span>Informative references</a></li></ul></li></ul></section> +</section><section id="toc"><h2 class="introductory" role="heading" id="h2_toc">Table of Contents</h2><ul class="toc" role="directory" id="respecContents"><li class="tocline"><a href="#introduction" class="tocxref"><span class="secno">1. </span>Introduction</a><ul class="toc"><li class="tocline"><a href="#cues-with-multiple-lines" class="tocxref"><span class="secno">1.1 </span>Cues with multiple lines</a></li><li class="tocline"><a href="#comments" class="tocxref"><span class="secno">1.2 </span>Comments</a></li><li class="tocline"><a href="#other-features" class="tocxref"><span class="secno">1.3 </span>Other features</a></li></ul></li><li class="tocline"><a href="#conformance" class="tocxref"><span class="secno">2. </span>Conformance</a><ul class="toc"><li class="tocline"><a href="#conformance-for-authors" class="tocxref"><span class="secno">2.1 </span>Conformance for authors</a></li><li class="tocline"><a href="#document-conformance" class="tocxref"><span class="secno">2.2 </span>Document conformance</a><li><li class="tocline"><a href="#dependencies" class="tocxref"><span class="secno">2.3 </span>Dependencies</a></li></ul></li><li class="tocline"><a href="#data-model" class="tocxref"><span class="secno">3. </span>Data model</a><ul class="toc"><li class="tocline"><a href="#text-track-cues" class="tocxref"><span class="secno">3.1 </span>Text track cues</a></li><li class="tocline"><a href="#text-track-regions" class="tocxref"><span class="secno">3.2 </span>Text track regions</a></li></ul></li><li class="tocline"><a href="#syntax" class="tocxref"><span class="secno">4. </span>Syntax</a><ul class="toc"><li class="tocline"><a href="#webvtt-file-structure" class="tocxref"><span class="secno">4.1 </span>WebVTT file structure</a></li><li class="tocline"><a href="#webvtt-comments" class="tocxref"><span class="secno">4.2 </span>WebVTT comments</a></li><li class="tocline"><a href="#types-of-webvtt-cue-payload" class="tocxref"><span class="secno">4.3 </span>Types of WebVTT cue payload</a><ul class="toc"><li class="toclie"><a href="#webvtt-metadata-text" class="tocxref"><span class="secno">4.3.1 </span>WebVTT metadata text</a></li><li class="tocline"><a href="#webvtt-cue-text" class="tocxref"><span class="secno">4.3.2 </span>WebVTT cue text</a></li></ul></li><li class="tocline"><a href="#webvtt-region-definition" class="tocxref"><span class="secno">4.4 </span>WebVTT region definition</a></li><li class="tocline"><a href="#webvtt-cue-settings" class="tocxref"><span class="secno">4.5 </span>WebVTT cue settings</a></li><li class="tocline"><a href="#properties-of-cue-sequences" class="tocxref"><span class="secno">4.6 </span>Properties of cue sequences</a><ul class="toc"><li class="tocline"><a href="#webvtt-file-using-only-nested-cues" class="tocxref"><span class="secno">4.6.1 </span>WebVTT file using only nested cues</a></li></ul></li><li class="tocline"><a href="#types-of-webvtt-files" class="tocxref"><span class="secno">4.7 </span>Types of WebVTT files</a><ul class="toc"><li class="tocline"><a href="#webvtt-file-using-metadat-content" class="tocxref"><span class="secno">4.7.1 </span>WebVTT file using metadata content</a></li><li class="tocline"><a href="#webvtt-file-using-chapter-title-text" class="tocxref"><span class="secno">4.7.2 </span>WebVTT file using chapter title text</a></li><li class="tocline"><a href="#webvtt-file-using-cue-text" class="tocxref"><span class="secno">4.7.3 </span>WebVTT file using cue text</a></li></ul></li></ul></li><li class="tocline"><a href="#parsing" class="tocxref"><span class="secno">5. </span>Parsing</a><ul class="toc"><li class="tocline"><a href="#webvtt-file-parsing" class="tocxref"><span class="secno">5.1 </span>WebVTT file parsing</a></li><li class="tocline"><a href="#webvtt-region-settings-parsing" class="tocxref"><span class="secno">5.2 </span>WebVTT region settings parsing</a></li><li class="tocline"><a href="#webvtt-cue-timings-and-settings-parsing" class="tocxref"><span class="secno">5.3 </span>WebVTT cue timings and settings parsing</a></li><li class="tocline"><a href="#webvtt-cue-tex-parsing-rules" class="tocxref"><span class="secno">5.4 </span><span>WebVTT cue text parsing rules</span></a></li><li class="tocline"><a href="#webvtt-cue-text-dom-construction-rules" class="tocxref"><span class="secno">5.5 </span><span>WebVTT cue text DOM construction rules</span></a></li></ul></li><li class="tocline"><a href="#rendering" class="tocxref"><span class="secno">6. </span>Rendering</a><ul class="toc"><li class="tocline"><a href="#cues-in-isolation" class="tocxref"><span class="secno">6.1 </span>Cues in isolation</a></li><li class="tocline"><a href="#cues-with-video" class="tocxref"><span class="secno">6.2 </span>Cues with video</a><ul class="toc"><li class="tocline"><a href="#processing-model" class="tocxref"><span class="secno">6.2.1 </span>Processing model</a></li><li class="tocline"><a href="#applying-css-properties-to-webvtt-node-objects" class="tocxref"><span class="secno">6.2.2 </span>Applying CSS properties to <span title="WebVTT Node Object" class="formerLink">WebVTT Node Objects</span>/a></li><li class="tocline"><a href="#css-extensions" class="tocxref"><span class="secno">6.2.3 </span>CSS extensions</a><ul class="toc"><li class="tocline"><a href="#the-cue-pseudo-element" class="tocxref"><span class="secno">6.2.3.1 </span>The '::cue' pseudo-element</a></li><li class="tocline"><a href="#the-past-and-future-pseudo-classes" class="tocxref"><span class="secno">6.2.3.2 </span>The ':past' and ':future' pseudo-classes</a></li><li class="tocline"><a href="#the-cue-region-pseudo-element" class="tocxref"><span class="secno">6.2.3.3 </span>The '::cue-region' pseudo-element</a></li></ul></li></ul></li></ul></li><li class="tocline"><a href="#api" class="tocxref"><span class="secno">7. </span>API</a><ul class="toc"><li class="tocline"><a href="#the-vttcue-interface" class="tocxref"><span class="secno">7.1 </span>The <span class="formerLink"><code>VTTCue</code></span> interface</a></li><li class="tocline"><a href="#the-vttregion-interface" class="tocxref"><span class="secno">7.2 </span>The <span class=formerLink"><code>VTTRegion</code></span> interface</a></li></ul></li><li class="tocline"><a href="#iana-considerations" class="tocxref"><span class="secno">8. </span>IANA considerations</a><ul class="toc"><li class="tocline"><a href="#text-vtt" class="tocxref"><span class="secno">8.1 </span><span><code>text/vtt</code></span></a></li></ul></li><li class="tocline"><a href="#acknowledgements" class="tocxref"><span class="secno">9. </span>Acknowledgements</a></li><li class="tocline"><a href="#references" class="tocxref"><span class="secno">A. </span>References</a><ul class="toc"><li class="tocline"><a href="#normative-references" class="tocxref"><span class="secno">A.1 </span>Normative references</a></li><li class="tocline"><a href="#informative-references" class="tocxref"><span class="secno">A.2 </span>Informative references</a></li></ul></li></ul></section> @@ -1844,315 +1845,311 @@ </section><!-- end cue payload types --> - <section id="webvtt-cue-settings"> - <h3 role="heading" id="h3_webvtt-cue-settings"><span class="secno">4.4 </span>WebVTT cue settings</h3> - - <section id="webvtt-region-definition"> - <h4 role="heading" id="h4_webvtt-region-definition"><span class="secno">4.4.1 </span>WebVTT region definition</h4> + <section id="webvtt-region-definition"> + <h3 role="heading" id="h3_webvtt-region-definition"><span class="secno">4.4 </span>WebVTT region definition</h3> - <p>A <a href="#dfn-webvtt-cue-settings-list" class="internalDFN">WebVTT cue settings list</a> may contain a reference to a <a title="text track - region" href="#dfn-text-track-region" class="internalDFN">text track region</a>. To define a region, a <a href="#dfn-webvtt-region-metadata-header" class="internalDFN">WebVTT region metadata header</a> is - specified.</p> + <p>A <a href="#dfn-webvtt-cue-settings-list" class="internalDFN">WebVTT cue settings list</a> may contain a reference to a <a title="text track + region" href="#dfn-text-track-region" class="internalDFN">text track region</a>. To define a region, a <a href="#dfn-webvtt-region-metadata-header" class="internalDFN">WebVTT region metadata header</a> is + specified.</p> - <p>A <dfn id="dfn-webvtt-region-metadata-header">WebVTT region metadata header</dfn> is a special kind of <a href="#dfn-webvtt-metadata-header" class="internalDFN">WebVTT metadata - header</a> where both of the following apply:</p> + <p>A <dfn id="dfn-webvtt-region-metadata-header">WebVTT region metadata header</dfn> is a special kind of <a href="#dfn-webvtt-metadata-header" class="internalDFN">WebVTT metadata header</a> + where both of the following apply:</p> - <ul> - <li>The <a href="#dfn-webvtt-metadata-header-name" class="internalDFN">WebVTT metadata header name</a> is the string "<code>Region</code>".</li> - <li>The <a href="#dfn-webvtt-metadata-header-value" class="internalDFN">WebVTT metadata header value</a> is a <a href="#dfn-webvtt-region-setting-list" class="internalDFN">WebVTT region setting list</a>.</li> - </ul> + <ul> + <li>The <a href="#dfn-webvtt-metadata-header-name" class="internalDFN">WebVTT metadata header name</a> is the string "<code>Region</code>".</li> + <li>The <a href="#dfn-webvtt-metadata-header-value" class="internalDFN">WebVTT metadata header value</a> is a <a href="#dfn-webvtt-region-setting-list" class="internalDFN">WebVTT region setting list</a>.</li> + </ul> - <p>A <dfn id="dfn-webvtt-region">WebVTT region</dfn> represents its <a title="WebVTT region setting list" href="#dfn-webvtt-region-setting-list" class="internalDFN">WebVTT - region settings</a>.</p> + <p>A <dfn id="dfn-webvtt-region">WebVTT region</dfn> represents its <a title="WebVTT region setting list" href="#dfn-webvtt-region-setting-list" class="internalDFN">WebVTT region + settings</a>.</p> - <p>The <dfn id="dfn-webvtt-region-setting-list">WebVTT region setting list</dfn> of a <a href="#dfn-webvtt-region-metadata-header" class="internalDFN">WebVTT region metadata header</a> consists - of zero or more of the following components, in any order, separated from each other by one or - more U+0020 SPACE characters or U+0009 CHARACTER TABULATION (tab) characters. Each component - must not be included more than once per <a href="#dfn-webvtt-region-setting-list" class="internalDFN">WebVTT region setting list</a> string.</p> + <p>The <dfn id="dfn-webvtt-region-setting-list">WebVTT region setting list</dfn> of a <a href="#dfn-webvtt-region-metadata-header" class="internalDFN">WebVTT region metadata header</a> consists + of zero or more of the following components, in any order, separated from each other by one or + more U+0020 SPACE characters or U+0009 CHARACTER TABULATION (tab) characters. Each component + must not be included more than once per <a href="#dfn-webvtt-region-setting-list" class="internalDFN">WebVTT region setting list</a> string.</p> - <ul> - <li>A <a href="#dfn-webvtt-region-identifier-setting" class="internalDFN">WebVTT region identifier setting</a>.</li> - <li>A <a href="#dfn-webvtt-region-width-setting" class="internalDFN">WebVTT region width setting</a>.</li> - <li>A <a href="#dfn-webvtt-region-lines-setting" class="internalDFN">WebVTT region lines setting</a>.</li> - <li>A <a href="#dfn-webvtt-region-anchor-setting" class="internalDFN">WebVTT region anchor setting</a>.</li> - <li>A <a href="#dfn-webvtt-region-viewport-anchor-setting" class="internalDFN">WebVTT region viewport anchor setting</a>.</li> - <li>A <a href="#dfn-webvtt-region-scroll-setting" class="internalDFN">WebVTT region scroll setting</a>.</li> - </ul> + <ul> + <li>A <a href="#dfn-webvtt-region-identifier-setting" class="internalDFN">WebVTT region identifier setting</a>.</li> + <li>A <a href="#dfn-webvtt-region-width-setting" class="internalDFN">WebVTT region width setting</a>.</li> + <li>A <a href="#dfn-webvtt-region-lines-setting" class="internalDFN">WebVTT region lines setting</a>.</li> + <li>A <a href="#dfn-webvtt-region-anchor-setting" class="internalDFN">WebVTT region anchor setting</a>.</li> + <li>A <a href="#dfn-webvtt-region-viewport-anchor-setting" class="internalDFN">WebVTT region viewport anchor setting</a>.</li> + <li>A <a href="#dfn-webvtt-region-scroll-setting" class="internalDFN">WebVTT region scroll setting</a>.</li> + </ul> - <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_11"><span>Note</span></div><p class="">The <a href="#dfn-webvtt-region-setting-list" class="internalDFN">WebVTT region setting list</a> gives configuration options regarding the - dimensions, positioning and anchoring of the region. For example, it allows a group of cues - within a region to be anchored in the center of the region and the center of the video - viewport. In this example, when the font size grows, the region grows uniformly in all - directions from the center.</p></div> + <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_11"><span>Note</span></div><p class="">The <a href="#dfn-webvtt-region-setting-list" class="internalDFN">WebVTT region setting list</a> gives configuration options regarding the + dimensions, positioning and anchoring of the region. For example, it allows a group of cues + within a region to be anchored in the center of the region and the center of the video viewport. + In this example, when the font size grows, the region grows uniformly in all directions from the + center.</p></div> - <p>A <dfn id="dfn-webvtt-region-identifier-setting">WebVTT region identifier setting</dfn> consists of the following components, in the - order given:</p> - <ol> - <li><p>The string "<code>id</code>".</p></li> - <li><p>A U+003D EQUALS SIGN character (=).</p></li> - <li><p>An arbitrary string of one or more characters other than U+0020 SPACE or U+0009 - CHARACTER TABULATION character. The string must not contain the substring "<code>--></code>" - (U+002D HYPHEN-MINUS, U+002D HYPHEN-MINUS, U+003E GREATER-THAN SIGN). The string is called the - <dfn id="dfn-webvtt-region-identifier">WebVTT region identifier</dfn>.</p></li> - </ol> + <p>A <dfn id="dfn-webvtt-region-identifier-setting">WebVTT region identifier setting</dfn> consists of the following components, in the + order given:</p> + <ol> + <li><p>The string "<code>id</code>".</p></li> + <li><p>A U+003D EQUALS SIGN character (=).</p></li> + <li><p>An arbitrary string of one or more characters other than U+0020 SPACE or U+0009 + CHARACTER TABULATION character. The string must not contain the substring "<code>--></code>" + (U+002D HYPHEN-MINUS, U+002D HYPHEN-MINUS, U+003E GREATER-THAN SIGN). The string is called the + <dfn id="dfn-webvtt-region-identifier">WebVTT region identifier</dfn>.</p></li> + </ol> - <p>A <a href="#dfn-webvtt-region-identifier" class="internalDFN">WebVTT region identifier</a> must be unique amongst all the <a title="WebVTT region - identifier" href="#dfn-webvtt-region-identifier" class="internalDFN">WebVTT region identifiers</a> of all <a title="WebVTT region" href="#dfn-webvtt-region" class="internalDFN">WebVTT regions</a> of - a <a href="#dfn-webvtt-file" class="internalDFN">WebVTT file</a>.</p> + <p>A <a href="#dfn-webvtt-region-identifier" class="internalDFN">WebVTT region identifier</a> must be unique amongst all the <a title="WebVTT region + identifier" href="#dfn-webvtt-region-identifier" class="internalDFN">WebVTT region identifiers</a> of all <a title="WebVTT region" href="#dfn-webvtt-region" class="internalDFN">WebVTT regions</a> of + a <a href="#dfn-webvtt-file" class="internalDFN">WebVTT file</a>.</p> - <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_12"><span>Note</span></div><p class="">The <a href="#dfn-webvtt-region-identifier" class="internalDFN">WebVTT region identifier</a> gives a name to the region so it can be - referenced by the cues that belong to the region.</p></div> + <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_12"><span>Note</span></div><p class="">The <a href="#dfn-webvtt-region-identifier" class="internalDFN">WebVTT region identifier</a> gives a name to the region so it can be + referenced by the cues that belong to the region.</p></div> - <p>A <dfn id="dfn-webvtt-region-width-setting">WebVTT region width setting</dfn> consists of the following components, in the order - given:</p> - <ol> - <li><p>The string "<code>width</code>".</p></li> - <li><p>A U+003D EQUALS SIGN character (=).</p></li> - <li><p>A <a href="#dfn-webvtt-percentage" class="internalDFN">WebVTT percentage</a>.</p></li> - </ol> - <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_13"><span>Note</span></div><p class="">The <a href="#dfn-webvtt-region-width-setting" class="internalDFN">WebVTT region width setting</a> provides a fixed width as a percentage - of the video width for the region into which cues are rendered and based on which alignment is - calculated.</p></div> + <p>A <dfn id="dfn-webvtt-region-width-setting">WebVTT region width setting</dfn> consists of the following components, in the order + given:</p> + <ol> + <li><p>The string "<code>width</code>".</p></li> + <li><p>A U+003D EQUALS SIGN character (=).</p></li> + <li><p>A <a href="#dfn-webvtt-percentage" class="internalDFN">WebVTT percentage</a>.</p></li> + </ol> + <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_13"><span>Note</span></div><p class="">The <a href="#dfn-webvtt-region-width-setting" class="internalDFN">WebVTT region width setting</a> provides a fixed width as a percentage + of the video width for the region into which cues are rendered and based on which alignment is + calculated.</p></div> - <p>A <dfn id="dfn-webvtt-region-lines-setting">WebVTT region lines setting</dfn> consists of the following components, in the order - given:</p> - <ol> - <li><p>The string "<code>lines</code>".</p></li> - <li><p>A U+003D EQUALS SIGN character (=).</p></li> - <li><p>One or more <a href="#dfn-ascii-digits" class="internalDFN">ASCII digits</a>.</p></li> - </ol> - <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_14"><span>Note</span></div><p class="">The <a href="#dfn-webvtt-region-lines-setting" class="internalDFN">WebVTT region lines setting</a> provides a fixed height as a number of - lines for the region into which cues are rendered. As such, it defines the height of the - roll-up region if it is a scroll region.</p></div> + <p>A <dfn id="dfn-webvtt-region-lines-setting">WebVTT region lines setting</dfn> consists of the following components, in the order + given:</p> + <ol> + <li><p>The string "<code>lines</code>".</p></li> + <li><p>A U+003D EQUALS SIGN character (=).</p></li> + <li><p>One or more <a href="#dfn-ascii-digits" class="internalDFN">ASCII digits</a>.</p></li> + </ol> + <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_14"><span>Note</span></div><p class="">The <a href="#dfn-webvtt-region-lines-setting" class="internalDFN">WebVTT region lines setting</a> provides a fixed height as a number of + lines for the region into which cues are rendered. As such, it defines the height of the roll-up + region if it is a scroll region.</p></div> - <p>A <dfn id="dfn-webvtt-region-anchor-setting">WebVTT region anchor setting</dfn> consists of the following components, in the order - given:</p> - <ol> - <li><p>The string "<code>regionanchor</code>".</p></li> - <li><p>A U+003D EQUALS SIGN character (=).</p></li> - <li><p>A <a href="#dfn-webvtt-percentage" class="internalDFN">WebVTT percentage</a>.</p></li> - <li><p>A U+002C COMMA character (,).</p></li> - <li><p>A <a href="#dfn-webvtt-percentage" class="internalDFN">WebVTT percentage</a>.</p></li> - </ol> - <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_15"><span>Note</span></div><p class="">The <a href="#dfn-webvtt-region-anchor-setting" class="internalDFN">WebVTT region anchor setting</a> provides a tuple of two percentages - that specify the point within the region box that is fixed in location. The first percentage - measures the x-dimension and the second percentage y-dimension from the top left corner of the - region box. If no <a href="#dfn-webvtt-region-anchor-setting" class="internalDFN">WebVTT region anchor setting</a> is given, the anchor defaults to 0%, 100% - (i.e. the bottom left corner).</p></div> + <p>A <dfn id="dfn-webvtt-region-anchor-setting">WebVTT region anchor setting</dfn> consists of the following components, in the order + given:</p> + <ol> + <li><p>The string "<code>regionanchor</code>".</p></li> + <li><p>A U+003D EQUALS SIGN character (=).</p></li> + <li><p>A <a href="#dfn-webvtt-percentage" class="internalDFN">WebVTT percentage</a>.</p></li> + <li><p>A U+002C COMMA character (,).</p></li> + <li><p>A <a href="#dfn-webvtt-percentage" class="internalDFN">WebVTT percentage</a>.</p></li> + </ol> + <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_15"><span>Note</span></div><p class="">The <a href="#dfn-webvtt-region-anchor-setting" class="internalDFN">WebVTT region anchor setting</a> provides a tuple of two percentages + that specify the point within the region box that is fixed in location. The first percentage + measures the x-dimension and the second percentage y-dimension from the top left corner of the + region box. If no <a href="#dfn-webvtt-region-anchor-setting" class="internalDFN">WebVTT region anchor setting</a> is given, the anchor defaults to 0%, 100% + (i.e. the bottom left corner).</p></div> - <p>A <dfn id="dfn-webvtt-region-viewport-anchor-setting">WebVTT region viewport anchor setting</dfn> consists of the following components, in - the order given:</p> - <ol> - <li><p>The string "<code>viewportanchor</code>".</p></li> - <li><p>A U+003D EQUALS SIGN character (=).</p></li> - <li><p>A <a href="#dfn-webvtt-percentage" class="internalDFN">WebVTT percentage</a>.</p></li> - <li><p>A U+002C COMMA character (,).</p></li> - <li><p>A <a href="#dfn-webvtt-percentage" class="internalDFN">WebVTT percentage</a>.</p></li> - </ol> - <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_16"><span>Note</span></div><p class="">The <a href="#dfn-webvtt-region-viewport-anchor-setting" class="internalDFN">WebVTT region viewport anchor setting</a> provides a tuple of two - percentages that specify the point within the video viewport that the region anchor point is - anchored to. The first percentage measures the x-dimension and the second percentage measures - the y-dimension from the top left corner of the video viewport box. If no viewport anchor is - given, it defaults to 0%, 100% (i.e. the bottom left corner).</p></div> - - <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_17"><span>Note</span></div><p class="">For browsers, the region maps to an absolute positioned CSS box relative to - the video viewport, i.e. there is a relative positioned box that represents the video viewport - relative to which the regions are absolutely positioned. Overflow is hidden.</p></div> + <p>A <dfn id="dfn-webvtt-region-viewport-anchor-setting">WebVTT region viewport anchor setting</dfn> consists of the following components, in + the order given:</p> + <ol> + <li><p>The string "<code>viewportanchor</code>".</p></li> + <li><p>A U+003D EQUALS SIGN character (=).</p></li> + <li><p>A <a href="#dfn-webvtt-percentage" class="internalDFN">WebVTT percentage</a>.</p></li> + <li><p>A U+002C COMMA character (,).</p></li> + <li><p>A <a href="#dfn-webvtt-percentage" class="internalDFN">WebVTT percentage</a>.</p></li> + </ol> + <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_16"><span>Note</span></div><p class="">The <a href="#dfn-webvtt-region-viewport-anchor-setting" class="internalDFN">WebVTT region viewport anchor setting</a> provides a tuple of two + percentages that specify the point within the video viewport that the region anchor point is + anchored to. The first percentage measures the x-dimension and the second percentage measures + the y-dimension from the top left corner of the video viewport box. If no viewport anchor is + given, it defaults to 0%, 100% (i.e. the bottom left corner).</p></div> + + <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_17"><span>Note</span></div><p class="">For browsers, the region maps to an absolute positioned CSS box relative to the + video viewport, i.e. there is a relative positioned box that represents the video viewport + relative to which the regions are absolutely positioned. Overflow is hidden.</p></div> - <p>A <dfn id="dfn-webvtt-region-scroll-setting">WebVTT region scroll setting</dfn> consists of the following components, in the order - given:</p> - <ol> - <li><p>The string "<code>scroll</code>".</p></li> - <li><p>A U+003D EQUALS SIGN character (=).</p></li> - <li><p>The string "<code>up</code>".</p></li> - </ol> - <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_18"><span>Note</span></div><p class="">The <a href="#dfn-webvtt-region-scroll-setting" class="internalDFN">WebVTT region scroll setting</a> specifies whether cues rendered into - the region are allowed to move out of their initial rendering place and roll up, i.e. move - towards the top of the video viewport. If the scroll setting is omitted, cues do not move from - their rendered position.</p></div> - - <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_19"><span>Note</span></div><p class="">Cues are added to a region one line at a time below existing cue lines. When an - existing rendered cue line is removed, and it was above another already rendered cue line, that - cue line moves into its space, thus scrolling in the given direction. If there is not enough - space for a new cue line to be added to a region, the top-most cue line is pushed off the - visible region (thus slowly becoming invisible as it moves into overflow:hidden). This - eventually makes space for the new cue line and allows it to be added.</p></div> - - <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_20"><span>Note</span></div><p class="">When there is no scroll direction, cue lines are added in the empty line - closest to the line in the bottom of the region. If no empty line is available, the oldest line - is replaced.</p></div> + <p>A <dfn id="dfn-webvtt-region-scroll-setting">WebVTT region scroll setting</dfn> consists of the following components, in the order + given:</p> + <ol> + <li><p>The string "<code>scroll</code>".</p></li> + <li><p>A U+003D EQUALS SIGN character (=).</p></li> + <li><p>The string "<code>up</code>".</p></li> + </ol> + <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_18"><span>Note</span></div><p class="">The <a href="#dfn-webvtt-region-scroll-setting" class="internalDFN">WebVTT region scroll setting</a> specifies whether cues rendered into + the region are allowed to move out of their initial rendering place and roll up, i.e. move + towards the top of the video viewport. If the scroll setting is omitted, cues do not move from + their rendered position.</p></div> + + <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_19"><span>Note</span></div><p class="">Cues are added to a region one line at a time below existing cue lines. When an + existing rendered cue line is removed, and it was above another already rendered cue line, that + cue line moves into its space, thus scrolling in the given direction. If there is not enough + space for a new cue line to be added to a region, the top-most cue line is pushed off the + visible region (thus slowly becoming invisible as it moves into overflow:hidden). This + eventually makes space for the new cue line and allows it to be added.</p></div> + + <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_20"><span>Note</span></div><p class="">When there is no scroll direction, cue lines are added in the empty line closest + to the line in the bottom of the region. If no empty line is available, the oldest line is + replaced.</p></div> - </section> + </section><!-- end region definition --> - <section id="webvtt-cue-settings-1"> - <h4 role="heading" id="h4_webvtt-cue-settings-1"><span class="secno">4.4.2 </span>WebVTT cue settings</h4> + <section id="webvtt-cue-settings"> + <h3 role="heading" id="h3_webvtt-cue-settings"><span class="secno">4.5 </span>WebVTT cue settings</h3> - <p>A <a href="#dfn-webvtt-cue-settings-list" class="internalDFN">WebVTT cue settings list</a> consists of zero or more of the following settings. Each - setting must not be included more than once per <a href="#dfn-webvtt-cue-settings-list" class="internalDFN">WebVTT cue settings list</a>.</p> + <p>A <a href="#dfn-webvtt-cue-settings-list" class="internalDFN">WebVTT cue settings list</a> consists of zero or more of the following settings. Each + setting must not be included more than once per <a href="#dfn-webvtt-cue-settings-list" class="internalDFN">WebVTT cue settings list</a>.</p> - <ul class="brief"> - <li>A <a href="#dfn-webvtt-vertical-text-cue-setting" class="internalDFN">WebVTT vertical text cue setting</a>.</li> - <li>A <a href="#dfn-webvtt-line-position-cue-setting" class="internalDFN">WebVTT line position cue setting</a>.</li> - <li>A <a href="#dfn-webvtt-text-position-cue-setting" class="internalDFN">WebVTT text position cue setting</a>.</li> - <li>A <a href="#dfn-webvtt-size-cue-setting" class="internalDFN">WebVTT size cue setting</a>.</li> - <li>A <a href="#dfn-webvtt-alignment-cue-setting" class="internalDFN">WebVTT alignment cue setting</a>.</li> - <li>A <a href="#dfn-webvtt-region-cue-setting" class="internalDFN">WebVTT region cue setting</a>.</li> - </ul> + <ul class="brief"> + <li>A <a href="#dfn-webvtt-vertical-text-cue-setting" class="internalDFN">WebVTT vertical text cue setting</a>.</li> + <li>A <a href="#dfn-webvtt-line-position-cue-setting" class="internalDFN">WebVTT line position cue setting</a>.</li> + <li>A <a href="#dfn-webvtt-text-position-cue-setting" class="internalDFN">WebVTT text position cue setting</a>.</li> + <li>A <a href="#dfn-webvtt-size-cue-setting" class="internalDFN">WebVTT size cue setting</a>.</li> + <li>A <a href="#dfn-webvtt-alignment-cue-setting" class="internalDFN">WebVTT alignment cue setting</a>.</li> + <li>A <a href="#dfn-webvtt-region-cue-setting" class="internalDFN">WebVTT region cue setting</a>.</li> + </ul> - <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_21"><span>Note</span></div><p class="">A <a href="#dfn-webvtt-cue-settings-list" class="internalDFN">WebVTT cue settings list</a> gives configuration options regarding the - position and alignment of the cue box and the cue text within. For example, it allows a cue box - to be aligned to the left or positioned at the top right with the cue text within middle - aligned.</p></div> + <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_21"><span>Note</span></div><p class="">A <a href="#dfn-webvtt-cue-settings-list" class="internalDFN">WebVTT cue settings list</a> gives configuration options regarding the + position and alignment of the cue box and the cue text within. For example, it allows a cue box + to be aligned to the left or positioned at the top right with the cue text within middle + aligned.</p></div> - <p>A <dfn id="dfn-webvtt-vertical-text-cue-setting">WebVTT vertical text cue setting</dfn> is a <a href="#dfn-webvtt-cue-setting" class="internalDFN">WebVTT cue setting</a> that consists - of the following components, in the order given:</p> + <p>A <dfn id="dfn-webvtt-vertical-text-cue-setting">WebVTT vertical text cue setting</dfn> is a <a href="#dfn-webvtt-cue-setting" class="internalDFN">WebVTT cue setting</a> that consists of + the following components, in the order given:</p> - <ol> - <li>The string "<code>vertical</code>" as the <a href="#dfn-webvtt-cue-setting-name" class="internalDFN">WebVTT cue setting name</a>.</li> - <li><p>A U+003A COLON character (:).</p></li> - <li>One of the following strings as the <a href="#dfn-webvtt-cue-setting-value" class="internalDFN">WebVTT cue setting value</a>: "<code>rl</code>", - "<code>lr</code>".</li> - </ol> + <ol> + <li>The string "<code>vertical</code>" as the <a href="#dfn-webvtt-cue-setting-name" class="internalDFN">WebVTT cue setting name</a>.</li> + <li><p>A U+003A COLON character (:).</p></li> + <li>One of the following strings as the <a href="#dfn-webvtt-cue-setting-value" class="internalDFN">WebVTT cue setting value</a>: "<code>rl</code>", + "<code>lr</code>".</li> + </ol> - <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_22"><span>Note</span></div><p class="">A <a href="#dfn-webvtt-vertical-text-cue-setting" class="internalDFN">WebVTT vertical text cue setting</a> configures the cue to use vertical - text layout rather than horizontal text layout. Vertical text layout is sometimes used in - Japanese, for example. The default is horizontal layout.</p></div> + <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_22"><span>Note</span></div><p class="">A <a href="#dfn-webvtt-vertical-text-cue-setting" class="internalDFN">WebVTT vertical text cue setting</a> configures the cue to use vertical + text layout rather than horizontal text layout. Vertical text layout is sometimes used in + Japanese, for example. The default is horizontal layout.</p></div> - <p>A <dfn id="dfn-webvtt-line-position-cue-setting">WebVTT line position cue setting</dfn> consists of the following components, in the - order given:</p> + <p>A <dfn id="dfn-webvtt-line-position-cue-setting">WebVTT line position cue setting</dfn> consists of the following components, in the + order given:</p> - <ol> - <li><p>The string "<code>line</code>" as the <a href="#dfn-webvtt-cue-setting-name" class="internalDFN">WebVTT cue setting name</a>.</p></li> - <li><p>A U+003A COLON character (:).</p></li> - <li> - As the <a href="#dfn-webvtt-cue-setting-value" class="internalDFN">WebVTT cue setting value</a>: - <ol> - <li> - a position value, either: - <dl> - <dt>To represent a specific position relative to the video frame</dt> - <dd> - <p>A <a href="#dfn-webvtt-percentage" class="internalDFN">WebVTT percentage</a>.</p> - </dd> - <dt>Or to represent a line number</dt> - <dd> [268 lines skipped]
Received on Tuesday, 28 October 2014 08:58:22 UTC