- From: CVS User pjgenste <cvsmail@w3.org>
- Date: Tue, 17 Mar 2015 08:17:52 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/webvtt
In directory roscoe:/tmp/cvs-serv1893
Modified Files:
Overview.html
Log Message:
Sync WebVTT with Git commit f0362b8cbb0fb34d3c7c1e03e3d7f0159a8930a1
--- /sources/public/html5/webvtt/Overview.html 2015/03/09 07:33:27 1.214
+++ /sources/public/html5/webvtt/Overview.html 2015/03/17 08:17:51 1.215
@@ -3,7 +3,7 @@
<head>
<title>WebVTT: The Web Video Text Tracks Format</title>
<meta charset="utf-8">
- <meta name="revision" content="966f0a8427381a4c144290e9a5b8303c0674a6a2">
+ <meta name="revision" content="f0362b8cbb0fb34d3c7c1e03e3d7f0159a8930a1">
@@ -305,7 +305,7 @@
</p>
<h1 class="title p-name" id="title">WebVTT: The Web Video Text Tracks Format</h1>
- <h2 id="draft-community-group-report-09-march-2015">Draft Community Group Report <time class="dt-published" datetime="2015-03-09">09 March 2015</time></h2>
+ <h2 id="draft-community-group-report-17-march-2015">Draft Community Group Report <time class="dt-published" datetime="2015-03-17">17 March 2015</time></h2>
<dl>
@@ -395,7 +395,7 @@
(<a href="mailto:public-texttracks-request@w3.org?subject=subscribe">subscribe</a>,
<a href="http://lists.w3.org/Archives/Public/public-texttracks/">archives</a>).</p>
-</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="#webvtt-cues" class="tocxref"><span class="secno">3.1 </span>WebVTT 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="#types-of-webvtt-cue-payload" class="tocxref"><span class="secno">4.2 </span>Types of WebVTT cue payload</a><ul class="toc"><li class="tocline"><a href="#webvtt-metadata-text" class="tocxref"><span class="secno">4.2.1 </span>WebVTT metadata text</a></li><li class="tcline"><a href="#webvtt-cue-text" class="tocxref"><span class="secno">4.2.2 </span>WebVTT cue text</a></li></ul></li><li class="tocline"><a href="#webvtt-region-definition" class="tocxref"><span class="secno">4.3 </span>WebVTT region definition</a></li><li class="tocline"><a href="#webvtt-cue-settings" class="tocxref"><span class="secno">4.4 </span>WebVTT cue settings</a></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-webvtt-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 ref="#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-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-text-parsing-rules" class="tocxref"><span class="secno">5.4 </span><span>WebVTT cue text parsing rules</span></a></li><li class="ocline"><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><li class="tocline"><a href="#webvtt-rules-for-extracting-the-chapter-title" class="tocxref"><span class="secno">5.6 </span>WebVTT rules for extracting the chapter title</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="#processing-model" class="tocxref"><span class="secno">6.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 </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.3 </span>CSS extensions</a><ul class="toc"><li class="tocline"><a href="#the-cue-pseudo-element" class="tocxre"><span class="secno">6.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.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.3.3 </span>The '::cue-region' pseudo-element</a></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="tocine"><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="#webvtt-cues" class="tocxref"><span class="secno">3.1 </span>WebVTT cues</a></li><li class="tocline"><a href="#webvtt-regions" class="tocxref"><span class="secno">3.2 </span>WebVTT 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="#types-of-webvtt-cue-payload" class="tocxref"><span class="secno">4.2 </span>Types of WebVTT cue payload</a><ul class="toc"><li class="tocline"><a href="#webvtt-metadata-text" class="tocxref"><span class="secno">4.2.1 </span>WebVTT metadata text</a></li><li class="tocline">a href="#webvtt-cue-text" class="tocxref"><span class="secno">4.2.2 </span>WebVTT cue text</a></li></ul></li><li class="tocline"><a href="#webvtt-region-definition" class="tocxref"><span class="secno">4.3 </span>WebVTT region definition</a></li><li class="tocline"><a href="#webvtt-cue-settings" class="tocxref"><span class="secno">4.4 </span>WebVTT cue settings</a></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-webvtt-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="#wbvtt-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-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-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><li class="tocline"><a href="#webvtt-rules-for-extracting-the-chapter-title" class="tocxref"><span class="secno">5.6 </span>WebVTT rules for extracting the chapter title</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="#processing-model" class="tocxref"><span class="secno">6.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 </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.3 </span>CSS extensions</a><ul class="toc"><li class="tocline"><a href="#the-cue-pseudo-element" class="tocxref"><spanclass="secno">6.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.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.3.3 </span>The '::cue-region' pseudo-element</a></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"><ahref="#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>
@@ -652,14 +652,13 @@
00:00:04.000 --> 00:00:06.500 position:45%,end align:middle size:35%
What are you waiting for?</pre>
- <p>The cues cover only 35% of the video viewport's width. The first cue has its <a title="text
- track cue box" href="#dfn-text-track-cue-box" class="internalDFN">cue box</a> left aligned at the 10% mark of the video viewport width and the
- text is left aligned within that box - probably underneath a speaker on the left of the video
- image. "start" alignment of the cue box is the default for start aligned text, so does not need
- to be specified in "position". The second cue has its <a title="text track cue box" href="#dfn-text-track-cue-box" class="internalDFN">cue box</a>
- right aligned at the 90% mark of the video viewport width. The same effect can be achieved with
- "position:55%,start", which explicitly positions the cue box. The third cue has middle aligned
- text within the same type of cue box as the first cue.</p>
+ <p>The cues cover only 35% of the video viewport's width. The first cue has its <a title="WebVTT cue box" href="#dfn-webvtt-cue-box" class="internalDFN">cue box</a> left aligned at the 10% mark of the video viewport width and
+ the text is left aligned within that box - probably underneath a speaker on the left of the
+ video image. "start" alignment of the cue box is the default for start aligned text, so does
+ not need to be specified in "position". The second cue has its <a title="WebVTT cue box" href="#dfn-webvtt-cue-box" class="internalDFN">cue
+ box</a> right aligned at the 90% mark of the video viewport width. The same effect can be
+ achieved with "position:55%,start", which explicitly positions the cue box. The third cue has
+ middle aligned text within the same type of cue box as the first cue.</p>
</div>
<div class="example">
@@ -858,95 +857,91 @@
<section id="webvtt-cues">
<h3 role="heading" id="h3_webvtt-cues"><span class="secno">3.1 </span>WebVTT cues</h3>
- <p>A <dfn id="dfn-webvtt-cue">WebVTT cue</dfn> is a HTML <a title="" href="#dfn-text-track-cue" class="internalDFN">text track cue</a> that additionally consist of
- the following: [<cite><a class="bibref" href="#bib-HTML">HTML</a></cite>]</p>
+ <p>A <dfn id="dfn-webvtt-cue">WebVTT cue</dfn> is a <a href="#dfn-text-track-cue" class="internalDFN">text track cue</a> that additionally consist of the
+ following: [<cite><a class="bibref" href="#bib-HTML">HTML</a></cite>]</p>
<dl>
- <dt><dfn title="text track cue box" id="dfn-text-track-cue-box">A cue box</dfn></dt>
+ <dt><dfn title="WebVTT cue box" id="dfn-webvtt-cue-box">A cue box</dfn></dt>
<dd>
<p>The cue box of a <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> is a box within which the text of all lines of the cue
is to be rendered.</p>
- <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_1"><span>Note</span></div><p class="">The position of the <a title="text track cue box" href="#dfn-text-track-cue-box" class="internalDFN">cue box</a> within the video
- frame's dimensions depends on the value of the <a href="#dfn-text-track-cue-text-position" class="internalDFN">text track cue text position</a> and the
- <a href="#dfn-text-track-cue-line-position" class="internalDFN">text track cue line position</a>.</p></div>
+ <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_1"><span>Note</span></div><p class="">The position of the <a title="WebVTT cue box" href="#dfn-webvtt-cue-box" class="internalDFN">cue box</a> within the video
+ frame's dimensions depends on the value of the <a href="#dfn-webvtt-cue-text-position" class="internalDFN">WebVTT cue text position</a> and the
+ <a href="#dfn-webvtt-cue-line-position" class="internalDFN">WebVTT cue line position</a>.</p></div>
- <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_2"><span>Note</span></div><p class="">Lines are wrapped within the <a title="text track cue box" href="#dfn-text-track-cue-box" class="internalDFN">cue box</a>'s <a title="text track cue size" href="#dfn-text-track-cue-size" class="internalDFN">size</a> if lines' lengths make this necessary.</p></div>
+ <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_2"><span>Note</span></div><p class="">Lines are wrapped within the <a title="WebVTT cue box" href="#dfn-webvtt-cue-box" class="internalDFN">cue box</a>'s <a title="WebVTT cue size" href="#dfn-webvtt-cue-size" class="internalDFN">size</a> if lines' lengths make this necessary.</p></div>
</dd>
- <dt><dfn title="text track cue writing direction" id="dfn-text-track-cue-writing-direction">A writing direction</dfn></dt>
+ <dt><dfn title="WebVTT cue writing direction" id="dfn-webvtt-cue-writing-direction">A writing direction</dfn></dt>
<dd>
- <p>A writing direction, either <dfn title="text track cue horizontal writing
- direction" id="dfn-text-track-cue-horizontal-writing-direction">horizontal</dfn> (a line extends horizontally and is positioned vertically, with
- consecutive lines displayed below each other), <dfn title="text track cue vertical growing
- left writing direction" id="dfn-text-track-cue-vertical-growing-left-writing-direction">vertical growing left</dfn> (a line extends vertically and is
- positioned horizontally, with consecutive lines displayed to the left of each other<!-- used
- for east asian-->), or <dfn title="text track cue vertical growing right writing
- direction" id="dfn-text-track-cue-vertical-growing-right-writing-direction">vertical growing right</dfn> (a line extends vertically and is positioned
- horizontally, with consecutive lines displayed to the right of each other<!-- used for
- mongolian -->).</p>
+ <p>A writing direction, either <dfn title="WebVTT cue horizontal writing
+ direction" id="dfn-webvtt-cue-horizontal-writing-direction">horizontal</dfn> (a line extends horizontally and is positioned vertically, with
+ consecutive lines displayed below each other), <dfn title="WebVTT cue vertical growing left
+ writing direction" id="dfn-webvtt-cue-vertical-growing-left-writing-direction">vertical growing left</dfn> (a line extends vertically and is positioned
+ horizontally, with consecutive lines displayed to the left of each other<!-- used for east
+ asian-->), or <dfn title="WebVTT cue vertical growing right writing direction" id="dfn-webvtt-cue-vertical-growing-right-writing-direction">vertical
+ growing right</dfn> (a line extends vertically and is positioned horizontally, with
+ consecutive lines displayed to the right of each other<!-- used for mongolian -->).</p>
- <p>If the <a title="text track cue writing direction" href="#dfn-text-track-cue-writing-direction" class="internalDFN">writing direction</a> is <a title="text
- track cue horizontal writing direction" href="#dfn-text-track-cue-horizontal-writing-direction" class="internalDFN">horizontal</a>, then the <a title="text track cue line
- position" href="#dfn-text-track-cue-line-position" class="internalDFN">line position</a> percentages are relative to the height of the video, and <a title="text track cue text position" href="#dfn-text-track-cue-text-position" class="internalDFN">text position</a> and <a title="text track cue
- size" href="#dfn-text-track-cue-size" class="internalDFN">size</a> percentages are relative to the width of the video.</p>
+ <p>If the <a title="WebVTT cue writing direction" href="#dfn-webvtt-cue-writing-direction" class="internalDFN">writing direction</a> is <a title="WebVTT
+ cue horizontal writing direction" href="#dfn-webvtt-cue-horizontal-writing-direction" class="internalDFN">horizontal</a>, then the <a title="WebVTT cue line
+ position" href="#dfn-webvtt-cue-line-position" class="internalDFN">line position</a> percentages are relative to the height of the video, and <a title="WebVTT cue text position" href="#dfn-webvtt-cue-text-position" class="internalDFN">text position</a> and <a title="WebVTT cue size" href="#dfn-webvtt-cue-size" class="internalDFN">size</a>
+ percentages are relative to the width of the video.</p>
- <p>Otherwise, <a title="text track cue line position" href="#dfn-text-track-cue-line-position" class="internalDFN">line position</a> percentages are
- relative to the width of the video, and <a title="text track cue text position" href="#dfn-text-track-cue-text-position" class="internalDFN">text
- position</a> and <a title="text track cue size" href="#dfn-text-track-cue-size" class="internalDFN">size</a> percentages are relative to the
- height of the video.</p>
+ <p>Otherwise, <a title="WebVTT cue line position" href="#dfn-webvtt-cue-line-position" class="internalDFN">line position</a> percentages are relative
+ to the width of the video, and <a title="WebVTT cue text position" href="#dfn-webvtt-cue-text-position" class="internalDFN">text position</a> and <a title="WebVTT cue size" href="#dfn-webvtt-cue-size" class="internalDFN">size</a> percentages are relative to the height of the video.</p>
- <p>The <a title="text track cue writing direction" href="#dfn-text-track-cue-writing-direction" class="internalDFN">writing direction</a> defaults to <a title="text track cue horizontal writing direction" href="#dfn-text-track-cue-horizontal-writing-direction" class="internalDFN">horizontal</a>.</p>
+ <p>The <a title="WebVTT cue writing direction" href="#dfn-webvtt-cue-writing-direction" class="internalDFN">writing direction</a> defaults to <a title="WebVTT cue horizontal writing direction" href="#dfn-webvtt-cue-horizontal-writing-direction" class="internalDFN">horizontal</a>.</p>
</dd>
- <dt><dfn title="text track cue snap-to-lines flag" id="dfn-text-track-cue-snap-to-lines-flag">A snap-to-lines flag</dfn></dt>
+ <dt><dfn title="WebVTT cue snap-to-lines flag" id="dfn-webvtt-cue-snap-to-lines-flag">A snap-to-lines flag</dfn></dt>
<dd>
- <p>A boolean indicating whether the <a title="text track cue line position" href="#dfn-text-track-cue-line-position" class="internalDFN">line's
- position</a> is a line position (positioned to a multiple of the line dimensions of the first
- line of the cue), or whether it is a percentage of the dimension of the video.</p>
+ <p>A boolean indicating whether the <a title="WebVTT cue line position" href="#dfn-webvtt-cue-line-position" class="internalDFN">line's position</a> is
+ a line position (positioned to a multiple of the line dimensions of the first line of the
+ cue), or whether it is a percentage of the dimension of the video.</p>
- <p>Cues whose <a href="#dfn-text-track-cue-snap-to-lines-flag" class="internalDFN">text track cue snap-to-lines flag</a> is set will be placed within the
- title-safe area on user agents that use overscan. Cues with the flag unset will be positioned
- as requested (modulo overlap avoidance if multiple cues are in the same place).</p>
+ <p>Cues whose <a href="#dfn-webvtt-cue-snap-to-lines-flag" class="internalDFN">WebVTT cue snap-to-lines flag</a> is set will be placed within the title-safe
+ area on user agents that use overscan. Cues with the flag unset will be positioned as
+ requested (modulo overlap avoidance if multiple cues are in the same place).</p>
- <p>By default, the <a title="text track cue snap-to-lines flag" href="#dfn-text-track-cue-snap-to-lines-flag" class="internalDFN">snap-to-lines flag</a> is set
- to true.</p>
+ <p>By default, the <a title="WebVTT cue snap-to-lines flag" href="#dfn-webvtt-cue-snap-to-lines-flag" class="internalDFN">snap-to-lines flag</a> is set to
+ true.</p>
</dd>
- <dt><dfn title="text track cue line position" id="dfn-text-track-cue-line-position">A line position</dfn></dt>
+ <dt><dfn title="WebVTT cue line position" id="dfn-webvtt-cue-line-position">A line position</dfn></dt>
<dd>
- <p>The line position defines positioning of the <a title="text track cue box" href="#dfn-text-track-cue-box" class="internalDFN">cue box</a>.</p>
+ <p>The line position defines positioning of the <a title="WebVTT cue box" href="#dfn-webvtt-cue-box" class="internalDFN">cue box</a>.</p>
<p>A line position is either a number giving the position of the lines of the cue, to be
- interpreted as defined by the <a title="text track cue writing direction" href="#dfn-text-track-cue-writing-direction" class="internalDFN">writing
- direction</a> and <a title="text track cue snap-to-lines flag" href="#dfn-text-track-cue-snap-to-lines-flag" class="internalDFN">snap-to-lines flag</a> of the
- cue, or the special value <dfn title="text track cue automatic line position" id="dfn-text-track-cue-automatic-line-position">auto</dfn>,
- which means the position is to depend on the other showing tracks.</p>
-
- <p>A <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> has a <dfn id="dfn-text-track-cue-computed-line-position">text track cue computed line position</dfn> whose value is
- that returned by the following algorithm, which is defined in terms of the other aspects of
- the cue:</p>
+ interpreted as defined by the <a title="WebVTT cue writing direction" href="#dfn-webvtt-cue-writing-direction" class="internalDFN">writing direction</a>
+ and <a title="WebVTT cue snap-to-lines flag" href="#dfn-webvtt-cue-snap-to-lines-flag" class="internalDFN">snap-to-lines flag</a> of the cue, or the special
+ value <dfn title="WebVTT cue automatic line position" id="dfn-webvtt-cue-automatic-line-position">auto</dfn>, which means the position is
+ to depend on the other showing tracks.</p>
+
+ <p>A <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> has a <dfn id="dfn-webvtt-cue-computed-line-position">WebVTT cue computed line position</dfn> whose value is that
+ returned by the following algorithm, which is defined in terms of the other aspects of the
+ cue:</p>
<ol>
- <li><p>If the <a href="#dfn-text-track-cue-line-position" class="internalDFN">text track cue line position</a> is numeric, the <a href="#dfn-text-track-cue-snap-to-lines-flag" class="internalDFN">text track cue
- snap-to-lines flag</a> of the <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> is not set, and the <a href="#dfn-text-track-cue-line-position" class="internalDFN">text track cue line
- position</a> is negative or greater than 100, then return 100 and abort these steps.</p></li>
-
- <li><p>If the <a href="#dfn-text-track-cue-line-position" class="internalDFN">text track cue line position</a> is numeric, return the value of the <a href="#dfn-text-track-cue-line-position" class="internalDFN">text
- track cue line position</a> and abort these steps. (Either the <a href="#dfn-text-track-cue-snap-to-lines-flag" class="internalDFN">text track cue
- snap-to-lines flag</a> is set, so any value, not just those in the range 0..100, is valid, or
- the value is in the range 0..100 and is thus valid regardless of the value of that
- flag.)</p></li>
-
- <li><p>If the <a href="#dfn-text-track-cue-snap-to-lines-flag" class="internalDFN">text track cue snap-to-lines flag</a> of the <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> is not set,
- return the value 100 and abort these steps. (The <a href="#dfn-text-track-cue-line-position" class="internalDFN">text track cue line position</a> is the
- special value <a title="text track cue automatic line position" href="#dfn-text-track-cue-automatic-line-position" class="internalDFN">auto</a>.)</p></li>
+ <li><p>If the <a href="#dfn-webvtt-cue-line-position" class="internalDFN">WebVTT cue line position</a> is numeric, the <a href="#dfn-webvtt-cue-snap-to-lines-flag" class="internalDFN">WebVTT cue snap-to-lines
+ flag</a> of the <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> is not set, and the <a href="#dfn-webvtt-cue-line-position" class="internalDFN">WebVTT cue line position</a> is
+ negative or greater than 100, then return 100 and abort these steps.</p></li>
+
+ <li><p>If the <a href="#dfn-webvtt-cue-line-position" class="internalDFN">WebVTT cue line position</a> is numeric, return the value of the <a href="#dfn-webvtt-cue-line-position" class="internalDFN">WebVTT
+ cue line position</a> and abort these steps. (Either the <a href="#dfn-webvtt-cue-snap-to-lines-flag" class="internalDFN">WebVTT cue snap-to-lines flag</a>
+ is set, so any value, not just those in the range 0..100, is valid, or the value is in the
+ range 0..100 and is thus valid regardless of the value of that flag.)</p></li>
+
+ <li><p>If the <a href="#dfn-webvtt-cue-snap-to-lines-flag" class="internalDFN">WebVTT cue snap-to-lines flag</a> of the <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> is not set,
+ return the value 100 and abort these steps. (The <a href="#dfn-webvtt-cue-line-position" class="internalDFN">WebVTT cue line position</a> is the
+ special value <a title="WebVTT cue automatic line position" href="#dfn-webvtt-cue-automatic-line-position" class="internalDFN">auto</a>.)</p></li>
<li><p>Let <var>cue</var> be the <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a>.</p></li>
@@ -971,193 +966,189 @@
</dd>
- <dt><dfn title="text track cue line alignment" id="dfn-text-track-cue-line-alignment">A line alignment</dfn></dt>
+ <dt><dfn title="WebVTT cue line alignment" id="dfn-webvtt-cue-line-alignment">A line alignment</dfn></dt>
<dd>
- <p>An alignment for the <a title="text track cue box" href="#dfn-text-track-cue-box" class="internalDFN">cue box</a>'s <a title="text track cue
- line position" href="#dfn-text-track-cue-line-position" class="internalDFN">line position</a>, one of:</p>
+ <p>An alignment for the <a title="WebVTT cue box" href="#dfn-webvtt-cue-box" class="internalDFN">cue box</a>'s <a title="WebVTT cue line
+ position" href="#dfn-webvtt-cue-line-position" class="internalDFN">line position</a>, one of:</p>
<dl>
- <dt><dfn title="text track cue line start alignment" id="dfn-text-track-cue-line-start-alignment">Start alignment</dfn></dt>
- <dd>The <a title="text track cue box" href="#dfn-text-track-cue-box" class="internalDFN">cue box</a>'s top side (for <a title="text track cue
- horizontal writing direction" href="#dfn-text-track-cue-horizontal-writing-direction" class="internalDFN">horizontal</a> cues), left side (for <a title="text track cue
- vertical growing right writing direction" href="#dfn-text-track-cue-vertical-growing-right-writing-direction" class="internalDFN">vertical growing right</a>), or right side (for <a title="text track cue vertical growing left writing direction" href="#dfn-text-track-cue-vertical-growing-left-writing-direction" class="internalDFN">vertical growing left</a>) is
- aligned at the <a title="text track cue line position" href="#dfn-text-track-cue-line-position" class="internalDFN">line position</a>.</dd>
-
- <dt><dfn title="text track cue line middle alignment" id="dfn-text-track-cue-line-middle-alignment">Middle alignment</dfn></dt>
- <dd>The <a title="text track cue box" href="#dfn-text-track-cue-box" class="internalDFN">cue box</a> is centered at the <a title="text track cue
- line position" href="#dfn-text-track-cue-line-position" class="internalDFN">line position</a>.</dd>
-
- <dt><dfn title="text track cue line end alignment" id="dfn-text-track-cue-line-end-alignment">End alignment</dfn></dt>
- <dd>The <a title="text track cue box" href="#dfn-text-track-cue-box" class="internalDFN">cue box</a>'s bottom side (for <a title="text track cue
- horizontal writing direction" href="#dfn-text-track-cue-horizontal-writing-direction" class="internalDFN">horizontal</a> cues), right side (for <a title="text track cue
- vertical growing right writing direction" href="#dfn-text-track-cue-vertical-growing-right-writing-direction" class="internalDFN">vertical growing right</a>), or left side (for <a title="text track cue vertical growing left writing direction" href="#dfn-text-track-cue-vertical-growing-left-writing-direction" class="internalDFN">vertical growing left</a>) is
- aligned at the <a title="text track cue line position" href="#dfn-text-track-cue-line-position" class="internalDFN">line position</a>.</dd>
+ <dt><dfn title="WebVTT cue line start alignment" id="dfn-webvtt-cue-line-start-alignment">Start alignment</dfn></dt>
+ <dd>The <a title="WebVTT cue box" href="#dfn-webvtt-cue-box" class="internalDFN">cue box</a>'s top side (for <a title="WebVTT cue horizontal
+ writing direction" href="#dfn-webvtt-cue-horizontal-writing-direction" class="internalDFN">horizontal</a> cues), left side (for <a title="WebVTT cue vertical growing
+ right writing direction" href="#dfn-webvtt-cue-vertical-growing-right-writing-direction" class="internalDFN">vertical growing right</a>), or right side (for <a title="WebVTT cue
+ vertical growing left writing direction" href="#dfn-webvtt-cue-vertical-growing-left-writing-direction" class="internalDFN">vertical growing left</a>) is aligned at the <a title="WebVTT cue line position" href="#dfn-webvtt-cue-line-position" class="internalDFN">line position</a>.</dd>
+
+ <dt><dfn title="WebVTT cue line middle alignment" id="dfn-webvtt-cue-line-middle-alignment">Middle alignment</dfn></dt>
+ <dd>The <a title="WebVTT cue box" href="#dfn-webvtt-cue-box" class="internalDFN">cue box</a> is centered at the <a title="WebVTT cue line
+ position" href="#dfn-webvtt-cue-line-position" class="internalDFN">line position</a>.</dd>
+
+ <dt><dfn title="WebVTT cue line end alignment" id="dfn-webvtt-cue-line-end-alignment">End alignment</dfn></dt>
+ <dd>The <a title="WebVTT cue box" href="#dfn-webvtt-cue-box" class="internalDFN">cue box</a>'s bottom side (for <a title="WebVTT cue
+ horizontal writing direction" href="#dfn-webvtt-cue-horizontal-writing-direction" class="internalDFN">horizontal</a> cues), right side (for <a title="WebVTT cue
+ vertical growing right writing direction" href="#dfn-webvtt-cue-vertical-growing-right-writing-direction" class="internalDFN">vertical growing right</a>), or left side (for <a title="WebVTT cue vertical growing left writing direction" href="#dfn-webvtt-cue-vertical-growing-left-writing-direction" class="internalDFN">vertical growing left</a>) is
+ aligned at the <a title="WebVTT cue line position" href="#dfn-webvtt-cue-line-position" class="internalDFN">line position</a>.</dd>
</dl>
- <p>A <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> has a default <a href="#dfn-text-track-cue-line-alignment" class="internalDFN">text track cue line alignment</a> of <a title="text
- track cue line start alignment" href="#dfn-text-track-cue-line-start-alignment" class="internalDFN">start</a>.</p>
+ <p>A <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> has a default <a href="#dfn-webvtt-cue-line-alignment" class="internalDFN">WebVTT cue line alignment</a> of <a title="WebVTT cue
+ line start alignment" href="#dfn-webvtt-cue-line-start-alignment" class="internalDFN">start</a>.</p>
</dd>
- <dt><dfn title="text track cue text position" id="dfn-text-track-cue-text-position">A text position</dfn></dt>
+ <dt><dfn title="WebVTT cue text position" id="dfn-webvtt-cue-text-position">A text position</dfn></dt>
<dd>
- <p>The text position defines positioning of the <a title="text track cue box" href="#dfn-text-track-cue-box" class="internalDFN">cue box</a> in
- the direction defined by the <a title="text track cue writing direction" href="#dfn-text-track-cue-writing-direction" class="internalDFN">writing
- direction</a>.</p>
+ <p>The text position defines positioning of the <a title="WebVTT cue box" href="#dfn-webvtt-cue-box" class="internalDFN">cue box</a> in the
+ direction defined by the <a title="WebVTT cue writing direction" href="#dfn-webvtt-cue-writing-direction" class="internalDFN">writing direction</a>.</p>
- <p>The text position is either a number giving the position of the <a title="text track cue
- box" href="#dfn-text-track-cue-box" class="internalDFN">cue box</a> as a percentage value or the special value <dfn title="text track cue
- automatic text position" id="dfn-text-track-cue-automatic-text-position">auto</dfn>, which means the position is to depend on the <a title="text track cue text alignment" href="#dfn-text-track-cue-text-alignment" class="internalDFN">text alignment</a> of the cue.</p>
+ <p>The text position is either a number giving the position of the <a title="WebVTT cue
+ box" href="#dfn-webvtt-cue-box" class="internalDFN">cue box</a> as a percentage value or the special value <dfn title="WebVTT cue automatic
+ text position" id="dfn-webvtt-cue-automatic-text-position">auto</dfn>, which means the position is to depend on the <a title="WebVTT cue
+ text alignment" href="#dfn-webvtt-cue-text-alignment" class="internalDFN">text alignment</a> of the cue.</p>
- <p>If the cue is not within a <a title="text track region" href="#dfn-text-track-region" class="internalDFN">region</a>, the percentage value is
- to be interpreted as a percentage of the video dimensions, otherwise as a percentage of the
+ <p>If the cue is not within a <a title="WebVTT region" href="#dfn-webvtt-region" class="internalDFN">region</a>, the percentage value is to
+ be interpreted as a percentage of the video dimensions, otherwise as a percentage of the
region dimensions.</p>
- <p>A <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> has a <dfn id="dfn-text-track-cue-computed-text-position">text track cue computed text position</dfn> whose value is
- that returned by the following algorithm, which is defined in terms of the other aspects of
- the cue:</p>
+ <p>A <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> has a <dfn id="dfn-webvtt-cue-computed-text-position">WebVTT cue computed text position</dfn> whose value is that
+ returned by the following algorithm, which is defined in terms of the other aspects of the
+ cue:</p>
<ol>
- <li><p>If the <a href="#dfn-text-track-cue-text-position" class="internalDFN">text track cue text position</a> is numeric, then return the value of the
- <a href="#dfn-text-track-cue-text-position" class="internalDFN">text track cue text position</a> and abort these steps. (Otherwise, the <a href="#dfn-text-track-cue-text-position" class="internalDFN">text track cue
- text position</a> is the special value <a title="text track cue automatic text
- position" href="#dfn-text-track-cue-automatic-text-position" class="internalDFN">auto</a>.)</p></li>
+ <li><p>If the <a href="#dfn-webvtt-cue-text-position" class="internalDFN">WebVTT cue text position</a> is numeric, then return the value of the
+ <a href="#dfn-webvtt-cue-text-position" class="internalDFN">WebVTT cue text position</a> and abort these steps. (Otherwise, the <a href="#dfn-webvtt-cue-text-position" class="internalDFN">WebVTT cue text
+ position</a> is the special value <a title="WebVTT cue automatic text
+ position" href="#dfn-webvtt-cue-automatic-text-position" class="internalDFN">auto</a>.)</p></li>
- <li><p>If the <a href="#dfn-text-track-cue-text-alignment" class="internalDFN">text track cue text alignment</a> is <a title="text track cue start
- alignment" href="#dfn-text-track-cue-start-alignment" class="internalDFN">start</a> or <a title="text track cue left alignment" href="#dfn-text-track-cue-left-alignment" class="internalDFN">left</a>, return 0 and abort
+ <li><p>If the <a href="#dfn-webvtt-cue-text-alignment" class="internalDFN">WebVTT cue text alignment</a> is <a title="WebVTT cue start
+ alignment" href="#dfn-webvtt-cue-start-alignment" class="internalDFN">start</a> or <a title="WebVTT cue left alignment" href="#dfn-webvtt-cue-left-alignment" class="internalDFN">left</a>, return 0 and abort
these steps.</p></li>
- <li><p>If the <a href="#dfn-text-track-cue-text-alignment" class="internalDFN">text track cue text alignment</a> is <a title="text track cue end
- alignment" href="#dfn-text-track-cue-end-alignment" class="internalDFN">end</a> or <a title="text track cue right alignment" href="#dfn-text-track-cue-right-alignment" class="internalDFN">right</a>, return 100 and
- abort these steps.</p></li>
+ <li><p>If the <a href="#dfn-webvtt-cue-text-alignment" class="internalDFN">WebVTT cue text alignment</a> is <a title="WebVTT cue end alignment" href="#dfn-webvtt-cue-end-alignment" class="internalDFN">end</a>
+ or <a title="WebVTT cue right alignment" href="#dfn-webvtt-cue-right-alignment" class="internalDFN">right</a>, return 100 and abort these
+ steps.</p></li>
- <li><p>If the <a href="#dfn-text-track-cue-text-alignment" class="internalDFN">text track cue text alignment</a> is <a title="text track cue middle
- alignment" href="#dfn-text-track-cue-middle-alignment" class="internalDFN">middle</a>, return 50 and abort these steps.</p></li>
+ <li><p>If the <a href="#dfn-webvtt-cue-text-alignment" class="internalDFN">WebVTT cue text alignment</a> is <a title="WebVTT cue middle
+ alignment" href="#dfn-webvtt-cue-middle-alignment" class="internalDFN">middle</a>, return 50 and abort these steps.</p></li>
</ol>
- <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_3"><span>Note</span></div><p class="">Since the default value of the <a href="#dfn-text-track-cue-text-alignment" class="internalDFN">text track cue text alignment</a> is <a title="text track cue middle alignment" href="#dfn-text-track-cue-middle-alignment" class="internalDFN">middle</a>, if there is no <a href="#dfn-text-track-cue-text-alignment" class="internalDFN">text track cue text
- alignment</a> setting for a cue, the <a href="#dfn-text-track-cue-text-position" class="internalDFN">text track cue text position</a> defaults to 50%.</p></div>
+ <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_3"><span>Note</span></div><p class="">Since the default value of the <a href="#dfn-webvtt-cue-text-alignment" class="internalDFN">WebVTT cue text alignment</a> is <a title="WebVTT cue middle alignment" href="#dfn-webvtt-cue-middle-alignment" class="internalDFN">middle</a>, if there is no <a href="#dfn-webvtt-cue-text-alignment" class="internalDFN">WebVTT cue text
+ alignment</a> setting for a cue, the <a href="#dfn-webvtt-cue-text-position" class="internalDFN">WebVTT cue text position</a> defaults to 50%.</p></div>
- <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_4"><span>Note</span></div><p class="">Even for <a title="text track cue horizontal writing direction" href="#dfn-text-track-cue-horizontal-writing-direction" class="internalDFN">horizontal</a>
- cues with right-to-left <i>paragraph direction</i> text, the <a title="text track cue box" href="#dfn-text-track-cue-box" class="internalDFN">cue
+ <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_4"><span>Note</span></div><p class="">Even for <a title="WebVTT cue horizontal writing direction" href="#dfn-webvtt-cue-horizontal-writing-direction" class="internalDFN">horizontal</a>
+ cues with right-to-left <i>paragraph direction</i> text, the <a title="WebVTT cue box" href="#dfn-webvtt-cue-box" class="internalDFN">cue
box</a> is positioned from the left edge of the video frame. This allows defining a rendering
space template which can be filled with either left-to-right or right-to-left <i>paragraph
- direction</i> text. If such a <a title="text track cue box" href="#dfn-text-track-cue-box" class="internalDFN">cue box</a> template is created
- with <a title="text track cue start alignment" href="#dfn-text-track-cue-start-alignment" class="internalDFN">start</a> or <a title="text track cue end
- alignment" href="#dfn-text-track-cue-end-alignment" class="internalDFN">end</a> aligned text, it is best to also specify a <a title="text track cue
- size" href="#dfn-text-track-cue-size" class="internalDFN">size</a> since otherwise the text may flip from one side of the video frame to the
- other.</p></div>
+ direction</i> text. If such a <a title="WebVTT cue box" href="#dfn-webvtt-cue-box" class="internalDFN">cue box</a> template is created with
+ <a title="WebVTT cue start alignment" href="#dfn-webvtt-cue-start-alignment" class="internalDFN">start</a> or <a title="WebVTT cue end alignment" href="#dfn-webvtt-cue-end-alignment" class="internalDFN">end</a>
+ aligned text, it is best to also specify a <a title="WebVTT cue size" href="#dfn-webvtt-cue-size" class="internalDFN">size</a> since otherwise
+ the text may flip from one side of the video frame to the other.</p></div>
</dd>
- <dt><dfn title="text track cue text position alignment" id="dfn-text-track-cue-text-position-alignment">A text position alignment</dfn></dt>
+ <dt><dfn title="WebVTT cue text position alignment" id="dfn-webvtt-cue-text-position-alignment">A text position alignment</dfn></dt>
<dd>
- <p>An alignment for the <a title="text track cue box" href="#dfn-text-track-cue-box" class="internalDFN">cue box</a> in the dimension of the <a title="text track cue writing direction" href="#dfn-text-track-cue-writing-direction" class="internalDFN">writing direction</a>, describing which part of the
- <a title="text track cue box" href="#dfn-text-track-cue-box" class="internalDFN">cue box</a> is aligned to the <a title="text track cue text
- position" href="#dfn-text-track-cue-text-position" class="internalDFN">text position</a>, one of:</p>
+ <p>An alignment for the <a title="WebVTT cue box" href="#dfn-webvtt-cue-box" class="internalDFN">cue box</a> in the dimension of the <a title="WebVTT cue writing direction" href="#dfn-webvtt-cue-writing-direction" class="internalDFN">writing direction</a>, describing which part of the <a title="WebVTT cue box" href="#dfn-webvtt-cue-box" class="internalDFN">cue box</a> is aligned to the <a title="WebVTT cue text position" href="#dfn-webvtt-cue-text-position" class="internalDFN">text
+ position</a>, one of:</p>
<dl>
- <dt><dfn title="text track cue text position start alignment" id="dfn-text-track-cue-text-position-start-alignment">Start alignment</dfn></dt>
- <dd>The <a title="text track cue box" href="#dfn-text-track-cue-box" class="internalDFN">cue box</a>'s left side (for <a title="text track cue
- horizontal writing direction" href="#dfn-text-track-cue-horizontal-writing-direction" class="internalDFN">horizontal</a> cues) or top side (otherwise) is aligned at the
- <a title="text track cue text position" href="#dfn-text-track-cue-text-position" class="internalDFN">text position</a>.</dd>
-
- <dt><dfn title="text track cue text position middle alignment" id="dfn-text-track-cue-text-position-middle-alignment">Middle alignment</dfn></dt>
- <dd>The <a title="text track cue box" href="#dfn-text-track-cue-box" class="internalDFN">cue box</a> is centered at the <a title="text track cue
- text position" href="#dfn-text-track-cue-text-position" class="internalDFN">text position</a>.</dd>
-
- <dt><dfn title="text track cue text position end alignment" id="dfn-text-track-cue-text-position-end-alignment">End alignment</dfn></dt>
- <dd>The <a title="text track cue box" href="#dfn-text-track-cue-box" class="internalDFN">cue box</a>'s right side (for <a title="text track cue
- horizontal writing direction" href="#dfn-text-track-cue-horizontal-writing-direction" class="internalDFN">horizontal</a> cues) or bottom side (otherwise) is aligned at
- the <a title="text track cue text position" href="#dfn-text-track-cue-text-position" class="internalDFN">text position</a>.</dd>
+ <dt><dfn title="WebVTT cue text position start alignment" id="dfn-webvtt-cue-text-position-start-alignment">Start alignment</dfn></dt>
+ <dd>The <a title="WebVTT cue box" href="#dfn-webvtt-cue-box" class="internalDFN">cue box</a>'s left side (for <a title="WebVTT cue
+ horizontal writing direction" href="#dfn-webvtt-cue-horizontal-writing-direction" class="internalDFN">horizontal</a> cues) or top side (otherwise) is aligned at the
+ <a title="WebVTT cue text position" href="#dfn-webvtt-cue-text-position" class="internalDFN">text position</a>.</dd>
+
+ <dt><dfn title="WebVTT cue text position middle alignment" id="dfn-webvtt-cue-text-position-middle-alignment">Middle alignment</dfn></dt>
+ <dd>The <a title="WebVTT cue box" href="#dfn-webvtt-cue-box" class="internalDFN">cue box</a> is centered at the <a title="WebVTT cue text
+ position" href="#dfn-webvtt-cue-text-position" class="internalDFN">text position</a>.</dd>
+
+ <dt><dfn title="WebVTT cue text position end alignment" id="dfn-webvtt-cue-text-position-end-alignment">End alignment</dfn></dt>
+ <dd>The <a title="WebVTT cue box" href="#dfn-webvtt-cue-box" class="internalDFN">cue box</a>'s right side (for <a title="WebVTT cue
+ horizontal writing direction" href="#dfn-webvtt-cue-horizontal-writing-direction" class="internalDFN">horizontal</a> cues) or bottom side (otherwise) is aligned at
+ the <a title="WebVTT cue text position" href="#dfn-webvtt-cue-text-position" class="internalDFN">text position</a>.</dd>
- <dt><dfn title="text track cue text position automatic alignment" id="dfn-text-track-cue-text-position-automatic-alignment">Auto alignment</dfn></dt>
- <dd>The <a title="text track cue box" href="#dfn-text-track-cue-box" class="internalDFN">cue box</a>'s alignment depends on the value of the <a title="text track cue text alignment" href="#dfn-text-track-cue-text-alignment" class="internalDFN">text alignment</a> of the cue.</dd>
+ <dt><dfn title="WebVTT cue text position automatic alignment" id="dfn-webvtt-cue-text-position-automatic-alignment">Auto alignment</dfn></dt>
+ <dd>The <a title="WebVTT cue box" href="#dfn-webvtt-cue-box" class="internalDFN">cue box</a>'s alignment depends on the value of the <a title="WebVTT cue text alignment" href="#dfn-webvtt-cue-text-alignment" class="internalDFN">text alignment</a> of the cue.</dd>
</dl>
- <p>A <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> has a <dfn id="dfn-text-track-cue-computed-text-position-alignment">text track cue computed text position alignment</dfn> whose
+ <p>A <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> has a <dfn id="dfn-webvtt-cue-computed-text-position-alignment">WebVTT cue computed text position alignment</dfn> whose
value is that returned by the following algorithm, which is defined in terms of other aspects
of the cue:</p>
<ol>
- <li><p>If the <a href="#dfn-text-track-cue-text-position-alignment" class="internalDFN">text track cue text position alignment</a> is not <a title="text track cue
- text position automatic alignment" href="#dfn-text-track-cue-text-position-automatic-alignment" class="internalDFN">auto</a>, then return the value of the <a href="#dfn-text-track-cue-text-position-alignment" class="internalDFN">text track cue
- text position alignment</a> and abort these steps.</p></li>
-
- <li><p>If the <a href="#dfn-text-track-cue-text-alignment" class="internalDFN">text track cue text alignment</a> is <a title="text track cue start
- alignment" href="#dfn-text-track-cue-start-alignment" class="internalDFN">start</a> or <a title="text track cue left alignment" href="#dfn-text-track-cue-left-alignment" class="internalDFN">left</a>, return <a title="text track cue text position start alignment" href="#dfn-text-track-cue-text-position-start-alignment" class="internalDFN">start</a> and abort these
- steps.</p></li>
-
- <li><p>If the <a href="#dfn-text-track-cue-text-alignment" class="internalDFN">text track cue text alignment</a> is <a title="text track cue end
[1682 lines skipped]
Received on Tuesday, 17 March 2015 08:17:55 UTC