GLAPI/glBindFramebuffer

From OpenGL.org
< GLAPI
Revision as of 03:21, 26 February 2012 by AlfonsesCategoryBot (Talk | contribs) (Renaming category: 'GL 4 API Framebuffer Objects' to 'Core API Ref Framebuffer Objects'.)

Jump to: navigation, search
glBindFramebuffer
Core in version 4.5
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, glFramebufferRenderbuffer, glFramebufferTexture, glFramebufferTexture1D, glFramebufferTexture2D, glFramebufferTexture3D, glFramebufferTextureLayer, glIsFramebuffer

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