GLES2.0中文API-glFramebufferTexture2D

名称

glFramebufferTexture2D - 将纹理图像附加到帧缓冲对象

C规范

void glFramebufferTexture2D（GLenum target,

GLenum attachment,

GLenum textarget,

GLuint texture,

GLint level）;

参数

target

指定帧缓冲目标。符号常量必须是GL_FRAMEBUFFER。

attachment

指定应附加纹理图像的附着点。必须是以下符号常量之一：GL_COLOR_ATTACHMENT0，GL_DEPTH_ATTACHMENT或GL_STENCIL_ATTACHMENT。

textarget

指定纹理目标。必须是以下符号常量之一：GL_TEXTURE_2D，GL_TEXTURE_CUBE_MAP_POSITIVE_X，GL_TEXTURE_CUBE_MAP_NEGATIVE_X，GL_TEXTURE_CUBE_MAP_POSITIVE_Y，GL_TEXTURE_CUBE_MAP_NEGATIVE_Y，GL_TEXTURE_CUBE_MAP_POSITIVE_Z或GL_TEXTURE_CUBE_MAP_NEGATIVE_Z。

texture

指定要附加图像的纹理对象。

level

指定要附加的纹理图像的mipmap级别，该级别必须为0。

描述

glFramebufferTexture2D将texture和level指定的纹理图像附加为当前绑定的帧缓冲区对象的逻辑缓冲区之一。 attachment指定是否应将纹理图像附加到帧缓冲对象的颜色，深度或模板缓冲区。纹理图像不可以附加到默认（名称为0）的帧缓冲对象。

如果texture不为0，则指定附加点的GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE的值设置为GL_TEXTURE，GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME的值设置为texture，GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL的值设置为level。如果纹理是立方体贴图纹理，则GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE的值设置为textarget; 否则将其设置为默认值GL_TEXTURE_CUBE_MAP_POSITIVE_X。先前绑定的帧缓冲区对象的附件逻辑缓冲区都将被破坏。

如果texture为0，则分离附加到当前绑定的帧缓冲区对象的附件逻辑缓冲区的当前图像（如果有的话）。 GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE的值设置为GL_NONE。 GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME的值设置为0. GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL和GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE分别设置为默认值0和GL_TEXTURE_CUBE_MAP_POSITIVE_X。

注意

当纹理对象当前被绑定并可能被当前顶点或片段着色器采样时，需要采取特殊预防措施以避免将纹理图像附加到当前绑定的帧缓冲区。这样做可能导致在通过渲染操作写入像素和在当前绑定纹理中用作纹素时同时读取那些相同像素之间创建“反馈循环”。在这种情况下，帧缓冲区将被视为帧缓冲区完成，但在此状态下渲染的片段的值将是未定义的。纹理样本的值也可能是未定义的。

如果在将图像附加到当前绑定的帧缓冲区时删除纹理对象，这就好比使用纹理0调用glFramebufferTexture2D作为此图像附加到当前绑定的帧缓冲区对象中的附着点。换句话说，纹理图像与当前绑定的帧缓冲区分离了。请注意，纹理图像不会与任何未绑定的帧缓冲区分离。从任何非绑定帧缓冲区中分离映像是应用程序的责任。

错误

GL_INVALID_ENUM ：target不是GL_FRAMEBUFFER。

GL_INVALID_ENUM ：texture不为0时textarget不是可接收的纹理target。

GL_INVALID_ENUM ：attachment是不可接收的附着点。

GL_INVALID_VALUE ：level不是0时，texture不是0。

GL_INVALID_OPERATION ：如果绑定了默认的帧缓冲对象名称0。

GL_INVALID_OPERATION ：如果texture既不是0也不是现有纹理对象的名称。

GL_INVALID_OPERATION ：如果texture是现有二维纹理对象的名称，但textarget不是GL_TEXTURE_2D，或者texture是现有立方体贴图纹理对象的名称，但textarget是GL_TEXTURE_2D。

另见

glBindFramebuffer,glBindTexture,glCheckFramebufferStatus，glDeleteFramebuffers，glDeleteTextures，glFramebufferRenderbuffer，glGenerateMipmap，glGetFramebufferAttachmentParameteriv，glTexImage2D

版权

https://www.khronos.org/registry/OpenGL-Refpages/es2.0/xhtml/glFramebufferTexture2D.xml

https://blog.csdn.net/flycatdeng

GLES2.0中文API-glFramebufferTexture2D相关推荐

GLES2.0中文API-glBindFramebuffer
名称 glBindFramebuffer- 绑定一个命名的帧缓冲区对象 C规范 void glBindFramebuffer(GLenum target, GLuint framebuffer); 参 ...
GLES2.0中文API-glUseProgram
名称 glUseProgram- 使用程序对象作为当前渲染状态的一部分 C规范 void glUseProgram(GLuint program); 参数 program 指定程序对象的句柄,该程序对 ...
GLES2.0中文API-glFramebufferRenderbuffer
名称 glFramebufferRenderbuffer- 将renderbuffer对象附加到framebuffer对象 C规范 void glFramebufferRenderbuffer(GLe ...
GLES2.0中文API-glGet
名称 glGet - 返回所选参数的值 C规范 void glGetBooleanv( GLenum pname, GLboolean * params); void glGetFlo ...
GLES2.0中文API-glUniform
名称 glUniform - 指定当前程序对象的统一变量的值 C规范 void glUniform1f( GLint location, GLfloat v0); void glUniform2 ...
GLES2.0中文API-glTexImage2D
名称 glTexImage2D- 指定一个二维的纹理图片 C规范 void glTexImage2D(GLenum target, GLint level, GLint internalformat, ...
GLES2.0中文API-glReadPixels
名称 glReadPixels - 从帧缓冲区中读取一个像素块 C规范 void glReadPixels(GLint x, GLint y, GLsizei width, GLsizei heigh ...
GLES2.0中文API-glCopyTexImage2D
名称 glCopyTexImage2D - 将像素复制到2D纹理图像中 C规范 void glCopyTexImage2D( GLenum target, GLint level, ...
GLES2.0中文API-glGetActiveUniform
名称 glGetActiveUniform - 返回有关活动统一变量的信息 C规范 void glGetActiveUniform(GLuint program, GLuint index, GLsi ...

GLES2.0中文API-glFramebufferTexture2D

名称

C规范

参数

描述

注意

错误

相关Gets

另见

版权

GLES2.0中文API-glFramebufferTexture2D相关推荐

最新文章

热门文章