D3DXMatrixTransformation2D-Funktion (D3DX10Math.h)

Hinweis

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

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

Syntax

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

Parameter

pOut [ein, aus]

Typ: D3DXMATRIX*

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

pScalingCenter [in]

Typ: const D3DXVECTOR2*

Zeiger auf einen D3DXVECTOR2, einen Punkt, der das Skalierungszentrum identifiziert. Wenn dieses Argument NULL ist, wird eine M_sc-Matrix der Identität auf die Formel in Hinweise angewendet.

ScalingRotation [in]

Typ: FLOAT

Zeiger auf den Skalierungsdrehungsfaktor.

pScaling [in]

Typ: const D3DXVECTOR2*

Zeiger auf eine D3DXVECTOR2-Struktur, einen Punkt, der die Skalierung identifiziert. Wenn dieses Argument NULL ist, wird eine Ms-Matrix der Identität auf die Formel in Den Hinweisen angewendet.

pRotationCenter [in]

Typ: const D3DXVECTOR2*

Zeiger auf eine D3DXVECTOR2-Struktur, einen Punkt, der das Drehzentrum identifiziert. Wenn dieses Argument NULL ist, wird eine M_rc-Matrix der Identität auf die Formel in Den Hinweisen angewendet.

Drehung [in]

Typ: FLOAT

Der Drehwinkel in Bogenmaßen.

pTranslation [in]

Typ: const D3DXVECTOR2*

Zeiger auf eine D3DXVECTOR2-Struktur, um die Übersetzung zu identifizieren. Wenn dieses Argument NULL ist, wird eine Mt-Matrix der Identität auf die Formel in Anmerkungen angewendet.

Rückgabewert

Typ: D3DXMATRIX*

Zeiger auf eine D3DXMATRIX-Struktur, die die Transformationsmatrix enthält.

Bemerkungen

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

M_out = (M_sc)⁻¹* (M_sr)⁻¹* Ms * M_sr * M_sc * (M_rc)⁻¹* M_r * M_rc * Mt

Dabei gilt Folgendes:

M_out = Ausgabematrix (pOut)

M_sc = Skalierungszentrierungsmatrix (pScalingCenter)

M_sr = Skalierungsrotation (pScalingRotation)

Ms = Skalierungsmatrix (pScaling)

M_rc = Mittelpunkt der Rotationsmatrix (pRotationCenter)

M_r = Rotationsmatrix (Rotation)

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

Verwenden Sie für 3D-Transformationen D3DXMatrixTransformation.

Anforderungen

Anforderung	Wert
Header	D3DX10Math.h
Bibliothek	D3DX10.lib

Siehe auch

Mathematische Funktionen