WebGLRenderingContext.drawArrays()

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

语法

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

参数

mode

GLenum (en-US) 类型,指定绘制图元的方式,可能值如下。

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

GLint (en-US) 类型,指定从哪个点开始绘制。

count

GLsizei (en-US) 类型,指定绘制需要使用到多少个点。

返回值

无。

异常

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

示例

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

规范

Specification
WebGL Specification
# 5.14.11

浏览器兼容性

BCD tables only load in the browser

参见