GLAPI/glFramebufferTextureLayer

From OpenGL.org
Jump to: navigation, search
glFramebufferTextureLayer
Core in version 4.4
Core since version 3.2
ARB extension ARB_geometry_shader4


glFramebufferTextureLayer: attach a single layer of a texture to a framebuffer

Function Definition

 void glFramebufferTextureLayer(GLenum target​, GLenum attachment​, GLuint texture​, GLint level​, GLint layer​);
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_ATTACHMENT​.
texture
Specifies the texture object to attach to the framebuffer attachment point named by attachment​.
level
Specifies the mipmap level of texture​ to attach.
layer
Specifies the layer of texture​ to attach.

Description

glFramebufferTextureLayer operates like glFramebufferTexture, except that only a single layer of the texture level, given by layer​, is attached to the attachment point. If texture​ is not zero, layer​ must be greater than or equal to zero. texture​ must either be zero or the name of an existing three-dimensional texture, one- or two-dimensional array texture, cube map array texture, or multisample array 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_VALUE​ is generated if texture​ is not zero or the name of an existing texture object.

GL_INVALID_VALUE​ is generated if texture​ is not zero and layer​ is negative.

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

glBindFramebuffer, glFramebufferRenderbuffer, glFramebufferTexture

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