WEBGL_multi_draw: multiDrawArraysWEBGL() 方法

WEBGL_multi_draw.multiDrawArraysWEBGL() 是 WebGL API 的方法，用于从数组数据渲染多个图元。它与对 gl.drawArrays() 方法的多次调用相同。

语法

js
multiDrawArraysWEBGL(mode,
    firstsList, firstsOffset,
    countsList, countsOffset,
    drawCount);

参数

mode

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

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

一个 Int32Array 或 Array（GLint），指定矢量点数组的起始索引列表。

firstsOffset

一个 GLuint，定义 firstsLists 数组的起始点。

countsList

一个 Int32Array 或 Array（GLsizei），指定要渲染的索引数量列表。

countsOffset

一个 GLuint，定义 countsList 数组的起始点。

drawCount

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

返回值

无。

异常

  • 如果 mode 不是接受的值之一，则会抛出 gl.INVALID_ENUM 错误。
  • 如果 drawCount 或 firstsList 和 countsList 中的项目为负，则会抛出 gl.INVALID_VALUE 错误。
  • 如果 gl.CURRENT_PROGRAM 为 null，则会抛出 gl.INVALID_OPERATION 错误。

示例

js
const firsts = new Int32Array(/* … */);
const counts = new Int32Array(/* … */);
ext.multiDrawArraysWEBGL(gl.TRIANGLES, firsts, 0, counts, 0, firsts.length);

规范

规范
WebGL WEBGL_multi_draw 扩展规范

浏览器兼容性

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

另请参阅