- From: CVS User pjgenste <cvsmail@w3.org>
- Date: Mon, 10 Aug 2015 08:55:48 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/webvtt
In directory roscoe:/var/tmp/cvs-serv13330
Modified Files:
Overview.html
Log Message:
Sync WebVTT with Git commit d9c8059e2829394cb1b9e769768168e05ab4e91f
--- /sources/public/html5/webvtt/Overview.html 2015/08/05 08:12:46 1.229
+++ /sources/public/html5/webvtt/Overview.html 2015/08/10 08:55:47 1.230
@@ -3,7 +3,7 @@
<head>
<title>WebVTT: The Web Video Text Tracks Format</title>
<meta charset="utf-8">
- <meta name="revision" content="0f75fb9bea13ed1fb99dd4f98141933a3476a8b0">
+ <meta name="revision" content="d9c8059e2829394cb1b9e769768168e05ab4e91f">
@@ -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-05-august-2015">Draft Community Group Report <time class="dt-published" datetime="2015-08-05">05 August 2015</time></h2>
+ <h2 id="draft-community-group-report-10-august-2015">Draft Community Group Report <time class="dt-published" datetime="2015-08-10">10 August 2015</time></h2>
<dl>
@@ -877,8 +877,8 @@
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="WebVTT cue box" href="#dfn-webvtt-cue-box" class="internalDFN">cue box</a> within the video
- viewport's dimensions depends on the value of the <a href="#dfn-webvtt-cue-position" class="internalDFN">WebVTT cue position</a> and the <a href="#dfn-webvtt-cue-line" class="internalDFN">WebVTT
- cue line</a>.</p></div>
+ 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-offset" class="internalDFN">WebVTT cue line offset</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="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>
@@ -886,34 +886,22 @@
<dt><dfn title="WebVTT cue writing direction" id="dfn-webvtt-cue-writing-direction">A writing direction</dfn></dt>
<dd>
- <p>A writing direction, either</p>
- <ul>
-
- <li><dfn title="WebVTT cue horizontal writing direction" id="dfn-webvtt-cue-horizontal-writing-direction">horizontal</dfn> (a line extends
- horizontally and is offset vertically from the video viewport's top edge, with consecutive
- lines displayed below each other),</li>
-
- <li> <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 offset horizontally from the video viewport's
- right edge, with consecutive lines displayed to the left of each other<!-- used for east
- asian-->), or</li>
-
- <li><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 offset horizontally from the video viewport's
- left edge, with consecutive lines displayed to the right of each other<!-- used for mongolian
- -->).</li>
-
- </ul>
+ <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 offset 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 offset
+ 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 offset horizontally, with consecutive
+ lines displayed to the right of each other<!-- used for mongolian -->).</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" href="#dfn-webvtt-cue-line" class="internalDFN">cue
- line</a> percentages are relative to the height of the video, and <a title="WebVTT cue
- position" href="#dfn-webvtt-cue-position" class="internalDFN">cue 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="WebVTT cue line" href="#dfn-webvtt-cue-line" class="internalDFN">cue line</a> percentages are relative to the width of
- the video, and <a title="WebVTT cue position" href="#dfn-webvtt-cue-position" class="internalDFN">cue 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>
+ cue horizontal writing direction" href="#dfn-webvtt-cue-horizontal-writing-direction" class="internalDFN">horizontal</a>, then the <a title="WebVTT cue line
+ offset" href="#dfn-webvtt-cue-line-offset" class="internalDFN">line offset</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="WebVTT cue line offset" href="#dfn-webvtt-cue-line-offset" class="internalDFN">line offset</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="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>
@@ -922,10 +910,9 @@
<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="WebVTT cue line" href="#dfn-webvtt-cue-line" class="internalDFN">cue line</a> is an integer
- number of lines (using the line dimensions of the first line of the cue), or whether it is a
- percentage of the dimension of the video. The flag is set when lines are counted, unset
- otherwise.</p>
+ <p>A boolean indicating whether the <a title="WebVTT cue line offset" href="#dfn-webvtt-cue-line-offset" class="internalDFN">line's offset</a> is a
+ line offset (offset by 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-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 offset as requested
@@ -936,40 +923,34 @@
</dd>
- <dt><dfn title="WebVTT cue line" id="dfn-webvtt-cue-line">A cue line</dfn></dt>
+ <dt><dfn title="WebVTT cue line offset" id="dfn-webvtt-cue-line-offset">A line offset</dfn></dt>
<dd>
- <p>The <a title="WebVTT cue line" href="#dfn-webvtt-cue-line" class="internalDFN">cue line</a> defines positioning of the <a title="WebVTT cue
- box" href="#dfn-webvtt-cue-box" class="internalDFN">cue box</a>.</p>
+ <p>The line offset defines positioning of the <a title="WebVTT cue box" href="#dfn-webvtt-cue-box" class="internalDFN">cue box</a>.</p>
- <p>The <a title="WebVTT cue line" href="#dfn-webvtt-cue-line" class="internalDFN">cue line</a> offsets the <a title="WebVTT cue box" href="#dfn-webvtt-cue-box" class="internalDFN">cue
- box</a> from the top, the right or left of the video viewport as defined by the <a title="WebVTT cue writing direction" href="#dfn-webvtt-cue-writing-direction" class="internalDFN">writing direction</a>, the <a title="WebVTT cue
- snap-to-lines flag" href="#dfn-webvtt-cue-snap-to-lines-flag" class="internalDFN">snap-to-lines flag</a>, or the lines occupied by any other showing
- tracks.</p>
-
- <p>The <a title="WebVTT cue line" href="#dfn-webvtt-cue-line" class="internalDFN">cue line</a> is set either as a number of lines, a
- percentage of the video viewport height or width, or as the special value <dfn title="WebVTT
- cue line automatic" id="dfn-webvtt-cue-line-automatic">auto</dfn>, which means the offset is to depend on the other showing
- tracks.</p>
-
- <p>A <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> has a <dfn title="cue computed line" id="dfn-cue-computed-line">computed line</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 line offset is either a number giving the offset of the lines of the cue, to be
+ 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 offset" id="dfn-webvtt-cue-automatic-line-offset">auto</dfn>, which means the offset is to
+ depend on the other showing tracks.</p>
- <ol>
+ <p>A <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> has a <dfn title="cue computed line offset" id="dfn-cue-computed-line-offset">computed line offset</dfn>
+ whose value is that returned by the following algorithm, which is defined in terms of the
+ other aspects of the cue:</p>
- <li><p>If the <a title="WebVTT cue line" href="#dfn-webvtt-cue-line" class="internalDFN">cue line</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 title="WebVTT cue
- line" href="#dfn-webvtt-cue-line" class="internalDFN">cue line</a> is negative or greater than 100, then return 100 and abort these
- steps.</p></li>
+ <ol>
- <li><p>If the <a title="WebVTT cue line" href="#dfn-webvtt-cue-line" class="internalDFN">cue line</a> is numeric, return the value of the
- <a href="#dfn-webvtt-cue-line" class="internalDFN">WebVTT cue line</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-line-offset" class="internalDFN">WebVTT cue line offset</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-offset" class="internalDFN">WebVTT cue line offset</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-offset" class="internalDFN">WebVTT cue line offset</a> is numeric, return the value of the <a href="#dfn-webvtt-cue-line-offset" class="internalDFN">WebVTT cue
+ line offset</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 title="WebVTT cue line" href="#dfn-webvtt-cue-line" class="internalDFN">cue line</a> is
- the special value <a title="WebVTT cue line automatic" href="#dfn-webvtt-cue-line-automatic" class="internalDFN">auto</a>.)</p></li>
+ return the value 100 and abort these steps. (The <a href="#dfn-webvtt-cue-line-offset" class="internalDFN">WebVTT cue line offset</a> is the special
+ value <a title="WebVTT cue automatic line offset" href="#dfn-webvtt-cue-automatic-line-offset" 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>
@@ -996,8 +977,8 @@
<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="WebVTT cue box" href="#dfn-webvtt-cue-box" class="internalDFN">cue box</a>'s <a title="WebVTT cue line" href="#dfn-webvtt-cue-line" class="internalDFN">cue
- line</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
+ offset" href="#dfn-webvtt-cue-line-offset" class="internalDFN">line offset</a>, one of:</p>
<dl>
@@ -1005,17 +986,17 @@
<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" href="#dfn-webvtt-cue-line" class="internalDFN">cue line</a>.</dd>
+ 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 offset" href="#dfn-webvtt-cue-line-offset" class="internalDFN">line offset</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" href="#dfn-webvtt-cue-line" class="internalDFN">cue line</a>.</dd>
+ <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
+ offset" href="#dfn-webvtt-cue-line-offset" class="internalDFN">line offset</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" href="#dfn-webvtt-cue-line" class="internalDFN">cue line</a>.</dd>
+ aligned at the <a title="WebVTT cue line offset" href="#dfn-webvtt-cue-line-offset" class="internalDFN">line offset</a>.</dd>
</dl>
@@ -1024,111 +1005,111 @@
</dd>
- <dt><dfn title="WebVTT cue position" id="dfn-webvtt-cue-position">A cue position</dfn></dt>
+ <dt><dfn title="WebVTT cue text position" id="dfn-webvtt-cue-text-position">A text position</dfn></dt>
<dd>
- <p>The <a title="WebVTT cue position" href="#dfn-webvtt-cue-position" class="internalDFN">cue position</a> defines the indent 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 defines the offset 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 <a title="WebVTT cue position" href="#dfn-webvtt-cue-position" class="internalDFN">cue position</a> 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 position" id="dfn-webvtt-cue-automatic-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>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="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 title="cue computed position" id="dfn-cue-computed-position">computed cue 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 title="cue computed text position" id="dfn-cue-computed-text-position">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 title="WebVTT cue position" href="#dfn-webvtt-cue-position" class="internalDFN">cue position</a> is numeric, then return the
- value of the <a title="WebVTT cue position" href="#dfn-webvtt-cue-position" class="internalDFN">cue position</a> and abort these steps.
- (Otherwise, the <a title="WebVTT cue position" href="#dfn-webvtt-cue-position" class="internalDFN">cue position</a> is the special value <a title="WebVTT cue automatic position" href="#dfn-webvtt-cue-automatic-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 title="WebVTT cue text alignment" href="#dfn-webvtt-cue-text-alignment" class="internalDFN">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-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 title="WebVTT cue text alignment" href="#dfn-webvtt-cue-text-alignment" class="internalDFN">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-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 title="WebVTT cue text alignment" href="#dfn-webvtt-cue-text-alignment" class="internalDFN">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>
+ <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-webvtt-cue-position-alignment" class="internalDFN">WebVTT cue position 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-position" class="internalDFN">WebVTT cue 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="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 viewport. 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="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 viewport to the
- other.</p></div>
+ 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="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="WebVTT cue position alignment" id="dfn-webvtt-cue-position-alignment">A cue 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="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 what the <a title="WebVTT cue position" href="#dfn-webvtt-cue-position" class="internalDFN">cue position</a> is anchored to, 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 what the <a title="WebVTT cue text position" href="#dfn-webvtt-cue-text-position" class="internalDFN">text position</a> is anchored to, one of:</p>
<dl>
- <dt><dfn title="WebVTT cue position start alignment" id="dfn-webvtt-cue-position-start-alignment">Start alignment</dfn></dt>
+ <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 position" href="#dfn-webvtt-cue-position" class="internalDFN">cue position</a>.</dd>
+ <a title="WebVTT cue text position" href="#dfn-webvtt-cue-text-position" class="internalDFN">text position</a>.</dd>
- <dt><dfn title="WebVTT cue position middle alignment" id="dfn-webvtt-cue-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
- position" href="#dfn-webvtt-cue-position" class="internalDFN">cue 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 position end alignment" id="dfn-webvtt-cue-position-end-alignment">End alignment</dfn></dt>
+ <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 position" href="#dfn-webvtt-cue-position" class="internalDFN">cue position</a>.</dd>
+ the <a title="WebVTT cue text position" href="#dfn-webvtt-cue-text-position" class="internalDFN">text position</a>.</dd>
- <dt><dfn title="WebVTT cue position automatic alignment" id="dfn-webvtt-cue-position-automatic-alignment">Auto alignment</dfn></dt>
+ <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 title="cue computed position alignment" id="dfn-cue-computed-position-alignment">computed cue
+ <p>A <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> has a <dfn title="cue computed text position alignment" id="dfn-cue-computed-text-position-alignment">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-webvtt-cue-position-alignment" class="internalDFN">WebVTT cue position alignment</a> is not <a title="WebVTT cue position
- automatic alignment" href="#dfn-webvtt-cue-position-automatic-alignment" class="internalDFN">auto</a>, then return the value of the <a href="#dfn-webvtt-cue-position-alignment" class="internalDFN">WebVTT cue position
- alignment</a> and abort these steps.</p></li>
+ <li><p>If the <a href="#dfn-webvtt-cue-text-position-alignment" class="internalDFN">WebVTT cue text position alignment</a> is not <a title="WebVTT cue text
+ position automatic alignment" href="#dfn-webvtt-cue-text-position-automatic-alignment" class="internalDFN">auto</a>, then return the value of the <a href="#dfn-webvtt-cue-text-position-alignment" class="internalDFN">WebVTT cue text
+ position alignment</a> 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 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 <a title="WebVTT cue position start alignment" href="#dfn-webvtt-cue-position-start-alignment" class="internalDFN">start</a> and abort these steps.</p></li>
+ 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 <a title="WebVTT cue text position start alignment" href="#dfn-webvtt-cue-text-position-start-alignment" class="internalDFN">start</a> 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 <a title="WebVTT cue position end
- alignment" href="#dfn-webvtt-cue-position-end-alignment" class="internalDFN">end</a> and abort these steps.</p></li>
+ or <a title="WebVTT cue right alignment" href="#dfn-webvtt-cue-right-alignment" class="internalDFN">right</a>, return <a title="WebVTT cue text position
+ end alignment" href="#dfn-webvtt-cue-text-position-end-alignment" class="internalDFN">end</a> 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 <a title="WebVTT cue position middle alignment" href="#dfn-webvtt-cue-position-middle-alignment" class="internalDFN">middle</a> and
- abort these steps.</p></li>
+ alignment" href="#dfn-webvtt-cue-middle-alignment" class="internalDFN">middle</a>, return <a title="WebVTT cue text position middle alignment" href="#dfn-webvtt-cue-text-position-middle-alignment" class="internalDFN">middle</a>
+ and abort these steps.</p></li>
</ol>
- <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_5"><span>Note</span></div><p class="">Since the <a title="WebVTT cue position" href="#dfn-webvtt-cue-position" class="internalDFN">cue position</a> always measures from
- the left of the video (for <a title="WebVTT cue horizontal writing direction" href="#dfn-webvtt-cue-horizontal-writing-direction" class="internalDFN">horizontal</a>
- cues) or the top (otherwise), the <a href="#dfn-webvtt-cue-position-alignment" class="internalDFN">WebVTT cue position alignment</a> <a title="WebVTT cue
- position start alignment" href="#dfn-webvtt-cue-position-start-alignment" class="internalDFN">start value</a> varies between left and top for horizontal and
- vertical cues, but not between left and right even for changing <i>paragraph
- direction</i>.</p></div>
+ <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_5"><span>Note</span></div><p class="">Since the <a href="#dfn-webvtt-cue-text-position" class="internalDFN">WebVTT cue text position</a> always measures from the left of the
+ video (for <a title="WebVTT cue horizontal writing direction" href="#dfn-webvtt-cue-horizontal-writing-direction" class="internalDFN">horizontal</a> cues) or the top
+ (otherwise), the <a href="#dfn-webvtt-cue-text-position-alignment" class="internalDFN">WebVTT cue text position alignment</a> <a title="WebVTT cue text position
+ start alignment" href="#dfn-webvtt-cue-text-position-start-alignment" class="internalDFN">start value</a> varies between left and top for horizontal and vertical cues,
+ but not between left and right even for changing <i>paragraph direction</i>.</p></div>
</dd>
@@ -1187,7 +1168,8 @@
<p>When a <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> whose <a title="text track cue active flag" href="#dfn-text-track-cue-active-flag" class="internalDFN">active flag</a> is set
has its <a title="WebVTT cue writing direction" href="#dfn-webvtt-cue-writing-direction" class="internalDFN">writing direction</a>, <a title="WebVTT cue
- snap-to-lines flag" href="#dfn-webvtt-cue-snap-to-lines-flag" class="internalDFN">snap-to-lines flag</a>, <a title="WebVTT cue line" href="#dfn-webvtt-cue-line" class="internalDFN">cue line</a>, <a title="WebVTT cue position" href="#dfn-webvtt-cue-position" class="internalDFN">cue position</a>, <a title="WebVTT cue size" href="#dfn-webvtt-cue-size" class="internalDFN">size</a>, <a title="WebVTT cue text alignment" href="#dfn-webvtt-cue-text-alignment" class="internalDFN">text alignment</a>, <a title="WebVTT cue region" href="#dfn-webvtt-cue-region" class="internalDFN">region</a>,
+ snap-to-lines flag" href="#dfn-webvtt-cue-snap-to-lines-flag" class="internalDFN">snap-to-lines flag</a>, <a title="WebVTT cue line offset" href="#dfn-webvtt-cue-line-offset" class="internalDFN">line offset</a>,
+ <a title="WebVTT cue text position" href="#dfn-webvtt-cue-text-position" class="internalDFN">text position</a>, <a title="WebVTT cue size" href="#dfn-webvtt-cue-size" class="internalDFN">size</a>, <a title="WebVTT cue text alignment" href="#dfn-webvtt-cue-text-alignment" class="internalDFN">text alignment</a>, <a title="WebVTT cue region" href="#dfn-webvtt-cue-region" class="internalDFN">region</a>,
or <a title="text track cue text" href="#dfn-text-track-cue-text" class="internalDFN">text</a> change value, then the user agent must empty the
<a href="#dfn-text-track-cue-display-state" class="internalDFN">text track cue display state</a>, and then immediately run the <a href="#dfn-text-track" class="internalDFN">text track</a>'s <a href="#dfn-rules-for-updating-the-display-of-webvtt-text-tracks" class="internalDFN">rules
for updating the display of WebVTT text tracks</a>.</p>
@@ -1865,8 +1847,8 @@
<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-cue-setting" class="internalDFN">WebVTT line cue setting</a>.</li>
- <li>A <a href="#dfn-webvtt-position-cue-setting" class="internalDFN">WebVTT position cue setting</a>.</li>
+ <li>A <a href="#dfn-webvtt-line-offset-cue-setting" class="internalDFN">WebVTT line offset 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>
@@ -1891,8 +1873,8 @@
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-cue-setting">WebVTT line cue setting</dfn> consists of the following components, in the order
- given:</p>
+ <p>A <dfn id="dfn-webvtt-line-offset-cue-setting">WebVTT line offset 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>
@@ -1903,7 +1885,7 @@
<li>
an offset value, either:
<dl>
- <dt>To represent a specific offset relative to the video viewport</dt>
+ <dt>To represent a specific offset relative to the video frame</dt>
<dd>
<p>A <a href="#dfn-webvtt-percentage" class="internalDFN">WebVTT percentage</a>.</p>
</dd>
@@ -1928,19 +1910,18 @@
</li>
</ol>
[519 lines skipped]
Received on Monday, 10 August 2015 08:55:51 UTC