OpenGL API 之 glPixelMap
1. 简介
glPixelMap设置像素传输中的像素映射
2. 函数原型
// c style void glPixelMapfv(GLenum map, GLsizei mapsize, const GLfloat * values); void glPixelMapuiv(GLenum map, GLsizei mapsize, const GLuint * values); void glPixelMapusv(GLenum map, GLsizei mapsize, const GLushort * values);
# python style def glPixelMapfv( map , mapsize , values ) def glPixelMapuiv( map , mapsize , values ) def glPixelMapusv( map , mapsize , 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 mapsize: 设置映射区域的大小 values: 设置映射区域的值
3. 详细描述
glPixelMap设置像素传输的转换表(或者称为对应关系)，当设置之后，它会影响如下API的作用效果：
glCopyPixels,glCopyTexImage1D,glCopyTexImage2D,glCopyTexSubImage1D,glCopyTexSubImage2D,glCopyTexSubImage3D,glDrawPixels,glReadPixels,glTexImage1D,glTexImage2D,glTexImage3D,glTexSubImage1D,glTexSubImage2DglTexSubImage3D
如果 ARB_imaging扩展开启，那么以下API的调用也会受到glPixelMap的影响：
glColorTableglColorSubTableglConvolutionFilter1DglConvolutionFilter2DglHistogramglMinmaxglSeparableFilter2D
glPixelMap中的mapsize的参数定义了映射的数组的大小(mapsize的大小必须是2的n次方，否则结果未定义)，value指向实际数组的地址(如果开启了PBO，那么value的作用就是PBO中的偏移量)下表列出了glPixelMap中参数的初始值：
| map取值 | 查询索引(源) | 查询索引(目标) | 初始值 | 初始值 |
|---|---|---|---|---|
| GL_PIXEL_MAP_I_TO_I | 颜色索引值 | 颜色索引值 | 1 | 0 |
| GL_PIXEL_MAP_S_TO_S | 模板索引值 | 模板索引值 | 1 | 0 |
| GL_PIXEL_MAP_I_TO_R | 颜色索引值 | 红色 | 1 | 0 |
| GL_PIXEL_MAP_I_TO_G | 颜色索引值 | 绿色 | 1 | 0 |
| GL_PIXEL_MAP_I_TO_B | 颜色索引值 | 蓝色 | 1 | 0 |
| GL_PIXEL_MAP_I_TO_A | 颜色索引值 | Alpha | 1 | 0 |
| GL_PIXEL_MAP_R_TO_R | 红色 | 红色 | 1 | 0 |
| GL_PIXEL_MAP_G_TO_G | 绿色 | 绿色 | 1 | 0 |
| GL_PIXEL_MAP_G_TO_B | 蓝色 | 蓝色 | 1 | 0 |
| GL_PIXEL_MAP_G_TO_A | Alpha | Alpha | 1 | 0 |
4. 示例
我们现在要做这样一个功能：反转一张图片，让图片中的颜色变为它的互补色。假设我们设置mapsize的大小是255，并设置value的取值是从1.0到0.0按255的级别递减，也就是：
mapArray = [1]; for i in range(1, 256): mapArray.append(1.0- ((1.0)/255.0)*i)
然后我们使用GL_PIXEL_MAP_R_TO_R、GL_PIXEL_MAP_G_TO_G、GL_PIXEL_MAP_G_TO_B让颜色通过映射表中的颜色得到它的处理后的颜色。假设图片中某一像素的颜色是RGB(255,127,127)，那么它映射的计算过程如下：先把颜色从[0,255](颜色的取值范围)映射到mapsize这个大小上，也就是 R = round(255/255)*255、G=round(127/255)*255、B=round(127/255)*255 = R(255,127,127)然后利用得到的索引值去mapArray数组中查询对应地方的颜色得到最终RGB是(0.0,0.5,0.5)，最后将得到的结果进行处理并绘制出来。
#!/usr/bin/env python
# -*- coding: utf-8 -*-
import sys
from OpenGL.GL import *
from OpenGL.GLU import *
from OpenGL.GLUT import *
from PIL.Image import *
ix = 0
iy = 0
data = None
def gl_init():
glClearColor(0.0, 0.0, 0.0, 0.0)
image = open("textures/lzl.png")
global ix
global iy
ix = image.size[0]
iy = image.size[1]
global data
data = image.tobytes("raw", "RGBX", 0, -1)
glTexImage2D(GL_TEXTURE_2D, 0, 3, ix, iy, 0, GL_RGBA, GL_UNSIGNED_BYTE, data)
glTexParameterf(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_CLAMP)
glTexParameterf(GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_CLAMP)
glTexParameterf(GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_REPEAT)
glTexParameterf(GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_REPEAT)
glTexParameterf(GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST)
glTexParameterf(GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST)
glEnable(GL_TEXTURE_2D)
def keyboard(key, x, y):
global data
global ix
global iy
if key == ' ':
glPixelTransferi(GL_MAP_COLOR, GL_TRUE)
mapArray = [1];
for i in range(1, 256):
mapArray.append(1.0- ((1.0)/255.0)*i)
glPixelMapfv(GL_PIXEL_MAP_R_TO_R, 255, mapArray)
glPixelMapfv(GL_PIXEL_MAP_G_TO_G, 255, mapArray)
glPixelMapfv(GL_PIXEL_MAP_B_TO_B, 255, mapArray)
glTexImage2D(GL_TEXTURE_2D, 0, 3, ix, iy, 0, GL_RGBA, GL_UNSIGNED_BYTE, data)
glutPostRedisplay()
def display():
glClear(GL_COLOR_BUFFER_BIT|GL_DEPTH_BUFFER_BIT)
glLoadIdentity()
glTranslatef(0.0, 0.0, -3.0)
glBegin(GL_QUADS)
glTexCoord2f(0,0)
glVertex3f(-1, -1, 0)
glTexCoord2f(1,0)
glVertex3f(1, -1, 0)
glTexCoord2f(1,1)
glVertex3f(1, 1, 0)
glTexCoord2f(0,1)
glVertex3f(-1, 1, 0)
glEnd()
glutSwapBuffers()
def resize(w, h):
if h == 0:
h = 1
glViewport(0, 0, w, h)
global windowWidth
global windowHeight
windowWidth = w
windowHeight = h
glMatrixMode(GL_PROJECTION)
glLoadIdentity()
gluPerspective(45.0, float(w)/float(h), 0.001, 1000)
glMatrixMode(GL_MODELVIEW)
glLoadIdentity()
def main():
glutInit(sys.argv)
glutInitDisplayMode(GLUT_RGBA | GLUT_DEPTH | GLUT_DOUBLE)
glutInitWindowSize(640, 480)
glutInitWindowPosition(500, 500)
glutCreateWindow(u"OpenGL像素传输")
glutDisplayFunc(display)
glutReshapeFunc(resize)
glutKeyboardFunc(keyboard)
gl_init()
glutMainLoop()
if __name__ == '__main__':
main()