D3DXSHEvalSphericalLight-Funktion (D3DX10.h)
Wertet ein pherisches Licht aus und gibt SH-Daten (PhericalIcalIcals) zurück.
Syntax
HRESULT D3DXSHEvalSphericalLight(
_In_ UINT Order,
_In_ const D3DXVECTOR3 *pPos,
_In_ FLOAT Radius,
_In_ FLOAT RIntensity,
_In_ FLOAT GIntensity,
_In_ FLOAT BIntensity,
_In_ FLOAT *pROut,
_In_ FLOAT *pGOut,
_In_ FLOAT *pBOut
);
Parameter
-
Bestellung [ In]
-
Typ: UINT
Reihenfolge der SH-Auswertung. Muss im Bereich von D3DXSH _ MINORDER bis D3DXSH _ MAXORDER (einschließlich) liegen. Die Auswertung generiert Order Koeffizienten. Der Grad der Auswertung ist Order - 1.
-
pPos [ In]
-
Typ: const D3DXVECTOR3 *
Zeiger auf die Lichtposition.
-
Radius [ In]
-
Typ: FLOAT
Radius der pherischen Glühbirnenquelle.
-
RIntensity [ In]
-
Typ: FLOAT
Die rote Intensität des Lichts.
-
GIntensity [ In]
-
Typ: FLOAT
Die grüne Intensität des Lichts.
-
BIntensity [ In]
-
Typ: FLOAT
Die blaue Intensität des Lichts.
-
pROut [ In]
-
Typ: FLOAT*
Zeiger auf den SH-Ausgabevektor für die rote Komponente.
-
pGOut [ In]
-
Typ: FLOAT*
Zeiger auf den SH-Ausgabevektor für die grüne Komponente.
-
pBOut [ In]
-
Typ: FLOAT*
Zeiger auf den SH-Ausgabevektor für die blaue Komponente.
Rückgabewert
Typ: HRESULT
Wenn die Funktion erfolgreich ist, ist der Rückgabewert D3D _ OK. Wenn die Funktion fehlschlägt, kann der Rückgabewert D3DERR _ INVALIDCALL sein.
Hinweise
Wertet ein pherisches Licht aus und gibt sh-Daten zurück. Es gibt keine Normalisierung der Intensität des Lichts wie bei direktionalen Licht, daher muss bei der Angabe der Intensitäten vorsichtssam vorgesamst werden. Dadurch werden drei Beispielbeispiele berechnet. pROut wird zurückgegeben, während pGOut und pBOut zurückgegeben werden können.
Auf der Kugel mit Einheitenradius, wie in der folgenden Abbildung dargestellt, kann die Richtung einfach mit theta, dem Winkel um die Z-Achse in der rechtshändigen Richtung und dem Winkel von z angegeben werden.

Die folgenden Gleichungen zeigen die Beziehung zwischen kartesischen Koordinaten (x, y, z) und pherischen Koordinaten (Theta, phi) auf der Einheitenkugel. Der Winkel theta variiert im Bereich von 0 bis 2 Pi, während phi von 0 bis pi variiert.

Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|