Microsoft DirectX 8.1 (Visual Basic)

D3DXVec3TransformNormal

Transforms the 3-D vector normal by the given matrix.

D3DXVec3TransformNormal( _ 
    VOut As D3DVECTOR, _ 
    V1 As D3DVECTOR, _ 
    M As D3DMATRIX)

Parameters

VOut
D3DVECTOR type that is the result of the operation, the transformed vector.
V1
The source D3DVECTOR type.
M
The source D3DMATRIX type.

Error Codes

If the function fails, an error is raised and Err.Number can be set to one of the following values.

D3DERR_INVALIDCALL
D3DERR_OUTOFVIDEOMEMORY

For information on trapping errors, see the Microsoft® Visual Basic® Error Handling topic.

Remarks

This function transforms the vector normal (x, y, z, 0) of the vector, V1, by the matrix, M.

If you transform a normal by a nonaffine 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.