MDN self-hosted library · e01.org

WebGLRenderingContext: getVertexAttrib() method

WebGL

WebGL

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

gl.getVertexAttrib(0, gl.VERTEX_ATTRIB_ARRAY_BUFFER_BINDING);

Specifications

Browser compatibility

See also

  • WebGLRenderingContext.getVertexAttribOffset()
  • ANGLE_instanced_arrays