glMaterialf, fonction
La fonction glMaterialf spécifie les paramètres de matériau pour le modèle d’éclairage.
Syntaxe
void WINAPI glMaterialf(
GLenum face,
GLenum pname,
GLfloat 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 une valeur à virgule flottante 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 |
|---|---|
|
Face oupname n’était pas une valeur acceptée. |
|
Un exposant spéculaire en dehors de la plage de [0, 128] a été spécifié. |
Notes
La fonction glMaterialf 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 glMaterialf 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, glMaterialf peut être appelé entre un appel à glBegin et l’appel correspondant à glEnd. Toutefois, si un seul paramètre de matériau doit être modifié par sommet, glColorMaterial est préféré à glMaterialf.
La fonction suivante récupère les informations relatives à glMaterialf :
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 |
|