- From: CVS User pjgenste <cvsmail@w3.org>
- Date: Mon, 10 Aug 2015 11:34:51 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/webvtt
In directory roscoe:/var/tmp/cvs-serv21257
Modified Files:
Overview.html
Log Message:
Sync WebVTT with Git commit fbb24933ec1bdb9e968d61425d300867d8809f20
--- /sources/public/html5/webvtt/Overview.html 2015/08/10 08:55:47 1.230
+++ /sources/public/html5/webvtt/Overview.html 2015/08/10 11:34:51 1.231
@@ -3,7 +3,7 @@
<head>
<title>WebVTT: The Web Video Text Tracks Format</title>
<meta charset="utf-8">
- <meta name="revision" content="d9c8059e2829394cb1b9e769768168e05ab4e91f">
+ <meta name="revision" content="fbb24933ec1bdb9e968d61425d300867d8809f20">
@@ -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
- 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>
+ 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>
<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,22 +886,34 @@
<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="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>A writing direction, either</p>
+ <ul>
- <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
- 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>
+ <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>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>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>
<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>
@@ -910,9 +922,10 @@
<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 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>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>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
@@ -923,34 +936,40 @@
</dd>
- <dt><dfn title="WebVTT cue line offset" id="dfn-webvtt-cue-line-offset">A line offset</dfn></dt>
+ <dt><dfn title="WebVTT cue line" id="dfn-webvtt-cue-line">A cue line</dfn></dt>
<dd>
- <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> defines positioning of the <a title="WebVTT cue
+ box" href="#dfn-webvtt-cue-box" class="internalDFN">cue box</a>.</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>
-
- <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>
+ <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>
<ol>
- <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 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>
+
+ <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-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-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>
+ 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>
<li><p>Let <var>cue</var> be the <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a>.</p></li>
@@ -977,8 +996,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
- offset" href="#dfn-webvtt-cue-line-offset" class="internalDFN">line offset</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" href="#dfn-webvtt-cue-line" class="internalDFN">cue
+ line</a>, one of:</p>
<dl>
@@ -986,17 +1005,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 offset" href="#dfn-webvtt-cue-line-offset" class="internalDFN">line offset</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" href="#dfn-webvtt-cue-line" class="internalDFN">cue line</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
- offset" href="#dfn-webvtt-cue-line-offset" class="internalDFN">line offset</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" href="#dfn-webvtt-cue-line" class="internalDFN">cue line</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 offset" href="#dfn-webvtt-cue-line-offset" class="internalDFN">line offset</a>.</dd>
+ aligned at the <a title="WebVTT cue line" href="#dfn-webvtt-cue-line" class="internalDFN">cue line</a>.</dd>
</dl>
@@ -1005,111 +1024,111 @@
</dd>
- <dt><dfn title="WebVTT cue text position" id="dfn-webvtt-cue-text-position">A text position</dfn></dt>
+ <dt><dfn title="WebVTT cue position" id="dfn-webvtt-cue-position">A cue position</dfn></dt>
<dd>
- <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> 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 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>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>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 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>
+ <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>
<ol>
- <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 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-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 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 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 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 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 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>
</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-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_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_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="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>
+ 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>
</dd>
- <dt><dfn title="WebVTT cue text position alignment" id="dfn-webvtt-cue-text-position-alignment">A text position alignment</dfn></dt>
+ <dt><dfn title="WebVTT cue position alignment" id="dfn-webvtt-cue-position-alignment">A cue 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 text position" href="#dfn-webvtt-cue-text-position" class="internalDFN">text 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 position" href="#dfn-webvtt-cue-position" class="internalDFN">cue position</a> is anchored to, one of:</p>
<dl>
- <dt><dfn title="WebVTT cue text position start alignment" id="dfn-webvtt-cue-text-position-start-alignment">Start alignment</dfn></dt>
+ <dt><dfn title="WebVTT cue position start alignment" id="dfn-webvtt-cue-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>
+ <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 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 end alignment" id="dfn-webvtt-cue-text-position-end-alignment">End alignment</dfn></dt>
+ <dt><dfn title="WebVTT cue position end alignment" id="dfn-webvtt-cue-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>
+ the <a title="WebVTT cue position" href="#dfn-webvtt-cue-position" class="internalDFN">cue position</a>.</dd>
- <dt><dfn title="WebVTT cue text position automatic alignment" id="dfn-webvtt-cue-text-position-automatic-alignment">Auto alignment</dfn></dt>
+ <dt><dfn title="WebVTT cue position automatic alignment" id="dfn-webvtt-cue-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 text position alignment" id="dfn-cue-computed-text-position-alignment">computed text
+ <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
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-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-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-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 text position start alignment" href="#dfn-webvtt-cue-text-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 position start alignment" href="#dfn-webvtt-cue-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 text position
- end alignment" href="#dfn-webvtt-cue-text-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 position end
+ alignment" href="#dfn-webvtt-cue-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 text position middle alignment" href="#dfn-webvtt-cue-text-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 position middle alignment" href="#dfn-webvtt-cue-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 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>
+ <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>
</dd>
@@ -1168,8 +1187,7 @@
<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 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>,
+ 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>,
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>
@@ -1847,8 +1865,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-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-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-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>
@@ -1873,8 +1891,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-offset-cue-setting">WebVTT line offset cue setting</dfn> consists of the following components, in the
- order given:</p>
+ <p>A <dfn id="dfn-webvtt-line-cue-setting">WebVTT line 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>
@@ -1885,7 +1903,7 @@
<li>
an offset value, either:
<dl>
- <dt>To represent a specific offset relative to the video frame</dt>
+ <dt>To represent a specific offset relative to the video viewport</dt>
<dd>
<p>A <a href="#dfn-webvtt-percentage" class="internalDFN">WebVTT percentage</a>.</p>
</dd>
@@ -1910,18 +1928,19 @@
</li>
</ol>
- <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_24"><span>Note</span></div><p class="">A <a href="#dfn-webvtt-line-offset-cue-setting" class="internalDFN">WebVTT line offset cue setting</a> configures the offset of the cue box in
- the direction opposite to the <a title="WebVTT cue writing direction" href="#dfn-webvtt-cue-writing-direction" class="internalDFN">writing direction</a>. For
- horizontal cues, this is the vertical offset. The offset is calculated relative to the <a title="WebVTT cue line start alignment" href="#dfn-webvtt-cue-line-start-alignment" class="internalDFN">start</a>, <a title="WebVTT cue line middle
- alignment" href="#dfn-webvtt-cue-line-middle-alignment" class="internalDFN">middle</a>, or <a title="WebVTT cue line end alignment" href="#dfn-webvtt-cue-line-end-alignment" class="internalDFN">end</a> of the cue box,
- depending on the <a href="#dfn-webvtt-cue-line-alignment" class="internalDFN">WebVTT cue line alignment</a> value - <a title="WebVTT cue line start
- alignment" href="#dfn-webvtt-cue-line-start-alignment" class="internalDFN">start</a> by default. The offset can be given either as a percentage of the video
- dimension or as a line number. Line numbers are based on the size of the first line of the cue.
- Positive line numbers count from the start of the video frame (the first line is numbered 0),
- negative line numbers from the end of the frame (the last line is numbered −1).</p></div>
[509 lines skipped]
Received on Monday, 10 August 2015 11:34:54 UTC