[html5] r1850 - [gow] (2) Define handling of poster frame on <video> in more detail.
whatwg at whatwg.org
whatwg at whatwg.org
Tue Jul 8 15:58:46 PDT 2008
Author: ianh
Date: 2008-07-08 15:58:43 -0700 (Tue, 08 Jul 2008)
New Revision: 1850
Modified:
index
source
Log:
[gow] (2) Define handling of poster frame on <video> in more detail.
Modified: index
===================================================================
--- index 2008-07-07 09:17:51 UTC (rev 1849)
+++ index 2008-07-08 22:58:43 UTC (rev 1850)
@@ -25,7 +25,7 @@
<h1 id=html-5>HTML 5</h1>
- <h2 class="no-num no-toc" id=draft>Draft Recommendation — 7 July
+ <h2 class="no-num no-toc" id=draft>Draft Recommendation — 8 July
2008</h2>
<p>You can take part in this work. <a
@@ -16735,7 +16735,7 @@
attribute long <a href="#height4" title=dom-dim-height>height</a>;
readonly attribute unsigned long <a href="#videowidth" title=dom-video-videoWidth>videoWidth</a>;
readonly attribute unsigned long <a href="#videoheight" title=dom-video-videoHeight>videoHeight</a>;
- attribute DOMString <a href="#poster0" title=dom-video-poster>poster</a>;
+ attribute DOMString <a href="#poster1" title=dom-video-poster>poster</a>;
};</pre>
</dl>
@@ -16781,16 +16781,18 @@
a <a href="#valid">valid URL</a>. If the specified resource is to be used,
it must be fetched when the element is created or when the <code
title=attr-video-poster><a href="#poster">poster</a></code> attribute is
- set.</p>
- <!-- So that it is unaffected by changes to the base URL.
- -->
+ set. The <dfn id=poster0>poster frame</dfn> is then the image obtained
+ from that resource, if any.</p>
+ <!-- So that it is unaffected by changes
+ to the base URL. -->
<p class=note>The image given by the <code title=attr-video-poster><a
- href="#poster">poster</a></code> attribute is intended to be a <i>poster
- frame</i>, a representative frame of the video (typically one of the first
- non-blank frames) that gives the user an idea of what the video is like.
+ href="#poster">poster</a></code> attribute, the <i><a
+ href="#poster0">poster frame</a></i>, is intended to be a representative
+ frame of the video (typically one of the first non-blank frames) that
+ gives the user an idea of what the video is like.
- <p>The <dfn id=poster0 title=dom-video-poster><code>poster</code></dfn> DOM
+ <p>The <dfn id=poster1 title=dom-video-poster><code>poster</code></dfn> DOM
attribute must <a href="#reflect">reflect</a> the <code
title=attr-video-poster><a href="#poster">poster</a></code> content
attribute.
@@ -16805,6 +16807,8 @@
the video corresponds to one CSS pixel. If no video data is available,
then the attributes must return 0.
+ <hr>
+
<p>When no video data is available (the element's <code
title=dom-media-networkState><a
href="#networkstate">networkState</a></code> attribute is either <code
@@ -16812,31 +16816,21 @@
title=dom-media-LOADING><a href="#loading0">LOADING</a></code>, or <code
title=dom-media-LOADED_METADATA><a
href="#loadedmetadata">LOADED_METADATA</a></code>), <code><a
- href="#video1">video</a></code> elements represent either the image given
- by the <code title=attr-video-poster><a href="#poster">poster</a></code>
- attribute, or nothing.
+ href="#video1">video</a></code> elements represent either the <a
+ href="#poster0">poster frame</a>, or nothing.
<p>When a <code><a href="#video1">video</a></code> element is <a
- href="#actively">actively playing</a>, it represents the frame of video at
- the continuously increasing <a href="#current0" title="current playback
- position">"current" position</a>. When the <a href="#current0">current
- playback position</a> changes such that the last frame rendered is no
- longer the frame corresponding to the <a href="#current0">current playback
- position</a> in the video, the new frame must be rendered. Similarly, any
- audio associated with the video must, if played, be played synchronized
- with the <a href="#current0">current playback position</a>, at the
- specified <a href="#volume" title=dom-media-volume>volume</a> with the
- specified <a href="#muted" title=dom-media-muted>mute state</a>.
-
- <p>When a <code><a href="#video1">video</a></code> element is <a
href="#paused" title=dom-media-paused>paused</a> and the <a
href="#current0" title="current playback position">current playback
position</a> is the first frame of video, the element represents either
the frame of video corresponding to the <a href="#current0" title="current
- playback position">current playback position</a> or the image given by the
- <code title=attr-video-poster><a href="#poster">poster</a></code>
- attribute, at the discretion of the user agent.
+ playback position">current playback position</a> or the <a
+ href="#poster0">poster frame</a>, at the discretion of the user agent.
+ <p>Notwithstanding the above, the <a href="#poster0">poster frame</a>
+ should be preferred over nothing, but the <a href="#poster0">poster
+ frame</a> should not be shown again after a frame of video has been shown.
+
<p>When a <code><a href="#video1">video</a></code> element is <a
href="#paused" title=dom-media-paused>paused</a> at any other position,
the element represents the frame of video corresponding to the <a
@@ -16844,6 +16838,18 @@
position</a>, or, if that is not yet available (e.g. because the video is
seeking or buffering), the last frame of the video to have been rendered.
+ <p>When a <code><a href="#video1">video</a></code> element is <a
+ href="#actively">actively playing</a>, it represents the frame of video at
+ the continuously increasing <a href="#current0" title="current playback
+ position">"current" position</a>. When the <a href="#current0">current
+ playback position</a> changes such that the last frame rendered is no
+ longer the frame corresponding to the <a href="#current0">current playback
+ position</a> in the video, the new frame must be rendered. Similarly, any
+ audio associated with the video must, if played, be played synchronized
+ with the <a href="#current0">current playback position</a>, at the
+ specified <a href="#volume" title=dom-media-volume>volume</a> with the
+ specified <a href="#muted" title=dom-media-muted>mute state</a>.
+
<p>When a <code><a href="#video1">video</a></code> element is neither <a
href="#actively">actively playing</a> nor <a href="#paused"
title=dom-media-paused>paused</a> (e.g. when seeking or stalled), the
@@ -16900,21 +16906,18 @@
<p>The intrinsic width of a <code><a href="#video1">video</a></code>
element's playback area is the intrinsic width of the video resource, if
- that is available; otherwise it is the intrinsic width of the resource
- given by the <code title=attr-video-poster><a
- href="#poster">poster</a></code> attribute, if that is available;
- otherwise it is 300 CSS pixels.
+ that is available; otherwise it is the intrinsic width of the <a
+ href="#poster0">poster frame</a>, if that is available; otherwise it is
+ 300 CSS pixels.
<p>The intrinsic height of a <code><a href="#video1">video</a></code>
element's playback area is the intrinsic height of the video resource, if
- that is available; otherwise it is the intrinsic height of the resource
- given by the <code title=attr-video-poster><a
- href="#poster">poster</a></code> attribute, if that is available;
- otherwise it is 150 CSS pixels.
+ that is available; otherwise it is the intrinsic height of the <a
+ href="#poster0">poster frame</a>, if that is available; otherwise it is
+ 150 CSS pixels.
- <p class=note>The image given by the <code title=attr-video-poster><a
- href="#poster">poster</a></code> attribute is not affected by the pixel
- ratio conversions.
+ <p class=note>The <a href="#poster0">poster frame</a> is not affected by
+ the pixel ratio conversions.
<hr>
<!-- XXX
Modified: source
===================================================================
--- source 2008-07-07 09:17:51 UTC (rev 1849)
+++ source 2008-07-08 22:58:43 UTC (rev 1850)
@@ -14581,12 +14581,13 @@
must contain a <span>valid URL</span>. If the specified resource is
to be used, it must be fetched when the element is created or when
the <code title="attr-video-poster">poster</code> attribute is
- set.</p> <!-- So that it is unaffected by changes to the base URL.
- -->
+ set. The <dfn>poster frame</dfn> is then the image obtained from
+ that resource, if any.</p> <!-- So that it is unaffected by changes
+ to the base URL. -->
<p class="note">The image given by the <code
- title="attr-video-poster">poster</code> attribute is intended to be
- a <i>poster frame</i>, a representative frame of the video
+ title="attr-video-poster">poster</code> attribute, the <i>poster
+ frame</i>, is intended to be a representative frame of the video
(typically one of the first non-blank frames) that gives the user an
idea of what the video is like.</p>
@@ -14606,36 +14607,28 @@
pixel. If no video data is available, then the attributes must
return 0.</p>
+ <hr>
+
<p>When no video data is available (the element's <code
title="dom-media-networkState">networkState</code> attribute is
either <code title="dom-media-EMPTY">EMPTY</code>, <code
title="dom-media-LOADING">LOADING</code>, or <code
title="dom-media-LOADED_METADATA">LOADED_METADATA</code>),
- <code>video</code> elements represent either the image given by the
- <code title="attr-video-poster">poster</code> attribute, or
- nothing.</p>
+ <code>video</code> elements represent either the <span>poster
+ frame</span>, or nothing.</p>
- <p>When a <code>video</code> element is <span>actively
- playing</span>, it represents the frame of video at the continuously
- increasing <span title="current playback position">"current"
- position</span>. When the <span>current playback position</span>
- changes such that the last frame rendered is no longer the frame
- corresponding to the <span>current playback position</span> in the
- video, the new frame must be rendered. Similarly, any audio
- associated with the video must, if played, be played synchronized
- with the <span>current playback position</span>, at the specified
- <span title="dom-media-volume">volume</span> with the specified
- <span title="dom-media-muted">mute state</span>.</p>
-
<p>When a <code>video</code> element is <span
title="dom-media-paused">paused</span> and the <span title="current
playback position">current playback position</span> is the first
frame of video, the element represents either the frame of video
corresponding to the <span title="current playback position">current
- playback position</span> or the image given by the <code
- title="attr-video-poster">poster</code> attribute, at the discretion
- of the user agent.</p>
+ playback position</span> or the <span>poster frame</span>, at the
+ discretion of the user agent.</p>
+ <p>Notwithstanding the above, the <span>poster frame</span> should
+ be preferred over nothing, but the <span>poster frame</span> should
+ not be shown again after a frame of video has been shown.</p>
+
<p>When a <code>video</code> element is <span
title="dom-media-paused">paused</span> at any other position, the
element represents the frame of video corresponding to the <span
@@ -14644,6 +14637,18 @@
or buffering), the last frame of the video to have been
rendered.</p>
+ <p>When a <code>video</code> element is <span>actively
+ playing</span>, it represents the frame of video at the continuously
+ increasing <span title="current playback position">"current"
+ position</span>. When the <span>current playback position</span>
+ changes such that the last frame rendered is no longer the frame
+ corresponding to the <span>current playback position</span> in the
+ video, the new frame must be rendered. Similarly, any audio
+ associated with the video must, if played, be played synchronized
+ with the <span>current playback position</span>, at the specified
+ <span title="dom-media-volume">volume</span> with the specified
+ <span title="dom-media-muted">mute state</span>.</p>
+
<p>When a <code>video</code> element is neither <span>actively
playing</span> nor <span title="dom-media-paused">paused</span>
(e.g. when seeking or stalled), the element represents the last
@@ -14703,19 +14708,18 @@
<p>The intrinsic width of a <code>video</code> element's playback
area is the intrinsic width of the video resource, if that is
- available; otherwise it is the intrinsic width of the resource given
- by the <code title="attr-video-poster">poster</code> attribute, if
- that is available; otherwise it is 300 CSS pixels.</p>
+ available; otherwise it is the intrinsic width of the <span>poster
+ frame</span>, if that is available; otherwise it is 300 CSS
+ pixels.</p>
<p>The intrinsic height of a <code>video</code> element's playback
area is the intrinsic height of the video resource, if that is
- available; otherwise it is the intrinsic height of the resource given
- by the <code title="attr-video-poster">poster</code> attribute, if
- that is available; otherwise it is 150 CSS pixels.</p>
+ available; otherwise it is the intrinsic height of the <span>poster
+ frame</span>, if that is available; otherwise it is 150 CSS
+ pixels.</p>
- <p class="note">The image given by the <code
- title="attr-video-poster">poster</code> attribute is not affected by
- the pixel ratio conversions.</p>
+ <p class="note">The <span>poster frame</span> is not affected by the
+ pixel ratio conversions.</p>
<hr>
More information about the Commit-Watchers
mailing list