Revision as of 20:18, 28 April 2012 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_ATTACHMMENT​.
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, 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

glGenFramebuffers, 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.