P
glPixelMap
Chapter 14
324
glPixelMap
glPixelMapfv, glPixelMapuiv, glPixelMapusv: set up pixel transfer maps.
C Specification
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)
Parameters
map Specifies a symbolic map name. Must be one of the following:
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, or GL_PIXEL_MAP_A_TO_A.
mapsize Specifies the size of the map being defined.
values Specifies an array of mapsize values.
Description
glPixelMap sets up translation tables, or maps, used by glCopyPixels,
glCopyTexImage1D, glCopyTexImage2D, glCopyTexSubImage1D,
glCopyTexSubImage2D, glDrawPixels, glReadPixels, glTexImage1D, glTexImage2D,
glTexSubImage1D, and glTexSubImage2D. Use of these maps is described completely in
the glPixelTransfer reference page, and partly in the reference pages for the pixel and
texture image commands. Only the specification of the maps is described in this
reference page.
map is a symbolic map name, indicating one of ten maps to set.
mapsize specifies the number of entries in the map, and values is a pointer to an array of
mapsize map values.
The ten maps are as follows:
GL_PIXEL_MAP_I_TO_I
Maps color indices to color indices.
GL_PIXEL_MAP_S_TO_S
Maps stencil indices to stencil indices.