WebGLRenderingContext.drawArrays()

 WebGL API 中的WebGLRenderingContext.drawArrays()方法用于从向量数组中绘制图元。

语法

void gl.drawArrays(mode, first, count);

参数

mode

GLenum 类型，指定绘制图元的方式，可能值如下。

• gl.POINTS: 绘制一系列点。
• gl.LINE_STRIP: 绘制一个线条。即，绘制一系列线段，上一点连接下一点。
• gl.LINE_LOOP: 绘制一个线圈。即，绘制一系列线段，上一点连接下一点，并且最后一点与第一个点相连。
• gl.LINES: 绘制一系列单独线段。每两个点作为端点，线段之间不连接。
• gl.TRIANGLE_STRIP：绘制一个三角带。
• gl.TRIANGLE_FAN：绘制一个三角扇。
• gl.TRIANGLES: 绘制一系列三角形。每三个点作为顶点。

first

GLint 类型 ，指定从哪个点开始绘制。

count

GLsizei 类型，指定绘制需要使用到多少个点。

返回值

无。

异常

• 如果 mode 不是一个可接受值，将会抛出 gl.INVALID_ENUM 异常。
• 如果 first 或者 count 是负值，会抛出 gl.INVALID_VALUE 异常。
• 如果 gl.CURRENT_PROGRAM 为 null，会抛出 gl.INVALID_OPERATION 异常。

示例

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

文档规范

浏览器兼容性

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

另见

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