glGetPixelMapuiv 函数

glGetPixelMapfv、glGetPixelMapuiv 和 glGetPixelMapusv 函数返回指定的像素映射。

语法

void WINAPI glGetPixelMapuiv(
   GLenum map,
   GLuint *values
);

map: 要返回的像素映射的名称。接受的值为 GL_PIXEL_MAP_I_TO_I、GL_PIXEL_MAP_S_TO_S、GL_PIXEL_MAP_I_TO_R、GL_PIXEL_MAP_I_TO_G、GL_PIXEL_MAP_I_TO_B、GL_PIXEL_MAP_I_TO_A、GL_PIXEL_MAP_R_TO_R、GL_PIXEL_MAP_G_TO_G、GL_PIXEL_MAP_B_TO_B 和 GL_PIXEL_MAP_A_TO_A。
值: 返回像素映射内容。

此函数不返回值。

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

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

有关 map 参数的可接受值的说明，请参阅 glPixelMap。 glGetPixelMap 函数在值中返回 map 中指定的像素映射的内容。在执行 glReadPixels、 glDrawPixels、 glCopyPixels、 glTexImage1D 和 glTexImage2D 期间使用像素映射将颜色索引、模具索引、颜色分量和深度分量映射到其他值。

无符号整数值（如果请求）从内部固定或浮点表示形式线性映射，以便 1.0 映射到最大的可表示整数值，0.0 映射到零。如果映射值不在 [0，1] 范围内，则返回未定义的无符号整数值。

若要确定 所需的映射大小，请使用相应的符号常量调用 glGet 。

如果生成错误，则不会更改值的内容。

以下函数检索与 glGetPixelMap 相关的信息：

带参数GL_PIXEL_MAP_I_TO_I_SIZE的 glGet

带参数GL_PIXEL_MAP_S_TO_S_SIZE的 glGet

带参数GL_PIXEL_MAP_I_TO_R_SIZE的 glGet

带参数GL_PIXEL_MAP_I_TO_G_SIZE的 glGet

带参数GL_PIXEL_MAP_I_TO_B_SIZE的 glGet

带参数GL_PIXEL_MAP_I_TO_A_SIZE的 glGet

带参数GL_PIXEL_MAP_R_TO_R_SIZE的 glGet

带参数GL_PIXEL_MAP_G_TO_G_SIZE的 glGet

带参数GL_PIXEL_MAP_B_TO_B_SIZE的 glGet

带参数GL_PIXEL_MAP_A_TO_A_SIZE的 glGet

带参数GL_MAX_PIXEL_MAP_TABLE的 glGet

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