Función glPixelMapusv
La función glPixelMapusv configura mapas de transferencia de píxeles.
Sintaxis
void WINAPI glPixelMapusv(
GLenum map,
GLsizei mapsize,
const GLushort *values
);
Parámetros
-
map
-
Un nombre de mapa simbólico. Los diez mapas son los siguientes.
Value Significado - GL_PIXEL_MAP_I_TO_I
Asigna índices de color a índices de color. - GL_PIXEL_MAP_S_TO_S
Asigna índices de galería de símbolos a índices de galería de símbolos. - GL_PIXEL_MAP_I_TO_R
Asigna índices de color a componentes rojos. - GL_PIXEL_MAP_I_TO_G
Asigna índices de color a componentes verdes. - GL_PIXEL_MAP_I_TO_B
Asigna índices de color a componentes azules. - GL_PIXEL_MAP_I_TO_A
Asigna índices de color a componentes alfa. - GL_PIXEL_MAP_R_TO_R
Asigna componentes rojos a componentes rojos. - GL_PIXEL_MAP_G_TO_G
Asigna componentes verdes a componentes verdes. - GL_PIXEL_MAP_B_TO_B
Asigna componentes azules a componentes azules. - GL_PIXEL_MAP_A_TO_A
Asigna componentes alfa a componentes alfa. -
mapsize
-
Tamaño del mapa que se va a definir.
-
Valores
-
Matriz de asignaciones de valores.
Valor devuelto
Esta función no devuelve ningún valor.
Códigos de error
La función glGetError puede recuperar los siguientes códigos de error.
| Nombre | Significado |
|---|---|
|
map no era un valor aceptado. |
|
mapsize era negativo o mayor que GL_PIXEL_MAP_TABLE. |
|
map era 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 o GL_PIXEL_MAP_I_TO_A, y mapsize no era una potencia de dos. |
|
Se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd. |
Comentarios
La función glPixelMap configura tablas de traducción, o mapas, usados por glCopyPixels, glCopyTexImage1D, glCopyTexImage2D, glCopyTexSubImage1D, glCopyTexSubImage2D, glDrawPixels, glReadPixels, glTexImage1D, glTexImage2D, glTexSubImage1D y glTexSubImage2D. El uso de estos mapas se describe por completo en el tema glPixelTransfer y, en parte, en los temas de los comandos de imagen de píxeles y texturas. En este tema solo se describe la especificación de los mapas.
El parámetro map es un nombre de mapa simbólico, que indica uno de diez mapas que se van a establecer. El parámetro mapsize especifica el número de entradas del mapa y los valores son un puntero a una matriz de valores de mapa de asignaciones .
Las entradas de un mapa se pueden especificar como números de punto flotante de precisión sencilla, enteros cortos sin signo o enteros largos sin signo. Los mapas que almacenan valores de componentes de color (todos pero GL_PIXEL_MAP_I_TO_I y GL_PIXEL_MAP_S_TO_S) conservan sus valores en formato de punto flotante, con tamaños de mantisa y exponente no especificados. Los valores de punto flotante especificados por glPixelMapfv se convierten directamente en el formato de punto flotante interno de estos mapas y, a continuación, se sujetan al intervalo [0,1]. Los valores enteros sin signo especificados por glPixelMapusv y glPixelMapuiv se convierten linealmente de modo que el entero más grande representable se asigna a 1,0 y cero se asigna a 0,0.
Asigna que almacenan índices, GL_PIXEL_MAP_I_TO_I y GL_PIXEL_MAP_S_TO_S, conservan sus valores en formato de punto fijo, con un número no especificado de bits a la derecha del punto binario. Los valores de punto flotante especificados por glPixelMapfv se convierten directamente en el formato de punto fijo interno de estos mapas. Los valores enteros sin signo especificados por glPixelMapusv y glPixelMapuiv especifican valores enteros, con todos los ceros a la derecha del punto binario.
En la tabla siguiente se muestran los tamaños iniciales y los valores de cada uno de los mapas. Las asignaciones indizada por índices de color o galería de símbolos deben tener mapsize = 2 ^ n para algunos n o resultados no están definidos. El tamaño máximo permitido para cada mapa depende de la implementación y se puede determinar llamando a glGet con el argumento GL_MAX_PIXEL_MAP_TABLE. El máximo único se aplica a todos los mapas y es al menos 32.
| Asignación | Índice de búsqueda | Valor de búsqueda | Tamaño inicial | Valor inicial |
|---|---|---|---|---|
| GL_PIXEL_MAP_I_TO_I | índice de color | índice de color | 1 | 0,0 |
| GL_PIXEL_MAP_S_TO_S | índice de galería de símbolos | índice de galería de símbolos | 1 | 0,0 |
| GL_PIXEL_MAP_I_TO_R | índice de color | R | 1 | 0,0 |
| GL_PIXEL_MAP_I_TO_G | índice de color | G | 1 | 0,0 |
| GL_PIXEL_MAP_I_TO_B | índice de color | B | 1 | 0,0 |
| GL_PIXEL_MAP_I_TO_A | índice de color | A | 1 | 0,0 |
| GL_PIXEL_MAP_R_TO_R | R | R | 1 | 0,0 |
| GL_PIXEL_MAP_G_TO_G | G | G | 1 | 0,0 |
| GL_PIXEL_MAP_B_TO_B | B | B | 1 | 0,0 |
| GL_PIXEL_MAP_A_TO_A | A | A | 1 | 0,0 |
Las siguientes funciones recuperan información relacionada con glPixelMap:
glGet con GL_PIXEL_MAP_I_TO_I_SIZE de argumentos
glGet con GL_PIXEL_MAP_S_TO_S_SIZE de argumentos
glGet con GL_PIXEL_MAP_I_TO_R_SIZE de argumentos
glGet con GL_PIXEL_MAP_I_TO_G_SIZE de argumentos
glGet con GL_PIXEL_MAP_I_TO_B_SIZE de argumentos
glGet con GL_PIXEL_MAP_I_TO_A_SIZE de argumentos
glGet con GL_PIXEL_MAP_R_TO_R_SIZE de argumentos
glGet con GL_PIXEL_MAP_G_TO_G_SIZE de argumentos
glGet con GL_PIXEL_MAP_B_TO_B_SIZE de argumentos
glGet con GL_PIXEL_MAP_A_TO_A_SIZE de argumentos
glGet con GL_MAX_PIXEL_MAP_TABLE de argumentos
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows 2000 Server [solo aplicaciones de escritorio] |
| Encabezado |
|
| Biblioteca |
|
| Archivo DLL |
|