Partilhar via


Função D3DXQuaternionRotationAxis (D3dx9math.h)

Observação

A biblioteca do utilitário D3DX foi preterida. Em vez disso, recomendamos que você use DirectXMath .

Gira um quatérnion sobre um eixo arbitrário.

Sintaxe

D3DXQUATERNION* D3DXQuaternionRotationAxis(
  _Inout_       D3DXQUATERNION *pOut,
  _In_    const D3DXVECTOR3    *pV,
  _In_          FLOAT          Angle
);

Parâmetros

pOut [in, out]

Tipo: D3DXQUATERNION*

Ponteiro para a estrutura D3DXQUATERNION que é o resultado da operação.

pV [in]

Tipo: const D3DXVECTOR3*

Ponteiro para a estrutura D3DXVECTOR3 que identifica o eixo sobre o qual girar o quatérnion.

Ângulo [in]

Tipo: FLOAT

Ângulo de rotação, em radianos. Os ângulos são medidos no sentido horário olhando ao longo do eixo de rotação em direção à origem.

Valor retornado

Tipo: D3DXQUATERNION*

Ponteiro para uma estrutura D3DXQUATERNION girada em torno do eixo especificado.

Comentários

O valor retornado para essa função é o mesmo valor retornado no parâmetro pOut . Dessa forma, a função D3DXQuaternionRotationAxis pode ser usada como um parâmetro para outra função.

Use D3DXQuaternionNormalize para qualquer entrada de quatérnion que ainda não esteja normalizada.

Requisitos

Requisito Valor
parâmetro
D3dx9math.h
Biblioteca
D3dx9.lib

Confira também

Funções Matemáticas

D3DXQuaternionRotationMatrix

D3DXQuaternionRotationYawPitchRoll