- From: CVS User pjgenste <cvsmail@w3.org>
- Date: Tue, 16 Jun 2015 07:32:17 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/webvtt
In directory roscoe:/var/tmp/cvs-serv17343
Modified Files:
Overview.html
Log Message:
Sync WebVTT with Git commit bffcecbd179480fab284e44bd63926916dd3b529
--- /sources/public/html5/webvtt/Overview.html 2015/06/10 08:07:17 1.224
+++ /sources/public/html5/webvtt/Overview.html 2015/06/16 07:32:17 1.225
@@ -3,7 +3,7 @@
<head>
<title>WebVTT: The Web Video Text Tracks Format</title>
<meta charset="utf-8">
- <meta name="revision" content="645a6920adcbde079362453d5c99e4b3cf18903a">
+ <meta name="revision" content="bffcecbd179480fab284e44bd63926916dd3b529">
@@ -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-june-2015">Draft Community Group Report <time class="dt-published" datetime="2015-06-10">10 June 2015</time></h2>
+ <h2 id="draft-community-group-report-16-june-2015">Draft Community Group Report <time class="dt-published" datetime="2015-06-16">16 June 2015</time></h2>
<dl>
@@ -3825,6 +3825,12 @@
<section id="rendering">
<!--OddPage--><h2 role="heading" id="h2_rendering"><span class="secno">6. </span>Rendering</h2>
+ <div class="note"><div class="note-title" aria-level="1" role="heading" id="h_note_31"><span>Note</span></div><p class="">This section describes in some detail how to visually render WebVTT cues in a
+ user agent. It also specifies extra CSS functionality made available to manipulate the visual
+ rendering. The processing model is quite tightly linked to media elements in HTML. When
+ supporting WebVTT in media players that don't support CSS, equivalent visual rendering will need
+ to be implemented.</p></div>
+
<section id="processing-model">
<h3 role="heading" id="h3_processing-model"><span class="secno">6.1 </span>Processing model</h3>
@@ -3834,6 +3840,11 @@
track" href="#dfn-text-track" class="internalDFN">text tracks</a> that use these rules for a given <a href="#dfn-media-element" class="internalDFN">media element</a>, or other playback
mechanism, are rendered together, to avoid overlapping subtitles from multiple tracks.</p>
+ <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_32"><span>Note</span></div><p class="">In HTML, audio elements don't have a visual rendering area and therefore, this
+ algorithm will abort for audio elements. When authors do create WebVTT captions or subtitles for
+ audio resources, they need to publish them in a video element for rendering by the user
+ agent.</p></div>
+
<p>The output of the steps below is a set of CSS boxes that covers the rendering area of the
<a href="#dfn-media-element" class="internalDFN">media element</a> or other playback mechanism, which user agents are expected to render in a
manner suiting the user.</p>
@@ -3843,8 +3854,7 @@
<ol>
<li><p>If the <a href="#dfn-media-element" class="internalDFN">media element</a> is an <a href="#dfn-audio" class="internalDFN"><code>audio</code></a> element, or is another
- playback mechanism with no rendering area, abort these steps. There is nothing to
- render.</p></li>
+ playback mechanism with no rendering area, abort these steps.</p></li>
<li><p>Let <var>video</var> be the <a href="#dfn-media-element" class="internalDFN">media element</a> or other playback mechanism.</p></li>
@@ -3988,7 +3998,7 @@
depth-first traversal, excluding <a title="WebVTT Ruby Text Object" href="#dfn-webvtt-ruby-text-object" class="internalDFN">WebVTT Ruby Text
Objects</a> and their descendants, to determine the <i>paragraph embedding level</i> of
the first Unicode paragraph of the cue. [<cite><a class="bibref" href="#bib-BIDI">BIDI</a></cite>]</p>
- <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_31"><span>Note</span></div><p class="">Within a cue, paragraph boundaries are only denoted by Type B characters,
+ <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_33"><span>Note</span></div><p class="">Within a cue, paragraph boundaries are only denoted by Type B characters,
such as U+000A LINE FEED (LF), U+0085 NEXT LINE (NEL), and U+2029 PARAGRAPH SEPARATOR.
(This means each line of the cue is reordered as if it was a separate paragraph.)</p></div>
</li>
@@ -4071,7 +4081,7 @@
descendants, to determine the <i>paragraph embedding level</i> of the first Unicode paragraph
of the cue. [<cite><a class="bibref" href="#bib-BIDI">BIDI</a></cite>]</p>
- <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_32"><span>Note</span></div><p class="">Within a cue, paragraph boundaries are only denoted by Type B characters, such
+ <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_34"><span>Note</span></div><p class="">Within a cue, paragraph boundaries are only denoted by Type B characters, such
as U+000A LINE FEED (LF), U+0085 NEXT LINE (NEL), and U+2029 PARAGRAPH SEPARATOR. (This means
each line of the cue is reordered as if it was a separate paragraph.)</p></div>
@@ -4245,7 +4255,7 @@
</dl>
- <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_33"><span>Note</span></div><p class="">These are not final positions, they are merely temporary positions used to
+ <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_35"><span>Note</span></div><p class="">These are not final positions, they are merely temporary positions used to
calculate box dimensions below.</p></div>
</li>
@@ -4806,7 +4816,7 @@
following sections affect the styling of parts of <a title="WebVTT cue" href="#dfn-webvtt-cue" class="internalDFN">WebVTT cues</a> that are
being rendered for the <i>matched element</i>.</p>
- <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_34"><span>Note</span></div><p class="">If the <i>matched element</i> is not a <a href="#dfn-video" class="internalDFN"><code>video</code></a> element, the
+ <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_36"><span>Note</span></div><p class="">If the <i>matched element</i> is not a <a href="#dfn-video" class="internalDFN"><code>video</code></a> element, the
pseudo-elements defined below won't have any effect according to this specification.</p></div>
<p>A CSS user agent that implements the <a title="text track" href="#dfn-text-track" class="internalDFN">text tracks</a> model must
@@ -5012,7 +5022,7 @@
section, that element is the matched element. The pseudo-element defined below affects the
styling of text track regions that are being rendered for the matched element.</p>
- <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_35"><span>Note</span></div><p class="">If the matched element is not a video element, the pseudo-element defined below
+ <div class="note"><div class="note-title" aria-level="3" role="heading" id="h_note_37"><span>Note</span></div><p class="">If the matched element is not a video element, the pseudo-element defined below
won't have any effect according to this specification.</p></div>
<p>The '<dfn title="pseudo-region" id="dfn-pseudo-region">::cue-region</dfn>' pseudo-element (with no argument)
@@ -5666,7 +5676,7 @@
<li> 57 45 42 56 54 54 09 </li>
<li> 57 45 42 56 54 54 EOF </li>
</ul>
- <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_36"><span>Note</span></div><p class="">(An optional UTF-8 BOM, the ASCII string "<code>WEBVTT</code>", and finally
+ <div class="note"><div class="note-title" aria-level="2" role="heading" id="h_note_38"><span>Note</span></div><p class="">(An optional UTF-8 BOM, the ASCII string "<code>WEBVTT</code>", and finally
a space, tab, line break, or the end of the file.)</p></div>
</dd>
<dt>File extension(s):</dt>
Received on Tuesday, 16 June 2015 07:32:21 UTC