UnsafeNativeMethods.Vector3.TransformNormal Method

Language:

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 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
);

C++ public:
static Vector3 TransformNormal(
    Vector3 pOut,
    Vector3 pSource,
    Matrix pSourceMatrix
);

JScript public static function TransformNormal(
    pOut : Vector3,
    pSource : Vector3,
    pSourceMatrix : Matrix
) : Vector3;

Visual Basic	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 );
C++	public: static Vector3 TransformNormal( Vector3 pOut, Vector3 pSource, Matrix pSourceMatrix );
JScript	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. This allows you to use the TransformNormal method as a parameter for another method.

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.