Função XMMatrixRotationRollPitchYawFromVector (directxmath.h)

Cria uma matriz de rotação com base em um vetor que contém os ângulos de Euler (pitch, yaw e roll).

Sintaxe

XMMATRIX XM_CALLCONV XMMatrixRotationRollPitchYawFromVector(
  [in] FXMVECTOR Angles
) noexcept;

Parâmetros

[in] Angles

Vetor 3D que contém os ângulos de Euler na ordem eixo x (eixo x), eixo y (yaw) e, em seguida, eixo z (roll). O elemento W é ignorado.

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