Skip to content

Timeranges #419

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
silviapfeiffer wants to merge 15 commits into
base: gh-pages
Choose a base branch
from
Open

Timeranges #419

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
15 commits
Select commit Hold shift + click to select a range
504110b
Attempt to redirect whatwg copy to new location
zcorpan Oct 19, 2015
f6078cc
HTML-level redirect whatwg copy to new location
zcorpan Oct 19, 2015
3bebbcc
Merge remote-tracking branch 'upstream/master' into gh-pages
silviapfeiffer Nov 19, 2017
02768b4
Merge remote-tracking branch 'upstream/gh-pages' into gh-pages
silviapfeiffer Nov 19, 2017
938e5e6
Merge remote-tracking branch 'upstream/gh-pages' into gh-pages
silviapfeiffer Dec 3, 2017
c46d439
Merge remote-tracking branch 'upstream/gh-pages' into gh-pages
silviapfeiffer Dec 8, 2017
04d1ea9
Explain start and end time of a WebVTT cue by reference to the HTML s…
silviapfeiffer Dec 8, 2017
a2d88a5
Merge remote-tracking branch 'upstream/gh-pages' into timeranges
silviapfeiffer Dec 8, 2017
17ece3f
Add normative link to HTML5 spec about processing model
silviapfeiffer Dec 21, 2017
6d7ad90
Make sure to mention not supporting HTML in the processing model.
silviapfeiffer Feb 25, 2018
e75495e
Merge branch 'gh-pages' into timeranges
silviapfeiffer Feb 25, 2018
c4f517f
Merge branch 'gh-pages' into timeranges
silviapfeiffer Feb 25, 2018
6fa921a
Rebuild index.html
silviapfeiffer Feb 25, 2018
6d8ddbd
Refer to conformance classes rather than trying to re-describe player…
silviapfeiffer Apr 2, 2018
ad60ddc
Merge branch 'gh-pages' into timeranges
silviapfeiffer Apr 2, 2018
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions anchors-w3c.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,10 @@ urlPrefix: https://www.w3.org/TR/html51/
text: rules for updating the text track rendering
text: text track cue active flag
text: text track cue text
text: text track cue data
text: text track cue display state
text: time marches on
text: playing the media resource; url: #list-of-newly-introduced-cues
text: current playback position; url: #current-position
text: text track cue identifier
text: text track cue pause-on-exit flag; url: #pause-on-exit-flag
Expand Down
30 changes: 16 additions & 14 deletions index.bs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,11 @@ urlPrefix: https://html.spec.whatwg.org/multipage/
text: text track showing
text: rules for updating the text track rendering
text: text track cue active flag
text: text track cue text
text: text track cue data
text: text track cue display state
text: time marches on
text: playing the media resource; url: #list-of-newly-introduced-cues
text: current playback position
text: text track cue identifier
text: text track cue pause-on-exit flag
Expand Down Expand Up @@ -4125,22 +4129,20 @@ follows:</p>

<h2 id=rendering>Rendering</h2>

<p class="note">This section describes in some detail how to visually render <a>WebVTT caption or
subtitle cues</a> in a user agent. The processing model is quite tightly linked to media elements in
HTML, where CSS is available. <a>User agents that do not support CSS</a> are expected to render
plain text only, without styling and positioning features. <a>User agents that do not support a full
HTML CSS engine</a> are expected to render an equivalent visual representation to what a user agent
with a full CSS engine would render.</p>
<p>This section describes how to visually render WebVTT cues in a user agent. The processing model
is tightly linked to media elements in HTML and follows the handling of cues when <a>playing the
media resource</a>. When supporting WebVTT in media players that falls into the <a>User agents that
Copy link
Contributor

@nigelmegitt nigelmegitt Apr 3, 2018

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Grammar nit: s/in media players/in a media player

do not support CSS</a> or <a>User agents that do not support a full HTML CSS engine</a> conformace
Copy link
Contributor

@nigelmegitt nigelmegitt Apr 3, 2018

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

typo: s/conformace/conformance

classes, equivalent visual rendering will need to be implemented.</p>
Copy link
Contributor

@nigelmegitt nigelmegitt Apr 3, 2018

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Another nit: s/will need/needs



<h3 id=processing-model algorithm>Processing model</h3>

<p>The <dfn>rules for updating the display of WebVTT text tracks</dfn> render the <a>text tracks</a>
of a <a>media element</a> (specifically, a <a element>video</a> element), or of another playback
mechanism, by applying the steps below. All the <a lt="text track">text tracks</a> that use these
rules for a given <a>media element</a>, or other playback mechanism, are rendered together, to avoid
overlapping subtitles from multiple tracks. A fallback language |language| may be set when calling
this algorithm.</p>
of a <a>media element</a> (specifically, a <a element>video</a> element) by applying the steps
below. All the <a lt="text track">text tracks</a> that use these rules for a given <a>media
element</a> are rendered together, to avoid overlapping subtitles from multiple tracks. A fallback
language |language| may be set when calling this algorithm.</p>

