ID3DXMATRIXStack::RotateAxis-Methode (D3dx9math.h)

Hinweis

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

Dreht sich (relativ zum Weltkoordinatenraum) um eine beliebige Achse.

Syntax

HRESULT RotateAxis(
  [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 im Bogenmaß. Winkel werden gegen den Uhrzeigersinn gemessen, wenn sie entlang der beliebigen Achse in Richtung des Ursprungs betrachtet werden.

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

Da die Drehung mit dem Matrixstapel rechts multipliziert wird, ist die Drehung relativ zum Weltkoordinatenraum.

Anforderungen

Anforderung Wert
Header
D3dx9math.h
Bibliothek
D3dx9.lib

Siehe auch

ID3DXMATRIXStack

D3DXMatrixRotationAxis

ID3DXMATRIXStack::RotateAxisLocal

ID3DXMATRIXStack::RotateYawPitchRoll

ID3DXMATRIXStack::RotateYawPitchRollLocal