D3DXMatrixTransformation2D-Funktion (D3dx9math.h)

Erstellt eine 2D-Transformationsmatrix, die Transformationen in der XY-Ebene darstellt. NULL-Argumente werden als Identitätstransformationen behandelt.

Syntax

D3DXMATRIX* D3DXMatrixTransformation2D(
  _Inout_       D3DXMATRIX  *pOut,
  _In_    const D3DXVECTOR2 *pScalingCenter,
  _In_          FLOAT       pScalingRotation,
  _In_    const D3DXVECTOR2 *pScaling,
  _In_    const D3DXVECTOR2 *pRotationCenter,
  _In_          FLOAT       Rotation,
  _In_    const D3DXVECTOR2 *pTranslation
);

Parameter

pOut [ in, out]

Typ: D3DXMATRIX*

Zeiger auf die D3DXMATRIX-Struktur, die das Ergebnis der Transformationen enthält.

pScalingCenter [ In]

Typ: const D3DXVECTOR2 *

Zeiger auf eine D3DXVECTOR2-Struktur, ein Punkt, der das Skalierungscenter identifiziert. Wenn dieses Argument NULL ist, wird eine M sc-Matrix der Identität auf die Formel in "Hinweise" angewendet.

pScalingRotation [ In]

Typ: FLOAT

Der Skalierungsrotationsfaktor.

pScaling [ In]

Typ: const D3DXVECTOR2 *

Zeiger auf eine D3DXVECTOR2-Struktur, ein Punkt, der die Skala identifiziert. Wenn dieses Argument NULL ist, wird eine Ms-Identitätsmatrix auf die Formel in "Hinweise" angewendet.

pRotationCenter [ In]

Typ: const D3DXVECTOR2 *

Zeiger auf eine D3DXVECTOR2-Struktur, ein Punkt, der den Drehmittelpunkt 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 Drehwinkel im Bogenmaß.

pTranslation [ In]

Typ: const D3DXVECTOR2 *

Zeiger auf eine D3DXVECTOR2-Struktur, die die Übersetzung identifiziert. 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 die Transformationsmatrix enthält.

Hinweise

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

Mout = (Msc)⁻. * (Msr)⁻. Ms * M * sr * Msc * (Mrc)⁻. * Mr * Mrc * Mt

Dabei gilt:

M out = Ausgabematrix (pOut)

M sc = Skalierungscentermatrix (pScalingCenter)

M sr = Skalierungsrotationsmatrix (pScalingRotation)

Ms = Skalierungsmatrix (pScaling)

M rc = Mitte der Rotationsmatrix (pRotationCenter)

M r = 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 D3DXMatrixTransformation2D-Funktion als Parameter für eine andere Funktion verwendet werden.

Verwenden Sie für 3D-Transformationen D3DXMatrixTransformation.

Anforderungen

Anforderung Wert
Header
D3dx9math.h
Bibliothek
D3dx9.lib

Weitere Informationen

Mathematische Funktionen

D3DXMatrixAffineTransformation2D

Transformationen (Direct3D 9)