Fungsi D3DXMatrixAffineTransformation (D3DX10Math.h)

Artikel
08/14/2024

Catatan

Pustaka utilitas D3DX tidak digunakan lagi. Kami menyarankan agar Anda menggunakan DirectXMath sebagai gantinya.

Membangun matriks transformasi affine 3D. Argumen NULL diperlakukan sebagai transformasi identitas.

Sintaks

D3DXMATRIX* D3DXMatrixAffineTransformation(
  _In_       D3DXMATRIX     *pOut,
  _In_       FLOAT          Scaling,
  _In_ const D3DXVECTOR3    *pRotationCenter,
  _In_ const D3DXQUATERNION *pRotation,
  _In_ const D3DXVECTOR3    *pTranslation
);

Parameter

pOut [in]

Jenis: D3DXMATRIX*

Arahkan ke D3DXMATRIX yang merupakan hasil operasi.

Penskalakan [in]

Jenis: FLOAT

Faktor penskalakan.

pRotationCenter [in]

Jenis: const D3DXVECTOR3*

Penunjuk ke D3DXVECTOR3, titik yang mengidentifikasi pusat rotasi. Jika argumen ini adalah NULL, identitas matriks M_rc diterapkan ke rumus dalam Keterangan.

pRotasi [in]

Jenis: const D3DXQUATERNION*

Penunjuk ke D3DXQUATERNION yang menentukan rotasi. Jika argumen ini ADALAH NULL, identitas matriks M_r diterapkan ke rumus dalam Keterangan.

pTranslation [in]

Jenis: const D3DXVECTOR3*

Penunjuk ke struktur D3DXVECTOR3 yang mewakili terjemahan. Jika argumen ini adalah NULL, identitas matriks Mt diterapkan ke rumus dalam Remarks.

Nilai kembali

Jenis: D3DXMATRIX*

Penunjuk ke struktur D3DXMATRIX yang merupakan matriks transformasi affine.

Keterangan

Fungsi ini menghitung matriks transformasi affine dengan rumus berikut, dengan perangkaian matriks dievaluasi dalam urutan kiri-ke-kanan:

M_out = Ms * (M_rc)-1 * M_r * M_rc * Mt

Dimana:

M_out = matriks output (pOut)

Ms = matriks penskalan (Penskalakan)

M_rc = pusat matriks rotasi (pRotationCenter)

M_r = matriks rotasi (pRotasi)

Mt = matriks terjemahan (pTranslation)

Nilai yang dikembalikan untuk fungsi ini adalah nilai yang sama yang dikembalikan dalam parameter pOut. Dengan cara ini, fungsi D3DXMatrixAffineTransformation dapat digunakan sebagai parameter untuk fungsi lain.

Untuk transformasi affine 2D, gunakan D3DXMatrixAffineTransformation2D.

Persyaratan

Persyaratan	Nilai
Header	D3DX10Math.h
Pustaka	D3DX10.lib

Lihat juga

Fungsi matematika

Bagikan melalui