<p class="note">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
Expand All @@ -4157,7 +4159,7 @@ manner suiting the user.</p>
<li><p>If the <a>media element</a> is an <a element>audio</a> element, or is another playback
mechanism with no rendering area, abort these steps.</p></li>

<li><p>Let |video| be the <a>media element</a> or other playback mechanism.</p></li>
<li><p>Let |video| be the <a>media element</a>.</p></li>

<li><p>Let |output| be an empty list of absolutely positioned CSS block boxes.</p></li>

Expand Down Expand Up @@ -4931,8 +4933,8 @@ if the <a>text track</a> is being rendered for another media playback mechanism)
properties on the root <a>list of WebVTT Node Objects</a> and the <a lt="WebVTT region
object">WebVTT region objects</a> must take their initial values.</p>

<p>If there are style sheets that apply to the <a>media element</a> or other playback mechanism,
then they must be interpreted as defined in the next section.</p>
<p>If there are style sheets that apply to the <a>media element</a>, then they must be interpreted
as defined in the next section.</p>


<h2 id=css-extensions>CSS extensions</h2>
Expand Down
29 changes: 13 additions & 16 deletions index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1447,7 +1447,7 @@
<div class="head">
<p data-fill-with="logo"><a class="logo" href="https://www.w3.org/"> <img alt="W3C" height="48" src="https://www.w3.org/StyleSheets/TR/2016/logos/W3C" width="72"> </a> </p>
<h1 class="p-name no-ref" id="title">WebVTT: The Web Video Text Tracks Format</h1>
<h2 class="no-num no-toc no-ref heading settled" id="subtitle"><span class="content">Draft Community Group Report, <time class="dt-updated" datetime="2018-03-30">30 March 2018</time></span></h2>
<h2 class="no-num no-toc no-ref heading settled" id="subtitle"><span class="content">Draft Community Group Report, <time class="dt-updated" datetime="2018-04-02">2 April 2018</time></span></h2>
<div data-fill-with="spec-metadata">
<dl>
<dt>This version:
Expand Down Expand Up @@ -4451,18 +4451,16 @@ <h3 class="heading settled" data-level="6.5" id="dom-construction-rules"><span c
Objects</a> and their descendants.</p>
</ol>
<h2 class="heading settled" data-level="7" id="rendering"><span class="secno">7. </span><span class="content">Rendering</span><a class="self-link" href="#rendering"></a></h2>
<p class="note" role="note">This section describes in some detail how to visually render <a data-link-type="dfn" href="#webvtt-caption-or-subtitle-cue" id="ref-for-webvtt-caption-or-subtitle-cue-2">WebVTT caption or
subtitle cues</a> in a user agent. The processing model is quite tightly linked to media elements in
HTML, where CSS is available. <a data-link-type="dfn" href="#user-agents-that-do-not-support-css" id="ref-for-user-agents-that-do-not-support-css-1">User agents that do not support CSS</a> are expected to render
plain text only, without styling and positioning features. <a data-link-type="dfn" href="#user-agents-that-do-not-support-a-full-html-css-engine" id="ref-for-user-agents-that-do-not-support-a-full-html-css-engine-2">User agents that do not support a full
HTML CSS engine</a> are expected to render an equivalent visual representation to what a user agent
with a full CSS engine would render.</p>
<p>This section describes how to visually render WebVTT cues in a user agent. The processing model
is tightly linked to media elements in HTML and follows the handling of cues when <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/embedded-content.html#list-of-newly-introduced-cues">playing the
media resource</a>. When supporting WebVTT in media players that falls into the <a data-link-type="dfn" href="#user-agents-that-do-not-support-css" id="ref-for-user-agents-that-do-not-support-css-1">User agents that
do not support CSS</a> or <a data-link-type="dfn" href="#user-agents-that-do-not-support-a-full-html-css-engine" id="ref-for-user-agents-that-do-not-support-a-full-html-css-engine-2">User agents that do not support a full HTML CSS engine</a> conformace
classes, equivalent visual rendering will need to be implemented.</p>
<h3 class="heading settled algorithm" data-algorithm="Processing model" data-level="7.1" id="processing-model"><span class="secno">7.1. </span><span class="content">Processing model</span><a class="self-link" href="#processing-model"></a></h3>
<p>The <dfn class="dfn-paneled" data-dfn-type="dfn" data-noexport="" id="rules-for-updating-the-display-of-webvtt-text-tracks">rules for updating the display of WebVTT text tracks</dfn> render the <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/embedded-content.html#text-track">text tracks</a> of a <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/embedded-content.html#media-element">media element</a> (specifically, a <a data-link-type="element" href="https://html.spec.whatwg.org/multipage/media.html#video">video</a> element), or of another playback
mechanism, by applying the steps below. All the <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/embedded-content.html#text-track">text tracks</a> that use these
rules for a given <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/embedded-content.html#media-element">media element</a>, or other playback mechanism, are rendered together, to avoid
overlapping subtitles from multiple tracks. A fallback language <var>language</var> may be set when calling
this algorithm.</p>
<p>The <dfn class="dfn-paneled" data-dfn-type="dfn" data-noexport="" id="rules-for-updating-the-display-of-webvtt-text-tracks">rules for updating the display of WebVTT text tracks</dfn> render the <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/embedded-content.html#text-track">text tracks</a> of a <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/embedded-content.html#media-element">media element</a> (specifically, a <a data-link-type="element" href="https://html.spec.whatwg.org/multipage/media.html#video">video</a> element) by applying the steps
below. All the <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/embedded-content.html#text-track">text tracks</a> that use these rules for a given <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/embedded-content.html#media-element">media
element</a> are rendered together, to avoid overlapping subtitles from multiple tracks. A fallback
language <var>language</var> may be set when calling this algorithm.</p>
<p class="note" role="note">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>
Expand All @@ -4474,7 +4472,7 @@ <h3 class="heading settled algorithm" data-algorithm="Processing model" data-lev
<p>If the <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/embedded-content.html#media-element">media element</a> is an <a data-link-type="element" href="https://html.spec.whatwg.org/multipage/media.html#audio">audio</a> element, or is another playback
mechanism with no rendering area, abort these steps.</p>
<li>
<p>Let <var>video</var> be the <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/embedded-content.html#media-element">media element</a> or other playback mechanism.</p>
<p>Let <var>video</var> be the <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/embedded-content.html#media-element">media element</a>.</p>
<li>
<p>Let <var>output</var> be an empty list of absolutely positioned CSS block boxes.</p>
<li>
Expand Down Expand Up @@ -4987,8 +4985,8 @@ <h3 class="heading settled algorithm" data-algorithm="Applying CSS properties to
the root <a data-link-type="dfn" href="#list-of-webvtt-node-objects" id="ref-for-list-of-webvtt-node-objects-16">list of WebVTT Node Objects</a> must inherit their values from the <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/embedded-content.html#media-element">media element</a> for which the <a data-link-type="dfn" href="#webvtt-cue" id="ref-for-webvtt-cue-29">WebVTT cue</a> is being rendered, if any. If there is no <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/embedded-content.html#media-element">media element</a> (i.e.
if the <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/embedded-content.html#text-track">text track</a> is being rendered for another media playback mechanism), then inherited
properties on the root <a data-link-type="dfn" href="#list-of-webvtt-node-objects" id="ref-for-list-of-webvtt-node-objects-17">list of WebVTT Node Objects</a> and the <a data-link-type="dfn" href="#webvtt-region-object" id="ref-for-webvtt-region-object-9">WebVTT region objects</a> must take their initial values.</p>
<p>If there are style sheets that apply to the <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/embedded-content.html#media-element">media element</a> or other playback mechanism,
then they must be interpreted as defined in the next section.</p>
<p>If there are style sheets that apply to the <a data-link-type="dfn" href="https://html.spec.whatwg.org/multipage/embedded-content.html#media-element">media element</a>, then they must be interpreted
as defined in the next section.</p>
<h2 class="heading settled" data-level="8" id="css-extensions"><span class="secno">8. </span><span class="content">CSS extensions</span><a class="self-link" href="#css-extensions"></a></h2>
<p class="note" role="note">This section specifies some CSS pseudo-elements and pseudo-classes and how they
apply to WebVTT. This section does not apply to <a data-link-type="dfn" href="#user-agents-that-do-not-support-css" id="ref-for-user-agents-that-do-not-support-css-2">user agents that do not support CSS</a>.</p>
Expand Down Expand Up @@ -6635,7 +6633,6 @@ <h2 class="no-num no-ref heading settled" id="idl-index"><span class="content">I
<b><a href="#webvtt-caption-or-subtitle-cue">#webvtt-caption-or-subtitle-cue</a></b><b>Referenced in:</b>
<ul>
<li><a href="#ref-for-webvtt-caption-or-subtitle-cue-1">3.4. WebVTT caption or subtitle regions</a>
<li><a href="#ref-for-webvtt-caption-or-subtitle-cue-2">7. Rendering</a>
</ul>
</aside>
<aside class="dfn-panel" data-for="webvtt-cue-box">
Expand Down