Funzione D3DXMatrixAffineTransformation2D (D3dx9math.h)

Articolo
06/13/2023

Nota

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

Compila una matrice di trasformazione affine 2D nel piano xy. Gli argomenti NULL vengono considerati come trasformazioni di identità.

Sintassi

D3DXMATRIX* D3DXMatrixAffineTransformation2D(
  _Inout_       D3DXMATRIX  *pOut,
  _In_          FLOAT       Scaling,
  _In_    const D3DXVECTOR2 *pRotationCenter,
  _In_          FLOAT       Rotation,
  _In_    const D3DXVECTOR2 *pTranslation
);

Parametri

pOut [in, out]

Tipo: D3DXMATRIX*

Puntatore alla struttura D3DXMATRIX risultante dall'operazione.

Ridimensionamento [in]

Tipo: FLOAT

Fattore di ridimensionamento.

pRotationCenter [in]

Tipo: const D3DXVECTOR2*

Puntatore a una struttura D3DXVECTOR2 , un punto che identifica il centro di rotazione. Se questo argomento è NULL, alla formula in Osservazioni viene applicata una matrice identity M_rc .

Rotazione [in]

Tipo: FLOAT

Angolo di rotazione.

pTranslation [in]

Tipo: const D3DXVECTOR2*

Puntatore a una struttura D3DXVECTOR2 che rappresenta la traslazione. Se questo argomento è NULL, alla formula in Osservazioni viene applicata una matrice Identity Mt.

Valore restituito

Tipo: D3DXMATRIX*

Puntatore a una struttura D3DXMATRIX che è una matrice di trasformazione affine.

Commenti

Questa funzione calcola la matrice di trasformazione affine con la formula seguente, con la concatenazione della matrice valutata in ordine da sinistra a destra:

M_out = Ms * (M_rc)⁻¹ * M_r * M_rc * Mt

dove:

M_out = matrice di output (pOut)

Ms = matrice di ridimensionamento (ridimensionamento)

M_rc = centro della matrice di rotazione (pRotationCenter)

M_r = matrice di rotazione (rotazione)

Mt = matrice di traduzione (pTranslation)

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

Per le trasformazioni affine 3D, usare D3DXMatrixAffineTransformation.

Requisiti

Requisito	Valore
Intestazione	D3dx9math.h
Libreria	D3dx9.lib

Vedi anche

Funzioni matematiche
D3DXMatrixTransformation2D
Trasformazioni (Direct3D 9)

Condividi tramite