glGetColorTableParameterivEXT 函数

glGetColorTableParameterfvEXTglGetColorTableParameterivEXT 函数从颜色表获取调色板参数。

语法

void WINAPI glGetColorTableParameterivEXT(
   GLenum target,
   GLenum pname,
   GLint  *params
);

参数

目标

要为其参数数据的调色板的目标纹理。 必须是TEXTURE_1D、TEXTURE_2D、PROXY_TEXTURE_1D或PROXY_TEXTURE_2D。

pname

参数所指向的调色板参数数据类型的符号常量。

以下是接受的符号常量及其含义。

含义
GL_COLOR_TABLE_FORMAT_EXT
返回由最近调用 glColorTableEXT 或默认值指定的内部格式。
GL_COLOR_TABLE_WIDTH_EXT
返回当前调色板的宽度。
GL_COLOR_TABLE_RED_SIZE_EXT
返回内部用于存储调色板数据的红色组件的实际大小。
GL_COLOR_TABLE_GREEN_SIZE_EXT
返回内部用于存储调色板数据的绿色组件的实际大小。
GL_COLOR_TABLE_BLUE_SIZE_EXT
返回内部用于存储调色板数据的蓝色组件的实际大小。
GL_COLOR_TABLE_ALPHA_SIZE_EXT
返回内部用于存储调色板数据的 alpha 组件的实际大小。

params

指向 pname 参数指定的颜色表参数数据。

返回值

此函数不返回值。

注解

使用 glGetColorTableParameterivEXTglGetColorTableParameterfvEXT 函数 从为目标 纹理调色板设置的颜色表检索特定参数数据。 还可以使用这些函数来确定 glGetColorTableEXT 返回的颜色表条目数。

目标 参数GL_PROXY_TEXTURE_1D或GL_PROXY_TEXTURE_2D,并且实现不支持为 格式宽度指定的值时, glColorTableEXT 无法创建请求的颜色表。 在这种情况下,颜色表为空,检索的所有参数将为零。 可以通过使用代理目标调用 glColorTableEXT,然后调用 glGetColorTableParameterivEXTglGetColorTableParameterfvEXT 来确定宽度参数是否与 glColorTableEXT 设置的宽度参数匹配,来确定 OpenGL 是否支持特定颜色表格式和大小。 如果检索的宽度为零, 则 glColorTable 发出的颜色表请求失败。 如果检索的宽度不为零,则可以使用具有TEXTURE_1D或TEXTURE_2D的实际目标调用 glColorTable 来设置颜色表。

glGetColorTableParameterivEXTglGetColorTableParameterfvEXT 函数是不属于标准 OpenGL 库但属于GL_EXT_paletted_texture扩展的扩展函数。 若要检查 OpenGL 的实现是否支持 glGetColorTableParameterivEXTglGetColorTableParameterfvEXT,请调用 glGetString (GL_EXTENSIONS) 。 如果返回GL_EXT_paletted_texture,则支持 glGetColorTableParameterivEXTglGetColorTableParameterfvEXT 。 若要获取扩展函数的函数地址,请调用 wglGetProcAddress

要求

要求
最低受支持的客户端
Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器
Windows 2000 Server [仅限桌面应用]
标头
Gl.h

另请参阅

glColorSubTableEXT

glColorTableEXT

glGetColorTableEXT

glGetColorTableParameterfvEXT

wglGetProcAddress