GLAPI/glVertexAttribDivisor: Difference between revisions

From OpenGL Wiki
Jump to navigation Jump to search
m Bot: Adjusting API page category.
m Renaming category: 'GL 4 API Vertex Arrays' to 'Core API Ref Vertex Arrays'.
Line 39: Line 39:


[[Category:API Reference 4|VertexAttribDivisor]]
[[Category:API Reference 4|VertexAttribDivisor]]
[[Category:GL 4 API Vertex Arrays|VertexAttribDivisor]]
[[Category:Core API Ref Vertex Arrays|VertexAttribDivisor]]

Revision as of 07:19, 26 February 2012

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