Função glColorPointer
A função glColorPointer define uma matriz de cores.
Sintaxe
void WINAPI glColorPointer(
GLint size,
GLenum type,
GLsizei stride,
const GLvoid *pointer
);
Parâmetros
-
size
-
O número de componentes por cor. O valor deve ser 3 ou 4.
-
tipo
-
O tipo de dados de cada componente de cor em uma matriz de cores. Tipos de dados aceitáveis são especificados com as seguintes constantes: GL_BYTE, GL_UNSIGNED_BYTE, GL_SHORT, GL_UNSIGNED_SHORT, GL_INT, GL_UNSIGNED_INT, GL_FLOAT ou GL_DOUBLE.
-
Passo
-
O deslocamento de bytes entre cores consecutivas. Quando o passo é zero, as cores são bem embaladas na matriz.
-
pointer
-
Um ponteiro para o primeiro componente do primeiro elemento de cor em uma matriz de cores.
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 |
|---|---|
|
o tamanho não era 3 ou 4. |
|
type não era um valor aceito. |
|
stride ou count foi negativo. |
Comentários
A função glColorPointer especifica o local e o formato de dados de uma matriz de componentes de cor a serem usados durante a renderização. O parâmetro stride determina o deslocamento de bytes de uma cor para outra, permitindo o empacotamento de atributos de vértice em uma única matriz ou armazenamento em matrizes separadas. Em algumas implementações, armazenar atributos de vértice em uma única matriz pode ser mais eficiente do que o uso de matrizes separadas.
Habilitou a matriz de cores especificando a constante GL_COLOR_ARRAY com glEnableClientState. Chamar glArrayElement, glDrawElements ou glDrawArrays usa a matriz de cores habilitada. Por padrão, a matriz de cores está desabilitada. As chamadas glColorPointer não podem ser inseridas em listas de exibição.
Quando você especifica uma matriz de cores usando glColorPointer, os valores de todos os parâmetros de matriz de cores da função são salvos em um estado do lado do cliente e você pode armazenar em cache elementos de matriz estáticos. Como os parâmetros de matriz de cores estão em um estado do lado do cliente, glPushAttrib e glPopAttrib não salvam nem restauram os valores dos parâmetros.
Embora a especificação da matriz de cores nos pares glBegin e glend não gere um erro, os resultados são indefinidos.
As seguintes funções recuperam informações relacionadas à função glColorPointer :
glIsEnabled com GL_COLOR_ARRAY de argumento
glGet com GL_COLOR_ARRAY_SIZE de argumento
glGet com GL_COLOR_ARRAY_TYPE de argumento
glGet com GL_COLOR_ARRAY_STRIDE de argumento
glGet com GL_COLOR_ARRAY_COUNT de argumento
glGetPointerv com GL_COLOR_ARRAY_POINTER 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 |
|