D3DXMatrixAffineTransformation-Funktion (D3DX10Math.h)
Erstellt eine 3D-affine Transformationsmatrix. NULL-Argumente werden als Identitätstransformationen behandelt.
Syntax
D3DXMATRIX* D3DXMatrixAffineTransformation(
_In_ D3DXMATRIX *pOut,
_In_ FLOAT Scaling,
_In_ const D3DXVECTOR3 *pRotationCenter,
_In_ const D3DXQUATERNION *pRotation,
_In_ const D3DXVECTOR3 *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 D3DXVECTOR3 *
Zeiger auf ein D3DXVECTOR3, ein Punkt, der den Mittelpunkt der Drehung identifiziert. Wenn dieses Argument NULL ist, wird eine Rc-Matrix für identität M auf die Formel in "Hinweise" angewendet.
-
pRotation [ In]
-
Typ: const D3DXQUATERNION *
Zeiger auf ein D3DXQUATERNION-Element, das die Drehung angibt. Wenn dieses Argument NULL ist, wird eine M r-Identitätsmatrix auf die Formel in "Hinweise" angewendet.
-
pTranslation [ In]
-
Typ: const D3DXVECTOR3 *
Zeiger auf eine D3DXVECTOR3-Struktur, die die Übersetzung darstellt. Wenn dieses Argument NULL ist, wird eine Mt-Identitätsmatrix 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, wobei 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 = Mittelpunkt der Rotationsmatrix (pRotationCenter)
Mr = Rotationsmatrix (pRotation)
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 D3DXMatrixAffineTransformation-Funktion als Parameter für eine andere Funktion verwendet werden.
Verwenden Sie für 2D-affine Transformationen D3DXMatrixAffineTransformation2D.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header |
|
| Bibliothek |
|