Función glColorMaterial
La función glColorMaterial hace que un color de material realice un seguimiento del color actual.
Sintaxis
void WINAPI glColorMaterial(
GLenum face,
GLenum mode
);
Parámetros
-
Cara
-
Especifica si los parámetros de material frontal, trasero o frontal y posterior deben realizar un seguimiento del color actual. Los valores aceptados son GL_FRONT, GL_BACK y GL_FRONT_AND_BACK. El valor predeterminado es GL_FRONT_AND_BACK.
-
mode
-
Especifica cuál de varios parámetros de material realiza un seguimiento del color actual. Los valores aceptados son GL_EMISSION, GL_AMBIENT, GL_DIFFUSE, GL_SPECULAR y GL_AMBIENT_AND_DIFFUSE. El valor predeterminado es GL_AMBIENT_AND_DIFFUSE.
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 |
|---|---|
|
face o mode no era un valor aceptado. |
|
Se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd. |
Comentarios
La función glColorMaterial especifica qué parámetros de material realizan un seguimiento del color actual. Al habilitar GL_COLOR_MATERIAL, para cada uno de los materiales o materiales especificados por cara, el parámetro de material o los parámetros especificados por el modo realizan un seguimiento del color actual en todo momento. Habilite y deshabilite GL_COLOR_MATERIAL con las funciones glEnable y glDisable, a las que se llama con GL_COLOR_MATERIAL como argumento. De forma predeterminada, GL_COLOR_MATERIAL está deshabilitado.
Con glColorMaterial, puede cambiar un subconjunto de parámetros de material para cada vértice usando solo la función glColor , sin llamar a glMaterial. Si solo va a especificar este subconjunto de parámetros para cada vértice, es mejor hacerlo con glColorMaterial que con glMaterial.
Las siguientes funciones recuperan información relacionada con glColorMaterial:
glGet con GL_COLOR_MATERIAL_PARAMETER de argumentos
glGet con GL_COLOR_MATERIAL_FACE de argumentos
glIsEnabled con GL_COLOR_MATERIAL de argumentos
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 |
|