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	D3DX10.h
Bibliothek	D3DX10.lib

Siehe auch

Mathematische Funktionen