W3cubDocs

/Web APIs

WebGLRenderingContext: getVertexAttrib() method

The WebGLRenderingContext.getVertexAttrib() method of the WebGL API returns information about a vertex attribute at a given position.

Syntax

js

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 is true if the vertex attribute is enabled at this index. Otherwise false.

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 of

  • gl.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 given index.

gl.CURRENT_VERTEX_ATTRIB

Returns a Float32Array (with 4 elements) representing the current value of the vertex attribute at the given index.

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 given index.

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

js

gl.getVertexAttrib(0, gl.VERTEX_ATTRIB_ARRAY_BUFFER_BINDING);

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
getVertexAttrib 9 12 4 11 12 5.1 4.4.3 25 4 12 8 1.5

See also

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/getVertexAttrib