前言
将2维纹理对象绑定到帧缓冲区,帧缓冲区本身是不存放颜色、深度等信息的,这些信息需要通过纹理、深度缓存来存放,这些缓存可以绑定到帧缓冲区上。
这种绑定关系会被opengl记录,不会随着当前帧缓冲区改变而改变。因而这个帧缓冲区和纹理单元有点类似,绑定到纹理单元的纹理对象,也会被opengl记录,不会随着当前纹理单元的改变而改变。不同的是纹理单元与纹理对象的绑定关系是隐式进行的(不需要手工绑定),而帧缓冲区与纹理对象的绑定是显式进行的。
名称
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。
相关Gets
glGetFramebufferAttachmentParameteriv
另见
glBindFramebuffer,glBindTexture,glCheckFramebufferStatus,glDeleteFramebuffers,glDeleteTextures,glFramebufferRenderbuffer,glGenerateMipmap,glGetFramebufferAttachmentParameteriv,glTexImage2D
个人理解
target
Specifies the target to which the framebuffer is bound for all commands except glNamedFramebufferTexture.
指定当前帧缓冲区的操作类型,可以取GL_DRAW_FRAMEBUFFER, GL_READ_FRAMEBUFFER, GL_FRAMEBUFFER之一,GL_DRAW_FRAMEBUFFER表示当前帧缓冲区为写类型,GL_READ_FRAMEBUFFER表示当前帧缓冲区为读类型,GL_FRAMEBUFFER等同于GL_DRAW_FRAMEBUFFER(与glBindFramebuffer中的含义不一致,那里面等同于GL_DRAW_FRAMEBUFFER,和GL_READ_FRAMEBUFFER)。
attachment
Specifies the attachment point of the framebuffer.
指定纹理对象在帧缓冲区中的挂载点,可以取GL_COLOR_ATTACHMENTi, GL_DEPTH_ATTACHMENT, GL_STENCIL_ATTACHMENT or GL_DEPTH_STENCIL_ATTACHMENT。GL_COLOR_ATTACHMENTi表示颜色挂载点,可以有多个颜色挂载点,i的范围为0~GL_MAX_COLOR_ATTACHMENTS-1。GL_DEPTH_ATTACHMENT表示深度挂载点。GL_STENCIL_ATTACHMENT表示模板挂载点。GL_DEPTH_STENCIL_ATTACHMENT表示同时挂载到深度和模板挂载点。
textarget
For glFramebufferTexture1D, glFramebufferTexture2D and glFramebufferTexture3D, specifies what type of texture is expected in the texture parameter, or for cube map textures, which face is to be attached.
指定纹理对象中的目标类型,这个和glBindTexture中的目标类型是有区别的。可以取 GL_TEXTURE_2D, GL_TEXTURE_RECTANGLE, GL_TEXTURE_CUBE_MAP_POSITIVE_X, GL_TEXTURE_CUBE_MAP_POSITIVE_Y, GL_TEXTURE_CUBE_MAP_POSITIVE_Z, GL_TEXTURE_CUBE_MAP_NEGATIVE_X, GL_TEXTURE_CUBE_MAP_NEGATIVE_Y, GL_TEXTURE_CUBE_MAP_NEGATIVE_Z, or GL_TEXTURE_2D_MULTISAMPLE。GL_TEXTURE_2D表示纹理对象中的二维纹理,glBindTexture绑定GL_TEXTURE_2D的情况下。GL_TEXTURE_CUBE_MAP_POSITIVE_X, GL_TEXTURE_CUBE_MAP_POSITIVE_Y, GL_TEXTURE_CUBE_MAP_POSITIVE_Z, GL_TEXTURE_CUBE_MAP_NEGATIVE_X, GL_TEXTURE_CUBE_MAP_NEGATIVE_Y, GL_TEXTURE_CUBE_MAP_NEGATIVE_Z表示使用立方体纹理的哪一个面,glBindTexture绑定GL_TEXTURE_CUBE的情况下。GL_TEXTURE_2D_MULTISAMPLE表示***,glBindTexture绑定 GL_TEXTURE_2D_MULTISAMPLE的情况下。
texture
Specifies the name of an existing texture object to attach.
指定纹理对象的名字,与glGenTexture一致。
level
Specifies the mipmap level of the texture object to attach.