glGetColorTableParameterfvEXT 函数

  • 项目

glGetColorTableParameterfvEXT 和 glGetColorTableParameterivEXT 函数从颜色表获取调色板参数。

语法

void WINAPI glGetColorTableParameterfvEXT(
   GLenum  target,
   GLenum  pname,
   GLfloat *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 参数指定的颜色表参数数据。

返回值

此函数不返回值。

注解

使用 glGetColorTableParameterivEXT 和 glGetColorTableParameterfvEXT 函数从针对目标纹理调色板使用 glColorTableEXT 设置的颜色表中检索特定参数数据。 还可以使用这些函数来确定 glGetColorTableEXT 返回的颜色表条目数。

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

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

要求

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

另请参阅

glColorSubTableEXT

glColorTableEXT

glGetColorTableEXT

glGetColorTableParameterivEXT

wglGetProcAddress