Structure D3DLIGHT9

Définit un ensemble de propriétés d’éclairage.

Syntaxe

typedef struct D3DLIGHT9 {
  D3DLIGHTTYPE  Type;
  D3DCOLORVALUE Diffuse;
  D3DCOLORVALUE Specular;
  D3DCOLORVALUE Ambient;
  D3DVECTOR     Position;
  D3DVECTOR     Direction;
  float         Range;
  float         Falloff;
  float         Attenuation0;
  float         Attenuation1;
  float         Attenuation2;
  float         Theta;
  float         Phi;
} D3DLIGHT9, *LPD3DLIGHT;

Membres

Type

Type : D3DLIGHTTYPE

Type de la source de lumière. Cette valeur est l’un des membres du type énuméré D3DLIGHTTYPE .

Diffus

Type : D3DCOLORVALUE

Couleur diffuse émise par la lumière. Ce membre est une structure D3DCOLORVALUE .

Spéculaire

Type : D3DCOLORVALUE

Couleur spéculaire émise par la lumière. Ce membre est une structure D3DCOLORVALUE .

Ambiant

Type : D3DCOLORVALUE

Couleur ambiante émise par la lumière. Ce membre est une structure D3DCOLORVALUE .

Position

Type : D3DVECTOR

Position de la lumière dans l’espace mondial, spécifiée par une structure D3DVECTOR . Ce membre n’a aucune signification pour les lumières directionnelles et est ignoré dans ce cas.

Sens

Type : D3DVECTOR

Direction vers laquelle la lumière pointe dans l’espace du monde, spécifiée par une structure D3DVECTOR . Ce membre n’a de sens que pour les directions et les projecteurs. Ce vecteur n’a pas besoin d’être normalisé, mais il doit avoir une longueur différente de zéro.

Plage

Type : float

Distance au-delà de laquelle la lumière n’a aucun effet. La valeur maximale autorisée pour ce membre est la racine carrée de FLT_MAX. Ce membre n’affecte pas les lumières directionnelles.

Diminution

Type : float

Diminution de l’éclairage entre le cône interne d’un projecteur (l’angle spécifié par Theta) et le bord externe du cône externe (angle spécifié par Phi).

L’effet des retombées sur l’éclairage est subtil. En outre, une petite pénalité de performances est encourue en mettant en forme la courbe de repli. Pour ces raisons, la plupart des développeurs définissent cette valeur sur 1.0.

Atténuation0

Type : float

Valeur spécifiant la façon dont l’intensité lumineuse change sur la distance. Les valeurs d’atténuation sont ignorées pour les lumières directionnelles. Ce membre représente une constante d’atténuation. Pour plus d’informations sur l’atténuation, consultez Propriétés de la lumière (Direct3D 9). Les valeurs valides pour ce membre vont de 0,0 à l’infini. Pour les lumières non directionnelles, les trois valeurs d’atténuation ne doivent pas être définies sur 0,0 en même temps.

Atténuation1

Type : float

Valeur spécifiant la façon dont l’intensité lumineuse change sur la distance. Les valeurs d’atténuation sont ignorées pour les lumières directionnelles. Ce membre représente une constante d’atténuation. Pour plus d’informations sur l’atténuation, consultez Propriétés de la lumière (Direct3D 9). Les valeurs valides pour ce membre vont de 0,0 à l’infini. Pour les lumières non directionnelles, les trois valeurs d’atténuation ne doivent pas être définies sur 0,0 en même temps.

Atténuation2

Type : float

Valeur spécifiant la façon dont l’intensité lumineuse change sur la distance. Les valeurs d’atténuation sont ignorées pour les lumières directionnelles. Ce membre représente une constante d’atténuation. Pour plus d’informations sur l’atténuation, consultez Propriétés de la lumière (Direct3D 9). Les valeurs valides pour ce membre vont de 0,0 à l’infini. Pour les lumières non directionnelles, les trois valeurs d’atténuation ne doivent pas être définies sur 0,0 en même temps.

Theta

Type : float

Angle, en radians, du cône intérieur d’un projecteur - cône de projecteur entièrement éclairé. Cette valeur doit être comprise entre 0 et la valeur spécifiée par Phi.

Phi

Type : float

Angle, en radians, définissant le bord externe du cône externe du projecteur. Les points à l’extérieur de ce cône ne sont pas allumés par la lumière. Cette valeur doit être comprise entre 0 et pi.

Spécifications

Condition requise	Valeur
En-tête	D3D9Types.h

Voir aussi

Direct3D Structures

Getlight

SetLight