fonction glGetMaterialiv

Les fonctions glGetMaterialfv et glGetMaterialiv retournent des paramètres de matériau.

Syntaxe

void WINAPI glGetMaterialiv(
   GLenum face,
   GLenum pname,
   GLint  *params
);

Paramètres

Visage

Spécifie lequel des deux matériaux est interrogé. GL_FRONT ou GL_BACK sont acceptés, représentant les matériaux avant et arrière, respectivement.

pname

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

Valeur	Signification
GL_AMBIENT	Le paramètre params retourne quatre valeurs entières ou à virgule flottante représentant la réflectance ambiante du matériau. Les valeurs entières, quand elles sont demandées, sont mappées de manière linéaire à partir de la représentation à virgule flottante interne, de sorte que 1,0 est mappé à 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 entière correspondante n’est pas définie.
GL_DIFFUSE	Le paramètre params retourne quatre valeurs entières ou à virgule flottante représentant la réflectance diffuse du matériau. Les valeurs entières, quand elles sont demandées, sont mappées de manière linéaire à partir de la représentation à virgule flottante interne, de sorte que 1,0 est mappé à 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 entière correspondante n’est pas définie.
GL_SPECULAR	Le paramètre params retourne quatre valeurs entières ou à virgule flottante représentant la réflexion spéculaire du matériau. Les valeurs entières, quand elles sont demandées, sont mappées de manière linéaire à partir de la représentation à virgule flottante interne, de sorte que 1,0 est mappé à 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 entière correspondante n’est pas définie.
GL_EMISSION	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 manière linéaire à partir de la représentation à virgule flottante interne, de sorte que 1,0 est mappé à 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 entière correspondante n’est pas définie.
GL_SHININESS	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.
GL_COLOR_INDEXES	Le paramètre params retourne trois valeurs entières ou à virgule flottante représentant les index ambiants, diffus et spéculaires du matériau. Utilisez ces index uniquement pour l’éclairage d’index de couleur. (Les autres paramètres sont tous 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 interne 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 .

Notes

La fonction glGetMaterial retourne dans params la ou les valeurs du paramètre pname de la face de matériau.

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

Spécifications

Voir aussi

glBegin

glEnd

glMaterial