glGetLightfv, fonction

Article
06/13/2023

Les fonctions glGetLightfv et glGetLightiv retournent des valeurs de paramètres de source de lumière.

Syntaxe

void WINAPI glGetLightfv(
   GLenum  light,
   GLenum  pname,
   GLfloat *params
);

Paramètres

light

Une source de lumière. Le nombre de lumières possibles dépend de l’implémentation, mais au moins huit lumières sont prises en charge. Ils sont identifiés par des noms symboliques de la forme GL_LIGHT i où 0 = i< GL_MAX_LIGHTS.

pname

Paramètre de source de lumière pour la lumière. Les noms symboliques suivants sont acceptés.

Valeur	Signification
GL_AMBIENT	Le paramètre params retourne quatre valeurs entières ou à virgule flottante représentant l’intensité ambiante de la source de lumière. 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 l’intensité diffuse de la source de lumière. 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 l’intensité spéculaire de la source de lumière. 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_POSITION	Le paramètre params retourne quatre valeurs entières ou à virgule flottante représentant la position de la source de lumière. Les valeurs entières, quand elles sont demandées, sont calculées en arrondissant les valeurs à virgule flottante interne à la valeur entière la plus proche. Les valeurs retournées sont celles conservées en coordonnées oculaires. Elles ne sont pas égales aux valeurs spécifiées à l’aide de glLight, sauf si la matrice modelview a été identifiée au moment de l’appel de glLight .
GL_SPOT_DIRECTION	Le paramètre params retourne trois valeurs entières ou à virgule flottante représentant la direction de la source de lumière. Les valeurs entières, quand elles sont demandées, sont calculées en arrondissant les valeurs à virgule flottante interne à la valeur entière la plus proche. Les valeurs retournées sont celles conservées en coordonnées oculaires. Elles ne sont pas égales aux valeurs spécifiées à l’aide de glLight, sauf si la matrice modelview a été identifiée au moment de l’appel de glLight . Bien que la direction spot soit normalisée avant d’être utilisée dans l’équation d’éclairage, les valeurs retournées sont les versions transformées des valeurs spécifiées avant la normalisation.
GL_SPOT_EXPONENT	Le paramètre params retourne un entier unique ou une valeur à virgule flottante représentant l’exposant spot de la lumière. Une valeur entière, quand elle est demandée, est calculée en arrondissant la représentation à virgule flottante interne à l’entier le plus proche.
GL_SPOT_CUTOFF	Le paramètre params renvoie un entier unique ou une valeur à virgule flottante représentant l’angle de coupure de la lumière. Une valeur entière, quand elle est demandée, est calculée en arrondissant la représentation à virgule flottante interne à l’entier le plus proche.
GL_CONSTANT_ATTENUATION	Le paramètre params retourne un entier unique ou une valeur à virgule flottante représentant l’atténuation constante (et non liée à la distance) de la lumière. Une valeur entière, quand elle est demandée, est calculée en arrondissant la représentation à virgule flottante interne à l’entier le plus proche.
GL_LINEAR_ATTENUATION	Le paramètre params retourne un entier unique ou une valeur à virgule flottante représentant l’atténuation linéaire de la lumière. Une valeur entière, quand elle est demandée, est calculée en arrondissant la représentation à virgule flottante interne à l’entier le plus proche.
GL_QUADRATIC_ATTENUATION	Le paramètre params retourne un entier unique ou une valeur à virgule flottante représentant l’atténuation quadratique de la lumière. Une valeur entière, quand elle est demandée, est calculée en arrondissant la représentation à virgule flottante interne à l’entier le plus proche.

params

Retourne les données demandées.

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Notes

La fonction glGetLight retourne en params la ou les valeurs d’un paramètre de source de lumière. Le paramètre light nomme la lumière et est un nom symbolique de la forme GL_LIGHTi pour 0 = i< GL_MAX_LIGHTS, où GL_MAX_LIGHTS est une constante dépendante de l’implémentation supérieure ou égale à huit. Le paramètre pname spécifie l’un des dix paramètres de source de lumière, toujours par nom symbolique.

Il est toujours le cas que GL_LIGHTi = GL_LIGHT0 + i.

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
glLight

Share via