D3DXMatrixDecompose-Funktion (D3DX10Math.h)

Artikel
06/12/2023

Hinweis

Die D3DX-Hilfsprogrammbibliothek ist veraltet. Es wird empfohlen, stattdessen DirectXMath zu verwenden.

Unterteilt eine allgemeine 3D-Transformationsmatrix in ihre Skalar-, Rotations- und translationalen Komponenten.

Syntax

HRESULT D3DXMatrixDecompose(
  _In_       D3DXVECTOR3    *pOutScale,
  _In_       D3DXQUATERNION *pOutRotation,
  _In_       D3DXVECTOR3    *pOutTranslation,
  _In_ const D3DXMATRIX     *pM
);

Parameter

pOutScale [in]

Typ: D3DXVECTOR3*

Zeiger auf die Ausgabe D3DXVECTOR3 , die Skalierungsfaktoren enthält, die entlang der x-, y- und z-Achse angewendet werden.

pOutRotation [in]

Typ: D3DXQUATERNION*

Zeiger auf die D3DXQUATERNION , die die Drehung beschreibt.

pOutTranslation [in]

Typ: D3DXVECTOR3*

Zeiger auf den D3DXVECTOR3-Vektor, der die Übersetzung beschreibt.

pM [in]

Typ: const D3DXMATRIX*

Zeiger auf eine D3DXMATRIX-Matrix , die zerlegt werden soll.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, wird der Rückgabewert S_OK. Wenn die Funktion fehlschlägt, kann der Rückgabewert wie folgt aussehen: D3DERR_INVALIDCALL.

Anforderungen

Anforderung	Wert
Header	D3DX10Math.h
Bibliothek	D3DX10.lib

Siehe auch

Mathematische Funktionen