WEBGL_multi_draw: multiDrawElementsWEBGL() 方法

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

WEBGL_multi_draw.multiDrawElementsWEBGL() 方法是 WebGL API 的一部分,用于从数组数据中渲染多个图元。它等同于多次调用 gl.drawElements() 方法。

语法

js
multiDrawElementsWEBGL(mode,
    countsList, countsOffset,
    type,
    firstsList, firstsOffset,
    drawCount)

参数

模式

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

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

一个 Int32ArrayArray (包含 GLint 类型的值),用于指定要渲染的索引数量列表。

countsOffset

一个 GLUint,定义了 countsList 数组的起始点。

type

一个 GLenum,指定了元素数组缓冲区中值的类型。可能的值包括:

offsetsList

一个 Int32ArrayArray (包含 GLsizei 类型的值),用于指定向量点数组的起始索引列表。

offsetsOffset

一个 GLuint,定义了 offsetsList 数组的起始点。

drawCount

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

返回值

无。

异常

  • 如果 mode 不是接受的值之一,则会抛出 gl.INVALID_ENUM 错误。
  • 如果 drawCountcountsListoffsetsList 中的项目为负数,则会抛出 gl.INVALID_VALUE 错误。

示例

js
const counts = new Int32Array(/* … */);
const offsets = new Int32Array(/* … */);
ext.multiDrawElementsWEBGL(
  gl.TRIANGLES,
  counts,
  0,
  gl.UNSIGNED_SHORT,
  offsets,
  0,
  counts.length,
);

规范

规范
WebGL WEBGL_multi_draw 扩展规范

浏览器兼容性

另见