Provided by: opengl-4-man-doc_1.0~svn33624-1_all bug

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                                         │
       ├────────────────────────────┼─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┤
       │Function2.02.13.03.13.23.34.04.14.24.34.44.5 │
       │/                           │     │     │     │     │     │     │     │     │     │     │     │     │
       │Feature                     │     │     │     │     │     │     │     │     │     │     │     │     │
       │Name                        │     │     │     │     │     │     │     │     │     │     │     │     │
       ├────────────────────────────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
       │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.
       http://opencontent.org/openpub/.

COPYRIGHT

       Copyright © 2014 Khronos Group

[FIXME: source]                             01/03/2018                   GLGETVERTEXARRAYINDE(3G)