glVertexAttribDivisor - OpenGL ES 3.1 Reference Pages

## Name

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

## C Specification

`void glVertexAttribDivisor(` | GLuint index,
| GLuint divisor`)`;

## Parameters

`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 (see glDrawArraysInstanced and glDrawElementsInstanced). 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`.

## Errors

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

## API Version Support

| OpenGL ES API Version
--- | ---
Function Name | 2.0 | 3.0 | 3.1
glVertexAttribDivisor | - | ✔ | ✔

## See Also

glDrawArraysInstanced, glDrawElementsInstanced, glVertexAttribPointer, glEnableVertexAttribArray, glDisableVertexAttribArray

## Copyright

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