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);

文档规范

Specification Status Comment
WebGL 1.0
drawArrays
Recommendation Initial definition.
OpenGL ES 2.0
glDrawArrays
Standard Man page of the OpenGL API.

浏览器兼容性

BCD tables only load in the browser

另见