WebGLRenderingContext.enableVertexAttribArray()

在此页

句法
范例
规范
浏览器兼容性
另请参阅
相关话题

WebGLRenderingContext 方法 enableVertexAttribArray() , part of the WebGL API , turns on the generic vertex attribute array at the specified index into the list of attribute arrays.

You can disable the attribute array by calling disableVertexAttribArray() .

In WebGL, values that apply to a specific vertex are stored in attributes . These are only available to the JavaScript code and the vertex shader. Attributes are referenced by an index number into the list of attributes maintained by the GPU. Some vertex attribute indices may have predefined purposes, depending on the platform and/or the GPU. Others are assigned by the WebGL layer when you create the attributes.

Either way, since attributes cannot be used unless enabled, and are disabled by default, you need to call enableVertexAttribArray() to enable individual attributes so that they can be used. Once that's been done, other methods can be used to access the attribute, including vertexAttribPointer() , vertexAttrib*() ，和 getVertexAttrib() .

句法

void gl.enableVertexAttribArray(index);

参数

index: GLuint specifying the index number that uniquely identifies the vertex attribute to enable. If you know the name of the attribute but not its index, you can get the index by calling getAttribLocation() .

返回值

undefined .

错误

To check for errors after calling enableVertexAttribArray() ，调用 getError() .

WebGLRenderingContext.INVALID_VALUE: 指定 index is invalid; that is, it's greater than or equal to the maximum number of entries permitted in the context's vertex attribute list, as indicated by the value of WebGLRenderingContext.MAX_VERTEX_ATTRIBS .

范例

This code — a snippet taken from the full example A basic 2D WebGL animation example — shows the use of enableVertexArray() to activate the attribute that will be used by the WebGL layer to pass individual vertexes from the vertex buffer into the vertex shader function.

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

This code snippet is taken from the function


								animateScene()

in "A basic 2D WebGL animation example." See that article for the full sample and to see the resulting animation in action.

This code sets the buffer of vertexes that will be used to draw the triangles of the shape by calling bindBuffer() . Then the vertex position attribute's index is obtained from the shader program by calling getAttribLocation() .

With the index of the vertex position attribute now available in aVertexPosition , we call enableVertexAttribArray() to enable the position attribute so it can be used by the shader program (in particular, by the vertex shader).

Then the vertex buffer is bound to the aVertexPosition attribute by calling vertexAttribPointer() . This step is not obvious, since this binding is almost a side effect. But as a result, accessing aVertexPosition now obtains data from the vertex buffer.

With the association in place between the vertex buffer for our shape and the aVertexPosition attribute used to deliver vertexes one by one into the vertex shader, we're ready to draw the shape by calling drawArrays() .

规范

规范	状态	注释
WebGL 1.0 The definition of 'enableVertexAttribArray' in that specification.	推荐	初始定义。
OpenGL ES 2.0 The definition of 'glEnableVertexAttribArray' in that specification.	标准	Man page of the OpenGL API.

浏览器兼容性

更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`enableVertexAttribArray`	Chrome 9	Edge 12	Firefox 4	IE 11	Opera 12	Safari 5.1	WebView Android Yes	Chrome Android 25	Firefox Android Yes	Opera Android 12	Safari iOS 8	Samsung Internet Android 1.5

在此页

句法

参数

返回值

错误

范例

规范

浏览器兼容性

图例

另请参阅

元数据

相关话题