GLAPI/glVertexAttribDivisor: Difference between revisions
m Bot: Adding better formatting. |
m Bot: Adding better formatting. |
||
| Line 18: | Line 18: | ||
== Description == | == Description == | ||
'''glVertexAttribDivisor''' modifies the rate at which generic vertex attributes advance when rendering multiple instances of primitives in a single draw call. If {{param|divisor}} is zero, the attribute at slot {{param|index}} advances once per vertex. If {{param|divisor}} is non-zero, the attribute advances once per {{param|divisor}} instances of the set(s) of vertices being rendered. An attribute is referred to as instanced if its {{ | '''glVertexAttribDivisor''' modifies the rate at which generic vertex attributes advance when rendering multiple instances of primitives in a single draw call. If {{param|divisor}} is zero, the attribute at slot {{param|index}} advances once per vertex. If {{param|divisor}} is non-zero, the attribute advances once per {{param|divisor}} instances of the set(s) of vertices being rendered. An attribute is referred to as instanced if its {{enum|GL_VERTEX_ATTRIB_ARRAY_DIVISOR}} value is non-zero. | ||
{{param|index}} must be less than the value of {{ | {{param|index}} must be less than the value of {{enum|GL_MAX_VERTEX_ATTRIBUTES}}. | ||
== Notes == | == Notes == | ||
| Line 28: | Line 28: | ||
== Errors == | == Errors == | ||
{{ | {{enum|GL_INVALID_VALUE}} is generated if {{param|index}} is greater than or equal to the value of {{enum|GL_MAX_VERTEX_ATTRIBUTES}}. | ||
== See Also == | == See Also == | ||
Revision as of 17:30, 29 April 2012
| 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/.