glFramebufferTextureFace — attach a face of a cube map texture as a logical buffer to the currently bound framebuffer
void glFramebufferTextureFace( | GLenum target, |
GLenum attachment, | |
GLuint texture, | |
GLint level, | |
GLenum face) ; |
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.
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.
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.
glGenFramebuffers, glBindFramebuffer, glGenRenderbuffers, glFramebufferTexture, glFramebufferTextureLayer
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/.