Funzione D3DXQuaternionRotationAxis (D3dx9math.h)

Nota

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

Ruota un quaternione su un asse arbitrario.

Sintassi

D3DXQUATERNION* D3DXQuaternionRotationAxis(
  _Inout_       D3DXQUATERNION *pOut,
  _In_    const D3DXVECTOR3    *pV,
  _In_          FLOAT          Angle
);

Parametri

pOut [in, out]

Tipo: D3DXQUATERNION*

Puntatore alla struttura D3DXQUATERNION risultante dall'operazione.

pV [in]

Tipo: const D3DXVECTOR3*

Puntatore alla struttura D3DXVECTOR3 che identifica l'asse su cui ruotare il quaternione.

Angolo [in]

Tipo: FLOAT

Angolo di rotazione, in radianti. Gli angoli vengono misurati in senso orario quando si osserva lungo l'asse di rotazione verso l'origine.

Valore restituito

Tipo: D3DXQUATERNION*

Puntatore a una struttura D3DXQUATERNION ruotata attorno all'asse specificato.

Commenti

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

Usare D3DXQuaternionNormalize per qualsiasi input quaternione non già normalizzato.

Requisiti

Requisito Valore
Intestazione
D3dx9math.h
Libreria
D3dx9.lib

Vedi anche

Funzioni matematiche

D3DXQuaternionRotationMatrix

D3DXQuaternionRotationYawPitchRoll