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 |
|---|---|
|
map não era um valor aceito. |
|
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 |
|
| Biblioteca |
|
| DLL |
|