D3DDDI_LIGHT Struktur (d3dumddi.h)
Die D3DDDI_LIGHT Struktur beschreibt eine Reihe von Beleuchtungseigenschaften.
Syntax
typedef struct _D3DDDI_LIGHT {
[in] D3DLIGHTTYPE Type;
[in] D3DCOLORVALUE Diffuse;
[in] D3DCOLORVALUE Specular;
[in] D3DCOLORVALUE Ambient;
[in] D3DVECTOR Position;
[in] D3DVECTOR Direction;
[in] FLOAT Range;
[in] FLOAT Falloff;
[in] FLOAT Attenuation0;
[in] FLOAT Attenuation1;
[in] FLOAT Attenuation2;
[in] FLOAT Theta;
[in] FLOAT Phi;
} D3DDDI_LIGHT;
Angehörige
[in] Type
Ein D3DLIGHTTYPE typisierter Wert, der den Typ der Lichtquelle angibt. Weitere Informationen zu D3DLIGHTTYPE finden Sie in der Microsoft Windows SDK-Dokumentation.
[in] Diffuse
Eine D3DCOLORVALUE Struktur, die die diffuse Farbe angibt, die vom Licht ausgegeben wird. Weitere Informationen zu D3DCOLORVALUE finden Sie in der Windows SDK-Dokumentation.
[in] Specular
Eine D3DCOLORVALUE Struktur, die die Glanzfarbe angibt, die vom Licht ausgegeben wird.
[in] Ambient
Eine D3DCOLORVALUE Struktur, die die Umgebungsfarbe angibt, die vom Licht ausgegeben wird.
[in] Position
Eine D3DVECTOR Struktur, die die Position des Lichts im Weltraum angibt. Dieses Element hat keine Bedeutung für direktionale Lichter (d. h., wenn D3DLIGHT_DIRECTIONAL im element Typ festgelegt ist) und in dieser Situation ignoriert wird. Weitere Informationen zu D3DVECTOR finden Sie in der Windows SDK-Dokumentation.
[in] Direction
Eine D3DVECTOR Struktur, die die Richtung angibt, in die das Licht im Weltraum zeigt. Dieses Element hat nur Bedeutung für Direktlichter und Spotlights (d. h., wenn D3DLIGHT_DIRECTIONAL und D3DLIGHT_SPOT in Typfestgelegt werden). Dieser Vektor muss nicht normalisiert werden, sollte jedoch eine Nichtzerolänge aufweisen.
[in] Range
Der Abstand, über den das Licht hinaus keine Wirkung hat. Der maximal zulässige Wert für dieses Element ist D3DLIGHT_RANGE_MAX, der als Quadratwurzel von FLT_MAX definiert ist. Dieses Element wirkt sich nicht auf direktionale Lichter aus.
[in] Falloff
Die Abnahme der Beleuchtung zwischen dem inneren Kegel eines Spotlights (dem Winkel, der durch das Theta Member angegeben wird) und dem äußeren Rand des äußeren Kegels (der Winkel, der durch das Phi--Element angegeben wird). Der Effekt des Falloffs auf die Beleuchtung ist subtil. Darüber hinaus entsteht durch die Gestaltung der Falloffkurve eine geringe Leistungseinbuße. Aus diesen Gründen legen die meisten Entwickler dieses Mitglied auf 1.0 fest.
[in] Attenuation0
Der konstante Dämpfungsfaktor des Lichts. Dämpfungswerte geben an, wie sich die Lichtintensität über den Abstand ändert. Die Dämpfung wirkt sich nicht auf direktionale Lichter aus. Gültige Werte für diesen Memberbereich von 0,0 bis unendlich.
[in] Attenuation1
Der lineare Dämpfungsfaktor des Lichts. Dämpfungswerte geben an, wie sich die Lichtintensität über den Abstand ändert. Die Dämpfung wirkt sich nicht auf direktionale Lichter aus. Gültige Werte für diesen Memberbereich von 0,0 bis unendlich.
[in] Attenuation2
Der quadratische Dämpfungsfaktor des Lichts. Dämpfungswerte geben an, wie sich die Lichtintensität über den Abstand ändert. Die Dämpfung wirkt sich nicht auf direktionale Lichter aus. Gültige Werte für diesen Memberbereich von 0,0 bis unendlich.
[in] Theta
Der Winkel im Bogenmaß des inneren Kegels eines Blickpunkts, d. h. der voll beleuchtete Blickpunktkegel. Dieser Wert muss sich im Bereich von 0 bis zum Wert befinden, der durch das Phi-Element angegeben wird.
[in] Phi
Der Winkel in Bogenmaß, der den äußeren Rand des Äußeren Kegels des Blickpunkts definiert. Punkte außerhalb dieses Kegels werden nicht vom Spotlight beleuchtet. Dieser Wert muss zwischen 0 und Pi sein.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Header- | d3dumddi.h (include D3dumddi.h) |