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

  • Artigo

Observação

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

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

Sintaxe

HRESULT RotateAxisLocal(
  [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] = tmp * m_stack[m_currentPos];

Como a rotação é multiplicada à esquerda para a pilha de matriz, a rotação é relativa ao espaço de coordenadas local do objeto.

Requisitos

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

Confira também

ID3DXMATRIXStack

D3DXMatrixRotationAxis

ID3DXMATRIXStack::RotateAxis

ID3DXMATRIXStack::RotateYawPitchRoll

ID3DXMATRIXStack::RotateYawPitchRollLocal