D3DXMatrixAffineTransformation2D-Funktion (D3DX10Math.h)

Hinweis

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

Erstellt eine 2D-affine Transformationsmatrix auf der x-y-Ebene. NULL-Argumente werden als Identitätstransformationen behandelt.

Syntax

D3DXMATRIX* D3DXMatrixAffineTransformation2D(
  _In_       D3DXMATRIX  *pOut,
  _In_       FLOAT       Scaling,
  _In_ const D3DXVECTOR2 *pRotationCenter,
  _In_       FLOAT       Rotation,
  _In_ const D3DXVECTOR2 *pTranslation
);

Parameter

pOut [in]

Typ: D3DXMATRIX*

Zeiger auf die D3DXMATRIX , die das Ergebnis des Vorgangs ist.

Skalierung [in]

Typ: FLOAT

Skalierungsfaktor.

pRotationCenter [in]

Typ: const D3DXVECTOR2*

Zeiger auf einen D3DXVECTOR2, einen Punkt, der den Drehpunkt identifiziert. Wenn dieses Argument NULL ist, wird eine M_{rc-Identitätsmatrix} auf die Formel in Den Hinweisen angewendet.

Drehung [in]

Typ: FLOAT

Der Rotationswinkel.

pTranslation [in]

Typ: const D3DXVECTOR2*

Zeiger auf einen D3DXVECTOR2, der die Übersetzung darstellt. Wenn dieses Argument NULL ist, wird eine Mt-Matrix der Identität auf die Formel in Den Hinweisen angewendet.

Rückgabewert

Typ: D3DXMATRIX*

Zeiger auf eine D3DXMATRIX-Struktur, die eine affine Transformationsmatrix ist.

Bemerkungen

Diese Funktion berechnet die affine Transformationsmatrix mit der folgenden Formel, wobei die Matrixverkettung in der Reihenfolge von links nach rechts ausgewertet wird:

M_out = Ms * (M_rc)-1 * M_r * M_rc * Mt

Dabei gilt Folgendes:

M_out = Ausgabematrix (pOut)

Ms = Skalierungsmatrix (Skalierung)

M_rc = Mittelpunkt der Drehungsmatrix (pRotationCenter)

M_r = Drehungsmatrix (Drehung)

Mt = Übersetzungsmatrix (pTranslation)

Der Rückgabewert für diese Funktion ist derselbe Wert, der im pOut-Parameter zurückgegeben wird. Auf diese Weise kann die Funktion D3DXMatrixAffineTransformation2D als Parameter für eine andere Funktion verwendet werden.

Verwenden Sie für 3D-affine Transformationen D3DXMatrixAffineTransformation.

Anforderungen

Anforderung	Wert
Header	D3DX10Math.h
Bibliothek	D3DX10.lib

Siehe auch

Mathematische Funktionen