GLAPI/glGenFramebuffers

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

glGenFramebuffers: generate framebuffer object names

Function Definition

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

Description

glGenFramebuffers returns n​ framebuffer object names in ids​. 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 glGenFramebuffers.

Framebuffer object names returned by a call to glGenFramebuffers are not returned by subsequent calls, unless they are first deleted with glDeleteFramebuffers.

The names returned in ids​ are marked as used, for the purposes of glGenFramebuffers 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

glBindFramebuffer, glIsFramebuffer, glDeleteFramebuffers

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