- From: CVS User pjgenste <cvsmail@w3.org>
- Date: Fri, 21 Aug 2015 12:03:30 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/webvtt
In directory roscoe:/var/tmp/cvs-serv3730
Modified Files:
Overview.html
Log Message:
Sync WebVTT with Git commit 5a0cda9d7aa19b7c995753e1caff6a4c6945922d
--- /sources/public/html5/webvtt/Overview.html 2015/08/10 11:34:51 1.231
+++ /sources/public/html5/webvtt/Overview.html 2015/08/21 12:03:30 1.232
@@ -3,7 +3,7 @@
<head>
<title>WebVTT: The Web Video Text Tracks Format</title>
<meta charset="utf-8">
- <meta name="revision" content="fbb24933ec1bdb9e968d61425d300867d8809f20">
+ <meta name="revision" content="5a0cda9d7aa19b7c995753e1caff6a4c6945922d">
@@ -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-10-august-2015">Draft Community Group Report <time class="dt-published" datetime="2015-08-10">10 August 2015</time></h2>
+ <h2 id="draft-community-group-report-21-august-2015">Draft Community Group Report <time class="dt-published" datetime="2015-08-21">21 August 2015</time></h2>
<dl>
@@ -906,14 +906,14 @@
</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" 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" href="#dfn-webvtt-cue-line" class="internalDFN">line</a>
+ percentages are relative to the height of the video, and <a title="WebVTT cue
+ position" href="#dfn-webvtt-cue-position" class="internalDFN">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">line</a> percentages are relative to the width of the
+ video, and <a title="WebVTT cue position" href="#dfn-webvtt-cue-position" class="internalDFN">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,8 +922,8 @@
<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
+ <p>A boolean indicating whether the <a title="WebVTT cue line" href="#dfn-webvtt-cue-line" class="internalDFN">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>
@@ -936,20 +936,19 @@
</dd>
- <dt><dfn title="WebVTT cue line" id="dfn-webvtt-cue-line">A cue line</dfn></dt>
+ <dt><dfn title="WebVTT cue line" id="dfn-webvtt-cue-line">A line</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
+ <p>The <a title="WebVTT cue line" href="#dfn-webvtt-cue-line" class="internalDFN">line</a> 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>The <a title="WebVTT cue line" href="#dfn-webvtt-cue-line" class="internalDFN">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">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
@@ -957,19 +956,18 @@
<ol>
- <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">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">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
+ <li><p>If the <a title="WebVTT cue line" href="#dfn-webvtt-cue-line" class="internalDFN">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 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 title="WebVTT cue line" href="#dfn-webvtt-cue-line" class="internalDFN">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>
@@ -996,8 +994,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" href="#dfn-webvtt-cue-line" class="internalDFN">line</a>, one of:</p>
<dl>
@@ -1005,17 +1003,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" href="#dfn-webvtt-cue-line" class="internalDFN">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" href="#dfn-webvtt-cue-line" class="internalDFN">cue line</a>.</dd>
+ line" href="#dfn-webvtt-cue-line" class="internalDFN">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" href="#dfn-webvtt-cue-line" class="internalDFN">cue line</a>.</dd>
+ aligned at the <a title="WebVTT cue line" href="#dfn-webvtt-cue-line" class="internalDFN">line</a>.</dd>
</dl>
@@ -1024,28 +1022,29 @@
</dd>
- <dt><dfn title="WebVTT cue position" id="dfn-webvtt-cue-position">A cue position</dfn></dt>
+ <dt><dfn title="WebVTT cue position" id="dfn-webvtt-cue-position">A 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 <a title="WebVTT cue position" href="#dfn-webvtt-cue-position" class="internalDFN">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 <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
+ <p>The <a title="WebVTT cue position" href="#dfn-webvtt-cue-position" class="internalDFN">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 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 position" id="dfn-cue-computed-position">computed 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 title="WebVTT cue position" href="#dfn-webvtt-cue-position" class="internalDFN">position</a> is numeric, then return the value
+ of the <a title="WebVTT cue position" href="#dfn-webvtt-cue-position" class="internalDFN">position</a> and abort these steps. (Otherwise, the <a title="WebVTT cue position" href="#dfn-webvtt-cue-position" class="internalDFN">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 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
@@ -1075,34 +1074,34 @@
</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 position alignment" id="dfn-webvtt-cue-position-alignment">A 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 position" href="#dfn-webvtt-cue-position" class="internalDFN">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>
<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 position" href="#dfn-webvtt-cue-position" class="internalDFN">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>
+ position" href="#dfn-webvtt-cue-position" class="internalDFN">position</a>.</dd>
<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 position" href="#dfn-webvtt-cue-position" class="internalDFN">cue position</a>.</dd>
+ the <a title="WebVTT cue position" href="#dfn-webvtt-cue-position" class="internalDFN">position</a>.</dd>
<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 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>
+ <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 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>
@@ -1123,12 +1122,11 @@
</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 title="WebVTT cue position" href="#dfn-webvtt-cue-position" class="internalDFN">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>
@@ -1187,10 +1185,10 @@
<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>,
- 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" href="#dfn-webvtt-cue-line" class="internalDFN">line</a>, <a title="WebVTT cue position" href="#dfn-webvtt-cue-position" class="internalDFN">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>
@@ -1964,8 +1962,8 @@
<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-position-cue-setting" class="internalDFN">WebVTT position cue setting</a> configures the indent 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-cue-setting" class="internalDFN">WebVTT line cue
setting</a>. For horizontal cues, this is the horizontal position. The cue position is given as
a percentage of the video viewport. The positioning is for the <a title="WebVTT cue position
- start alignment" href="#dfn-webvtt-cue-position-start-alignment" class="internalDFN">start</a>, <a title="WebVTT cue position middle alignment" href="#dfn-webvtt-cue-position-middle-alignment" class="internalDFN">middle</a>, or <a title="WebVTT cue position end alignment" href="#dfn-webvtt-cue-position-end-alignment" class="internalDFN">end</a> of the cue box, depending on the cue's <a title="cue computed position alignment" href="#dfn-cue-computed-position-alignment" class="internalDFN">computed cue position alignment</a>, which is overridden
- by the <a href="#dfn-webvtt-position-cue-setting" class="internalDFN">WebVTT position cue setting</a>.</p></div>
+ start alignment" href="#dfn-webvtt-cue-position-start-alignment" class="internalDFN">start</a>, <a title="WebVTT cue position middle alignment" href="#dfn-webvtt-cue-position-middle-alignment" class="internalDFN">middle</a>, or <a title="WebVTT cue position end alignment" href="#dfn-webvtt-cue-position-end-alignment" class="internalDFN">end</a> of the cue box, depending on the cue's <a title="cue computed position alignment" href="#dfn-cue-computed-position-alignment" class="internalDFN">computed position alignment</a>, which is overridden by
+ the <a href="#dfn-webvtt-position-cue-setting" class="internalDFN">WebVTT 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>
@@ -2785,10 +2783,10 @@
<li><p>If <a href="#dfn-parse-a-percentage-string" class="internalDFN">parse a percentage string</a> from <var>colpos</var> doesn't fail, let
<var>number</var> be the returned <var>percentage</var>, otherwise jump to the step
- labeled <i>next setting</i> (<a title="WebVTT cue position" href="#dfn-webvtt-cue-position" class="internalDFN">cue position</a>'s value
- remains the special value <a title="WebVTT cue automatic position" href="#dfn-webvtt-cue-automatic-position" class="internalDFN">auto</a>).</p></li>
+ labeled <i>next setting</i> (<a title="WebVTT cue position" href="#dfn-webvtt-cue-position" class="internalDFN">position</a>'s value remains
+ the special value <a title="WebVTT cue automatic position" href="#dfn-webvtt-cue-automatic-position" class="internalDFN">auto</a>).</p></li>
- <li><p>Let <var>cue</var>'s <a title="WebVTT cue position" href="#dfn-webvtt-cue-position" class="internalDFN">cue position</a> be
+ <li><p>Let <var>cue</var>'s <a title="WebVTT cue position" href="#dfn-webvtt-cue-position" class="internalDFN">position</a> be
<var>number</var>.</p></li>
<li><p>If <var>colalign</var> is a <a href="#dfn-case-sensitive" class="internalDFN">case-sensitive</a> match for the string
@@ -3992,20 +3990,20 @@
let it be 'rtl'.</p></li>
<li><p>Let <var>offset</var> be <var>cue</var>'s <a title="cue computed position" href="#dfn-cue-computed-position" class="internalDFN">computed
- cue position</a> multiplied by <var>region</var>'s <a href="#dfn-webvtt-region-width" class="internalDFN">WebVTT region width</a> and divided
- by 100 (i.e. interpret it as a percentage of the region width).</p></li>
+ position</a> multiplied by <var>region</var>'s <a href="#dfn-webvtt-region-width" class="internalDFN">WebVTT region width</a> and divided by
+ 100 (i.e. interpret it as a percentage of the region width).</p></li>
<li>
<p>Adjust <var>offset</var> using <var>cue</var>'s <a title="cue computed position
- alignment" href="#dfn-cue-computed-position-alignment" class="internalDFN">computed cue position alignment</a> as follows:</p>
+ alignment" href="#dfn-cue-computed-position-alignment" class="internalDFN">computed position alignment</a> as follows:</p>
<dl class="switch">
- <dt>If the <a title="cue computed position alignment" href="#dfn-cue-computed-position-alignment" class="internalDFN">computed cue position alignment</a>
- is <a title="WebVTT cue position middle alignment" href="#dfn-webvtt-cue-position-middle-alignment" class="internalDFN">middle alignment</a></dt>
+ <dt>If the <a title="cue computed position alignment" href="#dfn-cue-computed-position-alignment" class="internalDFN">computed position alignment</a> is
+ <a title="WebVTT cue position middle alignment" href="#dfn-webvtt-cue-position-middle-alignment" class="internalDFN">middle alignment</a></dt>
<dd><p>Subtract half of <var>region</var>'s <a href="#dfn-webvtt-region-width" class="internalDFN">WebVTT region width</a> from
<var>offset</var>.</p></dd>
- <dt>If the <a title="cue computed position alignment" href="#dfn-cue-computed-position-alignment" class="internalDFN">computed cue position alignment</a>
- is <a title="WebVTT cue position end alignment" href="#dfn-webvtt-cue-position-end-alignment" class="internalDFN">end alignment</a></dt>
+ <dt>If the <a title="cue computed position alignment" href="#dfn-cue-computed-position-alignment" class="internalDFN">computed position alignment</a> is
+ <a title="WebVTT cue position end alignment" href="#dfn-webvtt-cue-position-end-alignment" class="internalDFN">end alignment</a></dt>
<dd><p>Subtract <var>region</var>'s <a href="#dfn-webvtt-region-width" class="internalDFN">WebVTT region width</a> from
<var>offset</var>.</p></dd>
</dl>
@@ -4092,34 +4090,30 @@
<dl class="switch">
- <dt>If the <a title="cue computed position alignment" href="#dfn-cue-computed-position-alignment" class="internalDFN">computed cue position alignment</a> is
- <a title="WebVTT cue position start alignment" href="#dfn-webvtt-cue-position-start-alignment" class="internalDFN">start</a></dt>
+ <dt>If the <a title="cue computed position alignment" href="#dfn-cue-computed-position-alignment" class="internalDFN">computed position alignment</a> is <a title="WebVTT cue position start alignment" href="#dfn-webvtt-cue-position-start-alignment" class="internalDFN">start</a></dt>
<dd>
- <p>Let <var>maximum size</var> be the <a title="cue computed position" href="#dfn-cue-computed-position" class="internalDFN">computed cue
- position</a> subtracted from 100.</p>
+ <p>Let <var>maximum size</var> be the <a title="cue computed position" href="#dfn-cue-computed-position" class="internalDFN">computed position</a>
+ subtracted from 100.</p>
</dd>
- <dt>If the <a title="cue computed position alignment" href="#dfn-cue-computed-position-alignment" class="internalDFN">computed cue position alignment</a> is
- <a title="WebVTT cue position end alignment" href="#dfn-webvtt-cue-position-end-alignment" class="internalDFN">end</a></dt>
+ <dt>If the <a title="cue computed position alignment" href="#dfn-cue-computed-position-alignment" class="internalDFN">computed position alignment</a> is <a title="WebVTT cue position end alignment" href="#dfn-webvtt-cue-position-end-alignment" class="internalDFN">end</a></dt>
<dd>
- <p>Let <var>maximum size</var> be the <a title="cue computed position" href="#dfn-cue-computed-position" class="internalDFN">computed cue
+ <p>Let <var>maximum size</var> be the <a title="cue computed position" href="#dfn-cue-computed-position" class="internalDFN">computed
position</a>.</p>
</dd>
- <dt>If the <a title="cue computed position alignment" href="#dfn-cue-computed-position-alignment" class="internalDFN">computed cue position alignment</a> is
- <a title="WebVTT cue position middle alignment" href="#dfn-webvtt-cue-position-middle-alignment" class="internalDFN">middle</a>, and the <a title="cue computed
- position" href="#dfn-cue-computed-position" class="internalDFN">computed cue position</a> is less than or equal to 50</dt>
+ <dt>If the <a title="cue computed position alignment" href="#dfn-cue-computed-position-alignment" class="internalDFN">computed position alignment</a> is <a title="WebVTT cue position middle alignment" href="#dfn-webvtt-cue-position-middle-alignment" class="internalDFN">middle</a>, and the <a title="cue computed
+ position" href="#dfn-cue-computed-position" class="internalDFN">computed position</a> is less than or equal to 50</dt>
<dd>
- <p>Let <var>maximum size</var> be the <a title="cue computed position" href="#dfn-cue-computed-position" class="internalDFN">computed cue
- position</a> multiplied by two.</p>
+ <p>Let <var>maximum size</var> be the <a title="cue computed position" href="#dfn-cue-computed-position" class="internalDFN">computed position</a>
+ multiplied by two.</p>
</dd>
- <dt>If the <a title="cue computed position alignment" href="#dfn-cue-computed-position-alignment" class="internalDFN">computed cue position alignment</a> is
- <a title="WebVTT cue position middle alignment" href="#dfn-webvtt-cue-position-middle-alignment" class="internalDFN">middle</a>, and the <a title="cue computed
- position" href="#dfn-cue-computed-position" class="internalDFN">computed cue position</a> is greater than <!-- or equal to --> 50</dt>
+ <dt>If the <a title="cue computed position alignment" href="#dfn-cue-computed-position-alignment" class="internalDFN">computed position alignment</a> is <a title="WebVTT cue position middle alignment" href="#dfn-webvtt-cue-position-middle-alignment" class="internalDFN">middle</a>, and the <a title="cue computed
+ position" href="#dfn-cue-computed-position" class="internalDFN">computed position</a> is greater than <!-- or equal to --> 50</dt>
<dd>
<p>Let <var>maximum size</var> be the result of subtracting <a title="cue computed
- position" href="#dfn-cue-computed-position" class="internalDFN">computed cue position</a> from 100 and then multiplying the result by two.</p>
+ position" href="#dfn-cue-computed-position" class="internalDFN">computed position</a> from 100 and then multiplying the result by two.</p>
</dd>
</dl>
@@ -4147,19 +4141,16 @@
direction" href="#dfn-webvtt-cue-horizontal-writing-direction" class="internalDFN">horizontal</a></dt>
<dd>
<dl class="switch">
- <dt>If the <a title="cue computed position alignment" href="#dfn-cue-computed-position-alignment" class="internalDFN">computed cue position alignment</a>
- is <a title="WebVTT cue position start alignment" href="#dfn-webvtt-cue-position-start-alignment" class="internalDFN">start alignment</a></dt>
- <dd><p>Let <var>x-position</var> be the <a title="cue computed position" href="#dfn-cue-computed-position" class="internalDFN">computed cue
+ <dt>If the <a title="cue computed position alignment" href="#dfn-cue-computed-position-alignment" class="internalDFN">computed position alignment</a> is <a title="WebVTT cue position start alignment" href="#dfn-webvtt-cue-position-start-alignment" class="internalDFN">start alignment</a></dt>
+ <dd><p>Let <var>x-position</var> be the <a title="cue computed position" href="#dfn-cue-computed-position" class="internalDFN">computed
position</a>.</p></dd>
- <dt>If the <a title="cue computed position alignment" href="#dfn-cue-computed-position-alignment" class="internalDFN">computed cue position alignment</a>
- is <a title="WebVTT cue position middle alignment" href="#dfn-webvtt-cue-position-middle-alignment" class="internalDFN">middle alignment</a></dt>
- <dd><p>Let <var>x-position</var> be the <a title="cue computed position" href="#dfn-cue-computed-position" class="internalDFN">computed cue
+ <dt>If the <a title="cue computed position alignment" href="#dfn-cue-computed-position-alignment" class="internalDFN">computed position alignment</a> is <a title="WebVTT cue position middle alignment" href="#dfn-webvtt-cue-position-middle-alignment" class="internalDFN">middle alignment</a></dt>
+ <dd><p>Let <var>x-position</var> be the <a title="cue computed position" href="#dfn-cue-computed-position" class="internalDFN">computed
position</a> minus half of <var>size</var>.</p></dd>
- <dt>If the <a title="cue computed position alignment" href="#dfn-cue-computed-position-alignment" class="internalDFN">computed cue position alignment</a>
- is <a title="WebVTT cue position end alignment" href="#dfn-webvtt-cue-position-end-alignment" class="internalDFN">end alignment</a></dt>
- <dd><p>Let <var>x-position</var> be the <a title="cue computed position" href="#dfn-cue-computed-position" class="internalDFN">computed cue
+ <dt>If the <a title="cue computed position alignment" href="#dfn-cue-computed-position-alignment" class="internalDFN">computed position alignment</a> is <a title="WebVTT cue position end alignment" href="#dfn-webvtt-cue-position-end-alignment" class="internalDFN">end alignment</a></dt>
+ <dd><p>Let <var>x-position</var> be the <a title="cue computed position" href="#dfn-cue-computed-position" class="internalDFN">computed
position</a> minus <var>size</var>.</p></dd>
</dl>
</dd>
@@ -4169,18 +4160,16 @@
writing direction" href="#dfn-webvtt-cue-vertical-growing-right-writing-direction" class="internalDFN">vertical growing right</a></dt>
<dd>
<dl class="switch">
- <dt>If the <a title="cue computed position alignment" href="#dfn-cue-computed-position-alignment" class="internalDFN">computed cue position alignment</a>
- is <a title="WebVTT cue position start alignment" href="#dfn-webvtt-cue-position-start-alignment" class="internalDFN">start alignment</a></dt>
- <dd><p>Let <var>y-position</var> be the <a title="cue computed position" href="#dfn-cue-computed-position" class="internalDFN">computed cue
+ <dt>If the <a title="cue computed position alignment" href="#dfn-cue-computed-position-alignment" class="internalDFN">computed position alignment</a> is <a title="WebVTT cue position start alignment" href="#dfn-webvtt-cue-position-start-alignment" class="internalDFN">start alignment</a></dt>
+ <dd><p>Let <var>y-position</var> be the <a title="cue computed position" href="#dfn-cue-computed-position" class="internalDFN">computed
position</a>.</p></dd>
- <dt>If the <a title="cue computed position alignment" href="#dfn-cue-computed-position-alignment" class="internalDFN">computed cue position alignment</a>
- is <a title="WebVTT cue position middle alignment" href="#dfn-webvtt-cue-position-middle-alignment" class="internalDFN">middle alignment</a></dt>
- <dd><p>Let <var>y-position</var> be the <a title="cue computed position" href="#dfn-cue-computed-position" class="internalDFN">computed cue
[10 lines skipped]
Received on Friday, 21 August 2015 12:03:34 UTC