GLAPI/glVertexAttribDivisor

From OpenGL Wiki
< GLAPI
Revision as of 02:14, 31 December 2011 by Alfonse (talk | contribs) (4.0 API.)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
glVertexAttribDivisor
Core in version 4.6
Core since version 3.3
ARB extension ARB_instanced_arrays

glVertexAttribDivisor: modify the rate at which generic vertex attributes advance during instanced rendering

Function Definition

 void glVertexAttribDivisor(GLuint index, GLuint divisor);
index
Specify the index of the generic vertex attribute.
divisor
Specify the number of instances that will pass between updates of the generic attribute at slot index.

Description

glVertexAttribDivisor modifies the rate at which generic vertex attributes advance when rendering multiple instances of primitives in a single draw call. If divisor is zero, the attribute at slot index advances once per vertex. If divisor is non-zero, the attribute advances once per divisor instances of the set(s) of vertices being rendered. An attribute is referred to as instanced if its GL_VERTEX_ATTRIB_ARRAY_DIVISOR value is non-zero.

index must be less than the value of GL_MAX_VERTEX_ATTRIBUTES.

Notes

glVertexAttribDivisor is available only if the GL version is 3.3 or higher.

Errors

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

See Also

glVertexAttribPointer, glEnableVertexAttribArray, glDisableVertexAttribArray

Copyright

Copyright © 2010 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/.