glGetVertexArrayIndexed.3G - Man Page

retrieve parameters of an attribute of a vertex array object

C Specification

void glGetVertexArrayIndexed64iv(GLuint vaobj, GLuint index, GLenum pname, GLint64 *param);

void glGetVertexArrayIndexediv(GLuint vaobj, GLuint index, GLenum pname, GLint *param);

Parameters

vaobj

Specifies the name of a vertex array object.

index

Specifies the index of the vertex array object attribute. Must be a number between 0 and (GL_MAX_VERTEX_ATTRIBS - 1).

pname

Specifies the property to be used for the query. For glGetVertexArrayIndexediv, it must be one of the following values: GL_VERTEX_ATTRIB_ARRAY_ENABLED, GL_VERTEX_ATTRIB_ARRAY_SIZE, GL_VERTEX_ATTRIB_ARRAY_STRIDE, GL_VERTEX_ATTRIB_ARRAY_TYPE, GL_VERTEX_ATTRIB_ARRAY_NORMALIZED, GL_VERTEX_ATTRIB_ARRAY_INTEGER, GL_VERTEX_ATTRIB_ARRAY_LONG, GL_VERTEX_ATTRIB_ARRAY_DIVISOR, or GL_VERTEX_ATTRIB_RELATIVE_OFFSET. For glGetVertexArrayIndexed64v, it must be equal to GL_VERTEX_BINDING_OFFSET.

param

Returns the requested value.

Description

glGetVertexArrayIndexediv and glGetVertexArrayIndexed64iv provide a way of querying parameters of an attribute at an user-specified index of a vertex array object. The vertex array object does not have to be bound to the rendering context at the time of the call, but must have been bound at least once prior to this call.

The following parameter values can be retrieved with glGetVertexArrayIndexediv for each of the attributes defined for a vertex array object:

glGetVertexArrayIndexed64iv can be used to retrieve GL_VERTEX_BINDING_OFFSET parameter value for any of the attributes defined for a vertex array object. When pname is set to GL_VERTEX_BINDING_OFFSET, param returns a single value that is the byte offset of the first element in the bound buffer's data store. The initial value for this parameter is 0.

Errors

GL_INVALID_OPERATION error is generated if vaobj is not the name of an existing vertex array object.

GL_INVALID_VALUE error is generated if index is greater than or equal to the value of GL_MAX_VERTEX_ATTRIBS.

GL_INVALID_ENUM error is generated if pname is not one of the valid values. For more details, please see above.

Version Support

OpenGL Version
Function / Feature Name2.02.13.03.13.23.34.04.14.24.34.44.5
glGetVertexArrayIndexed64iv-----------
glGetVertexArrayIndexediv-----------

See Also

glGetVertexAttrib(), glVertexAttribBinding(),

glVertexAttribIPointer,

glVertexAttribLPointer, glVertexAttribPointer()

Info

07/27/2020