glGetMaterialfv fonction)

Les fonctions glGetMaterialfv et glGetMaterialiv retournent des paramètres Material.

Syntaxe

void WINAPI glGetMaterialfv(
   GLenum  face,
   GLenum  pname,
   GLfloat *params
);

Paramètres

se

Spécifie les deux documents en cours d’interrogation. _Les arrière-plan _ du GL ou du GL sont acceptés, représentant respectivement les matériaux avant et arrière.

pname

Paramètre Material à retourner. Les valeurs suivantes sont acceptées.

Valeur Signification
ambiant du GL _
Le paramètre params retourne quatre valeurs entières ou à virgule flottante représentant la réflexion ambiante du matériau. Les valeurs entières, quand elles sont demandées, sont mappées de façon linéaire à partir de la représentation interne à virgule flottante, de sorte que 1,0 correspond à la valeur entière représentable la plus positive, et-1,0 correspond à la valeur entière représentable la plus négative. Si la valeur interne est en dehors de la plage [ -1, 1 ] , la valeur de retour de l’entier correspondant n’est pas définie.
_diffusion GL
Le paramètre params retourne quatre valeurs entières ou à virgule flottante représentant la réflexion diffuse du matériau. Les valeurs entières, quand elles sont demandées, sont mappées de façon linéaire à partir de la représentation interne à virgule flottante, de sorte que 1,0 correspond à la valeur entière représentable la plus positive, et-1,0 correspond à la valeur entière représentable la plus négative. Si la valeur interne est en dehors de la plage [ -1, 1 ] , la valeur de retour de l’entier correspondant n’est pas définie.
_spéculaire GL
Le paramètre params retourne quatre valeurs entières ou à virgule flottante représentant la réflectivité spéculaire du matériau. Les valeurs entières, quand elles sont demandées, sont mappées de façon linéaire à partir de la représentation interne à virgule flottante, de sorte que 1,0 correspond à la valeur entière représentable la plus positive, et-1,0 correspond à la valeur entière représentable la plus négative. Si la valeur interne est en dehors de la plage [ -1, 1 ] , la valeur de retour de l’entier correspondant n’est pas définie.
_émission GL
Le paramètre params retourne quatre valeurs entières ou à virgule flottante représentant l’intensité lumineuse émise du matériau. Les valeurs entières, quand elles sont demandées, sont mappées de façon linéaire à partir de la représentation interne à virgule flottante, de sorte que 1,0 correspond à la valeur entière représentable la plus positive, et-1,0 correspond à la valeur entière représentable la plus négative. Si la valeur interne est en dehors de la plage [ -1, 1 ] , la valeur de retour de l’entier correspondant n’est pas définie.
_éclat GL
Le paramètre params retourne un entier ou une valeur à virgule flottante représentant l’exposant spéculaire du matériau. Les valeurs entières, quand elles sont demandées, sont calculées en arrondissant la valeur à virgule flottante interne à la valeur entière la plus proche.
_index de couleurs GL _
Le paramètre params retourne trois valeurs entières ou à virgule flottante représentant les index ambiant, diffus et spéculaire du matériau. Utilisez ces index uniquement pour l’éclairage d’index de couleurs. (Les autres paramètres sont utilisés uniquement pour l’éclairage RVBA.) Les valeurs entières, quand elles sont demandées, sont calculées en arrondissant les valeurs à virgule flottante internes aux valeurs entières les plus proches.

params

Retourne les données demandées.

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
_enum GL non valide _
la cible ou la requête n’était pas une valeur acceptée.
_opération non valide du GL _
La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd.

Notes

La fonction glGetMaterial retourne dans les paramètres la valeur ou les valeurs du paramètre pname de la facette matérielle.

Si une erreur est générée, aucune modification n’est apportée au contenu des paramètres.

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

glBegin

glEnd

glMaterial