Revision as of 20:47, 24 July 2013 by AlfonsesCategoryBot (talk | contribs) (Bot: Adding better formatting.)

Jump to: navigation, search
Core in version 4.5
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​);
Specifies the framebuffer target. target​ must be GL_DRAW_FRAMEBUFFER, GL_READ_FRAMEBUFFER, or GL_FRAMEBUFFER. GL_FRAMEBUFFER is equivalent to GL_DRAW_FRAMEBUFFER.
Specifies the attachment point of the framebuffer. attachment​ must be GL_COLOR_ATTACHMENTi, GL_DEPTH_ATTACHMENT, GL_STENCIL_ATTACHMENT or GL_DEPTH_STENCIL_ATTACHMENT.
Specifies the texture object to attach to the framebuffer attachment point named by attachment​.
Specifies the mipmap level of texture​ to attach.
Specifies the layer of texture​ to attach.


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.


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