glBindFramebuffer — bind a framebuffer to a framebuffer target
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.
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.
glGenFramebuffers may be used to generate a set of unused framebuffer object names.
The storage, dimensions, allocation, and format of the images attached to the default framebuffer are managed entirely by the window system. In order that access to the default framebuffer is not lost, it is treated as a framebuffer object with the name of zero. The default framebuffer is therefore rendered to and read from while zero is bound to the corresponding targets.
GL_INVALID_ENUM
is generated if target
is not GL_DRAW_FRAMEBUFFER
,
GL_READ_FRAMEBUFFER
or GL_FRAMEBUFFER
.
OpenGL ES API Version | ||
---|---|---|
Function Name | 2.0 | 3.0 |
glBindFramebuffer | ✔ | ✔ |
glGenFramebuffers, glDeleteFramebuffers, glFramebufferRenderbuffer, glFramebufferTexture2D, glFramebufferTextureLayer, glIsFramebuffer
Copyright © 2010-2014 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. https://opencontent.org/openpub/.