'''glBindFramebuffer''' binds the framebuffer object with name ''framebuffer'' to the framebuffer target specified by ''target''. ''target'' must be either {{code|GL_DRAW_FRAMEBUFFER}}, {{code|GL_READ_FRAMEBUFFER}} or {{code|GL_FRAMEBUFFER}}. If a framebuffer object is bound to {{code|GL_DRAW_FRAMEBUFFER}} or {{code|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 {{code|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 [[GLAPI/glGenFramebuffers|glGenFramebuffers]], or zero to break the existing binding of a framebuffer object to ''target''.

+

'''glBindFramebuffer''' binds the framebuffer object with name {{param|framebuffer}} to the framebuffer target specified by {{param|target}}. {{param|target}} must be either {{enum|GL_DRAW_FRAMEBUFFER}}, {{enum|GL_READ_FRAMEBUFFER}} or {{enum|GL_FRAMEBUFFER}}. If a framebuffer object is bound to {{enum|GL_DRAW_FRAMEBUFFER}} or {{enum|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 {{param|target}} set to {{enum|GL_FRAMEBUFFER}} binds {{param|framebuffer}} to both the read and draw framebuffer targets. {{param|framebuffer}} is the name of a framebuffer object previously returned from a call to {{apifunc|glGenFramebuffers}}, or zero to break the existing binding of a framebuffer object to {{param|target}}.

== Errors ==

== Errors ==

−

{{code|GL_INVALID_ENUM}} is generated if ''target'' is not {{code|GL_DRAW_FRAMEBUFFER}}, {{code|GL_READ_FRAMEBUFFER}} or {{code|GL_FRAMEBUFFER}}.

+

{{enum|GL_INVALID_ENUM}} is generated if {{param|target}} is not {{enum|GL_DRAW_FRAMEBUFFER}}, {{enum|GL_READ_FRAMEBUFFER}} or {{enum|GL_FRAMEBUFFER}}.

−

{{code|GL_INVALID_OPERATION}} is generated if ''framebuffer'' is not zero or the name of a framebuffer previously returned from a call to [[GLAPI/glGenFramebuffers|glGenFramebuffers]].

+

{{enum|GL_INVALID_OPERATION}} is generated if {{param|framebuffer}} is not zero or the name of a framebuffer previously returned from a call to {{apifunc|glGenFramebuffers}}.

Latest revision as of 21:39, 26 September 2012

Contents

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