WebGLRenderingContext: drawArrays() 方法

语法

drawArrays(mode, first, count)

参数

模式

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

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

注意： 如果 mode 是 POINTS，可能需要设置 gl_PointSize 才能使 drawArrays 进行渲染，因为如果未显式写入，其值是未知的。只有部分 GPU 会将其默认值设置为 1.0。

first

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

计数

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

返回值

无（undefined）。

异常

• 如果 mode 不是接受的值之一，则会抛出 gl.INVALID_ENUM 错误。
• 如果 first 或 count 为负数，则会抛出 gl.INVALID_VALUE 错误。
• 如果 gl.CURRENT_PROGRAM 为 null，则会抛出 gl.INVALID_OPERATION 错误。

示例

gl.drawArrays(gl.POINTS, 0, 8);

规范

浏览器兼容性

另见

• WebGLRenderingContext.drawElements()
• ext.drawArraysInstancedANGLE()
• ext.drawElementsInstancedANGLE()
• ext.vertexAttribDivisorANGLE()
• WebGL2RenderingContext.drawArraysInstanced()
• WebGL2RenderingContext.drawElementsInstanced()
• WebGL2RenderingContext.vertexAttribDivisor()
• WEBGL_multi_draw.multiDrawArraysWEBGL()