D3DXMatrixTransformation 関数 (D3DX10Math.h)

[アーティクル]
06/13/2023

Note

D3DX10 ユーティリティライブラリは非推奨です。代わりに DirectXMath を使用することをお勧めします。

変換マトリックスを作成します。 NULL 引数は、ID 変換として扱われます。

構文

D3DXMATRIX* D3DXMatrixTransformation(
  _Inout_       D3DXMATRIX     *pOut,
  _In_    const D3DXVECTOR3    *pScalingCenter,
  _In_    const D3DXQUATERNION *pScalingRotation,
  _In_    const D3DXVECTOR3    *pScaling,
  _In_    const D3DXVECTOR3    *pRotationCenter,
  _In_    const D3DXQUATERNION *pRotation,
  _In_    const D3DXVECTOR3    *pTranslation
);

パラメーター

pOut [in, out]

種類: D3DXMATRIX*

操作の結果である D3DXMATRIX 構造体へのポインター。

pScalingCenter [in]

型: const D3DXVECTOR3*

D3DXVECTOR3 へのポインター。スケーリングセンターポイントを識別します。この引数が NULL の場合は、「解説」の数式に ID M_sc 行列が適用されます。

pScalingRotation [in]

型: const D3DXQUATERNION*

スケーリングの回転を指定する D3DXQUATERNION へのポインター。この引数が NULL の場合は、「解説」の数式に ID M_sr 行列が適用されます。

pScaling [in]

型: const D3DXVECTOR3*

D3DXVECTOR3 構造体 (スケーリングベクター) へのポインター。この引数が NULL の場合は、「解説」の数式に ID Ms 行列が適用されます。

pRotationCenter [in]

型: const D3DXVECTOR3*

回転の中心を識別するポイントである D3DXVECTOR3 構造体へのポインター。この引数が NULL の場合は、「解説」の数式に ID M_rc 行列が適用されます。

pRotation [in]

型: const D3DXQUATERNION*

回転を指定する D3DXQUATERNION 構造体へのポインター。この引数が NULL の場合は、「解説」の数式に ID M_r 行列が適用されます。

pTranslation [in]

型: const D3DXVECTOR3*

変換を表す D3DXVECTOR3 構造体へのポインター。この引数が NULL の場合は、「解説」の数式に ID Mt 行列が適用されます。

戻り値

種類: D3DXMATRIX*

変換行列である D3DXMATRIX 構造体へのポインター。

解説

この関数は、次の数式を使用して変換行列を計算し、行列連結を左から右の順序で評価します。

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

ここで、

M_out = 出力マトリックス (pOut)

M_sc = スケーリングセンターマトリックス (pScalingCenter)

M_sr = 拡大縮小回転行列 (pScalingRotation)

Ms = スケーリングマトリックス (pScaling)

M_rc = 回転行列の中心 (pRotationCenter)

M_r = 回転行列 (pRotation)

Mt = 翻訳行列 (pTranslation)

この関数の戻り値は、pOut パラメーターで返される値と同じです。このようにして、D3DXMatrixTransformation 関数を別の関数のパラメーターとして使用できます。

2D 変換の場合は、 D3DXMatrixTransformation2D を使用します。

要件

要件	値
ヘッダー	D3DX10Math.h
ライブラリ	D3DX10.lib

関連項目

数値演算関数