WebGLRenderingContext: getVertexAttrib() method
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.
The WebGLRenderingContext.getVertexAttrib()
method of the
WebGL API returns information about a vertex
attribute at a given position.
Syntax
getVertexAttrib(index, pname)
Parameters
index
-
A
GLuint
specifying the index of the vertex attribute. pname
-
A
GLenum
specifying the information to query. Possible values:gl.VERTEX_ATTRIB_ARRAY_BUFFER_BINDING
-
Returns the currently bound
WebGLBuffer
. gl.VERTEX_ATTRIB_ARRAY_ENABLED
-
Returns a
GLboolean
that istrue
if the vertex attribute is enabled at thisindex
. Otherwisefalse
. gl.VERTEX_ATTRIB_ARRAY_SIZE
-
Returns a
GLint
indicating the size of an element of the vertex array. gl.VERTEX_ATTRIB_ARRAY_STRIDE
-
Returns a
GLint
indicating the number of bytes between successive elements in the array. 0 means that the elements are sequential. gl.VERTEX_ATTRIB_ARRAY_TYPE
-
Returns a
GLenum
representing the array type. One ofgl.BYTE
gl.UNSIGNED_BYTE
gl.SHORT
,gl.UNSIGNED_SHORT
gl.FLOAT
gl.VERTEX_ATTRIB_ARRAY_NORMALIZED
-
Returns a
GLboolean
that is true if fixed-point data types are normalized for the vertex attribute array at the givenindex
. gl.CURRENT_VERTEX_ATTRIB
-
Returns a
Float32Array
(with 4 elements) representing the current value of the vertex attribute at the givenindex
.
When using a WebGL 2 context, the following values are available additionally:
gl.VERTEX_ATTRIB_ARRAY_INTEGER
-
Returns a
GLboolean
indicating whether an integer data type is in the vertex attribute array at the givenindex
. gl.VERTEX_ATTRIB_ARRAY_DIVISOR
-
Returns a
GLint
describing the frequency divisor used for instanced rendering.
When using the
ANGLE_instanced_arrays
extension:ext.VERTEX_ATTRIB_ARRAY_DIVISOR_ANGLE
-
Returns a
GLint
describing the frequency divisor used for instanced rendering.
Return value
Returns the requested vertex attribute information (as specified with
pname
).
Examples
gl.getVertexAttrib(0, gl.VERTEX_ATTRIB_ARRAY_BUFFER_BINDING);
Specifications
Specification |
---|
WebGL Specification # 5.14.10 |
WebGL 2.0 Specification # 3.7.8 |
Browser compatibility
BCD tables only load in the browser