glPixelMapuiv 函数

GlPixelMapuiv 函数设置像素传输映射。

语法

void WINAPI glPixelMapuiv(
         GLenum  map,
         GLsizei mapsize,
   const GLuint  *values
);

参数

map

符号映射名称。 十个映射如下所示。

含义
总帐 _ 像素 _ 映射 _ I _ 到 _ I
为颜色索引地图颜色索引。
总帐 _ 像素 _ 映射 _ _ 到 _ S
将模具索引地图到模具索引。
总帐 _ 像素 _ 映射 _ I _ 到 _ R
为红色组件地图颜色索引。
总帐 _ 像素 _ 映射 _ I _ 到 _ G
地图绿色组件的颜色索引。
总帐 _ 像素 _ 映射 _ I _ 到 _ B
地图蓝色组件的颜色索引。
总帐 _ 像素 _ 映射 _ I _ 到 _
地图 alpha 分量的颜色索引。
总帐 _ 像素 _ _ 将 R 映射 _ 到 _ R
将红色组件地图为红色组件。
总帐 _ 像素 _ 映射 _ G _ 到 _ G
向绿色组件地图绿色组件。
总帐 _ 像素 _ 映射 _ B _ 到 _ B
向蓝色组件地图蓝色组件。
总帐 _ 像素 _ 将 _ 映射 _ 到 _
将 alpha 分量地图到 alpha 分量。

mapsize

要定义的映射的大小。

Mapsize 值的数组。

返回值

此函数不返回值。

错误代码

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

名称 含义
总帐 _ 无效 _ 枚举
映射 不是接受的值。
总帐 _ 无效 _ 值
mapsize 为负数或大于 GL _ 像素 _ 映射 _ 表。
总帐 _ 无效 _ 值
map was gl _ 像素 _ 映射 _ i _ 到 _ i,gl _ 像素 _ 映射 _ _ 到 _ s,总帐像素映射 i 到 R,总帐像素映射 i 到 B,或总帐像素映射 i 到 _ _ _ _ _ _ _ B, _ _ _ _ _ _ _ _ _ _ _ _ _ 而 mapsize 不是2的幂。
总帐 _ 无效 _ 操作
调用 glBegin 和对 glEnd的相应调用之间调用了函数。

备注

GlPixelMap 函数设置 glCopyPixelsglCopyTexImage1DglCopyTexImage2DglCopyTexSubImage1DglCopyTexSubImage2DglDrawPixelsglReadPixelsglTexImage1DglTexImage2DglTexSubImage1DglTexSubImage2D使用的翻译表或 映射GlPixelTransfer主题完全介绍了这些映射的用法,其中部分介绍了像素和纹理图像命令。 本主题仅介绍了映射规范。

Map 参数是符号映射名称,指示要设置的10个映射之一。 Mapsize 参数指定映射中的条目数, 为指向 mapsize 映射值的数组的指针。

可以将映射中的条目指定为单精度浮点数、无符号短整数或无符号长整数。 地图,将颜色组件值存储 (所有(GL _ 像素 _ 映射 _ i _ 到 _ i),并将总帐 _ 像素地图映射 _ _ _ 到 _ s) 以浮点格式保留其值,但未指定的尾数和指数大小。 GlPixelMapfv指定的浮点值将直接转换为这些映射的内部浮点格式,然后限制为范围 [ 0,1 ] 。 GlPixelMapusvglPixelMapuiv 指定的无符号整数值以线性方式进行转换,以便最大的可表示整数映射到1.0,而零映射到0.0。

用于存储索引的地图,GL _ 像素映射 _ _ i _ 到 _ i 和 gl _ 象素 _ 图 _ s _ ,以 _ 定点格式保留其值,在二进制点右侧指定的位数为指定的位数。 GlPixelMapfv指定的浮点值直接转换为这些映射的内部定点格式。 GlPixelMapusvglPixelMapuiv 指定的无符号整数值指定整数值,所有零都位于二进制点的右侧。

下表显示了每个映射的初始大小和值。 按颜色或模具索引编制索引地图必须为某些 n 或结果定义 mapsize = 2 ^ n 。 每个地图允许的最大大小取决于实现,并且可通过调用带有参数 GL _ 最大 _ 像素 _ 映射 _ 表的 glGet 来确定。 单个最大值适用于所有映射,并且至少为32。

映射 查找索引 查找值 初始大小 初始值
总帐 _ 像素 _ 映射 _ I _ 到 _ I 颜色索引 颜色索引 1 0.0
总帐 _ 像素 _ 映射 _ _ 到 _ S 模具索引 模具索引 1 0.0
总帐 _ 像素 _ 映射 _ I _ 到 _ R 颜色索引 R 1 0.0
总帐 _ 像素 _ 映射 _ I _ 到 _ G 颜色索引 G 1 0.0
总帐 _ 像素 _ 映射 _ I _ 到 _ B 颜色索引 B 1 0.0
总帐 _ 像素 _ 映射 _ I _ 到 _ 颜色索引 A 1 0.0
总帐 _ 像素 _ _ 将 R 映射 _ 到 _ R R R 1 0.0
总帐 _ 像素 _ 映射 _ G _ 到 _ G G G 1 0.0
总帐 _ 像素 _ 映射 _ B _ 到 _ B B B 1 0.0
总帐 _ 像素 _ 将 _ 映射 _ 到 _ A A 1 0.0

以下函数检索与 glPixelMap 相关的信息:

带有自变量的 glGet _ 像素 _ 映射 _ i _ 到 _ i _ 大小

带有自变量 GL _ 像素映射的 glGet 的 _ _ _ _ _ 大小

带有自变量 GL _ 像素 _ 映射 _ I _ 到 _ R _ 大小的 glGet

glGet ,参数 GL _ 像素 _ 映射 _ I _ 到 _ G _ 大小

带有自变量 GL _ 像素 _ 映射 _ I _ 到 _ B _ 大小的 glGet

带有自变量 GL 像素的 glGet _ _ 图 _ I _ 到 _ _ 大小

带有自变量 GL 像素的 glGet _ _ 映射 _ r _ 到 _ r _ 大小

带有自变量 GL 像素的 glGet _ _ 图 _ g _ _ _ 大小

带有自变量 GL _ 像素 _ MAP _ b _ 到 _ b _ SIZE 的 glGet

带有自变量 GL _ 像素 _ 的 glGet 将映射 _ _ 到 _ _ 大小

带参数的 glGet _ 最大 _ 像素 _ 地图 _ 表

要求

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

Opengl32
DLL
Opengl32.dll

另请参阅

glBegin

glCopyPixels

glDrawPixels

glEnd

glPixelStore

glPixelTransfer

glReadPixels

glTexImage1D

glTexImage2D