GLAPI/glGenRenderbuffers

From OpenGL.org
Jump to: navigation, search
glGenRenderbuffers
Core in version 4.4
Core since version 3.0

glGenRenderbuffers: generate renderbuffer object names

Function Definition

 void glGenRenderbuffers(GLsizei n​, GLuint *renderbuffers​);
n
Specifies the number of renderbuffer object names to generate.
renderbuffers
Specifies an array in which the generated renderbuffer object names are stored.

Description

glGenRenderbuffers returns n​ renderbuffer object names in renderbuffers​. 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 glGenRenderbuffers.

Renderbuffer object names returned by a call to glGenRenderbuffers are not returned by subsequent calls, unless they are first deleted with glDeleteRenderbuffers.

The names returned in renderbuffers​ are marked as used, for the purposes of glGenRenderbuffers only, but they acquire state and type only when they are first bound.

Errors

GL_INVALID_VALUE​ is generated if n​ is negative.

See Also

glIsRenderbuffer, glBindRenderbuffer, glDeleteRenderbuffers

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