- From: CVS User pjgenste <cvsmail@w3.org>
- Date: Wed, 15 Oct 2014 20:41:48 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/webvtt In directory roscoe:/tmp/cvs-serv31569 Modified Files: Overview.html Log Message: Sync WebVTT with Git commit dae171147db764019a72d15f219a0395daad5c45 --- /sources/public/html5/webvtt/Overview.html 2014/10/15 13:10:03 1.183 +++ /sources/public/html5/webvtt/Overview.html 2014/10/15 20:41:48 1.184 @@ -4233,6 +4233,76 @@ </li> + <li> + + <p>If the <a href="#dfn-text-track-cue-snap-to-lines-flag" class="internalDFN">text track cue snap-to-lines flag</a> is set, then run the appropriate steps + from the following list:</p> + + <dl class="switch"> + + <dt>If the <a href="#dfn-text-track-cue-writing-direction" class="internalDFN">text track cue writing direction</a> is <a title="text track cue horizontal + writing direction" href="#dfn-text-track-cue-horizontal-writing-direction" class="internalDFN">horizontal</a></dt> + <dd> + + <ol> + + <li><p>Let <var>edge margin</var> be a user-agent-defined horizontal length, expressed as + a percentage of the width of the <var>video</var>'s rendering area, which will be used to + define a margin at the left and right edges of the video into which this cue will not be + placed. In situations with overscan, this margin should be sufficient to place the cue + within the title-safe area. In the absence of overscan, this value should be picked for + aesthetics (to avoid text being aligned precisely on the left or right edge of the video, + which can be ugly).</p></li> + + <li><p>If <var>x-position</var> is less than <var>edge margin</var> and the sum of + <var>x-position</var> and <var>size</var> is more than <var>edge margin</var>, then + increase <var>x-position</var> by <var>edge margin</var> and decrease <var>size</var> by + the same amount.</p></li> + + <li><p>Let <var>right margin edge</var> be 100 minus <var>edge margin</var>.</p></li> + + <li><p>If <var>x-position</var> is less than <var>right margin edge</var>, and the sum of + <var>x-position</var> and <var>size</var> is more than <var>right margin edge</var>, then + decrease <var>size</var> by <var>edge margin</var>.</p></li> + + </ol> + + </dd> + + <dt>If the <a href="#dfn-text-track-cue-writing-direction" class="internalDFN">text track cue writing direction</a> is <a title="text track cue vertical + growing left writing direction" href="#dfn-text-track-cue-vertical-growing-left-writing-direction" class="internalDFN">vertical growing left</a> or <a title="text track cue + vertical growing right writing direction" href="#dfn-text-track-cue-vertical-growing-right-writing-direction" class="internalDFN">vertical growing right</a></dt> + <dd> + + <ol> + + <li><p>Let <var>edge margin</var> be a user-agent-defined vertical length, expressed as a + percentage of the height of the <var>video</var>'s rendering area, which will be used to + define a margin at the top and bottom edges of the video into which this cue will not be + placed. In situations with overscan, this margin should be sufficient to place the cue + within the title-safe area. In the absence of overscan, this value should be picked for + aesthetics (to avoid text being aligned precisely on the top or bottom edge of the video, + which can be ugly).</p></li> + + <li><p>If <var>y-position</var> is less than <var>edge margin</var> and the sum of + <var>y-position</var> and <var>size</var> is more than <var>edge margin</var>, then + increase <var>y-position</var> by <var>edge margin</var> and decrease <var>size</var> by + the same amount.</p></li> + + <li><p>Let <var>bottom margin edge</var> be 100 minus <var>edge margin</var>.</p></li> + + <li><p>If <var>y-position</var> is less than <var>bottom margin edge</var>, and the sum of + <var>y-position</var> and <var>size</var> is more than <var>right margin edge</var>, then + decrease <var>size</var> by <var>edge margin</var>.</p></li> + + </ol> + + </dd> + + </dl> + + </li> + <li><p>Let <var>left</var> be '<var>x-position</var> vw' and <var>top</var> be '<var>y-position</var> vh'. (These are CSS values used by the next section to set CSS properties for the rendering; 'vw' and 'vh' are CSS units.) <a href="#refsCSSVALUES">[CSSVALUES]</a></p></li> @@ -4332,16 +4402,39 @@ <li> - <p><strong>Horizontal</strong>: Let <var>max dimension</var> be the height of - <var>video</var>'s rendering area minus twice the 'padding-top' space defined in the next - section.</p> - - <p><strong>Vertical</strong>: Let <var>max dimension</var> be the width of - <var>video</var>'s rendering area minus twice the 'padding-left' space defined in the - next section.</p> + <p><strong>Horizontal</strong>: Let <var>margin</var> be a user-agent-defined vertical + length which will be used to define a margin at the top and bottom edges of the video + into which cues will not be placed. In situations with overscan, this margin should be + sufficient to place all cues within the title-safe area. In the absence of overscan, this + value should be picked for aesthetics (to avoid text being aligned precisely on the + bottom edge of the video, which can be ugly).</p> + + <p><strong>Vertical</strong>: Let <var>margin</var> be a user-agent-defined horizontal + length which will be used to define a margin at the left and right edges of the video + into which cues will not be placed. In situations with overscan, this margin should be + sufficient to place all cues within the title-safe area. In the absence of overscan, this + value should be picked for aesthetics (to avoid text being aligned precisely on the left + or right edges of the video, which can be ugly).</p> + + </li> + + <li> + + <p><strong>Horizontal</strong>: Let <var>full dimension</var> be the height of + <var>video</var>'s rendering area.</p> + + <p><strong>Vertical</strong>: Let <var>full dimension</var> be the width of + <var>video</var>'s rendering area.</p> + + <p>These dimensions must not be adjusted for overscan. (The algorithm does that + separately.)</p> + + </li> + + <li> - <p>These dimensions must not be adjusted for overscan. (The padding of the next section - takes care of this.)</p> + <p>Let <var>max dimension</var> be + <var>full dimension</var> - (2 × <var>margin</var>).</p> </li>
Received on Wednesday, 15 October 2014 20:41:49 UTC