D3DXMatrixRotationYawPitchRoll-Funktion (D3dx9math.h)

Erstellt eine Matrix mit einem angegebenen Yaw, einer angegebenen Tonhöhe und einem angegebenen Roll.

Syntax

D3DXMATRIX* D3DXMatrixRotationYawPitchRoll(
  _Inout_ D3DXMATRIX *pOut,
  _In_    FLOAT      Yaw,
  _In_    FLOAT      Pitch,
  _In_    FLOAT      Roll
);

Parameter

pOut [ in, out]

Typ: D3DXMATRIX*

Zeiger auf die D3DXMATRIX-Struktur, die das Ergebnis des Vorgangs ist.

Yaw [ In]

Typ: FLOAT

Gieren Sie um die y-Achse im Bogenmaß.

Pitch [ In]

Typ: FLOAT

Tonhöhe um die X-Achse im Bogenmaß.

Roll [ In]

Typ: FLOAT

Rollieren Sie um die Z-Achse im Bogenmaß.

Rückgabewert

Typ: D3DXMATRIX*

Zeiger auf eine D3DXMATRIX-Struktur mit dem angegebenen Yaw, Pitch und Roll.

Bemerkungen

Der Rückgabewert für diese Funktion ist der gleiche Wert, der im pOut-Parameter zurückgegeben wird. Auf diese Weise kann die D3DXMatrixRotationYawPitchRoll-Funktion als Parameter für eine andere Funktion verwendet werden.

Die Reihenfolge der Transformationen wird zuerst rolliert, dann pitch, dann yaw. Relativ zur lokalen Koordinatenachse des Objekts entspricht dies der Drehung um die Z-Achse, gefolgt von einer Drehung um die x-Achse, gefolgt von einer Drehung um die y-Achse, wie in der folgenden Abbildung dargestellt.

Abbildung von "Roll", "Pitch" und "yaw" als Drehungen um die drei Achsen

Requirements (Anforderungen)

Anforderung Wert
Header
D3dx9math.h
Bibliothek
D3dx9.lib

Weitere Informationen

Mathematische Funktionen

D3DXMatrixRotationAxis

D3DXMatrixRotationQuaternion

D3DXMatrixRotationX

D3DXMatrixRotationY

D3DXMatrixRotationZ