Matrix.AffineTransformation Method

Language:

Builds a 3-D affine transformation matrix.

Definition

Visual Basic Public Sub AffineTransformation( _
    ByVal scaling As Single, _
    ByVal rotationCenter As Vector3, _
    ByVal rotation As Quaternion, _
    ByVal translation As Vector3 _
)

C# public void AffineTransformation(
    float scaling,
    Vector3 rotationCenter,
    Quaternion rotation,
    Vector3 translation
);

C++ public:
void AffineTransformation(
    float scaling,
    Vector3 rotationCenter,
    Quaternion rotation,
    Vector3 translation
);

JScript public function AffineTransformation(
    scaling : float,
    rotationCenter : Vector3,
    rotation : Quaternion,
    translation : Vector3
);

Visual Basic	Public Sub AffineTransformation( _ ByVal scaling As Single, _ ByVal rotationCenter As Vector3, _ ByVal rotation As Quaternion, _ ByVal translation As Vector3 _ )
C#	public void AffineTransformation( float scaling, Vector3 rotationCenter, Quaternion rotation, Vector3 translation );
C++	public: void AffineTransformation( float scaling, Vector3 rotationCenter, Quaternion rotation, Vector3 translation );
JScript	public function AffineTransformation( scaling : float, rotationCenter : Vector3, rotation : Quaternion, translation : Vector3 );

Parameters

scaling System.Single
Scaling factor. A value of zero indicates no scaling.

rotationCenter Microsoft.DirectX.Vector3
A Vector3 structure that indicates the point at 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 Vector2.Empty to specify no translation.

Remarks

The AffineTransformation method calculates the affine transformation matrix using the following formula, with matrix concatenation evaluated in left-to-right order.
M_out = M_s * (M_rc)^-1 * M_r * M_rc * M_t
where:
M_out = output matrix (this instance)
M_s = scaling matrix (scaling)
M_rc = center of rotation matrix (rotationCenter)
M_r = rotation matrix (rotation)
M_t = translation matrix (translation)

For 2-D affine transformations, use AffineTransformation2D.

Feedback? Please provide us with your comments on this topic.
For more help, visit the DirectX Developer Center

scaling	System.Single Scaling factor. A value of zero indicates no scaling.
rotationCenter	Microsoft.DirectX.Vector3 A Vector3 structure that indicates the point at 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 Vector2.Empty to specify no translation.