diff --git a/anchors-w3c.txt b/anchors-w3c.txt index 7955d378..ec959279 100644 --- a/anchors-w3c.txt +++ b/anchors-w3c.txt @@ -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 diff --git a/index.bs b/index.bs index 9890191b..eb316d65 100644 --- a/index.bs +++ b/index.bs @@ -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 @@ -4125,22 +4129,20 @@ follows:

Rendering

-

This section describes in some detail how to visually render WebVTT caption or -subtitle cues in a user agent. The processing model is quite tightly linked to media elements in -HTML, where CSS is available. User agents that do not support CSS are expected to render -plain text only, without styling and positioning features. User agents that do not support a full -HTML CSS engine are expected to render an equivalent visual representation to what a user agent -with a full CSS engine would render.

+

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 playing the +media resource. When supporting WebVTT in media players that falls into the User agents that +do not support CSS or User agents that do not support a full HTML CSS engine conformace +classes, equivalent visual rendering will need to be implemented.

Processing model

The rules for updating the display of WebVTT text tracks render the text tracks -of a media element (specifically, a video element), or of another playback -mechanism, by applying the steps below. All the text tracks that use these -rules for a given media element, 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.

+of a media element (specifically, a video element) by applying the steps +below. All the text tracks that use these rules for a given media +element are rendered together, to avoid overlapping subtitles from multiple tracks. A fallback +language |language| may be set when calling this algorithm.

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 @@ -4157,7 +4159,7 @@ manner suiting the user.

  • If the media element is an audio element, or is another playback mechanism with no rendering area, abort these steps.

    • -

  • Let |video| be the media element or other playback mechanism.

    • +

  • Let |video| be the media element.

  • Let |output| be an empty list of absolutely positioned CSS block boxes.

    • @@ -4931,8 +4933,8 @@ if the text track is being rendered for another media playback mechanism) properties on the root list of WebVTT Node Objects and the WebVTT region objects must take their initial values.

    -

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

    +

    If there are style sheets that apply to the media element, then they must be interpreted +as defined in the next section.

    CSS extensions

    diff --git a/index.html b/index.html index d041b479..83256ec9 100644 --- a/index.html +++ b/index.html @@ -1447,7 +1447,7 @@

    WebVTT: The Web Video Text Tracks Format

    -

    Draft Community Group Report,

    +

    Draft Community Group Report,

    This version: @@ -4451,18 +4451,16 @@

    and their descendants.

    7. Rendering

    -

    This section describes in some detail how to visually render WebVTT caption or -subtitle cues in a user agent. The processing model is quite tightly linked to media elements in -HTML, where CSS is available. User agents that do not support CSS are expected to render -plain text only, without styling and positioning features. User agents that do not support a full -HTML CSS engine are expected to render an equivalent visual representation to what a user agent -with a full CSS engine would render.

    +

    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 playing the +media resource. When supporting WebVTT in media players that falls into the User agents that +do not support CSS or User agents that do not support a full HTML CSS engine conformace +classes, equivalent visual rendering will need to be implemented.

    7.1. Processing model

    -

    The rules for updating the display of WebVTT text tracks render the text tracks of a media element (specifically, a video element), or of another playback -mechanism, by applying the steps below. All the text tracks that use these -rules for a given media element, 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.

    +

    The rules for updating the display of WebVTT text tracks render the text tracks of a media element (specifically, a video element) by applying the steps +below. All the text tracks that use these rules for a given media +element are rendered together, to avoid overlapping subtitles from multiple tracks. A fallback +language language may be set when calling this algorithm.

    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.

    @@ -4474,7 +4472,7 @@

    If the media element is an audio element, or is another playback mechanism with no rendering area, abort these steps.

  • -

    Let video be the media element or other playback mechanism.

    +

    Let video be the media element.

  • Let output be an empty list of absolutely positioned CSS block boxes.

  • @@ -4987,8 +4985,8 @@

    list of WebVTT Node Objects must inherit their values from the media element for which the WebVTT cue is being rendered, if any. If there is no media element (i.e. if the text track is being rendered for another media playback mechanism), then inherited properties on the root list of WebVTT Node Objects and the WebVTT region objects must take their initial values.

    -

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

    +

    If there are style sheets that apply to the media element, then they must be interpreted +as defined in the next section.

    8. CSS extensions

    This section specifies some CSS pseudo-elements and pseudo-classes and how they apply to WebVTT. This section does not apply to user agents that do not support CSS.

    @@ -6635,7 +6633,6 @@

    I #webvtt-caption-or-subtitle-cueReferenced in: