glPixelMapusv 函数

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

语法

void WINAPI glPixelMapusv(
         GLenum   map,
         GLsizei  mapsize,
   const GLushort *values
);

参数

map

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

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

mapsize

要定义的映射的大小。

映射 值的数组

返回值

此函数不返回值。

错误代码

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

名称 含义
GL _ 无效 _ 枚举
map 不是接受的值。
GL _ 无效 _ 值
mapsize 为负数或大于 GL _ PIXEL _ MAP _ TABLE。
GL _ 无效 _ 值
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, OR GL PIXEL MAP _ I TO _ _ _ _ A, mapize 不是 2 的功率。
GL _ 无效 _ 操作
函数是在对 glBegin 的调用与对 glEnd 的相应调用 之间调用的

备注

glPixelMap 函数设置转换表, 或 映射,由 glCopyPixels、glCopyTexImage1D、glCopyTexImage2D、glCopyTexSubImage1D、glCopyTexSubImage2D、glDrawPixels、glReadPixels、glTexImage1D、glTexImage2D、glTexSubImage1D 和 glTexSubImage2D 使用 glPixelTransfer主题以及像素和纹理图像命令主题中完整描述了这些映射的使用。 本主题仅介绍映射的规范。

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

映射中的条目可指定为单精度浮点数、无符号短整数或无符号长整数。 地图颜色组件值 (除 GL PIXEL MAP I TO I 和 GL PIXEL MAP S TO S 外的所有值) 以浮点格式保留其值,并且具有未指定的个数和指数 _ _ _ _ _ _ _ _ _ _ 大小。 glPixelMapfv指定的浮点值将直接转换为这些映射的内部浮点格式,然后固定到范围 [ 0,1 ] 。 glPixelMapusvglPixelMapuiv 指定的无符号整数值以线性方式转换,使最大可表示整数映射到 1.0,零映射到 0.0。

地图索引(GL PIXEL MAP I TO I 和 _ GL PIXEL MAP S _ TO _ _ _ _ _ _ _ _ S)的索引,以固定点格式保留其值,二进制点右侧有未指定的位数。 glPixelMapfv指定的浮点值直接转换为这些映射的内部定点格式。 glPixelMapusvglPixelMapuiv 指定的无符号整数值指定整数值,所有零都位于二进制点右侧。

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

映射 查找索引 查找值 初始大小 初始值
GL _ 像素 _ 映射 I 到 _ _ _ I 颜色索引 颜色索引 1 0.0
GL _ PIXEL MAP S 到 _ _ _ _ S 模具索引 模具索引 1 0.0
GL _ 像素 _ 映射 I 到 _ _ _ R 颜色索引 R 1 0.0
GL _ 像素 _ 映射 I 到 _ _ _ G 颜色索引 G 1 0.0
GL _ 像素 _ 映射 I 到 _ _ _ B 颜色索引 B 1 0.0
GL _ 像素 _ 将 I 映射到 _ _ _ A 颜色索引 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