función glColorPointer
La función glColorPointer define una matriz de colores.
Sintaxis
void WINAPI glColorPointer(
GLint size,
GLenum type,
GLsizei stride,
const GLvoid *pointer
);
Parámetros
-
size
-
Número de componentes por color. El valor debe ser 3 o 4.
-
type
-
Tipo de datos de cada componente de color en una matriz de colores. Los tipos de datos aceptables se especifican con las siguientes constantes: GL_BYTE, GL_UNSIGNED_BYTE, GL_SHORT, GL_UNSIGNED_SHORT, GL_INT, GL_UNSIGNED_INT, GL_FLOAT o GL_DOUBLE.
-
Paso
-
Desplazamiento de bytes entre colores consecutivos. Cuando el paso es cero, los colores se empaquetan estrechamente en la matriz.
-
pointer
-
Puntero al primer componente del primer elemento de color de una matriz de colores.
Valor devuelto
Esta función no devuelve ningún valor.
Códigos de error
La función glGetError puede recuperar los siguientes códigos de error.
| Nombre | Significado |
|---|---|
|
el tamaño no era 3 o 4. |
|
type no era un valor aceptado. |
|
stride o count fue negativo. |
Comentarios
La función glColorPointer especifica la ubicación y el formato de datos de una matriz de componentes de color que se van a usar al representar. El parámetro stride determina el desplazamiento de bytes de un color al siguiente, lo que permite el empaquetado de atributos de vértice en una sola matriz o almacenamiento en matrices independientes. En algunas implementaciones, el almacenamiento de atributos de vértice en una sola matriz puede ser más eficaz que el uso de matrices independientes.
Habilite la matriz de colores especificando la constante GL_COLOR_ARRAY con glEnableClientState. Al llamar a glArrayElement, glDrawElements o glDrawArrays , se usa la matriz de colores que, por tanto, está habilitada. De forma predeterminada, la matriz de colores está deshabilitada. Las llamadas glColorPointer no se pueden escribir en listas para mostrar.
Cuando se especifica una matriz de colores mediante glColorPointer, los valores de todos los parámetros de matriz de colores de la función se guardan en un estado del lado cliente y se pueden almacenar en caché elementos de matriz estáticos. Dado que los parámetros de la matriz de colores están en un estado del lado cliente, glPushAttrib y glPopAttrib no guardan ni restauran los valores de los parámetros.
Aunque especificar la matriz de colores en pares glBegin y glend no genera un error, los resultados no están definidos.
Las siguientes funciones recuperan información relacionada con la función glColorPointer :
glIsEnabled con GL_COLOR_ARRAY de argumento
glGet con GL_COLOR_ARRAY_SIZE de argumentos
glGet con GL_COLOR_ARRAY_TYPE de argumentos
glGet con GL_COLOR_ARRAY_STRIDE de argumentos
glGet con GL_COLOR_ARRAY_COUNT de argumentos
glGetPointerv con GL_COLOR_ARRAY_POINTER de argumento
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows 2000 Server [solo aplicaciones de escritorio] |
| Encabezado |
|
| Biblioteca |
|
| Archivo DLL |
|