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
GL_INVALID_ENUM	face o mode no era un valor aceptado.
GL_INVALID_OPERATION	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	Gl.h
Biblioteca	Opengl32.lib
Archivo DLL	Opengl32.dll

Consulte también

glBegin

glColor

glDisable

glEnable

glEnd

glGet

glIsEnabled

glLight

glLightModel

glMaterial