D3DXSHRotate-Funktion (D3dx9math.h)

Artikel
06/13/2023

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 Spherical Harmonics Math-BibliotheksfunktionXMSHRotate zu verwenden.

Dreht den kugelförmigen harmonischen Vektor (SH) um die angegebene Matrix.

Syntax

FLOAT* D3DXSHRotate(
  _Out_       FLOAT      *pOut,
  _In_        UINT       Order,
  _In_  const D3DXMATRIX *pMatrix,
  _In_  const FLOAT      *pIn
);

Parameter

pOut [out]

Typ: FLOAT*

Zeiger auf sphärische harmonische Ausgabekoeffizienten (SH). Die Auswertung generiert Order²-Koeffizienten. Dieser Zeiger sollte nicht als Alias mit pIn verwendet werden. Siehe Hinweise.

Reihenfolge [in]

Typ: UINT

Reihenfolge der SH-Auswertung. Muss im Bereich der D3DXSH_MINORDER liegen, um D3DXSH_MAXORDER inklusive. Die Auswertung generiert Order²-Koeffizienten. Der Grad der Auswertung ist Order - 1.

pMatrix [in]

Typ: const D3DXMATRIX*

Zeiger auf die Drehungsmatrix. Die Rotationsuntermatrix muss orthogonal sein und eine Einheitsdeterminante aufweisen.

pIn [in]

Typ: const FLOAT*

Zeiger auf gedrehte SH-Koeffizienten.

Rückgabewert

Typ: FLOAT*

Zeiger auf SH-Ausgabekoeffizienten.

Bemerkungen

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.

Anforderungen

Anforderung	Wert
Header	D3dx9math.h
Bibliothek	D3dx9.lib

Siehe auch

Mathematische Funktionen
Vorberechnete Radianzübertragung (Direct3D 9)

Share via