大网数据广告活动
Web 标准与前端开发

WebGLRenderingContext.enableVertexAttribArray()

· 52CE 我爱测

在 WebGL API 中,使用 WebGLRenderingContext 中的 **`enableVertexAttribArray()`** 方法,可以打开属性数组列表中指定索引处的通用顶点属性数组。

WebGL

在 WebGL API 中,使用 WebGLRenderingContext 中的 enableVertexAttribArray() 方法,可以打开属性数组列表中指定索引处的通用顶点属性数组。

[!NOTE] 你可以通过以下方法关闭顶点属性数组 WebGLRenderingContext.disableVertexAttribArray.

在 WebGL 中,作用于顶点的数据会先储存在attributes。这些数据仅对 JavaScript 代码和顶点着色器可用。属性由索引号引用到 GPU 维护的属性列表中。在不同的平台或 GPU 上,某些顶点属性索引可能具有预定义的值。创建属性时,WebGL 层会分配其他属性。

无论怎样,都需要你使用 enableVertexAttribArray() 方法,来激活每一个属性以便使用,不被激活的属性是不会被使用的。一旦激活,以下其他方法就可以获取到属性的值了,包括WebGLRenderingContext.vertexAttribPointer、WebGLRenderingContext.vertexAttrib 和 WebGLRenderingContext.getVertexAttrib。

语法

enableVertexAttribArray(index)

参数

  • index
    • : 类型为GLuint 的索引,指向要激活的顶点属性。如果你只知道属性的名称,不知道索引,你可以使用以下方法来获取索引WebGLRenderingContext.getAttribLocation.

返回值

无(undefined)。

错误

你可以使用WebGLRenderingContext.getError方法,来检查使用enableVertexAttribArray()时发生的错误。

  • WebGLRenderingContext.INVALID_VALUE
    • : 非法的 index 。一般是 index 大于或等于了顶点属性列表允许的最大值。该值可以通过 WebGLRenderingContext.MAX_VERTEX_ATTRIBS获取。

例子

该例子是 A basic 2D WebGL animation example 中的一部分,用以说明 enableVertexArray() 是如何激活顶点属性,并将顶点数据传输到 shader 函数的。

gl.bindBuffer(gl.ARRAY_BUFFER, vertexBuffer);

aVertexPosition = gl.getAttribLocation(shaderProgram, "aVertexPosition");

gl.enableVertexAttribArray(aVertexPosition);
gl.vertexAttribPointer(
  aVertexPosition,
  vertexNumComponents,
  gl.FLOAT,
  false,
  0,
  0,
);

gl.drawArrays(gl.TRIANGLES, 0, vertexCount);

该段代码来自于 "A basic 2D WebGL animation example." 中的 the function animateScene() 。通过连接来查看全文,你可以查看产生的动画效果。

以上代码中,使用了WebGLRenderingContext.bindBuffer来设置将用于绘图的顶点数据的缓存。然后使用WebGLRenderingContext.getAttribLocation来获取顶点数据在 shader 函数中的索引。

我们用 enableVertexAttribArray() 函数来激活 aVertexPosition中记录的索引位置,以便在后面对该顶点属性进行数据绑定。

使用WebGLRenderingContext.vertexAttribPointer 将缓存数据绑定到 shader 函数中的顶点属性。于是,我们可以通过WebGLRenderingContext.drawArrays函数将顶点一一绘制。

Specifications

Browser compatibility

See also

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。