GLES3.0中文API--glFramebufferTextureLayer

名称

glFramebufferTextureLayer — 将纹理的单层附加到帧缓冲区

C 规范
void glFramebufferTextureLayer( GLenum target,
GLenum attachment,
GLuint texture,
GLint level,
GLint layer);

参数
target
指定帧缓冲区目标。目标必须是GL_DRAW_FRAMEBUFFER，GL_READ_FRAMEBUFFER或GL_FRAMEBUFFER。 GL_FRAMEBUFFER等效于GL_DRAW_FRAMEBUFFER。

attachment
指定帧缓冲区的连接点。附件必须是GL_COLOR_ATTACHMENTi，GL_DEPTH_ATTACHMENT，GL_STENCIL_ATTACHMENT或GL_DEPTH_STENCIL_ATTACHMENT。

texture
指定要附着到由附件命名的帧缓冲区附着点的纹理对象。

level
指定要附加的纹理的mipmap级别。

layer
指定要附加的纹理层。

描述
glFramebufferTextureLayer的工作方式与glFramebufferTexture2D相似，不同之处在于，仅将由图层指定的纹理级别的单层附加到附加点。如果纹理不为零，则图层必须大于或等于零。 texture必须为零或现有的三维纹理，二维数组纹理，立方体贴图数组纹理或二维多重采样数组纹理的名称。

如果纹理是3D纹理，则级别必须大于或等于GL_MAX_3D_TEXTURE_SIZE的log2。如果纹理是2D数组或立方体贴图数组纹理，则级别必须大于或等于零且不大于GL_MAX_TEXTURE_SIZE的log2。如果纹理是2D多样本数组纹理，则级别必须等于零。

失误
如果目标不是接受的令牌之一，则生成GL_INVALID_ENUM。

如果附件不是可接受的令牌之一，则生成GL_INVALID_ENUM。

如果纹理不为零或现有纹理对象的名称，则生成GL_INVALID_VALUE。

如果纹理不为零且图层为负，则生成GL_INVALID_VALUE。

如果纹理不为零并且对于3D纹理，图层大于GL_MAX_3D_TEXTURE_SIZE的值减一，或者对于2D数组或2D多样本数组纹理，大于GL_MAX_ARRAY_TEXTURE_LAYERS的值，则生成GL_INVALID_VALUE。

如果将零绑定到目标，则生成GL_INVALID_OPERATION。

如果纹理不为零或现有的三维，二维数组，立方体贴图数组或二维多重采样数组纹理的名称，则生成GL_INVALID_OPERATION。

API 支持版本

函数名	2.0	3.0	3.1	3.2
glFramebufferTextureLayer	-	✔	✔	✔

另见

glGenFramebuffers, glBindFramebuffer, glGenRenderbuffers, glFramebufferRenderbuffer, glFramebufferTexture2D,

版权

https://www.khronos.org/registry/OpenGL-Refpages/es3/html/glFramebufferTextureLayer.xhtml
Copyright © 2010-2015 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/.