Funzione D3DXMatrixRotationYawPitchRoll (D3dx9math.h)

Nota

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

Compila una matrice con un yaw, un passo e un roll specificati.

Sintassi

D3DXMATRIX* D3DXMatrixRotationYawPitchRoll(
  _Inout_ D3DXMATRIX *pOut,
  _In_    FLOAT      Yaw,
  _In_    FLOAT      Pitch,
  _In_    FLOAT      Roll
);

Parametri

pOut [in, out]

Tipo: D3DXMATRIX*

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

Yaw [in]

Tipo: FLOAT

Yaw intorno all'asse y, in radianti.

Pitch [in]

Tipo: FLOAT

Ruotare intorno all'asse x, in radianti.

Roll [in]

Tipo: FLOAT

Ruotare intorno all'asse z, nei radianti.

Valore restituito

Tipo: D3DXMATRIX*

Puntatore a una struttura D3DXMATRIX con l'yaw, il passo e il roll specificati.

Commenti

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

L'ordine delle trasformazioni viene eseguito prima, quindi il passo, quindi l'yaw. Rispetto all'asse delle coordinate locali dell'oggetto, questo equivale alla rotazione attorno all'asse z, seguito dalla rotazione attorno all'asse x, seguita dalla rotazione intorno all'asse y, come illustrato nella figura seguente.

illustrazione del roll, del passo e dell'yaw come rotazioni intorno ai tre assi

Requisiti

Requisito Valore
Intestazione
D3dx9math.h
Libreria
D3dx9.lib

Vedi anche

Funzioni matematiche

D3DXMatrixRotationAxis

D3DXMatrixRotationQuaternion

D3DXMatrixRotationX

D3DXMatrixRotationY

D3DXMatrixRotationZ