Gl.ColorMaterial (gb.opengl)
Static Sub ColorMaterial ( Face As Integer, Mode As Integer )
Force un matériau à adopter la couleur courante
Paramètres
- face
-
Spécifie quel paramètre de matériau, front (de face), back (de dos), ou les deux doivent adopter la couleur courante. Les valeurs acceptées sont Gl.FRONT, Gl.BACK, et Gl.FRONT_AND_BACK. La valeur initiale est Gl.FRONT_AND_BACK.
- mode
-
Spécifie lequel, parmi plusieurs paramètres de matériau, doit suivre la couleur courante. Les valeurs acceptées sont Gl.EMISSION, Gl.AMBIENT, Gl.DIFFUSE, Gl.SPECULAR, et Gl.AMBIENT_AND_DIFFUSE. La valeur initiale est Gl.AMBIENT_AND_DIFFUSE.
Description
Gl.ColorMaterial spécifie quel paramètre de matériau, suit la couleur courante. Quand
Gl.COLOR_MATERIAL est activé, le ou les paramètres spécifiés par
Mode, du ou des matériaux spécifiés par
Face, adopte(nt) tout le temps la couleur courante.
Gl.COLOR_MATERIAL est activée ou désactivée avec les commandes respectives
Gl.Enable et
Gl.Disable, appelées avec l’ argument Gl.COLOR_MATERIAL. Gl.COLOR_MATERIAL est initialement désactivée.
Notes
Gl.ColorMaterial permet de changer un sous ensemble du jeu de paramètres de matériau, pour chaque sommet, en n’utilisant que la commande
Gl.Color, sans appeler Gl.Material.
Si un seul de ces sous ensembles de paramètres doit être spécifié pour chaque sommet, l’appel de
Gl.ColorMaterial est préférable à celui de Gl.Material.
Appeler
Gl.ColorMaterial avant d’activer les appels à Gl.DrawElements, Gl.DrawArrays, ou Gl.DrawRangeElements peuvent laisser la couleur courante indéterminée, si le tableau color est activé.
Si
Gl.ColorMaterial est activé alors que la couleur courante est indéterminée, l’état d’éclairement du matériau spécifié par
face et
mode est également indéterminé.
Si la version de GL est 1.1 ou plus, et si
Gl.COLOR_MATERIAL est activé, les valeurs de couleur évaluées affectent le résultat de l’équation d’éclairage comme si la couleur courante avait été modifiée, mais aucun changement du paramètre de poursuite d’éclairage de la couleur courante n’est effectué .
Erreurs
Gl.INVALID_ENUM est générée si face ou mode n’est pas une valeur acceptée.
Gl.INVALID_OPERATION est générée si Gl.ColorMaterial est appelée entre un appel à
Gl.Begin et l’appel correspondant à
Gl.End.
Gets Associés
Gl.IsEnabled avec l’argument
Gl.COLOR_MATERIAL
Gl.Get avec l’argument
Gl.COLOR_MATERIAL_PARAMETER
Gl.Get avec l’argument
Gl.COLOR_MATERIAL_FACE
Voir aussi
Gl.ColorPointer,
Gl.DrawArrays,
Gl.DrawElements,
Gl.DrawRangeElements,
Gl.Light,
Gl.LightModel,
Gl.Material