Difference between revisions of "GLAPI/glFramebufferTextureLayer"

From OpenGL.org
Jump to: navigation, search
(No such function.)
m (Bot: Adjusting API page category.)
Line 49: Line 49:
[[Category:API Reference 4|FramebufferTextureLayer]]
[[Category:API Reference 4|FramebufferTextureLayer]]
[[Category:GL 4 API Framebuffer Objects|FramebufferTextureLayer]]

Revision as of 22:29, 25 February 2012

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, glGenRenderbuffers, 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. http://opencontent.org/openpub/.