Name

glGenBuffers — generate buffer object names

C Specification

void glGenBuffers(GLsizei n,
 GLuint * buffers);
 

Parameters

n

Specifies the number of buffer object names to be generated.

buffers

Specifies an array in which the generated buffer object names are stored.

Description

glGenBuffers returns n buffer object names in buffers. There is no guarantee that the names form a contiguous set of integers; however, it is guaranteed that none of the returned names was in use immediately before the call to glGenBuffers.

Buffer object names returned by a call to glGenBuffers are not returned by subsequent calls, unless they are first deleted with glDeleteBuffers.

No buffer objects are associated with the returned buffer object names until they are first bound by calling glBindBuffer.

Notes

glGenBuffers is available only if the GL version is 1.5 or greater.

Errors

GL_INVALID_VALUE is generated if n is negative.

GL_INVALID_OPERATION is generated if glGenBuffers is executed between the execution of glBegin and the corresponding execution of glEnd.

Associated Gets

glIsBuffer

See Also

glBindBuffer, glDeleteBuffers, glGet

Copyright

Copyright © 2005 Addison-Wesley. 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/.