Funzione D3DXSHEvalDirection (D3DX10.h)

Nota

La libreria di utilità D3DX (D3DX 9, D3DX 10 e D3DX 11) è deprecata e non è supportata per le app di Windows Store.

Nota

Invece di usare questa funzione, è consigliabile usare la funzione di libreria matematica Armoniche SfericaliXMSHEvalDirection.

Valuta le funzioni di base armonica sferica (SH) da un vettore di direzione di input.

Sintassi

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

Parametri

pOut [in]

Tipo: FLOAT*

Puntatore ai coefficienti di output armonica sferica (SH). La valutazione genera coefficienti Order². Vedere la sezione Osservazioni.

Ordine [in]

Tipo: UINT

Ordine della valutazione SH. Deve essere compreso nell'intervallo di D3DXSH_MINORDER da D3DXSH_MAXORDER inclusi. La valutazione genera coefficienti Order². Il grado della valutazione è Order - 1.

pDir [in]

Tipo: const D3DXVECTOR3*

(x, y, z) vettore di direzione in cui valutare le funzioni di base SH. Deve essere normalizzato. Vedere la sezione Osservazioni.

Valore restituito

Tipo: FLOAT*

Puntatore ai coefficienti di output SH. Vedere la sezione Osservazioni.

Commenti

Ogni coefficiente della funzione di base Ylm viene archiviato nella posizione di memoria l² + m + l, dove:

• l è il grado della funzione di base.
• m è l'indice della funzione di base per il valore l specificato e gli intervalli da -l a l, inclusi.

Sulla sfera con raggio unitario, come illustrato nella figura seguente, la direzione può essere specificata semplicemente con theta, l'angolo circa l'asse z nella direzione destra e phi, l'angolo da z.

Le equazioni seguenti mostrano la relazione tra le coordinate cartesiane (x, y, z) e sferiche (theta, phi) sulla sfera dell'unità. L'angolo della theta varia nell'intervallo da 0 a 2 pi, mentre phi varia da 0 a pi.

Requisiti

Requisito	Valore
Intestazione	D3DX10.h
Libreria	D3DX10.lib

Vedi anche

Funzioni matematiche