D3DXMatrixAffineTransformation2D 函式 (D3dx9math.h)

注意

D3DX 公用程式程式庫已被取代。 建議您改用 DirectXMath 。

在 xy 平面中建置 2D 相依轉換矩陣。 Null 引數會被視為身分識別轉換。

語法

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

參數

pOut [in， out]

類型： D3DXMATRIX*

D3DXMATRIX結構的指標，這是作業的結果。

調整 [in]

類型： FLOAT

縮放比例。

pRotationCenter [in]

類型：const D3DXVECTOR2*

D3DXVECTOR2結構的指標，這是識別旋轉中心點。 如果這個引數為 Null，則會將識別 M_rc 矩陣套用至「備註」中的公式。

旋轉 [in]

類型： FLOAT

旋轉的角度。

pTranslation [in]

類型：const D3DXVECTOR2*

D3DXVECTOR2結構的指標，代表翻譯。 如果此引數為 Null，則會將身分識別 Mt 矩陣套用至「備註」中的公式。

傳回值

類型： D3DXMATRIX*

D3DXMATRIX結構的指標，這是相依轉換矩陣。

備註

此函式會使用下列公式計算相依轉換矩陣，並以從左至右的順序評估矩陣串連：

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

其中：

M_out = 輸出矩陣 (pOut)

Ms = 縮放矩陣 (縮放)

M_rc = 旋轉矩陣的中心 (pRotationCenter)

M_r = 旋轉矩陣 (旋轉)

Mt = 轉譯矩陣 (pTranslation)

此函式的傳回值與 pOut 參數中傳回的值相同。 如此一來， D3DXMatrixAffineTransformation2D 函式就可以當做另一個函式的參數使用。

針對 3D 相依轉換，請使用 D3DXMatrixAffineTransformation。

規格需求

需求	值
標頭	D3dx9math.h
程式庫	D3dx9.lib

另請參閱

數學函式

D3DXMatrixTransformation2D

轉換 (Direct3D 9)