- From: CVS User pjgenste <cvsmail@w3.org>
- Date: Wed, 15 Oct 2014 21:57:24 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/webvtt
In directory roscoe:/tmp/cvs-serv5054
Modified Files:
webvtt-staged-snapshot.html
Log Message:
Sync WebVTT with Git commit ffe375a3bf10b3c1cc582bd4247fe03c6434b966
--- /sources/public/html5/webvtt/webvtt-staged-snapshot.html 2014/10/15 13:00:06 1.1
+++ /sources/public/html5/webvtt/webvtt-staged-snapshot.html 2014/10/15 21:57:24 1.2
@@ -7,7 +7,6 @@
<!-- script to register bugs -->
<script src="https://dvcs.w3.org/hg/webcomponents/raw-file/tip/assets/scripts/bug-assist.js"></script>
- <meta name="bug.short_desc" content="[WebVTT] ">
<meta name="bug.product" content="TextTracks CG">
<meta name="bug.component" content="WebVTT">
<style>
@@ -298,7 +297,7 @@
<dt>Bug tracker:</dt>
- <dd><a href="http://www.w3.org/Bugs/Public/enter_bug.cgi?product=TextTracks%20CG&component=WebVTT&short_desc=%5BWebVTT%5D%20">file a bug</a> (<a href="http://www.w3.org/Bugs/Public/buglist.cgi?product=TextTracks%20CG&component=WebVTT&resolution=---">open bugs</a>)</dd>
+ <dd><a href="http://www.w3.org/Bugs/Public/enter_bug.cgi?product=TextTracks%20CG&component=WebVTT">file a bug</a> (<a href="http://www.w3.org/Bugs/Public/buglist.cgi?product=TextTracks%20CG&component=WebVTT&resolution=---">open bugs</a>)</dd>
@@ -353,13 +352,13 @@
<hr>
</div>
- <section id="abstract" class="introductory" property="dcterms:abstract" datatype=""><h2 role="heading" id="h2_abstract">Abstract</h2>
+ <section id="abstract" class="introductory"><h2 role="heading" id="h2_abstract">Abstract</h2>
<p>This specification defines WebVTT, the Web Video Text Tracks format. Its main use is for
marking up external text track resources in connection with the HTML <track> element.</p>
<p>WebVTT files provide captions or subtitles for video content, and also text video descriptions
- <a href="#refsMAUR">[MAUR]</a>, chapters for content navigation, and more generally any
- form of metadata that is time-aligned with audio or video content.</p>
+ <a href="#refsMAUR">[MAUR]</a>, chapters for content navigation, and more generally any form of
+ metadata that is time-aligned with audio or video content.</p>
</section><section id="sotd" class="introductory"><h2 role="heading" id="h2_sotd">Status of This Document</h2>
@@ -373,7 +372,7 @@
<p>Work on this specification is being undertaken both in the <a href="http://www.w3.org/community/texttracks/">Web Media Text Tracks Community Group</a> as well
as in the <a href="http://www.w3.org/AudioVideo/TT/"><abbr title="World Wide Web Consortium">W3C</abbr> Timed Text Working Group</a>. The latter
- group works towards a <abbr title="World Wide Web Consortium">W3C</abbr> Recommendation for reference purposes with interoperablity
+ group works towards a <abbr title="World Wide Web Consortium">W3C</abbr> Recommendation for reference purposes with interoperability
requirements, while the earlier is as a Living Standard that continues to evolve.</p>
<p>
@@ -383,9 +382,10 @@
If you wish to make comments regarding this document, please send them to
- <a href="mailto:public-tt@w3.org">public-tt@w3.org</a>
+ <a href="mailto:public-tt@w3.org?subject=%5Bwebvtt%5D">public-tt@w3.org</a>
(<a href="mailto:public-tt-request@w3.org?subject=subscribe">subscribe</a>,
- <a href="http://lists.w3.org/Archives/Public/public-tt/">archives</a>).
+ <a href="http://lists.w3.org/Archives/Public/public-tt/">archives</a>)
+ with <code>[webvtt]</code> at the start of your email's subject.
@@ -4304,6 +4304,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>
@@ -4403,16 +4473,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>
@@ -5799,4 +5892,4 @@
-<form id="bug-assist-form" action="//www.w3.org/Bugs/Public/enter_bug.cgi" target="_blank">See a problem? Select text and <input type="submit" accesskey="f" style="font-family: Tahoma, sans-serif; font-size: 10px; " value="file a bug"><input type="hidden" name="comment" value=""><input type="hidden" name="short_desc" value="[WebVTT] "><input type="hidden" name="product" value="TextTracks CG"><input type="hidden" name="component" value="WebVTT">.</form></body></html>
\ No newline at end of file
+<form id="bug-assist-form" action="//www.w3.org/Bugs/Public/enter_bug.cgi" target="_blank">See a problem? Select text and <input type="submit" accesskey="f" style="font-family: Tahoma, sans-serif; font-size: 10px; " value="file a bug"><input type="hidden" name="comment" value=""><input type="hidden" name="product" value="TextTracks CG"><input type="hidden" name="component" value="WebVTT">.</form></body></html>
\ No newline at end of file
Received on Wednesday, 15 October 2014 21:57:25 UTC