GLES2.0中文API-glGetFramebufferAttachmentParameteriv

名称

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。

另见

glBindFramebuffer，glFramebufferRenderbuffer，glFramebufferTexture2D

版权

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

https://blog.csdn.net/flycatdeng

Copyright © 1991-2006 Silicon Graphics, Inc.本文档的许可是根据SGI Free Software B License.详见http://oss.sgi.com/projects/FreeB/.

Android,OpenGL ES,图形学