Função glGetPixelMapusv

As funções glGetPixelMapfv, glGetPixelMapuiv e glGetPixelMapusv retornam o mapa de pixel especificado.

Sintaxe

void WINAPI glGetPixelMapusv(
   GLenum   map,
   GLushort *values
);

Parâmetros

map

O nome do mapa de pixel a ser retornado. Os valores aceitos são 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, e GL_PIXEL_MAP_A_TO_A.

Valores

Retorna o conteúdo do mapa de pixels.

Retornar valor

Essa função não retorna um valor.

Códigos de erro

Os códigos de erro a seguir podem ser recuperados pela função glGetError .

Nome	Significado
GL_INVALID_ENUM	map não era um valor aceito.
GL_INVALID_OPERATION	A função foi chamada entre uma chamada para glBegin e a chamada correspondente para glEnd.

Comentários

Consulte glPixelMap para obter uma descrição dos valores aceitáveis para o parâmetro de mapa . A função glGetPixelMap retorna em valores o conteúdo do mapa de pixel especificado no mapa. Use mapas de pixel durante a execução de glReadPixels, glDrawPixels, glCopyPixels, glTexImage1D e glTexImage2D para mapear índices de cores, índices de estêncil, componentes de cor e componentes de profundidade para outros valores.

Os valores inteiros sem sinal, se solicitados, são mapeados linearmente da representação interna de ponto fixo ou flutuante, de modo que 1,0 mapeia para o maior valor inteiro representável e 0,0 é mapeado para zero. Retornar valores inteiros sem sinal será indefinido se o valor do mapa não estiver no intervalo [0,1].

Para determinar o tamanho necessário do mapa, chame glGet com a constante simbólica apropriada.

Se um erro for gerado, nenhuma alteração será feita no conteúdo dos valores.

As seguintes funções recuperam informações relacionadas ao glGetPixelMap:

glGet com GL_PIXEL_MAP_I_TO_I_SIZE de argumento

glGet com GL_PIXEL_MAP_S_TO_S_SIZE de argumento

glGet com GL_PIXEL_MAP_I_TO_R_SIZE de argumento

glGet com GL_PIXEL_MAP_I_TO_G_SIZE de argumento

glGet com GL_PIXEL_MAP_I_TO_B_SIZE de argumento

glGet com GL_PIXEL_MAP_I_TO_A_SIZE de argumento

glGet com GL_PIXEL_MAP_R_TO_R_SIZE de argumento

glGet com GL_PIXEL_MAP_G_TO_G_SIZE de argumento

glGet com GL_PIXEL_MAP_B_TO_B_SIZE de argumento

glGet com GL_PIXEL_MAP_A_TO_A_SIZE de argumento

glGet com GL_MAX_PIXEL_MAP_TABLE de argumento

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	Gl.h
Biblioteca	Opengl32.lib
DLL	Opengl32.dll

Confira também

glBegin

glCopyPixels

glDrawPixels

glEnd

glGet

glPixelMap

glPixelTransfer

glReadPixels

glTexImage1D

glTexImage2D