- From: poot <cvsmail@w3.org>
- Date: Wed, 9 Jul 2008 17:13:24 +0900 (JST)
- To: public-html-diffs@w3.org
Define handling of poster frame on <video> in more detail. (whatwg r1850) (changed by: Ian Hickson) Diffs for this change per section: http://people.w3.org/mike/diffs/html5/spec/Overview.1.1039.html#adjusted http://people.w3.org/mike/diffs/html5/spec/Overview.1.1039.html#poster http://people.w3.org/mike/diffs/html5/spec/Overview.1.1039.html#poster0 http://people.w3.org/mike/diffs/html5/spec/Overview.1.1039.html#poster1 http://people.w3.org/mike/diffs/html5/spec/Overview.1.1039.html#htmlvideoelement http://people.w3.org/mike/diffs/html5/spec/Overview.1.1039.html#videoheight Current content per affected section: http://dev.w3.org/html5/spec/Overview.html#adjusted http://dev.w3.org/html5/spec/Overview.html#poster http://dev.w3.org/html5/spec/Overview.html#poster0 http://dev.w3.org/html5/spec/Overview.html#poster1 http://dev.w3.org/html5/spec/Overview.html#htmlvideoelement http://dev.w3.org/html5/spec/Overview.html#videoheight Previously published WD content per affected section: http://www.w3.org/TR/2008/WD-html5-20080610/single-page/#adjusted http://www.w3.org/TR/2008/WD-html5-20080610/single-page/#poster http://www.w3.org/TR/2008/WD-html5-20080610/single-page/#poster0 http://www.w3.org/TR/2008/WD-html5-20080610/single-page/#poster1 http://www.w3.org/TR/2008/WD-html5-20080610/single-page/#htmlvideoelement http://www.w3.org/TR/2008/WD-html5-20080610/single-page/#videoheight Cumulative diff: http://people.w3.org/mike/diffs/html5/spec/Overview.diff.html http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.1038&r2=1.1039&f=h http://html5.org/tools/web-apps-tracker?from=1849&to=1850 =================================================================== RCS file: /sources/public/html5/spec/Overview.html,v retrieving revision 1.1038 retrieving revision 1.1039 diff -u -d -r1.1038 -r1.1039 --- Overview.html 7 Jul 2008 09:17:57 -0000 1.1038 +++ Overview.html 8 Jul 2008 22:58:52 -0000 1.1039 @@ -59,7 +59,7 @@ for HTML and XHTML</h2> <h2 class="no-num no-toc" id=editors0><!-- "W3C Working Draft" --> - Editor's Draft <!--ZZZ--> 7 July 2008</h2> + Editor's Draft <!--ZZZ--> 8 July 2008</h2> <dl><!-- ZZZ: update the month/day <dt>This Version:</dt> @@ -207,7 +207,7 @@ <p>The W3C <a href="http://www.w3.org/html/wg/">HTML Working Group</a> is the W3C working group responsible for this specification's progress along - the W3C Recommendation track. <!--ZZZ:--> This specification is the 7 July + the W3C Recommendation track. <!--ZZZ:--> This specification is the 8 July 2008 <!--ZZZ "Working Draft"-->Editor's Draft. <!--:ZZZ--></p> <!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --> <!-- relationship to other work (required) --> @@ -16839,7 +16839,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> @@ -16885,16 +16885,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. @@ -16909,6 +16911,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 @@ -16916,30 +16920,20 @@ 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. - - <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>. + 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="#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, @@ -16948,6 +16942,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 @@ -17004,21 +17010,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
Received on Wednesday, 9 July 2008 08:14:16 UTC