Funzione D3DXMatrixAffineTransformation2D (D3DX10Math.h)

Nota

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

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

Sintassi

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

Parametri

pOut [in]

Tipo: D3DXMATRIX*

Puntatore all'oggetto D3DXMATRIX risultante dall'operazione.

Ridimensionamento [in]

Tipo: FLOAT

Fattore di ridimensionamento.

pRotationCenter [in]

Tipo: const D3DXVECTOR2*

Puntatore a 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 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)-1 * 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	D3DX10Math.h
Libreria	D3DX10.lib

Vedi anche

Funzioni matematiche