Share via


XMMatrixRotationRollPitchYawFromVector 関数 (directxmath.h)

オイラー角度 (ピッチ、ヨー、ロール) を含むベクトルに基づいて回転行列を作成します。

構文

XMMATRIX XM_CALLCONV XMMatrixRotationRollPitchYawFromVector(
  [in] FXMVECTOR Angles
) noexcept;

パラメーター

[in] Angles

オイラー角度を x 軸 (ピッチ)、次に y 軸 (ヨー)、z 軸 (ロール) の順に含む 3D ベクトル。 W 要素は無視されます。

戻り値

回転行列を返します。

解説

角度は、回転軸に沿って原点を見た状態で時計回りに測定されます。 これは左利きの座標系です。 右辺座標を使用するには、3 つの角度をすべて否定します。

変換の順序は最初にロール、次にピッチ、次にヨーです。 回転はすべてグローバル座標フレームに適用されます。

Note

この関数は、入力パラメーターとして x 軸、y 軸、z 軸の角度を受け取ります。 x 軸への ラベル ピッチ 、y 軸への ヨー 、z 軸への ロール の割り当ては、一般的な "ビュー" 座標系に一致するため、コンピューター グラフィックスとゲームでは一般的なものです。 他の座標系を使用するときにこれらのラベルを割り当てる方法は他にもあります (たとえば、 ロール には x 軸、y 軸の ピッチ 、z 軸の ヨー など)。

プラットフォームの要件

Windows 8 用 Windows SDK を使用した Microsoft Visual Studio 2010 または Microsoft Visual Studio 2012。 Win32 デスクトップ アプリ、Windows ストア アプリ、Windows Phone 8 アプリでサポートされます。

要件

   
対象プラットフォーム Windows
ヘッダー directxmath.h

関連項目

DirectXMath ライブラリマトリックス関数