PEXTransformPoints2DH Utility


Synopsis

 
   void PEXTransformPoints2DH(
        PEXMatrix3x3 transform,
        int count,
        PEXCoord *points,
        PEXCoord *points_return
   )
 

Arguments

transform
The transformation matrix to apply to the points.

count
The number of points to transform.

points
A pointer to an array of 2D homogeneous points to transform.

points_return
A pointer to an array in which to store the transformed points.

Returns

None.

Description

Invoke PEXTransformPoints2DH to apply the specified homogeneous transformation matrix to the list of two-dimensional homogeneous points (P = x, y, w). The transformation is applied:

  P' = TxP

Where P is the point, treated as a column vector, and T is the transformation matrix. The function returns P' = (x', y', w').

If the return array is the same as the input array, then this utility overwrites the input values with the transformed values.

Errors

None.

See Also

For a list of miscellaneous transformation utilities, see Miscellaneous Transformation Utilities. For a list of related topics, see PEXlib Utilities.