Difference between revisions of "GLAPI/glFramebufferTextureLayer"

From OpenGL.org
Jump to: navigation, search
m (Bot: Adding better formatting.)
m (Bot: Adding better formatting.)
 
(One intermediate revision by the same user not shown)
Line 14: Line 14:
 
: Specifies the framebuffer target. {{param|target}} must be {{enum|GL_DRAW_FRAMEBUFFER}}, {{enum|GL_READ_FRAMEBUFFER}}, or {{enum|GL_FRAMEBUFFER}}. {{enum|GL_FRAMEBUFFER}} is equivalent to {{enum|GL_DRAW_FRAMEBUFFER}}.
 
: Specifies the framebuffer target. {{param|target}} must be {{enum|GL_DRAW_FRAMEBUFFER}}, {{enum|GL_READ_FRAMEBUFFER}}, or {{enum|GL_FRAMEBUFFER}}. {{enum|GL_FRAMEBUFFER}} is equivalent to {{enum|GL_DRAW_FRAMEBUFFER}}.
 
; attachment
 
; attachment
: Specifies the attachment point of the framebuffer. {{param|attachment}} must be {{enum|GL_COLOR_ATTACHMENT''i''}}, {{enum|GL_DEPTH_ATTACHMENT}}, {{enum|GL_STENCIL_ATTACHMENT}} or {{enum|GL_DEPTH_STENCIL_ATTACHMMENT}}.
+
: Specifies the attachment point of the framebuffer. {{param|attachment}} must be {{enum|GL_COLOR_ATTACHMENT''i''}}, {{enum|GL_DEPTH_ATTACHMENT}}, {{enum|GL_STENCIL_ATTACHMENT}} or {{enum|GL_DEPTH_STENCIL_ATTACHMENT}}.
 
; texture
 
; texture
 
: Specifies the texture object to attach to the framebuffer attachment point named by {{param|attachment}}.
 
: Specifies the texture object to attach to the framebuffer attachment point named by {{param|attachment}}.
Line 50: Line 50:
 
[[Category:Core API Ref Framebuffer Objects|FramebufferTextureLayer]]
 
[[Category:Core API Ref Framebuffer Objects|FramebufferTextureLayer]]
 
[[Category:Core API Reference|FramebufferTextureLayer]]
 
[[Category:Core API Reference|FramebufferTextureLayer]]
 +
[[Category:Framebuffer Object API State Functions|FramebufferTextureLayer]]

Latest revision as of 05:58, 15 August 2013

glFramebufferTextureLayer
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​);
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/.