D3DXSHEvalDirection-Funktion (D3dx9math.h)
Hinweis
Die Hilfsprogrammbibliothek D3DX (D3DX 9, D3DX 10 und D3DX 11) ist veraltet und wird für Windows Store-Apps nicht unterstützt.
Hinweis
Anstelle dieser Funktion wird empfohlen, die Bibliotheksfunktion Spherical Harmonics MathXMSHEvalDirection zu verwenden.
Wertet die sphärischen harmonischen (SH)-Basisfunktionen aus einem Eingaberichtungsvektor aus.
Syntax
FLOAT* D3DXSHEvalDirection(
_Out_ FLOAT *pOut,
_In_ UINT Order,
_In_ const D3DXVECTOR3 *pDir
);
Parameter
-
pOut [out]
-
Typ: FLOAT*
Zeiger auf Spherical Harmonic (SH) Ausgabekoeffizienten. Die Auswertung generiert Order²-Koeffizienten. Siehe Hinweise.
-
Bestellung [in]
-
Typ: UINT
Reihenfolge der SH-Auswertung. Muss im Bereich der D3DXSH_MINORDER liegen, um D3DXSH_MAXORDER zu D3DXSH_MAXORDER, einschließlich. Die Auswertung generiert Order²-Koeffizienten. Der Grad der Bewertung ist Reihenfolge - 1.
-
pDir [in]
-
Typ: const D3DXVECTOR3*
(x, y, z) Richtungsvektor, in dem die SH-Basisfunktionen ausgewertet werden sollen. Muss normalisiert werden. Siehe Hinweise.
Rückgabewert
Typ: FLOAT*
Zeiger auf SH-Ausgabekoeffizienten. Siehe Hinweise.
Hinweise
Jeder Koeffizient der Basisfunktion Ylm wird am Speicherort l² + m + l gespeichert, wobei:
- l ist der Grad der Basisfunktion.
- m ist der Basisfunktionsindex für den angegebenen l-Wert und reicht von -l bis einschließlich l.
Auf der Kugel mit Einheitsradius kann, wie in der folgenden Abbildung dargestellt, die Richtung einfach mit theta, dem Winkel um die z-Achse in rechtshändiger Richtung und phi, dem Winkel von z angegeben werden.
Die folgenden Formeln zeigen die Beziehung zwischen kartesischen (x, y, z) und kugelförmigen Koordinaten (Theta, phi) auf der Einheitskugel. Der Winkel theta variiert über den Bereich von 0 bis 2 Pi, während phi von 0 bis pi variiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|
Siehe auch