Função XMMatrixRotationRollPitchYaw (directxmath.h)

Cria uma matriz de rotação com base em um determinado tom, yaw e roll (ângulos euler).

Sintaxe

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

Parâmetros

[in] Pitch

Ângulo de rotação ao redor do eixo x, em radianos.

[in] Yaw

Ângulo de rotação ao redor do eixo y, em radianos.

[in] Roll

Ângulo de rotação ao redor do eixo z, em radianos.

Valor retornado

Retorna a matriz de rotação.

Comentários

Os ângulos são medidos no sentido horário olhando ao longo do eixo de rotação em direção à origem. Este é um sistema de coordenadas canhoto. Para usar coordenadas destros, anule todos os três ângulos.

A ordem das transformações é rolar primeiro, depois arremessar e, em seguida, yaw. Todas as rotações são aplicadas no quadro de coordenadas global.

Observação

Essa função usa os ângulos do eixo x, do eixo y e do eixo z como parâmetros de entrada. A atribuição dos rótulos de pitch para o eixo x, yaw para o eixo y e rolar para o eixo z é comum para elementos gráficos e jogos de computação, pois corresponde aos sistemas típicos de coordenadas "view". É claro que há outras maneiras de atribuir esses rótulos ao usar outros sistemas de coordenadas (por exemplo, roll pode ser o eixo x, lançar o eixo y e yaw o eixo z).

Requisitos da plataforma

Microsoft Visual Studio 2010 ou Microsoft Visual Studio 2012 com o SDK do Windows para Windows 8. Com suporte para aplicativos da área de trabalho Win32, aplicativos da Windows Store e aplicativos Windows Phone 8.

Requisitos

Plataforma de Destino	Windows
Cabeçalho	directxmath.h

Confira também

Funções de matriz da biblioteca DirectXMath