Matrix.Transformation Method

Article
10/15/2009

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Builds a transformation matrix.

Namespace: Microsoft.WindowsMobile.DirectX
Assembly: Microsoft.WindowsMobile.DirectX (in Microsoft.WindowsMobile.DirectX.dll)

Syntax

'Declaration
Public Shared Function Transformation ( _
    scalingCenter As Vector3, _
    scalingRotation As Quaternion, _
    scaling As Vector3, _
    rotationCenter As Vector3, _
    rotation As Quaternion, _
    translation As Vector3 _
) As Matrix
'Usage
Dim scalingCenter As Vector3
Dim scalingRotation As Quaternion
Dim scaling As Vector3
Dim rotationCenter As Vector3
Dim rotation As Quaternion
Dim translation As Vector3
Dim returnValue As Matrix

returnValue = Matrix.Transformation(scalingCenter, _
    scalingRotation, scaling, rotationCenter, _
    rotation, translation)

public static Matrix Transformation(
    Vector3 scalingCenter,
    Quaternion scalingRotation,
    Vector3 scaling,
    Vector3 rotationCenter,
    Quaternion rotation,
    Vector3 translation
)

public:
static Matrix Transformation(
    Vector3 scalingCenter, 
    Quaternion scalingRotation, 
    Vector3 scaling, 
    Vector3 rotationCenter, 
    Quaternion rotation, 
    Vector3 translation
)

static member Transformation : 
        scalingCenter:Vector3 * 
        scalingRotation:Quaternion * 
        scaling:Vector3 * 
        rotationCenter:Vector3 * 
        rotation:Quaternion * 
        translation:Vector3 -> Matrix

Parameters

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

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

scaling
Type: Microsoft.WindowsMobile.DirectX.Vector3
A Vector3 structure that is the scaling vector.

rotationCenter
Type: Microsoft.WindowsMobile.DirectX.Vector3
A Vector3 structure that is a point that identifies the center of rotation.

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

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

Return Value

Type: Microsoft.WindowsMobile.DirectX.Matrix
A transformed 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 (scaling)
M rc = center of rotation matrix (rotationCenter)
M r = rotation matrix (rotation)
M t = translation matrix (translation)

For 3-D affine transformations, use AffineTransformation2D.

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Platforms

Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Compact Framework

Supported in: 3.5, 2.0

Share via