WebGLRenderingContext.drawArrays()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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_PROGRAMnull,会抛出 gl.INVALID_OPERATION 异常。

示例

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

规范

Specification
WebGL Specification
# 5.14.11

浏览器兼容性

BCD tables only load in the browser

参见