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

Siehe auch

Mathematische Funktionen

Vorcomputed Radiance Transfer (Direct3D 9)