Funzione D3DXQuaternionLn (D3dx9math.h)

Nota

La libreria di utilità D3DX è deprecata. È consigliabile usare invece DirectXMath .

Calcola il logaritmo naturale.

Sintassi

D3DXQUATERNION* D3DXQuaternionLn(
  _Inout_       D3DXQUATERNION *pOut,
  _In_    const D3DXQUATERNION *pQ
);

Parametri

pOut [in, out]

Tipo: D3DXQUATERNION*

Puntatore alla struttura D3DXQUATERNION che è il risultato dell'operazione.

pQ [in]

Tipo: const D3DXQUATERNION*

Puntatore alla struttura D3DXQUATERNION di origine.

Valore restituito

Tipo: D3DXQUATERNION*

Puntatore a una struttura D3DXQUATERNION che rappresenta il logaritmo naturale.

Commenti

La funzione D3DXQuaternionLn funziona solo per i quaternioni unità.

A unit quaternion, is defined by:
Q == (cos(theta), sin(theta) * v) where |v| = 1
The natural logarithm of Q is, ln(Q) = (0, theta * v)

Il valore restituito per questa funzione è lo stesso valore restituito nel parametro pOut . In questo modo, la funzione D3DXQuaternionLn può essere usata come parametro per un'altra funzione.

Usare D3DXQuaternionNormalize per qualsiasi input quaternion non già normalizzato.

Requisiti

Requisito	Valore
Intestazione	D3dx9math.h
Libreria	D3dx9.lib

Vedi anche

Funzioni matematiche

D3DXQuaternionExp

D3DXQuaternionSquad