add addition texElementImage2D + constraints + address review comments

Author: cabanier

specs/latest/2.0/index.html

@@ -2217,10 +2217,10 @@ <h4>Texture objects</h4>
       </dt>
       <dd>
         <p>Renders the given element to the currently bound WebGLTexture.</p>
-        <p>The width and height of the texture are derived from the CSS width and height of the element at the time of rendering. Add links to whatwg.</p>
+        <p>The width and height of the texture are derived from the CSS borderbox of the element at the time of rendering. Add links to whatwg.</p>
         <p>TBD: define state of rendering + security. These will be more links to whatwg</p><p></p>
-        <p>If no WebGLBuffer is bound to the <code>PIXEL_PACK_BUFFER</code> target, generates an
-             <code>INVALID_OPERATION</code> error.</p>
+        <p>If this function is called with an <code>HTMLElement</code> that is not a direct descendant of the <a href="#context-canvas">canvas</a> of the current context, generates an <code>INVALID_OPERATION</code> error.</p>
+        <p>If a WebGLBuffer is bound to the <code>PIXEL_UNPACK_BUFFER</code> target, generates an <code>INVALID_OPERATION</code> error.</p>
         <p>The combination of <em>internalformat</em>, <em>format</em>, and <em>type</em> must be listed in the following table:</p>
         <table id="TEXTURE_TYPES_FORMATS_FROM_DOM_ELEMENTS_TABLE_2">
         <tr><th>Internal Format</th><th>Format</th><th>Type</th></tr>
@@ -2231,6 +2231,27 @@ <h4>Texture objects</h4>
         <tr><td>RGBA16F</td><td>RGBA</td><td>HALF_FLOAT<br>FLOAT</td></tr>
         <tr><td>RGBA32F</td><td>RGBA</td><td>FLOAT</td></tr>
         </table>
+        <p>
+          If <a href="#PIXEL_STORE_PARAM_CONSTRAINTS">pixel store parameter constraints</a> are not met,
+          generates an <code>INVALID_OPERATION</code> error.
+        </p>
+      </dd>
+
+      <dt class="idl-code">
+        [throws] undefined texElementImage2D(GLenum target, GLint level, GLint internalformat, GLsizei width, GLsizei height,
+                              GLenum format, GLenum type, Element element);
+      </dt>
+      <dd>
+        <p>Renders the given element to the currently bound WebGLTexture.</p>
+        <p>The texture is resized to <code>width</code> and <code>height</code>>. Add links to whatwg.</p>
+        <p>TBD: define state of rendering + security. These will be more links to whatwg</p><p></p>
+        <p>If this function is called with an <code>HTMLElement</code> that is not a direct descendant of the <a href="#context-canvas">canvas</a> of the current context, generates an <code>INVALID_OPERATION</code> error.</p>
+        <p>If a WebGLBuffer is bound to the <code>PIXEL_UNPACK_BUFFER</code> target, generates an <code>INVALID_OPERATION</code> error.</p>
+        <p>See <a href="../1.0/index.html#TEXTURE_TYPES_FORMATS_FROM_DOM_ELEMENTS_TABLE_2">texElementImage2D</a> for the interpretation of the <em>internalformat</em>, <em>format</em> and <em>type</em> arguments, and notes on the <code>UNPACK_PREMULTIPLY_ALPHA_WEBGL</code> pixel storage parameter. </p>
+        <p>
+          If <a href="#PIXEL_STORE_PARAM_CONSTRAINTS">pixel store parameter constraints</a> are not met,
+          generates an <code>INVALID_OPERATION</code> error.
+        </p>
       </dd>
     </dl>
 

specs/latest/2.0/webgl2.idl

@@ -560,6 +560,8 @@ interface mixin WebGL2RenderingContextOverloads
 
   undefined texElementImage2D(GLenum target, GLint level, GLint internalformat, GLenum format, GLenum type,
                               Element element);
+  undefined texElementImage2D(GLenum target, GLint level, GLint internalformat, GLsizei width, GLsizei height,
+                             GLenum format, GLenum type, Element element);
 
   undefined uniform1fv(WebGLUniformLocation? location, Float32List data, optional unsigned long long srcOffset = 0,
                        optional GLuint srcLength = 0);