Microsoft DirectX 9.0 SDK Update (October 2004)

UnsafeNativeMethods.Vector3.TransformNormal Method

Language:

Note: This documentation is preliminary and is subject to change.

Transforms a 3-D vector normal by the given 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 .NET Public Shared Function TransformNormal( _
    ByVal pOut As Vector3, _
    ByVal pSource As Vector3, _
    ByVal pSourceMatrix As Matrix _
) As Vector3
C# public static Vector3 TransformNormal(
    Vector3 pOut,
    Vector3 pSource,
    Matrix pSourceMatrix
);
Managed C++ public: static Vector3 TransformNormal(
    Vector3 pOut,
    Vector3 pSource,
    Matrix pSourceMatrix
);
JScript .NET public static function TransformNormal(
    pOut : Vector3,
    pSource : Vector3,
    pSourceMatrix : Matrix
) : Vector3;

Parameters

pOut Microsoft.DirectX.Vector3. A Vector3 structure that contains the results of this method.
pSource Microsoft.DirectX.Vector3. Source Vector3 structure.
pSourceMatrix Microsoft.DirectX.Matrix. Source Matrix structure.

Return Value

Microsoft.DirectX.Vector3 . A Vector3 structure that contains the results of this method.

Remarks

This method transforms the vector normal (x, y, z, 0) of the pSource vector by the pSourceMatrix source matrix.

If you transform a normal by a non-affine matrix, the matrix you pass to this function should be the transpose of the inverse of the matrix you would use to transform a coordinate.

The return value for this method is the same value returned in the pOut parameter. Resultantly, the TransformNormal method can be used as a parameter for another method.

See Also


© 2004 Microsoft Corporation. All rights reserved. Terms of use.

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