Función glGetPixelMapfv

Las funciones glGetPixelMapfv, glGetPixelMapuiv y glGetPixelMapusv devuelven el mapa de píxeles especificado.

Sintaxis

void WINAPI glGetPixelMapfv(
   GLenum  map,
   GLfloat *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
GL_INVALID_ENUM
map no era un valor aceptado.
GL_INVALID_OPERATION
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
Gl.h
Biblioteca
Opengl32.lib
Archivo DLL
Opengl32.dll

Consulte también

glBegin

glCopyPixels

glDrawPixels

glEnd

glGet

glPixelMap

glPixelTransfer

glReadPixels

glTexImage1D

glTexImage2D