Função glColor3iv
Define a cor atual de uma matriz já existente de valores de cor.
void WINAPI glColor3iv(
const GLint *v
);
-
v
-
Um ponteiro para uma matriz que contém valores vermelhos, verdes e azuis.
Essa função não retorna um valor.
O GL armazena um índice de cor de valor único atual e uma cor RGBA de quatro valores atual. glcolor define uma nova cor RGBA com quatro valores. glcolor tem duas variantes principais: glcolor3 e glcolor4. As variantes glcolor3 especificam os novos valores vermelho, verde e azul explicitamente e definem o valor alfa atual como 1,0 (intensidade total) implicitamente. As variantes glcolor4 especificam explicitamente todos os quatro componentes de cor.
glcolor3b, glcolor4b, glcolor3s, glcolor4s, glcolor3i e glcolor4i tomam três ou quatro inteiros assinados, curtos ou longos como argumentos. Quando v é acrescentado ao nome, os comandos de cor podem levar um ponteiro para uma matriz desses valores.
Os valores de cor atuais são armazenados no formato de ponto flutuante, com mantissa e tamanhos expoentes não especificados. Componentes de cor de inteiro sem sinal, quando especificados, são mapeados linearmente para valores de ponto flutuante, de modo que o maior valor representável mapeia para 1,0 (intensidade total) e 0 mapeia para 0,0 (intensidade zero). Os componentes de cor de inteiro com sinal, quando especificados, são mapeados linearmente para valores de ponto flutuante, de modo que o valor representável mais positivo mapeia para 1,0 e o valor representável mais negativo é mapeado para -1,0. (Observe que esse mapeamento não converte 0 precisamente em 0.0.) Os valores de ponto flutuante são mapeados diretamente.
Nem valores inteiros de ponto flutuante nem com sinal são fixados no intervalo [0,1] antes que a cor atual seja atualizada. No entanto, os componentes de cor são fixados a esse intervalo antes de serem interpolados ou gravados em um buffer de cores.
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 |
|