glMateriali, fonction

La fonctionglMateriali spécifie les paramètres de matériau pour le modèle d’éclairage.

Syntaxe

void WINAPI glMateriali(
   GLenum face,
   GLenum pname,
   GLint  param
);

Paramètres

Visage

Visages en cours de mise à jour. Doit être l’un des éléments suivants : GL_FRONT, GL_BACK ou GL_FRONT et GL_BACK.

pname

Paramètre de matériau à valeur unique du ou des visages en cours de mise à jour. Doit être GL_SHININESS.

Valeur	Signification
GL_SHININESS	Le paramètre param est un entier unique qui spécifie l’exposant spéculaire RVBA du matériau. Les valeurs entières sont mappées directement. Seules les valeurs de la plage [0, 128] sont acceptées. L’exposant spéculaire par défaut pour les matériaux à l’avant et à l’arrière est 0.

param

Valeur à laquelle le paramètre GL_SHININESS sera défini.

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 .

Nom	Signification
GL_INVALID_ENUM	Face oupname n’était pas une valeur acceptée.
GL_INVALID_VALUE	Un exposant spéculaire en dehors de la plage de [0, 128] a été spécifié.

Notes

La fonction glMateriali affecte des valeurs aux paramètres de matériau. Il existe deux ensembles de paramètres de matériau correspondants. L’un, l’ensemble avant , est utilisé pour ombrage des points, des lignes, des bitmaps et tous les polygones (lorsque l’éclairage à deux côtés est désactivé), ou simplement les polygones avant (lorsque l’éclairage double face est activé). L’autre ensemble, orienté vers l’arrière, est utilisé pour ombrage des polygones arrière uniquement lorsque l’éclairage recto verso est activé. Reportez-vous à glLightModel pour plus d’informations sur les calculs d’éclairage un et deux côtés.

La fonction glMateriali prend trois arguments. La première, face, spécifie si les matériaux GL_FRONT, les matériaux GL_BACK ou les deux matériaux GL_FRONT_AND_BACK seront modifiés. Le second, pname, spécifie lequel des paramètres d’un ou des deux ensembles sera modifié. Le troisième, param, spécifie la valeur qui sera affectée au paramètre spécifié.

Les paramètres de matériau sont utilisés dans l’équation d’éclairage qui est éventuellement appliquée à chaque sommet. L’équation est décrite dans glLightModel.

Les paramètres matériels peuvent être mis à jour à tout moment. En particulier, glMateriali peut être appelé entre un appel à glBegin et l’appel à glEnd correspondant. Toutefois, si un seul paramètre de matériau doit être modifié par sommet, glColorMaterial est préféré à glMateriali.

La fonction suivante récupère les informations relatives à glMateriali :

glGetMaterial

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

glColorMaterial

glLight

glLightModel