GLGETVERTEXARRAYINDE
Section: [FIXME: manual] (3G)
Updated: 01/26/2021
Page Index
NAME
glGetVertexArrayIndexed - 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:
-
•
GL_VERTEX_ATTRIB_ARRAY_ENABLED:
param
returns a value that is non-zero (true) if the vertex attribute array for index is enabled and 0 (false) if it is disabled. The initial value is
GL_FALSE.
-
•
GL_VERTEX_ATTRIB_ARRAY_SIZE:
param
returns a single value, the size of the vertex attribute array for index. The size is the number of values for each element of the vertex attribute array, and it will be 1, 2, 3 or 4. The initial value is 4.
-
•
GL_VERTEX_ATTRIB_ARRAY_STRIDE:
param
returns a single value, the array stride for (number of bytes between successive elements in) the vertex attribute array for index. A value of 0 indicates the array elements are stored sequentially in memory. The initial value is 0.
-
•
GL_VERTEX_ATTRIB_ARRAY_TYPE:
param
returns a single value, a symbolic constant indicating the array type for the vertex attribute array for index. Possible values are
GL_BYTE,
GL_DOUBLE,
GL_FIXED,
GL_FLOAT,
GL_HALF_FLOAT,
GL_INT,
GL_INT_2_10_10_10_REV,
GL_SHORT,
GL_UNSIGNED_BYTE,
GL_UNSIGNED_SHORT,
GL_UNSIGNED_INT,
GL_UNSIGNED_INT_2_10_10_10_REV, and
GL_UNSIGNED_INT_10F_11F_11F_REV
. The initial value is
GL_FLOAT.
-
•
GL_VERTEX_ATTRIB_ARRAY_NORMALIZED:
param
returns a single value that is non-zero (true) if fixed-point data types for the vertex attribute array indicated by index are normalized when they are converted to floating-point, and 0 (false) otherwise. The initial value is
GL_FALSE.
-
•
GL_VERTEX_ATTRIB_ARRAY_INTEGER:
param
returns a single value that is non-zero (true) if fixed-point data types for the vertex attribute array indicated by index have integer data type, and 0 (false) otherwise. The initial value is 0 (GL_FALSE).
-
•
GL_VERTEX_ATTRIB_ARRAY_LONG:
param
returns a single value that is non-zero (true) if a vertex attribute is stored as an unconverted double, and 0 (false) otherwise. The initial value is 0 (GL_FALSE).
-
•
GL_VERTEX_ATTRIB_ARRAY_DIVISOR:
param
returns a single value that is the frequency divisor used for instanced rendering. See glVertexAttribDivisor. The initial value is 0.
-
•
GL_VERTEX_ATTRIB_RELATIVE_OFFSET:
param
returns a single value that is the byte offset of the first element relative to the start of the vertex buffer binding specified attribute fetches from. The initial value is 0.
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 Name
|
2.0
|
2.1
|
3.0
|
3.1
|
3.2
|
3.3
|
4.0
|
4.1
|
4.2
|
4.3
|
4.4
|
4.5
|
|
glGetVertexArrayIndexed64iv
|
-
|
-
|
-
|
-
|
-
|
-
|
-
|
-
|
-
|
-
|
-
|
✔
|
|
glGetVertexArrayIndexediv
|
-
|
-
|
-
|
-
|
-
|
-
|
-
|
-
|
-
|
-
|
-
|
✔
|
SEE ALSO
glGetVertexAttrib(),
glVertexAttribBinding(),
glVertexAttribIPointer,
glVertexAttribLPointer,
glVertexAttribPointer()
COPYRIGHT
Copyright
©
2014 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication License, v 1.0, 8 June 1999.
m[blue]http://opencontent.org/openpub/m[].
COPYRIGHT
Copyright © 2014 Khronos Group