GLAPI/glDeleteFramebuffers: Difference between revisions

From OpenGL Wiki
Jump to navigation Jump to search
m Bot: Adding better formatting.
m Bot: Adding better formatting.
Line 17: Line 17:
== Description ==
== Description ==


'''glDeleteFramebuffers''' deletes the {{param|n}} framebuffer objects whose names are stored in the array addressed by {{param|framebuffers}}. The name zero is reserved by the GL and is silently ignored, should it occur in {{param|framebuffers}}, as are other unused names. Once a framebuffer object is deleted, its name is again unused and it has no attachments. If a framebuffer that is currently bound to one or more of the targets {{code|GL_DRAW_FRAMEBUFFER}} or {{code|GL_READ_FRAMEBUFFER}} is deleted, it is as though {{apifunc|glBindFramebuffer}} had been executed with the corresponding {{param|target}} and {{param|framebuffer}} zero.
'''glDeleteFramebuffers''' deletes the {{param|n}} framebuffer objects whose names are stored in the array addressed by {{param|framebuffers}}. The name zero is reserved by the GL and is silently ignored, should it occur in {{param|framebuffers}}, as are other unused names. Once a framebuffer object is deleted, its name is again unused and it has no attachments. If a framebuffer that is currently bound to one or more of the targets {{enum|GL_DRAW_FRAMEBUFFER}} or {{enum|GL_READ_FRAMEBUFFER}} is deleted, it is as though {{apifunc|glBindFramebuffer}} had been executed with the corresponding {{param|target}} and {{param|framebuffer}} zero.


== Errors ==
== Errors ==


{{code|GL_INVALID_VALUE}} is generated if {{param|n}} is negative.
{{enum|GL_INVALID_VALUE}} is generated if {{param|n}} is negative.


== See Also ==
== See Also ==

Revision as of 17:18, 29 April 2012

glDeleteFramebuffers
Core in version 4.6
Core since version 3.0

glDeleteFramebuffers: delete framebuffer objects

Function Definition

 void glDeleteFramebuffers(GLsizei n​, GLuint *framebuffers​);
n
Specifies the number of framebuffer objects to be deleted.
framebuffers
A pointer to an array containing n​ framebuffer objects to be deleted.

Description

glDeleteFramebuffers deletes the n​ framebuffer objects whose names are stored in the array addressed by framebuffers​. The name zero is reserved by the GL and is silently ignored, should it occur in framebuffers​, as are other unused names. Once a framebuffer object is deleted, its name is again unused and it has no attachments. If a framebuffer that is currently bound to one or more of the targets GL_DRAW_FRAMEBUFFER or GL_READ_FRAMEBUFFER is deleted, it is as though glBindFramebuffer had been executed with the corresponding target​ and framebuffer​ zero.

Errors

GL_INVALID_VALUE is generated if n​ is negative.

See Also

glGenFramebuffers, glBindFramebuffer, glCheckFramebufferStatus

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