- From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
- Date: Sat, 15 Nov 2008 19:34:40 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv24615
Modified Files:
Overview.html
Log Message:
Remove bufferedBytes and totalBytes. (whatwg r2405)
Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1576
retrieving revision 1.1577
diff -u -d -r1.1576 -r1.1577
--- Overview.html 15 Nov 2008 19:28:51 -0000 1.1576
+++ Overview.html 15 Nov 2008 19:34:38 -0000 1.1577
@@ -385,9 +385,8 @@
<li><a href=#seeking><span class=secno>4.8.10.10 </span>Seeking</a></li>
<li><a href=#user-interface><span class=secno>4.8.10.11 </span>User interface</a></li>
<li><a href=#time-ranges><span class=secno>4.8.10.12 </span>Time ranges</a></li>
- <li><a href=#byte-ranges><span class=secno>4.8.10.13 </span>Byte ranges</a></li>
- <li><a href=#mediaevents><span class=secno>4.8.10.14 </span>Event summary</a></li>
- <li><a href=#security-and-privacy-considerations><span class=secno>4.8.10.15 </span>Security and privacy considerations</a></ol></li>
+ <li><a href=#mediaevents><span class=secno>4.8.10.13 </span>Event summary</a></li>
+ <li><a href=#security-and-privacy-considerations><span class=secno>4.8.10.14 </span>Security and privacy considerations</a></ol></li>
<li><a href=#the-canvas-element><span class=secno>4.8.11 </span>The <code>canvas</code> element</a>
<ol>
<li><a href=#the-2d-context><span class=secno>4.8.11.1 </span>The 2D context</a>
@@ -13734,8 +13733,6 @@
readonly attribute float <a href=#dom-media-bufferingrate title=dom-media-bufferingRate>bufferingRate</a>;
readonly attribute boolean <a href=#dom-media-bufferingthrottled title=dom-media-bufferingThrottled>bufferingThrottled</a>;
readonly attribute <a href=#timeranges>TimeRanges</a> <a href=#dom-media-buffered title=dom-media-buffered>buffered</a>;
- readonly attribute <a href=#byteranges>ByteRanges</a> <a href=#dom-media-bufferedbytes title=dom-media-bufferedBytes>bufferedBytes</a>;
- readonly attribute unsigned long <a href=#dom-media-totalbytes title=dom-media-totalBytes>totalBytes</a>;
void <a href=#dom-media-load title=dom-media-load>load</a>();
DOMString <a href=#dom-navigator-canplaytype title=dom-navigator-canPlayType>canPlayType</a>(in DOMString type);
@@ -14443,20 +14440,14 @@
attribute must return a static <a href=#normalized-timeranges-object>normalized
<code>TimeRanges</code> object</a> that represents the ranges of
the <a href=#media-resource>media resource</a>, if any, that the user agent has
- buffered, at the time the attribute is evaluated.<p class=note>Typically this will be a single range anchored at
+ buffered, at the time the attribute is evaluated. Users agents must
+ accurately determine the ranges available, even for media streams
+ where this can only be determined by tedious inspection.<p class=note>Typically this will be a single range anchored at
the zero point, but if, e.g. the user agent uses HTTP range requests
- in response to seeking, then there could be multiple ranges.<p>The <dfn id=dom-media-bufferedbytes title=dom-media-bufferedBytes><code>bufferedBytes</code></dfn>
- attribute must return a static <a href=#normalized-byteranges-object>normalized
- <code>ByteRanges</code> object</a> that represents the ranges of
- the <a href=#media-resource>media resource</a>, if any, that the user agent has
- buffered, at the time the attribute is evaluated.<p>The <dfn id=dom-media-totalbytes title=dom-media-totalBytes><code>totalBytes</code></dfn> attribute
- must return the length of the <a href=#media-resource>media resource</a>, in bytes,
- if it is known and finite. If it is not known, is infinite
- (e.g. streaming radio), or if no <a href=#media-data>media data</a> is
- available, the attribute must return 0.<p>User agents may discard previously buffered data.<p class=note>Thus, a time or byte position included within a
- range of the objects return by the <code title=dom-media-buffered><a href=#dom-media-buffered>buffered</a></code> or <code title=dom-media-bufferedBytes><a href=#dom-media-bufferedbytes>bufferedBytes</a></code> attributes at
- one time can end up being not included in the range(s) of objects
- returned by the same attributes at a later time.<h5 id=offsets-into-the-media-resource><span class=secno>4.8.10.6 </span>Offsets into the media resource</h5><p>The <dfn id=dom-media-duration title=dom-media-duration><code>duration</code></dfn>
+ in response to seeking, then there could be multiple ranges.<p>User agents may discard previously buffered data.<p class=note>Thus, a time position included within a range of the
+ objects return by the <code title=dom-media-buffered><a href=#dom-media-buffered>buffered</a></code> attribute at one time can
+ end up being not included in the range(s) of objects returned by the
+ same attribute at later times.<h5 id=offsets-into-the-media-resource><span class=secno>4.8.10.6 </span>Offsets into the media resource</h5><p>The <dfn id=dom-media-duration title=dom-media-duration><code>duration</code></dfn>
attribute must return the length of the <a href=#media-resource>media resource</a>,
in seconds. If no <a href=#media-data>media data</a> is available, then the
attributes must return 0. If <a href=#media-data>media data</a> is available
@@ -15075,33 +15066,7 @@
</ul><p>In other words, the ranges in such an object are ordered, don't
overlap, aren't empty, and don't touch (adjacent ranges are folded
into one bigger range).<p>The timelines used by the objects returned by the <code title=dom-media-buffered><a href=#dom-media-buffered>buffered</a></code>, <code title=dom-media-seekable><a href=#dom-media-seekable>seekable</a></code> and <code title=dom-media-played><a href=#dom-media-played>played</a></code> DOM attributes of <a href=#media-element title="media element">media elements</a> must be the same as that
- element's <a href=#media-resource>media resource</a>'s timeline.<h5 id=byte-ranges><span class=secno>4.8.10.13 </span>Byte ranges</h5><p>Objects implementing the <code><a href=#byteranges>ByteRanges</a></code> interface
- represent a list of ranges of bytes.<pre class=idl>interface <dfn id=byteranges>ByteRanges</dfn> {
- readonly attribute unsigned long <a href=#dom-byteranges-length title=dom-ByteRanges-length>length</a>;
- unsigned long <a href=#dom-byteranges-start title=dom-ByteRanges-start>start</a>(in unsigned long index);
- unsigned long <a href=#dom-byteranges-end title=dom-ByteRanges-end>end</a>(in unsigned long index);
-};</pre><p>The <dfn id=dom-byteranges-length title=dom-ByteRanges-length><code>length</code></dfn>
- DOM attribute must return the number of ranges represented by the object.<p>The <dfn id=dom-byteranges-start title=dom-ByteRanges-start><code>start(<var title="">index</var>)</code></dfn> method must return the position
- of the first byte of the <var title="">index</var>th range
- represented by the object.<p>The <dfn id=dom-byteranges-end title=dom-ByteRanges-end><code>end(<var title="">index</var>)</code></dfn> method must return the position
- of the byte immediately after the last byte of the <var title="">index</var>th range represented by the object. (The byte
- position returned by this method is not in the range itself. If the
- first byte of the range is the byte at position 0, and the entire
- stream of bytes is in the range, then the value of the position of
- the byte returned by this method for that range will be the same as
- the number of bytes in the stream.)<p>These methods must raise <code>INDEX_SIZE_ERR</code> exceptions
- if called with an <var title="">index</var> argument greater than or
- equal to the number of ranges represented by the object.<p>When a <code><a href=#byteranges>ByteRanges</a></code> object is said to be a
- <dfn id=normalized-byteranges-object>normalized <code>ByteRanges</code> object</dfn>, the ranges it
- represents must obey the following criteria:<ul><li>The start of a range must be greater than the end of all
- earlier ranges.</li>
-
- <li>The start of a range must be less than the end of that same
- range.</li>
-
- </ul><p>In other words, the ranges in such an object are ordered, don't
- overlap, aren't empty, and don't touch (adjacent ranges are folded
- into one bigger range).<h5 id=mediaevents><span class=secno>4.8.10.14 </span>Event summary</h5><p>The following events fire on <a href=#media-element title="media element">media
+ element's <a href=#media-resource>media resource</a>'s timeline.<h5 id=mediaevents><span class=secno>4.8.10.13 </span>Event summary</h5><p>The following events fire on <a href=#media-element title="media element">media
elements</a> as part of the processing model described above:<table><thead><tr><th>Event name
<th>Interface
<th>Dispatched when...
@@ -15201,7 +15166,7 @@
<td><code>Event</code>
<td>Either the <code title=dom-media-volume><a href=#dom-media-volume>volume</a></code> attribute or the <code title=dom-media-muted><a href=#dom-media-muted>muted</a></code> attribute has changed. Fired after the relevant attribute's setter has returned.
<td>
- </table><h5 id=security-and-privacy-considerations><span class=secno>4.8.10.15 </span>Security and privacy considerations</h5><p class=XXX>Talk about making sure interactive media files
+ </table><h5 id=security-and-privacy-considerations><span class=secno>4.8.10.14 </span>Security and privacy considerations</h5><p class=XXX>Talk about making sure interactive media files
(e.g. SVG) don't have access to the container DOM (XSS potential);
talk about not exposing any sensitive data like metadata from tracks
in the media files (intranet snooping risk)<h4 id=the-canvas-element><span class=secno>4.8.11 </span>The <dfn id=canvas><code>canvas</code></dfn> element</h4><dl class=element><dt>Categories</dt>
Received on Saturday, 15 November 2008 19:34:51 UTC