Documentation de Gambas - /comp/gb.opengl/gl/colormaterial

/comp/gb.opengl/gl/colormaterial

# 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.Color,

Gl.ColorPointer, Gl.DrawArrays, Gl.DrawElements, Gl.DrawRangeElements,

- Gl.Enable,

Gl.Light, Gl.LightModel, Gl.Material

Voir documentation originale sur le site OpenGL