glMultiDrawElementsBaseVertex - OpenGL 4 Reference Pages

## Name

glMultiDrawElementsBaseVertex — render multiple sets of primitives by specifying indices of array data elements and an index to apply to each index

## C Specification

`void glMultiDrawElementsBaseVertex(` | GLenum mode,
| const GLsizei *count,
| GLenum type,
| const GLvoid * const *indices,
| GLsizei drawcount,
| const GLint *basevertex`)`;

## Parameters

`mode`

  Specifies what kind of primitives to render. Symbolic constants `GL_POINTS`, `GL_LINE_STRIP`, `GL_LINE_LOOP`, `GL_LINES`, `GL_LINE_STRIP_ADJACENCY`, `GL_LINES_ADJACENCY`, `GL_TRIANGLE_STRIP`, `GL_TRIANGLE_FAN`, `GL_TRIANGLES`, `GL_TRIANGLE_STRIP_ADJACENCY`, `GL_TRIANGLES_ADJACENCY` and `GL_PATCHES` are accepted.

`count`

  Points to an array of the elements counts.

`type`

  Specifies the type of the values in `indices`. Must be one of `GL_UNSIGNED_BYTE`, `GL_UNSIGNED_SHORT`, or `GL_UNSIGNED_INT`.

`indices`

  Specifies a pointer to the location where the indices are stored.

`drawcount`

  Specifies the size of the `count`, `indices` and `basevertex` arrays.

`basevertex`

  Specifies a pointer to the location where the base vertices are stored.

## Description

`glMultiDrawElementsBaseVertex` behaves identically to glDrawElementsBaseVertex, except that `drawcount` separate lists of elements are specifried instead.

It has the same effect as:

        for (int i = 0; i < drawcount; i++)
            if (count[i] > 0)
                glDrawElementsBaseVertex(mode,
                                         count[i],
                                         type,
                                         indices[i],
                                         basevertex[i]);

## Notes

`glMultiDrawElementsBaseVertex` is available only if the GL version is 3.1 or greater.

`GL_LINE_STRIP_ADJACENCY`, `GL_LINES_ADJACENCY`, `GL_TRIANGLE_STRIP_ADJACENCY` and `GL_TRIANGLES_ADJACENCY` are available only if the GL version is 3.2 or greater.

## Errors

`GL_INVALID_ENUM` is generated if `mode` is not an accepted value.

`GL_INVALID_VALUE` is generated if `drawcount` is negative.

`GL_INVALID_OPERATION` is generated if a non-zero buffer object name is bound to an enabled array or the element array and the buffer object's data store is currently mapped.

## Version Support

| OpenGL Version
--- | ---
Function / Feature Name | 2.0 | 2.1 | 3.0 | 3.1 | 3.2 | 3.3 | 4.0 | 4.1 | 4.2 | 4.3 | 4.4 | 4.5
`glMultiDrawElementsBaseVertex` | - | - | - | - | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔

## See Also

glMultiDrawElements, glDrawElementsBaseVertex, glDrawArrays, glVertexAttribPointer

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