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 [仅限桌面应用] |
| 标头 |
|