Freigeben über


D3DXMatrixRotationYawPitchRoll-Funktion (D3dx9math.h)

Hinweis

Die D3DX-Hilfsprogrammbibliothek ist veraltet. Es wird empfohlen, stattdessen DirectXMath zu verwenden.

Erstellt eine Matrix mit einem angegebenen Gier, einer angegebenen Tonhöhe und einer angegebenen Rolle.

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

Im Bogenmaß um die y-Achse gähnen.

Tonhöhe [in]

Typ: FLOAT

Neigung um die x-Achse im Bogenmaß.

Roll [in]

Typ: FLOAT

Rollen Sie im Bogenmaß um die Z-Achse.

Rückgabewert

Typ: D3DXMATRIX*

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

Bemerkungen

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

Die Reihenfolge der Transformationen ist zuerst rollen, dann pitchen und dann gähnen. Relativ zur lokalen Koordinatenachse des Objekts entspricht dies der Drehung um die Z-Achse, gefolgt von der Drehung um die x-Achse, gefolgt von der Drehung um die y-Achse, wie in der folgenden Abbildung gezeigt.

Abbildung von Rolle, Tonhöhe und Gähnen als Drehungen um die drei Achsen

Anforderungen

Anforderung Wert
Header
D3dx9math.h
Bibliothek
D3dx9.lib

Siehe auch

Mathematische Funktionen

D3DXMatrixRotationAxis

D3DXMatrixRotationQuaternion

D3DXMatrixRotationX

D3DXMatrixRotationY

D3DXMatrixRotationZ