html5/spec Overview.html,1.1504,1.1505

Update of /sources/public/html5/spec
In directory hutz:/tmp/cvs-serv28271

Modified Files:
	Overview.html 
Log Message:
Add navigator.canPlayType() to introspect video and audio types. (whatwg r2332)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.1504
retrieving revision 1.1505
diff -u -d -r1.1504 -r1.1505
--- Overview.html	15 Oct 2008 00:45:31 -0000	1.1504
+++ Overview.html	15 Oct 2008 00:57:31 -0000	1.1505
@@ -592,7 +592,8 @@
      <li><a href=#custom-handlers><span class=secno>5.6.2 </span>Custom protocol and content handlers</a>
       <ol>
        <li><a href=#security-and-privacy><span class=secno>5.6.2.1 </span>Security and privacy</a></li>
-       <li><a href=#sample-handler-impl><span class=secno>5.6.2.2 </span>Sample user interface</a></ol></ol></li>
+       <li><a href=#sample-handler-impl><span class=secno>5.6.2.2 </span>Sample user interface</a></ol></li>
+     <li><a href=#client-abilities><span class=secno>5.6.3 </span>Client abilities</a></ol></li>
    <li><a href=#offline><span class=secno>5.7 </span>Offline Web applications</a>
     <ol>
      <li><a href=#introduction-0><span class=secno>5.7.1 </span>Introduction</a></li>
@@ -13562,7 +13563,9 @@
   implicit loads. Unless otherwise specified, the <a href=#task-source>task
   source</a> for all the tasks <a href=#queue-a-task title="queue a
   task">queued</a> in this section and its subsections is the
-  <a href=#media-element-event-task-source>media element event task source</a>.<h5 id=error-codes><span class=secno>4.8.10.1 </span>Error codes</h5><p>All <a href=#media-element title="media element">media elements</a> have an
+  <a href=#media-element-event-task-source>media element event task source</a>.<p>The <code title=dom-navigator-canPlayType><a href=#dom-navigator-canplaytype>canPlayType()</a></code>
+  method can be used to probe the user agent to determine what types
+  are supported.<h5 id=error-codes><span class=secno>4.8.10.1 </span>Error codes</h5><p>All <a href=#media-element title="media element">media elements</a> have an
   associated error status, which records the last error the element
   encountered since the <code title=dom-media-load><a href=#dom-media-load>load()</a></code>
   method was last invoked. The <dfn id=dom-media-error title=dom-media-error><code>error</code></dfn> attribute, on
@@ -27005,7 +27008,12 @@
   readonly attribute boolean <a href=#dom-navigator-online title=dom-navigator-onLine>onLine</a>;
   void <a href=#dom-navigator-registerprotocolhandler title=dom-navigator-registerProtocolHandler>registerProtocolHandler</a>(in DOMString protocol, in DOMString url, in DOMString title);
   void <a href=#dom-navigator-registercontenthandler title=dom-navigator-registerContentHandler>registerContentHandler</a>(in DOMString mimeType, in DOMString url, in DOMString title);
-};</pre><!-- XXX also, see window.external.AddSearchProvider() and similar DOM APIs from IE --><!-- XXX also, see: cookieEnabled geolocator javaEnabled mimeTypes mozIsLocallyAvailable plugins preference --><!-- XXX also, could expose languages:
+
+  // abilities<!--
+  XXX cookieEnabled geolocator javaEnabled mozIsLocallyAvailable plugins preference
+  readonly attribute <span>MimeTypeArray</span> <span title="dom-navigator-mimeTypes">mimeTypes</span>;-->
+  short <a href=#dom-navigator-canplaytype title=dom-navigator-canPlayType>canPlayType</a>(in DOMString type);
+};</pre><!-- XXX also, see window.external.AddSearchProvider() and similar DOM APIs from IE --><!-- XXX also, could expose languages:
    <dt><dfn title="dom-navigator-browserLanguage"><code>browserLanguage</code></dfn></dt> <!- - Opera and IE only - ->
    <dd><p>Must return either null or a language code representing the language the browser uses in its interface.</p></dd>
    <dt><dfn title="dom-navigator-userLanguage"><code>userLanguage</code></dfn></dt> <!- - Opera and IE only - ->
@@ -27291,7 +27299,12 @@
   sections, will redirect the user to
   "http://kittens.example.org/?show=x-meow%3AS2l0dGVucyBhcmUgdGhlIGN1dGVzdCE%253D".<p>The <code title=dom-navigator-registerContentHandler><a href=#dom-navigator-registercontenthandler>registerContentHandler()</a></code>
   method would work equivalently, but for unknown MIME types instead
-  of unknown protocols.<h3 id=offline><span class=secno>5.7 </span>Offline Web applications</h3><h4 id=introduction-0><span class=secno>5.7.1 </span>Introduction</h4><p><em>This section is non-normative.</em><p class=XXX>...<h4 id=appcache><span class=secno>5.7.2 </span>Application caches</h4><p>An <dfn id=application-cache>application cache</dfn> is a collection of resources. An
+  of unknown protocols.<h4 id=client-abilities><span class=secno>5.6.3 </span>Client abilities</h4><p>The <dfn id=dom-navigator-canplaytype title=dom-navigator-canPlayType><code>canPlayType(<var title="">type</var>)</code></dfn> method must return 1 if <var title="">type</var> is a MIME type that the user agent is confident
+  represents a <a href=#media-resource>media resource</a> that it can render if used
+  in a <code><a href=#audio>audio</a></code> or <code><a href=#video>video</a></code> element, 0 if it
+  cannot determine whether it could do so, and &minus;1 if it is
+  confident that it would not be able to render resources of that
+  type.<h3 id=offline><span class=secno>5.7 </span>Offline Web applications</h3><h4 id=introduction-0><span class=secno>5.7.1 </span>Introduction</h4><p><em>This section is non-normative.</em><p class=XXX>...<h4 id=appcache><span class=secno>5.7.2 </span>Application caches</h4><p>An <dfn id=application-cache>application cache</dfn> is a collection of resources. An
   application cache is identified by the <a href=#absolute-url>absolute URL</a> of
   a resource manifest which is used to populate the cache.<p>Application caches are versioned, and there can be different
   instances of caches for the same manifest URL, each having a

Received on Wednesday, 15 October 2008 00:58:13 UTC