Freigeben über


D3DXSHEvalDirectionalLight-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

Anstatt diese Funktion zu verwenden, empfiehlt es sich, die Mathematische Bibliotheksfunktion Spherical HarmonicsXMSHEvalDirectionalLight zu verwenden.

Wertet ein direktionales Licht aus und gibt spektrale sphärische harmonische Daten (SH) zurück.

Syntax

HRESULT D3DXSHEvalDirectionalLight(
  _In_        UINT        Order,
  _In_  const D3DXVECTOR3 *pDir,
  _In_        FLOAT       RIntensity,
  _In_        FLOAT       GIntensity,
  _In_        FLOAT       BIntensity,
  _Out_       FLOAT       *pROut,
  _Out_       FLOAT       *pGOut,
  _Out_       FLOAT       *pBOut
);

Parameter

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.

pDir [in]

Typ: const D3DXVECTOR3*

Zeiger auf den (x, y, z) Hemisphärenachsenrichtungsvektor, in dem die SH-Basisfunktionen ausgewertet werden sollen. Siehe Hinweise.

RIntensity [in]

Typ: FLOAT

Die rote Intensität des Lichts.

GIntensity [in]

Typ: FLOAT

Die grüne Intensität des Lichts.

BIntensity [in]

Typ: FLOAT

Die blaue Intensität des Lichts.

pROut [out]

Typ: FLOAT*

Zeiger auf den SH-Ausgabevektor für die rote Komponente.

pGOut [out]

Typ: FLOAT*

Optionaler Zeiger auf den SH-Ausgabevektor für die grüne Komponente.

pBOut [out]

Typ: FLOAT*

Optionaler Zeiger auf den SH-Ausgabevektor für die blaue Komponente.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Funktion fehlschlägt, kann der Rückgabewert sein: D3DERR_INVALIDCALL.

Bemerkungen

Der Ausgabevektor wird so berechnet, dass, wenn das Intensitätsverhältnis R/G/B gleich 1 ist, die resultierende Ausstrahlung eines Punkts direkt unter dem Licht auf einem diffusen Objekt mit einer Albedo von 1 1 1,0 wäre. Dadurch werden drei Spektralproben berechnet. pROut wird zurückgegeben, während pGOut und pBOut zurückgegeben werden können.

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.

Abbildung einer Kugel mit Einheitsradius

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.

Gleichungen der Beziehung zwischen kartesischen und kugelförmigen Koordinaten

Anforderungen

Anforderung Wert
Header
D3dx9math.h
Bibliothek
D3dx9.lib

Siehe auch

Mathematische Funktionen

Vorberechnete Radianzübertragung (Direct3D 9)