glGetColorTableEXT 函数

  • 项目

glGetColorTableEXT 函数获取当前目标纹理调色板的颜色表数据。

语法

void WINAPI glGetColorTableEXT(
         GLenum target,
         GLenum format,
         GLenum type,
   const GLvoid *data
);

parameters

目标

要更改其调色板的目标纹理。 必须是TEXTURE_1D或TEXTURE_2D。

format

像素数据的格式。 接受以下符号常量。

值 含义
GL_RGBA
 每个像素是一组四个分量，顺序如下：红色、绿色、蓝色、alpha。 按以下方式确定 RGBA 格式：
  1. glGetColorTableEXT 函数将浮点值直接转换为具有未指定精度的内部格式。 带符号整数值线性映射到内部格式，以便最正的可表示整数值映射到 1.0，而最负的可表示整数值映射到 -1.0。 无符号整数数据的映射方式类似：最大整数值映射到 1.0，零映射到 0.0。
  2. glGetColorTableEXT 函数将生成的颜色值乘以GL_c_SCALE，并将其添加到GL_c_BIAS，其中 c 是 RED、GREEN、BLUE 和 ALPHA，表示相应的颜色分量。 结果被限制在 [0，1] 范围内。
  3. 如果GL_MAP_COLOR为 TRUE， 则 glGetColorTableEXT 按查找表GL_PIXEL_MAP_c_TO_c的大小缩放每个颜色分量，然后将该组件替换为该表中引用的值; c 分别为 R、G、B 或 A。
  4. glGetColorTableEXT 函数将生成的 RGBA 颜色转换为片段，方法是将当前光栅位置 z 坐标和纹理坐标附加到每个像素，然后将 x 和 y 窗口坐标分配给第 n 个片段，这样 x？ = xr + n mod width
    y？ = yr + n/width
    其中， (xr 、 yr ) 是当前光栅位置。
  5. 然后，这些像素片段的处理方式与光栅化点、线或多边形生成的片段一样。 glGetColorTableEXT 函数在将片段写入 framebuffer 之前应用纹理映射、迷雾和所有片段操作。
GL_RED
 每个像素都是单个红色分量。
glGetColorTableEXT 函数将此组件转换为内部格式，其方式与 RGBA 像素的红色分量相同，然后将其转换为 RGBA 像素，其中绿色和蓝色设置为 0.0，alpha 设置为 1.0。 此转换后，将像将其读取为 RGBA 像素一样处理像素。
GL_GREEN
 每个像素都是单个绿色分量。
glGetColorTableEXT 函数将此组件转换为内部格式，其方式与 RGBA 像素的绿色分量相同，然后将其转换为红色和蓝色设置为 0.0、alpha 设置为 1.0 的 RGBA 像素。 此转换后，将像将其读取为 RGBA 像素一样处理像素。
GL_BLUE
 每个像素都是一个蓝色分量。
glGetColorTableEXT 函数将此组件转换为内部格式，其方式与 RGBA 像素的蓝色分量相同，然后将其转换为 RGBA 像素，其中红色和绿色设置为 0.0，alpha 设置为 1.0。 此转换后，将像将其读取为 RGBA 像素一样处理像素。
GL_ALPHA
 每个像素都是一个 alpha 分量。
glGetColorTableEXT 函数将此组件转换为内部格式，其方式与 RGBA 像素的 alpha 分量相同，然后将其转换为将红色、绿色和蓝色设置为 0.0 的 RGBA 像素。 此转换后，将像将其读取为 RGBA 像素一样处理像素。
GL_RGB
 每个像素都是一组三个分量，按以下顺序排列：红色、绿色、蓝色。
glGetColorTableEXT 函数将每个分量转换为内部格式，其方式与 RGBA 像素的红色、绿色和蓝色分量相同。 颜色三重转换为 alpha 设置为 1.0 的 RGBA 像素。 此转换后，将像将其读取为 RGBA 像素一样处理像素。
GL_BGR_EXT
 每个像素是一组三个分量，按以下顺序排列：蓝色、绿色、红色。
GL_BGR_EXT提供的格式与 microsoft Windows 设备无关位图的内存布局 (DIB) 相匹配。 因此，应用程序可以通过 Windows 函数调用和 OpenGL 像素函数调用使用相同的数据。
GL_BGRA_EXT
 每个像素都是一组四个分量，按以下顺序排列：蓝色、绿色、红色、alpha。
GL_BGRA_EXT提供的格式与与 windows 设备无关的位图 (DDB) 的内存布局相匹配。 因此，应用程序可以通过 Windows 函数调用和 OpenGL 像素函数调用使用相同的数据。

type

数据的数据类型。 以下是接受的符号常量及其含义。

值 含义
GL_UNSIGNED_BYTE
 无符号的 8 位整数
GL_BYTE
 8 位带符号整数
GL_UNSIGNED_SHORT
 无符号 16 位整数
GL_SHORT
 有符号 16 位整数
GL_UNSIGNED_INT
 无符号的 32 位整数
GL_INT
 32-bit integer
GL_FLOAT
 单精度浮点值

data

指向要存储返回的颜色表信息的位置。 每个颜色表条目都像存储一维纹理的单个像素一样。 由于所有纹理都具有默认调色板，因此即使纹理数据不是调色板格式， glGetColorTableEXT 也始终返回调色板信息。

返回值

此函数不返回值。

错误代码

glGetError 函数可以检索以下错误代码。

名称 含义
GL_INVALID_ENUM
 target、 format 或 type 不是接受的值。
GL_INVALID_OPERATION
 函数是在 对 glBegin 的调用和对 glEnd 的相应调用之间调用的。

备注

glGetColorTableEXT 函数获取 glColorTableEXT 和 glColorSubTableEXT 指定的实际颜色表数据。

glGetColorTableEXT 函数是一个扩展函数，它不属于标准 OpenGL 库，而是GL_EXT_paletted_texture扩展的一部分。 若要检查 OpenGL 的实现是否支持 glGetColorTableEXT，请调用 glGetString (GL_EXTENSIONS) 。 如果返回GL_EXT_paletted_texture，则支持 glGetColorTableEXT 。 若要获取扩展函数的函数地址，请调用 wglGetProcAddress。

要求

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

请参阅

glColorSubTableEXT

glColorTableEXT

glGetColorTableParameterfvEXT

glGetColorTableParameterivEXT

wglGetProcAddress