GLES2.0中文API-glGetFramebufferAttachmentParameteriv

最新推荐文章于 2024-02-06 21:21:44 发布

flycatdeng

最新推荐文章于 2024-02-06 21:21:44 发布

阅读量1.8k

点赞数

分类专栏： gles GLES2.0中文API 文章标签： glGetFramebufferAttachmentPara 中文 API gles

gles 同时被 2 个专栏收录

133 篇文章

订阅专栏

GLES2.0中文API

106 篇文章

订阅专栏

名称

glGetFramebufferAttachmentParameteriv - 返回帧缓冲对象的附件参数

C规范

void glGetFramebufferAttachmentParameteriv(   GLenum target,
    GLenum attachment,
    GLenum pname,
    GLint * params);

参数

target

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

attachment

指定帧缓冲区对象附加点的符号名称。可接受的值为GL_COLOR_ATTACHMENT0，GL_DEPTH_ATTACHMENT和GL_STENCIL_ATTACHMENT。

pname

指定帧缓冲区对象附件参数的符号名称。可接受的值为GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE，GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME，GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL和GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE。

params

返回请求的参数。

描述

glGetFramebufferAttachmentParameteriv以params形式返回当前绑定的framebuffer对象的附着点的选定附件参数。pname命名一个特定的framebuffer对象附件参数，如下所示：

GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE

params返回包含附加图像的对象类型，GL_RENDERBUFFER，GL_TEXTURE，或者如果没有附加图像，则返回GL_NONE。初始值为GL_NONE。

GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME

如果GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE的值为GL_RENDERBUFFER，则params返回包含附加图像的renderbuffer对象的名称。如果GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE的值为GL_TEXTURE，则params返回包含附加图像的纹理对象的名称。初始值为零。

GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL

如果GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE的值为GL_TEXTURE，则params返回包含附加图像的纹理对象的mipmap级别。初始值为零。

GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE

如果GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE的值为GL_TEXTURE且GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME是立方体贴图纹理的名称，则params返回包含附加图像的立方体贴图纹理对象的立方体贴图面。如果附加图像来自纹理对象但不是立方体贴图，则params返回0.初始值为GL_TEXTURE_CUBE_MAP_POSITIVE_X。

注意

如果生成错误，则不会更改params的内容。

错误

GL_INVALID_ENUM：target不是GL_FRAMEBUFFER。

GL_INVALID_ENUM：attachment不是GL_COLOR_ATTACHMENT0，GL_DEPTH_ATTACHMENT或GL_STENCIL_ATTACHMENT。

GL_INVALID_ENUM：指定附着点处的附加对象为GL_RENDERBUFFER但pname不是GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE或GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME。

GL_INVALID_ENUM：指定附着点处的附加对象是GL_TEXTURE但pname不是GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE，GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME，GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL或GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE。

GL_INVALID_ENUM：命名附加点上没有附加对象但pname不是GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE。

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