WebGL2RenderingContext：drawArraysInstanced() 方法

基线 广泛可用

此功能已得到良好建立，并在许多设备和浏览器版本中运行。它自以下日期起在浏览器中可用： 2021 年 9 月.

WebGL2RenderingContext.drawArraysInstanced() 方法是 WebGL 2 API 的方法，它像 gl.drawArrays() 方法一样从数组数据中渲染图元。此外，它还可以执行元素范围的多个实例。

注意：使用 WebGL 1 时，ANGLE_instanced_arrays 扩展也可以提供此方法。

语法

js
drawArraysInstanced(mode, first, count, instanceCount)

参数

mode

一个 GLenum，指定要渲染的图元类型。可能的值为：

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

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

count

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

instanceCount

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

返回值

无（undefined）。

示例

js
gl.drawArraysInstanced(gl.POINTS, 0, 8, 4);

规范

规范
WebGL 2.0 规范
# 3.7.9

浏览器兼容性

BCD 表仅在启用 JavaScript 的浏览器中加载。

另请参阅