Função glColor3usv

Define a cor atual de uma matriz já existente de valores de cor.

Sintaxe

void WINAPI glColor3usv(
   const GLushort *v
);

Parâmetros

v

Um ponteiro para uma matriz que contém valores vermelhos, verdes e azuis.

Retornar valor

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

Comentários

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.

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

glEnd

glGetBooleanv, glGetDoublev, glGetFloatv, glGetIntegerv

glIndex