- 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