名称

glGetInternalformativ — 检索有关内部格式的实现相关支持的信息

C规范

void glGetInternalformativ( GLenum target,
GLenum internalformat,
GLenum pname,
GLsizei bufSize,
GLint *params);

参数

target
指示内部格式的用法。目标必须是GL_RENDERBUFFER，GL_TEXTURE_2D_MULTISAMPLE或GL_TEXTURE_2D_MULTISAMPLE_ARRAY。

internalformat
指定用于检索信息的内部格式。

pname
指定要查询的信息类型。

bufSize
指定该函数可以写入参数的整数的最大数量。

params
指定将检索到的信息写入其中的变量的地址。

描述

glGetInternalformativ检索有关内部格式的实现相关支持的信息。 target指示将使用内部格式的目标，并且必须是GL_RENDERBUFFER，GL_TEXTURE_2D_MULTISAMPLE或GL_TEXTURE_2D_MULTISAMPLE_ARRAY之一，分别对应于用作渲染缓冲区，二维多重采样纹理或二维多重采样数组纹理。

internalformat指定用于检索信息的内部格式，并且必须是可彩色渲染，可深度渲染或可模版渲染的格式。

检索到的信息将被写入由params中指定的指针寻址的内存中。最多只能将bufSize个整数写入该内存。

如果pname为GL_NUM_SAMPLE_COUNTS，则通过查询GL_SAMPLES返回的样本数量将以参数形式返回。

如果pname为GL_SAMPLES，则内部格式和目标所支持的样本计数将以降序编号写入参数。仅返回正值。查询bufSize为1的GL_SAMPLES将仅返回此格式支持的最大样本数。 GL_SAMPLES中的最大值保证至少为以下最小值：

如果internalformat是有符号或无符号整数格式，则GL_MAX_INTEGER_SAMPLES的值。

如果内部格式是深度或模板可渲染格式，并且目标是GL_TEXTURE_2D_MULTISAMPLE或GL_TEXTURE_2D_MULTISAMPLE_ARRAY，则GL_MAX_DEPTH_TEXTURE_SAMPLES的值。

如果internalformat是可彩色显示的格式，并且目标是GL_TEXTURE_2D_MULTISAMPLE或GL_TEXTURE_2D_MULTISAMPLE_ARRAY，则GL_MAX_COLOR_TEXTURE_SAMPLES的值。

GL_MAX_SAMPLES的值。

错误

如果bufSize为负数，则生成GL_INVALID_VALUE。

如果pname不是GL_SAMPLES或GL_NUM_SAMPLE_COUNTS，则生成GL_INVALID_ENUM。

如果内部格式不可用于颜色，深度或模版，则将生成GL_INVALID_ENUM。

如果目标不是GL_RENDERBUFFER，GL_TEXTURE_2D_MULTISAMPLE或GL_TEXTURE_2D_MULTISAMPLE_ARRAY，则生成GL_INVALID_ENUM。

API 支持版本

另见

glGet

版权

https://www.khronos.org/registry/OpenGL-Refpages/es3/html/glGetInternalformativ.xhtml
Copyright © 2011-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/.