glGetLightiv, fonction

Les fonctions glGetLightfv et glGetLightiv retournent les valeurs des paramètres de source lumineuse.

Syntaxe

void WINAPI glGetLightiv(
   GLenum light,
   GLenum pname,
   GLint  *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, lorsqu’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 correspond à la valeur entière représentable la plus positive et que -1.0 correspond à la valeur entière représentable la plus négative. Si la valeur interne se trouve 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 renvoie quatre valeurs entières ou à virgule flottante représentant l’intensité diffuse de la source de lumière. Les valeurs entières, lorsqu’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 correspond à la valeur entière représentable la plus positive et que -1.0 correspond à la valeur entière représentable la plus négative. Si la valeur interne se trouve 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 renvoie quatre valeurs entières ou à virgule flottante représentant l’intensité spéculaire de la source de lumière. Les valeurs entières, lorsqu’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 correspond à la valeur entière représentable la plus positive et que -1.0 correspond à la valeur entière représentable la plus négative. Si la valeur interne se trouve 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, lorsqu’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 dans les 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, lorsqu’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 dans les 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 renvoie un entier unique ou une valeur à virgule flottante représentant l’exposant spot de la lumière. Une valeur entière, lorsqu’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 retourne une seule valeur entière ou à virgule flottante représentant l’angle de coupure spot de la lumière. Une valeur entière, lorsqu’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, lorsqu’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 une seule valeur entière ou à virgule flottante représentant l’atténuation linéaire de la lumière. Une valeur entière, lorsqu’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 renvoie un entier unique ou une valeur à virgule flottante représentant l’atténuation quadratique de la lumière. Une valeur entière, lorsqu’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 vrai 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