GLAPI/glVertexBindingDivisor

From OpenGL.org
Jump to: navigation, search
glVertexBindingDivisor
Core in version 4.4
Core since version 4.3
Core ARB extension ARB_vertex_attrib_binding

glVertexBindingDivisor: modify the rate at which generic vertex attributes advance

Function Definition

 void glVertexBindingDivisor(GLuint bindingindex​, GLuint divisor​);
bindingindex
The index of the binding whose divisor to modify.
divisor
The new value for the instance step rate to apply.

Description

glVertexBindingDivisor, modifies the rate at which generic vertex attributes advance when rendering multiple instances of primitives in a single draw command. If divisor​ is zero, the attributes using the buffer bound to bindingindex​ advance once per vertex. If divisor​ is non-zero, the attributes advance once per divisor​ instances of the set(s) of vertices being rendered. An attribute is referred to as instanced if the corresponding divisor​ value is non-zero.

Errors

GL_INVAILD_VALUE​ is generated if bindingindex​ is greater than or equal to the value of GL_MAX_VERTEX_ATTRIB_BINDINGS​.

GL_INVALID_OPERATION​ is generated if no vertex array object is bound.

Associated Gets

glGet with arguments GL_MAX_VERTEX_ATTRIB_BINDINGS​, GL_VERTEX_BINDING_DIVISOR​.

See Also

glBindVertexArray, glBindVertexBuffer, glVertexBindingDivisor, glVertexAttribPointer

Copyright

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