XMQuaternionRotationRollPitchYawFromVector 関数 (directxmath.h)
オイラー角度 (ピッチ、ヨー、ロール) を含むベクターに基づいて回転四元数を計算します。
構文
XMVECTOR XM_CALLCONV XMQuaternionRotationRollPitchYawFromVector(
[in] FXMVECTOR Angles
) noexcept;
パラメーター
[in] Angles
オイラー角度を x 軸 (ピッチ)、y 軸 (ヨー)、z 軸 (ロール) の順に含む 3D ベクター。 W 要素は無視されます。
戻り値
回転四元数を返します。
注釈
DirectXMath 四元数関数では、XMVECTOR 4 ベクターを使用して四元数を表します。ここで、X、Y、Z の各コンポーネントはベクター部分、W コンポーネントはスカラー部分です。
角度は、回転軸に沿って原点を見た状態で時計回りに測定されます。 これは左利きの座標系です。 右辺座標を使用するには、3 つの角度をすべて否定します。
変換の順序は最初にロール、次にピッチ、次にヨーです。 回転はすべてグローバル座標フレームに適用されます。
注意
この関数は、入力パラメーターとして x 軸、y 軸、z 軸の角度を受け取ります。 x 軸へのラベル ピッチ 、y 軸への ヨー 、z 軸への ロール の割り当ては、一般的な "ビュー" 座標系に一致するため、コンピューター グラフィックスやゲームでは一般的なものです。 他の座標系を使用するときにこれらのラベルを割り当てる方法は他にもあります (たとえば、 ロール は x 軸、y 軸 のピッチ 、z 軸の ヨー などです)。
プラットフォームの要件
Microsoft Visual Studio 2010 または Microsoft Visual Studio 2012 と Windows SDK for Windows 8。 Win32 デスクトップ アプリ、Windows ストア アプリ、Windows Phone 8 アプリでサポートされます。要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | directxmath.h |