UnsafeNativeMethods.Vector3.TransformNormalArray Method

Language:

Transforms array (x, y, z, 0) by a 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 TransformNormalArray( _
    ByVal pOut As Vector3, _
    ByVal outStride As Integer, _
    ByVal pSource As Vector3, _
    ByVal vectorStride As Integer, _
    ByVal pSourceMatrix As Matrix, _
    ByVal count As Integer _
) As Vector3
C# public static Vector3 TransformNormalArray(
    Vector3 pOut,
    int outStride,
    Vector3 pSource,
    int vectorStride,
    Matrix pSourceMatrix,
    int count
);
C++ public:
static Vector3 TransformNormalArray(
    Vector3 pOut,
    int outStride,
    Vector3 pSource,
    int vectorStride,
    Matrix pSourceMatrix,
    int count
);
JScript public static function TransformNormalArray(
    pOut : Vector3,
    outStride : int,
    pSource : Vector3,
    vectorStride : int,
    pSourceMatrix : Matrix,
    count : int
) : Vector3;

Parameters

pOut Microsoft.DirectX.Vector3
A Vector3 structure that is the result of the method.
outStride System.Int32
Stride between vectors in the output data stream.
pSource Microsoft.DirectX.Vector3
Source Vector3 structure array.
vectorStride System.Int32
Stride between vectors in the input data stream.
pSourceMatrix Microsoft.DirectX.Matrix
Source Matrix structure.
count System.Int32
Number of elements in the array.

Return Value

Microsoft.DirectX.Vector3
A Vector3 structure that is the result of the method.

Remarks

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

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 TransformNormalArray method as a parameter for another method.


Send comments about this topic to Microsoft. © Microsoft Corporation. All rights reserved.

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