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
-
一个
Int32Array
或Array
(包含GLint
类型的值),用于指定要渲染的索引数量列表。 countsOffset
-
一个
GLUint
,定义了countsList
数组的起始点。 - type
-
一个
GLenum
,指定了元素数组缓冲区中值的类型。可能的值包括:gl.UNSIGNED_BYTE
gl.UNSIGNED_SHORT
- 使用
OES_element_index_uint
扩展时gl.UNSIGNED_INT
offsetsList
-
一个
Int32Array
或Array
(包含GLsizei
类型的值),用于指定向量点数组的起始索引列表。 offsetsOffset
-
一个
GLuint
,定义了offsetsList
数组的起始点。 drawCount
-
一个
GLsizei
,指定要执行的元素范围的实例数量。
返回值
无。
异常
- 如果
mode
不是接受的值之一,则会抛出gl.INVALID_ENUM
错误。 - 如果
drawCount
或countsList
或offsetsList
中的项目为负数,则会抛出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 扩展规范 |
浏览器兼容性
加载中…