fonction glColorMaterial

La fonction glColorMaterial entraîne le suivi de la couleur actuelle par une couleur de matériau.

Syntaxe

void WINAPI glColorMaterial(
   GLenum face,
   GLenum mode
);

Paramètres

Visage

Spécifie si les paramètres de matériau avant, arrière ou avant et arrière doivent suivre la couleur actuelle. Les valeurs acceptées sont GL_FRONT, GL_BACK et GL_FRONT_AND_BACK. La valeur par défaut est GL_FRONT_AND_BACK.

mode

Spécifie lequel des paramètres de matériau effectue le suivi de la couleur actuelle. Les valeurs acceptées sont GL_EMISSION, GL_AMBIENT, GL_DIFFUSE, GL_SPECULAR et GL_AMBIENT_AND_DIFFUSE. La valeur par défaut est GL_AMBIENT_AND_DIFFUSE.

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Codes d’erreur

Les codes d’erreur suivants peuvent être récupérés par la fonction glGetError .

Name Signification
GL_INVALID_ENUM
face ou mode n’était pas une valeur acceptée.
GL_INVALID_OPERATION
La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd.

Notes

La fonction glColorMaterial spécifie les paramètres de matériau qui suivent la couleur actuelle. Lorsque vous activez GL_COLOR_MATERIAL, pour chacun des matériaux spécifiés par la face, le ou les paramètres de matériau spécifiés par le mode suivent la couleur actuelle à tout moment. Activez et désactivez GL_COLOR_MATERIAL avec les fonctions glEnable et glDisable, que vous appelez avec GL_COLOR_MATERIAL comme argument. Par défaut, GL_COLOR_MATERIAL est désactivé.

Avec glColorMaterial, vous pouvez modifier un sous-ensemble de paramètres de matériau pour chaque sommet en utilisant uniquement la fonction glColor , sans appeler glMaterial. Si vous souhaitez spécifier uniquement un tel sous-ensemble de paramètres pour chaque sommet, il est préférable de le faire avec glColorMaterial plutôt qu’avec glMaterial.

Les fonctions suivantes récupèrent des informations relatives à glColorMaterial :

glGet avec argument GL_COLOR_MATERIAL_PARAMETER

glGet avec argument GL_COLOR_MATERIAL_FACE

glIsEnabled avec argument GL_COLOR_MATERIAL

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge
Windows 2000 Server [applications de bureau uniquement]
En-tête
Gl.h
Bibliothèque
Opengl32.lib
DLL
Opengl32.dll

Voir aussi

glBegin

glColor

glDisable

glEnable

glEnd

glGet

glIsEnabled

glLight

glLightModel

glMaterial