- From: CVS User pjgenste <cvsmail@w3.org>
- Date: Mon, 08 Jun 2015 12:50:33 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/webvtt
In directory roscoe:/var/tmp/cvs-serv11040
Modified Files:
Overview.html
Log Message:
Sync WebVTT with Git commit 2f0a190de41c6eaeebc63794ba458346f7977381
--- /sources/public/html5/webvtt/Overview.html 2015/06/08 11:55:59 1.221
+++ /sources/public/html5/webvtt/Overview.html 2015/06/08 12:50:33 1.222
@@ -3,7 +3,7 @@
<head>
<title>WebVTT: The Web Video Text Tracks Format</title>
<meta charset="utf-8">
- <meta name="revision" content="71e0e4c6849998a2c2742c1f9747ec690db1d538">
+ <meta name="revision" content="2f0a190de41c6eaeebc63794ba458346f7977381">
@@ -868,7 +868,7 @@
<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>
+ <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>
@@ -877,21 +877,21 @@
<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 positioned vertically, with
+ 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 positioned
+ 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 positioned horizontally, with
- consecutive lines displayed to the right of each other<!-- used for mongolian -->).</p>
+ 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
- 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>
+ 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 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>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>
@@ -900,47 +900,47 @@
<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 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>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 positioned as
- requested (modulo overlap avoidance if multiple cues are in the same place).</p>
+ area on user agents that use overscan. Cues with the flag unset will be offset as requested
+ (modulo overlap avoidance if multiple cues are in the same place).</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="WebVTT cue line position" id="dfn-webvtt-cue-line-position">A line position</dfn></dt>
+ <dt><dfn title="WebVTT cue line offset" id="dfn-webvtt-cue-line-offset">A line offset</dfn></dt>
<dd>
- <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>The line offset 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
+ <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 position" id="dfn-webvtt-cue-automatic-line-position">auto</dfn>, which means the position is
- to depend on the other showing tracks.</p>
+ 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 position" id="dfn-cue-computed-line-position">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>
+ <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>
<ol>
- <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
+ <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-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-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 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>
+ 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>
@@ -968,7 +968,7 @@
<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
- position" href="#dfn-webvtt-cue-line-position" class="internalDFN">line position</a>, one of:</p>
+ offset" href="#dfn-webvtt-cue-line-offset" class="internalDFN">line offset</a>, one of:</p>
<dl>
@@ -976,17 +976,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 position" href="#dfn-webvtt-cue-line-position" class="internalDFN">line position</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
- position" href="#dfn-webvtt-cue-line-position" class="internalDFN">line position</a>.</dd>
+ 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 position" href="#dfn-webvtt-cue-line-position" class="internalDFN">line position</a>.</dd>
+ aligned at the <a title="WebVTT cue line offset" href="#dfn-webvtt-cue-line-offset" class="internalDFN">line offset</a>.</dd>
</dl>
@@ -997,7 +997,7 @@
<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="WebVTT cue box" href="#dfn-webvtt-cue-box" class="internalDFN">cue box</a> in the
+ <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 text position is either a number giving the position of the <a title="WebVTT cue
@@ -1049,8 +1049,7 @@
<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 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>
+ <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>
@@ -1159,12 +1158,11 @@
<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 position" href="#dfn-webvtt-cue-line-position" class="internalDFN">line
- position</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>
+ 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>
</div>
@@ -1869,7 +1867,7 @@
<ul class="brief">
<li>A <a href="#dfn-webvtt-vertical-text-cue-setting" class="internalDFN">WebVTT vertical text cue setting</a>.</li>
- <li>A <a href="#dfn-webvtt-line-position-cue-setting" class="internalDFN">WebVTT line position cue setting</a>.</li>
+ <li>A <a href="#dfn-webvtt-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>
@@ -1895,7 +1893,7 @@
text layout rather than horizontal text layout. Vertical text layout is sometimes used in
Japanese, for example. The default is horizontal layout.</p></div>
- <p>A <dfn id="dfn-webvtt-line-position-cue-setting">WebVTT line position cue setting</dfn> consists of the following components, in the
+ <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>
@@ -1905,9 +1903,9 @@
As the <a href="#dfn-webvtt-cue-setting-value" class="internalDFN">WebVTT cue setting value</a>:
<ol>
<li>
- a position value, either:
+ an offset value, either:
<dl>
- <dt>To represent a specific position relative to the video frame</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>
@@ -1932,13 +1930,12 @@
</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-position-cue-setting" class="internalDFN">WebVTT line position cue setting</a> configures the position 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 position. The positioning 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
+ <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 position can be given either as a percentage of the video
+ 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>
@@ -1965,13 +1962,13 @@
</li>
</ol>
- <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_25"><span>Note</span></div><p class="">A <a href="#dfn-webvtt-text-position-cue-setting" class="internalDFN">WebVTT text position cue setting</a> configures the position of the <a title="WebVTT cue box" href="#dfn-webvtt-cue-box" class="internalDFN">cue box</a> in the direction orthogonal to the <a href="#dfn-webvtt-line-position-cue-setting" class="internalDFN">WebVTT line position
- cue setting</a>. For horizontal cues, this is the horizontal position. The text position is
- given as a percentage of the video frame. The positioning is calculated relative to the <a title="WebVTT cue text position start alignment" href="#dfn-webvtt-cue-text-position-start-alignment" class="internalDFN">start</a>, <a title="WebVTT cue text position
- middle alignment" href="#dfn-webvtt-cue-text-position-middle-alignment" class="internalDFN">middle</a>, or <a title="WebVTT cue text position end alignment" href="#dfn-webvtt-cue-text-position-end-alignment" class="internalDFN">end</a> of
- the cue box, depending on the cue's <a title="cue computed text position alignment" href="#dfn-cue-computed-text-position-alignment" class="internalDFN">computed
- text position alignment</a>, which is overridden by the <a href="#dfn-webvtt-text-position-cue-setting" class="internalDFN">WebVTT text position cue
- setting</a>.</p></div>
+ <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_25"><span>Note</span></div><p class="">A <a href="#dfn-webvtt-text-position-cue-setting" class="internalDFN">WebVTT text position cue setting</a> configures the position of the <a title="WebVTT cue box" href="#dfn-webvtt-cue-box" class="internalDFN">cue box</a> in the direction orthogonal to the <a href="#dfn-webvtt-line-offset-cue-setting" class="internalDFN">WebVTT line offset cue
+ setting</a>. For horizontal cues, this is the horizontal position. The text position is given as
+ a percentage of the video frame. The positioning is calculated relative to the <a title="WebVTT
+ cue text position start alignment" href="#dfn-webvtt-cue-text-position-start-alignment" class="internalDFN">start</a>, <a title="WebVTT cue text position middle
+ alignment" href="#dfn-webvtt-cue-text-position-middle-alignment" class="internalDFN">middle</a>, or <a title="WebVTT cue text position end alignment" href="#dfn-webvtt-cue-text-position-end-alignment" class="internalDFN">end</a> of the cue
+ box, depending on the cue's <a title="cue computed text position alignment" href="#dfn-cue-computed-text-position-alignment" class="internalDFN">computed text
+ position alignment</a>, which is overridden by the <a href="#dfn-webvtt-text-position-cue-setting" class="internalDFN">WebVTT text position cue setting</a>.</p></div>
<p>A <dfn id="dfn-webvtt-size-cue-setting">WebVTT size cue setting</dfn> consists of the following components, in the order
given:</p>
@@ -2015,7 +2012,7 @@
<div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_28"><span>Note</span></div><p class="">A <a href="#dfn-webvtt-region-cue-setting" class="internalDFN">WebVTT region cue setting</a> configures a cue to become part of a region
by referencing the region's identifier unless the cue has a <a title="WebVTT vertical text cue
- setting" href="#dfn-webvtt-vertical-text-cue-setting" class="internalDFN">"vertical"</a>, <a title="WebVTT line position cue setting" href="#dfn-webvtt-line-position-cue-setting" class="internalDFN">"line"</a> or <a title="WebVTT size cue setting" href="#dfn-webvtt-size-cue-setting" class="internalDFN">"size"</a> cue setting. If a cue is part of a region, its cue
+ setting" href="#dfn-webvtt-vertical-text-cue-setting" class="internalDFN">"vertical"</a>, <a title="WebVTT line offset cue setting" href="#dfn-webvtt-line-offset-cue-setting" class="internalDFN">"line"</a> or <a title="WebVTT size cue setting" href="#dfn-webvtt-size-cue-setting" class="internalDFN">"size"</a> cue setting. If a cue is part of a region, its cue
settings for <a title="WebVTT text position cue setting" href="#dfn-webvtt-text-position-cue-setting" class="internalDFN">"position"</a> and <a title="WebVTT
alignment cue setting" href="#dfn-webvtt-alignment-cue-setting" class="internalDFN">"align"</a> are applied to the line boxes in the cue relative to the
region box.</p></div>
@@ -2336,8 +2333,8 @@
<li><p>Let <var>cue</var>'s <a href="#dfn-webvtt-cue-snap-to-lines-flag" class="internalDFN">WebVTT cue snap-to-lines flag</a> be true.</p></li>
- <li><p>Let <var>cue</var>'s <a href="#dfn-webvtt-cue-line-position" class="internalDFN">WebVTT cue line position</a> be <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>'s <a href="#dfn-webvtt-cue-line-offset" class="internalDFN">WebVTT cue line offset</a> be <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>'s <a href="#dfn-webvtt-cue-line-alignment" class="internalDFN">WebVTT cue line alignment</a> be <a title="WebVTT cue line
start alignment" href="#dfn-webvtt-cue-line-start-alignment" class="internalDFN">start alignment</a>.</p></li>
@@ -2756,8 +2753,7 @@
</dl>
</li>
- <li><p>Let <var>cue</var>'s <a href="#dfn-webvtt-cue-line-position" class="internalDFN">WebVTT cue line position</a> be
- <var>number</var>.</p></li>
+ <li><p>Let <var>cue</var>'s <a href="#dfn-webvtt-cue-line-offset" class="internalDFN">WebVTT cue line offset</a> be <var>number</var>.</p></li>
<li><p>If the last character in <var>linepos</var> is a U+0025 PERCENT SIGN character
(%), then let <var>cue</var>'s <a href="#dfn-webvtt-cue-snap-to-lines-flag" class="internalDFN">WebVTT cue snap-to-lines flag</a> be false. Otherwise,
@@ -4209,14 +4205,14 @@
<dt>If the <a href="#dfn-webvtt-cue-writing-direction" class="internalDFN">WebVTT cue writing direction</a> is <a title="WebVTT cue horizontal writing
direction" href="#dfn-webvtt-cue-horizontal-writing-direction" class="internalDFN">horizontal</a></dt>
- <dd><p>Let <var>y-position</var> be the <a title="cue computed line position" href="#dfn-cue-computed-line-position" class="internalDFN">computed line
- position</a>.</p></dd>
+ <dd><p>Let <var>y-position</var> be the <a title="cue computed line offset" href="#dfn-cue-computed-line-offset" class="internalDFN">computed line
+ offset</a>.</p></dd>
<dt>If the <a href="#dfn-webvtt-cue-writing-direction" class="internalDFN">WebVTT cue writing direction</a> is <a title="WebVTT cue vertical growing
left writing direction" href="#dfn-webvtt-cue-vertical-growing-left-writing-direction" class="internalDFN">vertical growing left</a> or <a title="WebVTT cue vertical growing
right writing direction" href="#dfn-webvtt-cue-vertical-growing-right-writing-direction" class="internalDFN">vertical growing right</a></dt>
- <dd><p>Let <var>x-position</var> be the <a title="cue computed line position" href="#dfn-cue-computed-line-position" class="internalDFN">computed line
- position</a>.</p></dd>
+ <dd><p>Let <var>x-position</var> be the <a title="cue computed line offset" href="#dfn-cue-computed-line-offset" class="internalDFN">computed line
+ offset</a>.</p></dd>
</dl>
</dd>
@@ -4459,17 +4455,17 @@
<li><p>If <var>step</var> is zero, then jump to the step labeled <i>done positioning</i>
below.</p></li>
- <li><p>Let <var>line position</var> be <var>cue</var>'s <a title="cue computed line
- position" href="#dfn-cue-computed-line-position" class="internalDFN">computed line position</a>.</p></li>
+ <li><p>Let <var>line offset</var> be <var>cue</var>'s <a title="cue computed line
+ offset" href="#dfn-cue-computed-line-offset" class="internalDFN">computed line offset</a>.</p></li>
- <li><p>Round <var>line position</var> to an integer by adding 0.5 and then flooring
+ <li><p>Round <var>line offset</var> to an integer by adding 0.5 and then flooring
it.</p></li>
- <li><p><strong>Vertical Growing Left</strong>: Add one to <var>line position</var> then
+ <li><p><strong>Vertical Growing Left</strong>: Add one to <var>line offset</var> then
negate it.</p></li>
<li><p>Let <var>position</var> be the result of multiplying <var>step</var> and <var>line
- position</var>.</p></li>
+ offset</var>.</p></li>
<li><p><strong>Vertical Growing Left</strong>: Decrease <var>position</var> by the width of
the bounding box of the boxes in <var>boxes</var>, then increase <var>position</var> by
@@ -4477,7 +4473,7 @@
<li>
- <p>If <var>line position</var> is less than zero then increase <var>position</var> by
+ <p>If <var>line offset</var> is less than zero then increase <var>position</var> by
<var>max dimension</var>, and negate <var>step</var>.</p>
<p>Otherwise, increase <var>position</var> by <var>margin</var>.</p>
@@ -5106,8 +5102,8 @@
<dt><var>cue</var> . <a title="VTTCue-line" href="#dfn-vttcue-line" class="internalDFN">line</a> [ = <var>value</var> ]</dt>
<dd>
- <p>Returns the <a href="#dfn-webvtt-cue-line-position" class="internalDFN">WebVTT cue line position</a>. In the case of the value being <a title="WebVTT cue automatic line position" href="#dfn-webvtt-cue-automatic-line-position" class="internalDFN">auto</a>, the string "<code>auto</code>" is
- returned.</p>
+ <p>Returns the <a href="#dfn-webvtt-cue-line-offset" class="internalDFN">WebVTT cue line offset</a>. In the case of the value being <a title="WebVTT
+ cue automatic line offset" href="#dfn-webvtt-cue-automatic-line-offset" class="internalDFN">auto</a>, the string "<code>auto</code>" is returned.</p>
<p>Can be set.</p>
</dd>
@@ -5219,8 +5215,8 @@
<li><p>Let <var>cue</var>'s <a href="#dfn-webvtt-cue-snap-to-lines-flag" class="internalDFN">WebVTT cue snap-to-lines flag</a> be true.</p></li>
- <li><p>Let <var>cue</var>'s <a href="#dfn-webvtt-cue-line-position" class="internalDFN">WebVTT cue line position</a> be <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>'s <a href="#dfn-webvtt-cue-line-offset" class="internalDFN">WebVTT cue line offset</a> be <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>'s <a href="#dfn-webvtt-cue-line-alignment" class="internalDFN">WebVTT cue line alignment</a> be <a title="WebVTT cue line start
alignment" href="#dfn-webvtt-cue-line-start-alignment" class="internalDFN">start alignment</a>.</p></li>
@@ -5286,12 +5282,11 @@
otherwise.</p>
<p>The <dfn title="VTTCue-line" id="dfn-vttcue-line"><code>line</code></dfn> attribute, on getting, must return the
- <a href="#dfn-webvtt-cue-line-position" class="internalDFN">WebVTT cue line position</a> of the <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> that the <a href="#dfn-vttcue" class="internalDFN"><code>VTTCue</code></a>
- object represents. The special value <a title="WebVTT cue automatic line position" href="#dfn-webvtt-cue-automatic-line-position" class="internalDFN">auto</a> must
- be represented as the string "<code>auto</code>". On setting, the <a href="#dfn-webvtt-cue-line-position" class="internalDFN">WebVTT cue line
- position</a> must be set to the new value; if the new value is the string "<code>auto</code>",
- then it must be interpreted as the special value <a title="WebVTT cue automatic line
- position" href="#dfn-webvtt-cue-automatic-line-position" class="internalDFN">auto</a>.</p>
+ <a href="#dfn-webvtt-cue-line-offset" class="internalDFN">WebVTT cue line offset</a> of the <a href="#dfn-webvtt-cue" class="internalDFN">WebVTT cue</a> that the <a href="#dfn-vttcue" class="internalDFN"><code>VTTCue</code></a>
+ object represents. The special value <a title="WebVTT cue automatic line offset" href="#dfn-webvtt-cue-automatic-line-offset" class="internalDFN">auto</a> must
+ be represented as the string "<code>auto</code>". On setting, the <a href="#dfn-webvtt-cue-line-offset" class="internalDFN">WebVTT cue line offset</a>
+ must be set to the new value; if the new value is the string "<code>auto</code>", then it must
+ be interpreted as the special value <a title="WebVTT cue automatic line offset" href="#dfn-webvtt-cue-automatic-line-offset" class="internalDFN">auto</a>.</p>
<p>The <dfn title="VTTCue-lineAlign" id="dfn-vttcue-linealign"><code>lineAlign</code></dfn> attribute, on getting, must
return the string from the second cell of the row in the table below whose first cell is the
Received on Monday, 8 June 2015 12:50:37 UTC