ID3DXMATRIXStack::RotateAxisLocal-Methode (D3dx9math.h)

Hinweis

Die D3DX-Hilfsprogrammbibliothek ist veraltet. Es wird empfohlen, stattdessen DirectXMath zusammen mit diesem Header von GitHub zu verwenden.

Dreht sich (relativ zum lokalen Koordinatenraum des Objekts) um eine beliebige Achse.

Syntax

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

Parameter

pV [in]

Typ: const D3DXVECTOR3*

Zeiger auf die beliebige Drehachse. Siehe D3DXVECTOR3.

Winkel [in]

Typ: FLOAT

Drehwinkel um die beliebige Achse in Bogenmaßen. Winkel werden gegen den Uhrzeigersinn gemessen, wenn sie entlang der beliebigen Achse zum Ursprung schauen.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Methode fehlschlägt, kann der Rückgabewert D3DERR_INVALIDCALL werden.

Bemerkungen

Diese Methode fügt die Drehung dem Matrixstapel mit der berechneten Rotationsmatrix wie folgt hinzu:

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

Da die Drehung mit dem Matrixstapel multipliziert wird, ist die Drehung relativ zum lokalen Koordinatenraum des Objekts.

Anforderungen

Anforderung Wert
Header
D3dx9math.h
Bibliothek
D3dx9.lib

Siehe auch

ID3DXMATRIXStack

D3DXMatrixRotationAxis

ID3DXMATRIXStack::RotateAxis

ID3DXMATRIXStack::RotateYawPitchRoll

ID3DXMATRIXStack::RotateYawPitchRollLocal