función glGetPixelMapuiv
Las funciones glGetPixelMapfv, glGetPixelMapuiv y glGetPixelMapusv devuelven el mapa de píxeles especificado.
Sintaxis
void WINAPI glGetPixelMapuiv(
GLenum map,
GLuint *values
);
Parámetros
-
map
-
Nombre del mapa de píxeles que se va a devolver. Los valores aceptados son 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, y GL_PIXEL_MAP_A_TO_A.
-
Valores
-
Devuelve el contenido del mapa de píxeles.
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. |
|
Se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd. |
Comentarios
Consulte glPixelMap para obtener una descripción de los valores aceptables para el parámetro map . La función glGetPixelMap devuelve en valores el contenido del mapa de píxeles especificado en el mapa. Use mapas de píxeles durante la ejecución de glReadPixels, glDrawPixels, glCopyPixels, glTexImage1D y glTexImage2D para asignar índices de color, índices de galería de símbolos, componentes de color y componentes de profundidad a otros valores.
Los valores enteros sin signo, si se solicitan, se asignan linealmente desde la representación interna fija o de punto flotante, de modo que 1,0 se asigna al valor entero representable más grande y 0,0 se asigna a cero. Los valores enteros sin signo no están definidos si el valor del mapa no estaba en el intervalo [0,1].
Para determinar el tamaño necesario del mapa, llame a glGet con la constante simbólica adecuada.
Si se genera un error, no se realiza ningún cambio en el contenido de los valores.
Las siguientes funciones recuperan información relacionada con glGetPixelMap:
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 |
|