Método ID3DXMATRIXStack::RotateAxis (D3dx9math.h)

  • Artigo

Observação

A biblioteca de utilitários D3DX foi preterida. Recomendamos que você use DirectXMath junto com esse cabeçalho do GitHub.

Gira (em relação ao espaço de coordenadas do mundo) em torno de um eixo arbitrário.

Sintaxe

HRESULT RotateAxis(
  [in] const D3DXVECTOR3 *pV,
  [in]       FLOAT       Angle
);

Parâmetros

pV [in]

Tipo: const D3DXVECTOR3*

Ponteiro para o eixo arbitrário de rotação. Consulte D3DXVECTOR3.

Ângulo [in]

Tipo: FLOAT

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

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, o valor retornado será D3D_OK. Se o método falhar, o valor retornado poderá ser D3DERR_INVALIDCALL.

Comentários

Esse método adiciona a rotação à pilha de matriz com a matriz de rotação computada semelhante à seguinte:

D3DXMATRIX tmp;
D3DXMatrixRotationAxis( &tmp, pV, angle );
m_stack[m_currentPos] = m_stack[m_currentPos] * tmp;

Como a rotação é multiplicada à direita para a pilha de matrizes, a rotação é relativa ao espaço de coordenadas do mundo.

Requisitos

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

Confira também

ID3DXMATRIXStack

D3DXMatrixRotationAxis

ID3DXMATRIXStack::RotateAxisLocal

ID3DXMATRIXStack::RotateYawPitchRoll

ID3DXMATRIXStack::RotateYawPitchRollLocal