add first prototype of texElementImage2D

specs/latest/2.0/index.html

@@ -266,6 +266,15 @@ <h3>Types</h3>
     <pre class="idl">
 typedef long long GLint64;
 typedef unsigned long long GLuint64;
+
+dictionary WebGLCopyElementImageConfig {
+  GLfloat sx;
+  GLfloat sy;
+  GLfloat swidth;
+  GLfloat sheight;
+  GLsizei width;
+  GLsizei height;
+};
 </pre>
 
 <!-- ======================================================================================================= -->
@@ -935,6 +944,10 @@ <h3><a name="WEBGLRENDERINGCONTEXT">The WebGL context</a></h3>
                                     optional unsigned long long srcOffset = 0,
                                     optional GLuint srcLengthOverride = 0);
 
+  undefined texElementImage2D(GLenum target, GLint level, GLenum internalformat,
+                              (Element or ElementImage) element,
+                              optional WebGLCopyElementImageConfig config = {}); // May throw DOMException
+
   undefined uniform1fv(WebGLUniformLocation? location, Float32List data, optional unsigned long long srcOffset = 0,
                        optional GLuint srcLength = 0);
   undefined uniform2fv(WebGLUniformLocation? location, Float32List data, optional unsigned long long srcOffset = 0,
@@ -2210,6 +2223,34 @@ <h4>Texture objects</h4>
         <p><em>offset</em> is the byte offset into the WebGLBuffer's data store; generates an <code>INVALID_VALUE</code> error if it's less than 0.</p>
         <p>The ETC2 and EAC texture formats defined in OpenGL ES 3.0 are <a href="#NO_ETC2_EAC">not available in WebGL 2.0</a>.
       </dd>
+
+      <dt class="idl-code">
+        [throws] undefined texElementImage2D(GLenum target, GLint level, GLenum internalformat,
+                              (Element or ElementImage) element,
+                              optional WebGLCopyElementImageConfig config = {});
+      </dt>
+      <dd>
+        <p>The <code>level</code> argument identifies the mipmap level of the texture object bound to <code>target</code> to redefine.</p>
+        <p>The <code>element</code> argument identifies an <a href="https://whatpr.org/html/11588/canvas.html#concept-canvas-element-image-snapshots">element image snapshot</a>, as defined by HTML. The HTML algorithms define how element image snapshots are created, updated, retrieved, and filtered for security- or privacy-sensitive information. If <code>element</code> is an <code>Element</code>, the source rendering is the snapshot from the most recent <code>paint</code> event for the <a href="#context-canvas">canvas</a> of the current context. If <code>element</code> is an <code>ElementImage</code>, the source rendering is that captured snapshot.</p>
+        <p>If this function is called with an <code>Element</code> that is not a direct child of the <a href="#context-canvas">canvas</a> of the current context in the most recent rendering update, generates an <code>INVALID_OPERATION</code> error.</p>
+        <p>If <code>target</code> is not <code>TEXTURE_2D</code>, generates an <code>INVALID_ENUM</code> error.</p>
+        <p>If no <code>WebGLTexture</code> is bound to <code>target</code>, 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>All <code>UNPACK_</code> pixel store parameters are ignored by this function.</p>
+        <p>If <code>config.sx</code>, <code>config.sy</code>, <code>config.swidth</code>, and <code>config.sheight</code> are all supplied, they define the source rectangle of the element image snapshot to render, in CSS pixels. If none of them are supplied, the source rectangle has <code>sx</code> and <code>sy</code> of 0, <code>swidth</code> equal to the source's natural width, and <code>sheight</code> equal to the source's natural height. If only some of them are supplied, generates an <code>INVALID_VALUE</code> error.</p>
+        <p>If <code>config.width</code> and <code>config.height</code> are both supplied, they define the generated texture size, in texels. If neither member is supplied, the texture width and height default to the source rectangle size scaled by the inverse of the canvas-grid-to-CSS scaling factor used to produce the element image snapshot. If only one of them is supplied, generates an <code>INVALID_VALUE</code> error.</p>
+        <p>The <code>internalformat</code> argument must be one of the values in the following table. Each value has an implied source format of <code>RGBA</code> and the listed implied source type:</p>
+        <table>
+        <tr><th>Internal Format</th><th>Implied Source Type</th></tr>
+        <tr><td>RGBA8</td><td>UNSIGNED_BYTE</td></tr>
+        <tr><td>SRGB8_ALPHA8</td><td>UNSIGNED_BYTE</td></tr>
+        <tr><td>RGBA16F</td><td>HALF_FLOAT</td></tr>
+        <tr><td>RGBA32F</td><td>FLOAT</td></tr>
+        </table>
+        <p>The RGBA source values produced by rendering the element image snapshot are computed independently of <code>internalformat</code>. In particular, when <code>internalformat</code> is <code>RGBA8</code> or <code>SRGB8_ALPHA8</code>, the generated <code>UNSIGNED_BYTE</code> source values are identical; the choice between those formats only affects the texture's storage and subsequent sampling behavior.</p>
+        <p>If <code>internalformat</code> is not listed in the table above, generates an <code>INVALID_ENUM</code> error.</p>
+        <p>If any supplied numeric member of <code>config</code> is negative, or if the computed source rectangle width, source rectangle height, texture width, or texture height is not positive, generates an <code>INVALID_VALUE</code> error.</p>
+      </dd>
     </dl>
 
 <!-- ======================================================================================================= -->

specs/latest/2.0/webgl2.idl

@@ -27,6 +27,15 @@
 typedef long long GLint64;
 typedef unsigned long long GLuint64;
 
+dictionary WebGLCopyElementImageConfig {
+  GLfloat sx;
+  GLfloat sy;
+  GLfloat swidth;
+  GLfloat sheight;
+  GLsizei width;
+  GLsizei height;
+};
+
 
 [Exposed=(Window,Worker)]
 interface WebGLQuery : WebGLObject {
@@ -558,6 +567,10 @@ interface mixin WebGL2RenderingContextOverloads
                                     optional unsigned long long srcOffset = 0,
                                     optional GLuint srcLengthOverride = 0);
 
+  undefined texElementImage2D(GLenum target, GLint level, GLenum internalformat,
+                              (Element or ElementImage) element,
+                              optional WebGLCopyElementImageConfig config = {}); // May throw DOMException
+
   undefined uniform1fv(WebGLUniformLocation? location, Float32List data, optional unsigned long long srcOffset = 0,
                        optional GLuint srcLength = 0);
   undefined uniform2fv(WebGLUniformLocation? location, Float32List data, optional unsigned long long srcOffset = 0,
@@ -601,4 +614,3 @@ interface WebGL2RenderingContext
 WebGL2RenderingContext includes WebGLRenderingContextBase;
 WebGL2RenderingContext includes WebGL2RenderingContextBase;
 WebGL2RenderingContext includes WebGL2RenderingContextOverloads;
-