[html5] r6130 - [e] (0) Mention the case of getContext('webgl') returning null due to hardware l [...]

[whatwg at whatwg.org]

Author: ianh
Date: 2011-05-11 23:58:07 -0700 (Wed, 11 May 2011)
New Revision: 6130

Modified:
   complete.html
   index
   source
Log:
[e] (0) Mention the case of getContext('webgl') returning null due to hardware limitations.

Modified: complete.html
===================================================================
--- complete.html	2011-05-12 03:30:48 UTC (rev 6129)
+++ complete.html	2011-05-12 06:58:07 UTC (rev 6130)
@@ -33964,10 +33964,22 @@
   <ol><li><p>Let <var title="">contextId</var> be the first argument to
    the method.</li>
 
-   <li><p>If <var title="">contextId</var> is not the name of a
-   context supported by the user agent, return null and abort these
-   steps.</li>
+   <li>
 
+    <p>If <var title="">contextId</var> is not the name of a context
+    supported by the user agent, return null and abort these
+    steps.</p>
+
+    <p class=note>An example of this would be a user agent that
+    theoretically supports the "<code title=canvas-context-webgl>webgl</code>" 3D context, in the case
+    where the platform does not have hardware support for OpenGL and
+    the user agent does not have a software OpenGL implementation.
+    Despite the user agent recognising the "<code title=canvas-context-webgl>webgl</code>" name, it would return
+    null at this step because that context is not, in practice,
+    supported at the time of the call.</p>
+
+   </li>
+
    <li><p>If the element has a <a href=#primary-context>primary context</a> and that
    context's entry in the <a href=http://wiki.whatwg.org/wiki/CanvasContexts>WHATWG Wiki
    CanvasContexts page</a> does not list <var title="">contextId</var>

Modified: index
===================================================================
--- index	2011-05-12 03:30:48 UTC (rev 6129)
+++ index	2011-05-12 06:58:07 UTC (rev 6130)
@@ -33992,10 +33992,22 @@
   <ol><li><p>Let <var title="">contextId</var> be the first argument to
    the method.</li>
 
-   <li><p>If <var title="">contextId</var> is not the name of a
-   context supported by the user agent, return null and abort these
-   steps.</li>
+   <li>
 
+    <p>If <var title="">contextId</var> is not the name of a context
+    supported by the user agent, return null and abort these
+    steps.</p>
+
+    <p class=note>An example of this would be a user agent that
+    theoretically supports the "<code title=canvas-context-webgl>webgl</code>" 3D context, in the case
+    where the platform does not have hardware support for OpenGL and
+    the user agent does not have a software OpenGL implementation.
+    Despite the user agent recognising the "<code title=canvas-context-webgl>webgl</code>" name, it would return
+    null at this step because that context is not, in practice,
+    supported at the time of the call.</p>
+
+   </li>
+
    <li><p>If the element has a <a href=#primary-context>primary context</a> and that
    context's entry in the <a href=http://wiki.whatwg.org/wiki/CanvasContexts>WHATWG Wiki
    CanvasContexts page</a> does not list <var title="">contextId</var>

Modified: source
===================================================================
--- source	2011-05-12 03:30:48 UTC (rev 6129)
+++ source	2011-05-12 06:58:07 UTC (rev 6130)
@@ -37465,10 +37465,24 @@
    <li><p>Let <var title="">contextId</var> be the first argument to
    the method.</p></li>
 
-   <li><p>If <var title="">contextId</var> is not the name of a
-   context supported by the user agent, return null and abort these
-   steps.</p></li>
+   <li>
 
+    <p>If <var title="">contextId</var> is not the name of a context
+    supported by the user agent, return null and abort these
+    steps.</p>
+
+    <p class="note">An example of this would be a user agent that
+    theoretically supports the "<code
+    title="canvas-context-webgl">webgl</code>" 3D context, in the case
+    where the platform does not have hardware support for OpenGL and
+    the user agent does not have a software OpenGL implementation.
+    Despite the user agent recognising the "<code
+    title="canvas-context-webgl">webgl</code>" name, it would return
+    null at this step because that context is not, in practice,
+    supported at the time of the call.</p>
+
+   </li>
+
    <li><p>If the element has a <span>primary context</span> and that
    context's entry in the <a
    href="http://wiki.whatwg.org/wiki/CanvasContexts">WHATWG Wiki