ANGLE_instanced_arrays: drawElementsInstancedANGLE() method
The ANGLE_instanced_arrays.drawElementsInstancedANGLE()
method of the WebGL API renders primitives from array data like the gl.drawElements()
method. In addition, it can execute multiple instances of a set of elements.
Syntax
drawElementsInstancedANGLE(mode, count, type, offset, primcount)
Parameters
-
mode
-
A GLenum
specifying the type primitive to render. Possible values are:
gl.POINTS
: Draws a single dot.
gl.LINE_STRIP
: Draws a straight line to the next vertex.
gl.LINE_LOOP
: Draws a straight line to the next vertex, and connects the last vertex back to the first.
gl.LINES
: Draws a line between a pair of vertices.
gl.TRIANGLE_STRIP
gl.TRIANGLE_FAN
gl.TRIANGLES
: Draws a triangle for a group of three vertices.
-
count
-
A GLsizei
specifying the number of elements to be rendered.
-
type
-
A GLenum
specifying the type of the values in the element array buffer. Possible values are:
-
offset
-
A GLintptr
specifying an offset in the element array buffer. Must be a valid multiple of the size of the given type
.
-
primcount
-
A GLsizei
specifying the number of instances of the set of elements to execute.
Return value
Exceptions
- If
mode
is not one of the accepted values, a gl.INVALID_ENUM
error is thrown.
- If
offset
is an invalid multiple of the size of the given type, a gl.INVALID_OPERATION
error is thrown.
- If
count
or primcount
are negative, a gl.INVALID_VALUE
error is thrown.
Examples
const ext = gl.getExtension("ANGLE_instanced_arrays");
ext.drawElementsInstancedANGLE(gl.POINTS, 2, gl.UNSIGNED_SHORT, 0, 4);
Specifications
Browser compatibility
|
Desktop |
Mobile |
|
Chrome |
Edge |
Firefox |
Internet Explorer |
Opera |
Safari |
WebView Android |
Chrome Android |
Firefox for Android |
Opera Android |
Safari on IOS |
Samsung Internet |
drawElementsInstancedANGLE |
30 |
12 |
47 |
11 |
17 |
8 |
4.4 |
30 |
47 |
18 |
8 |
2.0 |
See also