D3DXMatrixAffineTransformation2D-Funktion (D3DX10Math.h)

Erstellt eine 2D-affine Transformationsmatrix in 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,ein Punkt, der den Mittelpunkt der Drehung identifiziert. Wenn dieses Argument NULL ist, wird eine M RC-Matrix der Identität auf die Formel in "Hinweise" 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 Identitäts-Mt-Matrix auf die Formel in "Hinweise" angewendet.

Rückgabewert

Typ: D3DXMATRIX*

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

Hinweise

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

Mout = Mₛ * (Mrc)-1 * Mr * Mrc * Mₜ

Dabei gilt:

Mout = Ausgabematrix (pOut)

Ms = Skalierungsmatrix (Skalierung)

Mrc = Mitte der Rotationsmatrix (pRotationCenter)

Mr = Rotationsmatrix (Drehung)

Mt = Übersetzungsmatrix (pTranslation)

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

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

Anforderungen

Anforderung Wert
Header
D3DX10Math.h
Bibliothek
D3DX10.lib

Siehe auch

Mathematische Funktionen