名称
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/.
