- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 09 Oct 2012 22:55:18 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/webvtt
In directory hutz:/tmp/cvs-serv17086
Modified Files:
Overview.html
Log Message:
Step two: Make snap-to-line cues not overlap the overscan area in the direction of the text (i.e. horizontally for english captions). (whatwg r7447)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/webvtt/Overview.html,v
retrieving revision 1.40
retrieving revision 1.41
diff -u -d -r1.40 -r1.41
--- Overview.html 9 Oct 2012 21:30:25 -0000 1.40
+++ Overview.html 9 Oct 2012 22:55:16 -0000 1.41
@@ -2516,6 +2516,64 @@
</li>
+ <li>
+
+ <p>If the <a href=#text-track-cue-snap-to-lines-flag>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=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-horizontal-writing-direction title="text track cue horizontal writing direction">horizontal</a></dt>
+ <dd>
+
+ <ol><li><p>Let <var title="">edge margin</var> be a user-agent-defined horizontal length,
+ expressed as a percentage of the width of the <var title="">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).</li>
+
+ <li><p>If <var title="">x-position</var> is less than <var title="">edge margin</var> and
+ the sum of <var title="">x-position</var> and <var title="">size</var> is more than <var title="">edge margin</var>, then increase <var title="">x-position</var> by <var title="">edge margin</var> and decrease <var title="">size</var> by the same
+ amount.</li>
+
+ <li><p>Let <var title="">right margin edge</var> be 100 minus <var title="">edge
+ margin</var>.</li>
+
+ <li><p>If <var title="">x-position</var> is less than <var title="">right margin
+ edge</var>, and the sum of <var title="">x-position</var> and <var title="">size</var> is
+ more than <var title="">right margin edge</var>, then decrease <var title="">size</var> by
+ <var title="">edge margin</var>.</li>
+
+ </ol></dd>
+
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-left-writing-direction title="text track cue vertical growing left writing direction">vertical growing left</a></dt>
+ <dt>If the <a href=#text-track-cue-writing-direction>text track cue writing direction</a> is <a href=#text-track-cue-vertical-growing-right-writing-direction title="text track cue vertical growing right writing direction">vertical growing right</a></dt>
+ <dd>
+
+ <ol><li><p>Let <var title="">edge margin</var> be a user-agent-defined vertical length,
+ expressed as a percentage of the height of the <var title="">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).</li>
+
+ <li><p>If <var title="">y-position</var> is less than <var title="">edge margin</var> and
+ the sum of <var title="">y-position</var> and <var title="">size</var> is more than <var title="">edge margin</var>, then increase <var title="">y-position</var> by <var title="">edge margin</var> and decrease <var title="">size</var> by the same
+ amount.</li>
+
+ <li><p>Let <var title="">bottom margin edge</var> be 100 minus <var title="">edge
+ margin</var>.</li>
+
+ <li><p>If <var title="">y-position</var> is less than <var title="">bottom margin
+ edge</var>, and the sum of <var title="">y-position</var> and <var title="">size</var> is
+ more than <var title="">right margin edge</var>, then decrease <var title="">size</var> by
+ <var title="">edge margin</var>.</li>
+
+ </ol></dd>
+
+ </dl></li>
+
<li><p>Let <var title="">left</var> be '<var title="">x-position</var> vw' and <var title="">top</var>
be '<var title="">y-position</var> vh'. (These again are
CSS values used by the next section to set CSS properties for the
Received on Tuesday, 9 October 2012 22:55:19 UTC