GLAPI/glBindFramebuffer

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

glBindFramebuffer: bind a framebuffer to a framebuffer target

Function Definition

 void glBindFramebuffer(GLenum target​, GLuint framebuffer​);
target
Specifies the framebuffer target of the binding operation.
framebuffer
Specifies the name of the framebuffer object to bind.

Description

glBindFramebuffer binds the framebuffer object with name framebuffer​ to the framebuffer target specified by target​. target​ must be either GL_DRAW_FRAMEBUFFER​, GL_READ_FRAMEBUFFER​ or GL_FRAMEBUFFER​. If a framebuffer object is bound to GL_DRAW_FRAMEBUFFER​ or GL_READ_FRAMEBUFFER​, it becomes the target for rendering or readback operations, respectively, until it is deleted or another framebuffer is bound to the corresponding bind point. Calling glBindFramebuffer with target​ set to GL_FRAMEBUFFER​ binds framebuffer​ to both the read and draw framebuffer targets. framebuffer​ is the name of a framebuffer object previously returned from a call to glGenFramebuffers, or zero to break the existing binding of a framebuffer object to target​.

Errors

GL_INVALID_ENUM​ is generated if target​ is not GL_DRAW_FRAMEBUFFER​, GL_READ_FRAMEBUFFER​ or GL_FRAMEBUFFER​.

GL_INVALID_OPERATION​ is generated if framebuffer​ is not zero or the name of a framebuffer previously returned from a call to glGenFramebuffers.

See Also

glGenFramebuffers, glDeleteFramebuffers, glIsFramebuffer, glFramebufferRenderbuffer, glFramebufferTexture, glFramebufferTextureLayer, glBlitFramebuffer, glCheckFramebufferStatus, glDrawBuffers, glDrawBuffer, glReadBuffer, glReadPixels, glFramebufferParameter, glInvalidateFramebuffer, glInvalidateSubFramebuffer

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