ANGLE_instanced_arrays: drawArraysInstancedANGLE() 方法

Baseline 已广泛支持

此功能已成熟,可跨多种设备和浏览器版本正常运行。自 2016 年 6 月起,所有浏览器均已支持。

ANGLE_instanced_arrays.drawArraysInstancedANGLE() 方法是 WebGL API 的一部分,它像 gl.drawArrays() 方法一样,从数组数据渲染图元。此外,它还可以执行范围内元素的多个实例。

注意: 使用 WebGL2 时,此方法默认可用作 gl.drawArraysInstanced()

语法

js
drawArraysInstancedANGLE(mode, first, count, primcount)

参数

模式

一个 GLenum,指定要渲染的图元类型。可能的值有:

  • gl.POINTS:绘制一个点。
  • gl.LINE_STRIP:绘制一条连接到下一个顶点的直线。
  • gl.LINE_LOOP:绘制一条连接到下一个顶点的直线,并将最后一个顶点连接回第一个顶点。
  • gl.LINES:在两个顶点之间绘制一条线。
  • gl.TRIANGLE_STRIP
  • gl.TRIANGLE_FAN
  • gl.TRIANGLES:为一组三个顶点绘制一个三角形。
first

一个 GLint,指定向量点数组中的起始索引。

计数

一个 GLsizei,指定要渲染的索引数量。

primcount

一个 GLsizei,指定要执行的元素范围的实例数量。

返回值

无(undefined)。

异常

  • 如果 mode 不是接受的值之一,则会抛出 gl.INVALID_ENUM 错误。
  • 如果 firstcountprimcount 为负数,则会抛出 gl.INVALID_VALUE 错误。
  • 如果 gl.CURRENT_PROGRAMnull,则会抛出 gl.INVALID_OPERATION 错误。

示例

js
const ext = gl.getExtension("ANGLE_instanced_arrays");
ext.drawArraysInstancedANGLE(gl.POINTS, 0, 8, 4);

规范

规范
WebGL ANGLE_instanced_arrays Khronos 批准的扩展规范

浏览器兼容性

另见