2010
Khronos Group
glFramebufferTextureFace
3G
glFramebufferTextureFace
attach a face of a cube map texture as a logical buffer to the currently bound framebuffer
C Specification
void glFramebufferTextureFace
GLenum target
GLenum attachment
GLuint texture
GLint level
GLenum face
Parameters
target
Specifies the framebuffer target. target must be GL_DRAW_FRAMEBUFFER,
GL_READ_FRAMEBUFFER, or GL_FRAMEBUFFER. GL_FRAMEBUFFER
is equivalent to GL_DRAW_FRAMEBUFFER.
attachment
Specifies the attachment point of the framebuffer. attachment must be
GL_COLOR_ATTACHMENTi, GL_DEPTH_ATTACHMENT,
GL_STENCIL_ATTACHMENT or GL_DEPTH_STENCIL_ATTACHMMENT.
texture
Specifies the texture object to attach to the framebuffer attachment point named by attachment.
texture must be the name of an existing cube-map texture.
level
Specifies the mipmap level of texture to attach.
face
Specifies the face of texture to attach.
Description
glFramebufferTextureFace operates like glFramebufferTexture,
except that only a single face of a cube map texture, given by face, is attached to the attachment point.
face must be GL_TEXTURE_CUBE_MAP_POSITIVE_X, GL_TEXTURE_CUBE_MAP_POSITIVE_Y,
GL_TEXTURE_CUBE_MAP_POSITIVE_Z, GL_TEXTURE_CUBE_MAP_NEGATIVE_X, GL_TEXTURE_CUBE_MAP_NEGATIVE_Y,
or GL_TEXTURE_CUBE_MAP_NEGATIVE_Z. texture must either be zero, or the name of an existing cube map texture.
Errors
GL_INVALID_ENUM is generated if target is not one of the accepted tokens.
GL_INVALID_ENUM is generated if attachment is not one of the accepted tokens.
GL_INVALID_ENUM is generated if face is not one of the accepted tokens.
GL_INVALID_OPERATION is generated if zero is bound to target.
GL_INVALID_OPERATION is generated if texture is not zero or the name of an existing cube map texture.
See Also
glGenFramebuffers,
glBindFramebuffer,
glGenRenderbuffers,
glFramebufferTexture,
glFramebufferTextureLayer
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/.