glFramebufferRenderbuffer
3G
glFramebufferRenderbuffer
attach a renderbuffer object to a framebuffer object
C Specification
void glFramebufferRenderbuffer
GLenum target
GLenum attachment
GLenum renderbuffertarget
GLuint renderbuffer
Parameters
target
Specifies the framebuffer target. The symbolic constant must be
GL_FRAMEBUFFER.
attachment
Specifies the attachment point to which
renderbuffer should be attached. Must be one of the
following symbolic constants:
GL_COLOR_ATTACHMENT0,
GL_DEPTH_ATTACHMENT, or
GL_STENCIL_ATTACHMENT.
renderbuffertarget
Specifies the renderbuffer target. The symbolic constant must be
GL_RENDERBUFFER.
renderbuffer
Specifies the renderbuffer object that is to be attached.
Description
glFramebufferRenderbuffer attaches the
renderbuffer specified by renderbuffer as
one of the logical buffers of the currently bound framebuffer object.
attachment specifies whether the renderbuffer
should be attached to the framebuffer object's color, depth, or
stencil buffer. A renderbuffer may not be attached to the default
framebuffer object name 0.
If renderbuffer is not 0, the value of
GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE for the
specified attachment point is set to GL_RENDERBUFFER
and the value of GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME
is set to renderbuffer.
GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL and
GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE are
set to the default values 0 and GL_TEXTURE_CUBE_MAP_POSITIVE_X,
respectively. Any previous attachment to the attachment
logical buffer of the currently bound framebuffer object is broken.
If renderbuffer is 0, the current image, if any, attached to
the attachment logical buffer of the currently bound
framebuffer object is detached. The value of
GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE is set to
GL_NONE. The value of
GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME is set to 0.
GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL and
GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE are
set to the default values 0 and GL_TEXTURE_CUBE_MAP_POSITIVE_X,
respectively.
Notes
If a renderbuffer object is deleted while its image is attached to the currently
bound framebuffer, then it is as if glFramebufferRenderbuffer
had been called with a renderbuffer of 0 for the attachment
point to which this image was attached in the currently bound framebuffer object.
In other words, the renderbuffer image is detached from the currently bound
framebuffer. Note that the renderbuffer image is specifically not
detached from any non-bound framebuffers. Detaching the image from any non-bound
framebuffers is the responsibility of the application.
Errors
GL_INVALID_ENUM is generated if
target is not GL_FRAMEBUFFER.
GL_INVALID_ENUM is generated if
renderbuffertarget is not GL_RENDERBUFFER and
renderbuffer is not 0.
GL_INVALID_ENUM is generated if
attachment is not an accepted attachment point.
GL_INVALID_OPERATION is generated if
the default framebuffer object name 0 is bound.
GL_INVALID_OPERATION is generated if
renderbuffer is neither 0 nor the name of an existing
renderbuffer object.
Associated Gets
glGetFramebufferAttachmentParameteriv
See Also
glBindFramebuffer,
glBindRenderbuffer,
glCheckFramebufferStatus,
glDeleteFramebuffers,
glDeleteRenderbuffers,
glFramebufferTexture2D,
glGetFramebufferAttachmentParameteriv,
glRenderbufferStorage
Copyright
Copyright 2008 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/.