UnsafeNativeMethods.Matrix.Transformation Method

Language:

Builds a transformation matrix.

Note: For programming in Microsoft Visual Basic .NET or Microsoft JScript .NET, use the equivalent method in the Microsoft.DirectX structures.

Definition

Visual Basic Public Shared Function Transformation( _
    ByVal pOut As Matrix, _
    ByVal scalingCenter As Vector3, _
    ByVal scalingRotation As Quaternion, _
    ByVal scalingFactor As Vector3, _
    ByVal rotationCenter As Vector3, _
    ByVal rotation As Quaternion, _
    ByVal translation As Vector3 _
) As Matrix

C# public static Matrix Transformation(
    Matrix pOut,
    Vector3 scalingCenter,
    Quaternion scalingRotation,
    Vector3 scalingFactor,
    Vector3 rotationCenter,
    Quaternion rotation,
    Vector3 translation
);

C++ public:
static Matrix Transformation(
    Matrix pOut,
    Vector3 scalingCenter,
    Quaternion scalingRotation,
    Vector3 scalingFactor,
    Vector3 rotationCenter,
    Quaternion rotation,
    Vector3 translation
);

JScript public static function Transformation(
    pOut : Matrix,
    scalingCenter : Vector3,
    scalingRotation : Quaternion,
    scalingFactor : Vector3,
    rotationCenter : Vector3,
    rotation : Quaternion,
    translation : Vector3
) : Matrix;

Visual Basic	Public Shared Function Transformation( _ ByVal pOut As Matrix, _ ByVal scalingCenter As Vector3, _ ByVal scalingRotation As Quaternion, _ ByVal scalingFactor As Vector3, _ ByVal rotationCenter As Vector3, _ ByVal rotation As Quaternion, _ ByVal translation As Vector3 _ ) As Matrix
C#	public static Matrix Transformation( Matrix pOut, Vector3 scalingCenter, Quaternion scalingRotation, Vector3 scalingFactor, Vector3 rotationCenter, Quaternion rotation, Vector3 translation );
C++	public: static Matrix Transformation( Matrix pOut, Vector3 scalingCenter, Quaternion scalingRotation, Vector3 scalingFactor, Vector3 rotationCenter, Quaternion rotation, Vector3 translation );
JScript	public static function Transformation( pOut : Matrix, scalingCenter : Vector3, scalingRotation : Quaternion, scalingFactor : Vector3, rotationCenter : Vector3, rotation : Quaternion, translation : Vector3 ) : Matrix;

Parameters

pOut Microsoft.DirectX.Matrix
Resulting Matrix structure.

scalingCenter Microsoft.DirectX.Vector3
A Vector3 structure that identifies the scaling center point.

scalingRotation Microsoft.DirectX.Quaternion
A Quaternion structure that specifies the scaling rotation. Use Quaternion.Identity to specify no scaling.

scalingFactor Microsoft.DirectX.Vector3
A Vector3 structure that is the scaling vector.

rotationCenter Microsoft.DirectX.Vector3
A Vector3 structure that is a point identifying the center of rotation.

rotation Microsoft.DirectX.Quaternion
A Quaternion structure that specifies the rotation. Use Quaternion.Identity to specify no rotation.

translation Microsoft.DirectX.Vector3
A Vector3 structure that represents the translation. Use Vector3.Empty to specify no translation.

Return Value

Microsoft.DirectX.Matrix
Resulting Matrix structure.

Remarks

The Transformation method calculates the transformation matrix using the following formula, with matrix concatenation evaluated in left-to-right order.

M _out = (M_sc)^-1 * (M_sr)^-1 * M_s * M_sr * M_sc * (M_rc)^-1 * M_r * M_rc * M_t

where:

M _out = output transformation matrix (the return value)

M _sc = scaling center matrix (scalingCenter)

M _sr = scaling rotation matrix (scalingRotation)

M _s = scaling matrix (scalingFactor)

M _rc = center of rotation matrix (rotationCenter)

M _r = rotation matrix (rotation)

M _t = translation matrix (translation)

The return value for this method is the same value returned in the pOut parameter. This allows you to use the Transformation method as a parameter for another method.

pOut	Microsoft.DirectX.Matrix Resulting Matrix structure.
scalingCenter	Microsoft.DirectX.Vector3 A Vector3 structure that identifies the scaling center point.
scalingRotation	Microsoft.DirectX.Quaternion A Quaternion structure that specifies the scaling rotation. Use Quaternion.Identity to specify no scaling.
scalingFactor	Microsoft.DirectX.Vector3 A Vector3 structure that is the scaling vector.
rotationCenter	Microsoft.DirectX.Vector3 A Vector3 structure that is a point identifying the center of rotation.
rotation	Microsoft.DirectX.Quaternion A Quaternion structure that specifies the rotation. Use Quaternion.Identity to specify no rotation.
translation	Microsoft.DirectX.Vector3 A Vector3 structure that represents the translation. Use Vector3.Empty to specify no translation.