Freigeben über


XMMatrixRotationRollPitchYaw-Funktion (directxmath.h)

Erstellt eine Rotationsmatrix basierend auf einer bestimmten Tonhöhe, Gier und Rolle (Eulerwinkel).

Syntax

XMMATRIX XM_CALLCONV XMMatrixRotationRollPitchYaw(
  [in] float Pitch,
  [in] float Yaw,
  [in] float Roll
) noexcept;

Parameter

[in] Pitch

Drehwinkel um die x-Achse in Bogenmaß.

[in] Yaw

Drehwinkel um die y-Achse, in Bogenmaßen.

[in] Roll

Drehwinkel um die z-Achse in Bogenmaß.

Rückgabewert

Gibt die Rotationsmatrix zurück.

Hinweise

Winkel werden im Uhrzeigersinn gemessen, wenn sie entlang der Drehachse zum Ursprung schauen. Dies ist ein linkshändiges Koordinatensystem. Um rechtshändige Koordinaten zu verwenden, negieren Sie alle drei Winkel.

Die Reihenfolge der Transformationen ist zuerst rollen, dann pitchen und dann gähnen. Die Drehungen werden alle im globalen Koordinatenrahmen angewendet.

Hinweis

Diese Funktion verwendet die Winkel der x-Achse, y-Achse und Z-Achse als Eingabeparameter. Die Zuweisung der Bezeichnungen "Pitch to the x-axis", yaw to the y-axis, and roll to the z-axis is a common for computer graphics and games, da sie mit typischen "View"-Koordinatensystemen übereinstimmt. Es gibt natürlich auch andere Möglichkeiten, diese Bezeichnungen zuzuweisen, wenn sie andere Koordinatensysteme verwenden (z. B. kann die Rolle die x-Achse sein, die y-Achse aufstellen und die z-Achse gieren ).

Plattformanforderungen

Microsoft Visual Studio 2010 oder Microsoft Visual Studio 2012 mit dem Windows SDK für Windows 8. Unterstützt für Win32-Desktop-Apps, Windows Store-Apps und Windows Phone 8-Apps.

Anforderungen

   
Zielplattform Windows
Kopfzeile directxmath.h

Weitere Informationen

Matrixfunktionen der DirectXMath-Bibliothek