WebGL2RenderingContext: drawArraysInstanced() method
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.
Note: This feature is available inWeb Workers.
TheWebGL2RenderingContext.drawArraysInstanced() methodof theWebGL 2 API renders primitives fromarray data like thegl.drawArrays()method. In addition, it can execute multiple instances of the range of elements.
Note:When usingWebGL 1,theANGLE_instanced_arrays extension can provide this method,too.
Syntax
drawArraysInstanced(mode, first, count, instanceCount)Parameters
modeA
GLenumspecifying the type primitive to render. Possible valuesare: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, andconnects the last vertex back to the first.gl.LINES: Draws a line between a pair of vertices.gl.TRIANGLE_STRIPgl.TRIANGLE_FANgl.TRIANGLES: Draws a triangle for a group of three vertices.
firstA
GLintspecifying the starting index in the array of vector points.countA
GLsizeispecifying the number of indices to be rendered.instanceCountA
GLsizeispecifying the number of instances of the range of elementsto execute.
Return value
None (undefined).
Examples
gl.drawArraysInstanced(gl.POINTS, 0, 8, 4);Specifications
| Specification |
|---|
| WebGL 2.0 Specification # 3.7.9 |