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 |
|---|---|
|
face ou mode n’était pas une valeur acceptée. |
|
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 |
|
| Bibliothèque |
|
| DLL |
|