D3DXSHEvalDirection-Funktion (D3DX10.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
Anstatt diese Funktion zu verwenden, empfiehlt es sich, die Mathematische Bibliotheksfunktion Spherical HarmonicsXMSHEvalDirection zu verwenden.
Wertet die sphärischen harmonischen (SH)-Basisfunktionen aus einem Eingaberichtungsvektor aus.
Syntax
FLOAT* D3DXSHEvalDirection(
_In_ FLOAT *pOut,
_In_ UINT Order,
_In_ const D3DXVECTOR3 *pDir
);
Parameter
-
pOut [in]
-
Typ: FLOAT*
Zeiger auf sphärische harmonische Ausgabekoeffizienten (SH). Die Auswertung generiert Order²-Koeffizienten. Siehe Hinweise.
-
Reihenfolge [in]
-
Typ: UINT
Reihenfolge der SH-Auswertung. Muss sich im Bereich der D3DXSH_MINORDER D3DXSH_MAXORDER einschließlich. Die Auswertung generiert Order²-Koeffizienten. Der Grad der Auswertung ist Order - 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 Koeffizienten 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 l, einschließlich.
Auf der Kugel mit Einheitsradius, wie in der folgenden Abbildung dargestellt, kann 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 im Bereich von 0 bis 2 Pi, während phi von 0 bis pi variiert.
Anforderungen
Anforderung | Wert |
---|---|
Header |
|
Bibliothek |
|
Siehe auch