D3DXSHEvalDirection, fonction (D3DX10.h)

Notes

La bibliothèque d’utilitaires D3DX (D3DX 9, D3DX 10 et D3DX 11) est déconseillée et n’est pas prise en charge pour les applications du Windows Store.

Notes

Au lieu d’utiliser cette fonction, nous vous recommandons d’utiliser la fonction de bibliothèque Spherical Harmonics MathXMSHEvalDirection.

Évalue les fonctions de base harmonique sphérique (SH) à partir d’un vecteur de direction d’entrée.

Syntaxe

FLOAT* D3DXSHEvalDirection(
  _In_       FLOAT       *pOut,
  _In_       UINT        Order,
  _In_ const D3DXVECTOR3 *pDir
);

Paramètres

pOut [in]

Type : FLOAT*

Pointeur vers les coefficients de sortie harmonique sphérique (SH). L’évaluation génère des coefficients Order². Consultez la section Notes.

Ordre [in]

Type : UINT

Ordre de l’évaluation sh. Doit être dans la plage de D3DXSH_MINORDER à D3DXSH_MAXORDER, inclusive. L’évaluation génère des coefficients Order². Le degré de l’évaluation est Order - 1.

pDir [in]

Type : const D3DXVECTOR3*

(x, y, z) vecteur de direction dans lequel évaluer les fonctions de base SH. Doit être normalisé. Consultez la section Notes.

Valeur de retour

Type : FLOAT*

Pointeur vers les coefficients de sortie SH. Consultez la section Notes.

Notes

Chaque coefficient de la fonction de base Ylm est stocké à l’emplacement de mémoire l² + m + l, où :

• l est le degré de la fonction de base.
• m est l’index de fonction de base pour la valeur l donnée et est compris entre -l et l, inclus.

Sur la sphère avec rayon d’unité, comme le montre l’illustration suivante, la direction peut être spécifiée simplement avec téta, l’angle autour de l’axe z dans le sens droitier, et phi, l’angle à partir de z.

Les équations suivantes montrent la relation entre les coordonnées cartésiennes (x, y, z) et sphériques (the, phi) sur la sphère d’unité. L’angle 0 à 2 pi varie sur la plage de 0 à 2 pi, tandis que phi varie de 0 à pi.

Spécifications

Condition requise	Valeur
En-tête	D3DX10.h
Bibliothèque	D3DX10.lib

Voir aussi

Fonctions mathématiques