Name

PEXTransformPoints

Synopsis

int PEXTransformPoints(PEXMatrix transform, int count, PEXCoord ∗points, PEXCoord ∗points_return)

Arguments

transformThe transformation matrix to apply to the points

countThe number of points to transform

pointsA pointer to an array of 3D points to transform

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

Returns

Zero if successful; otherwise, one of the following:

PEXBadHomoCoord - one or more of the transformed points has a homogeneous coordinate of 0.

Description

This function applies the specified homogeneous transformation matrix to the list of points.  In applying the transformation, the points are first converted to homogeneous points by assigning them a homogeneous coordinate of 1.  The transformation is then applied:

P’ = TxP

Where P is the point, treated as a column vector, and T is the transformation matrix.  The points are then mapped to 3D by dividing their first three coordinates by the computed homogeneous coordinate. 

If the function returns unsuccessfully, all points other than those with a homogeneous coordinate of 0 will be transformed and returned. 

If the return array is the same as the input array, the function will overwrite the input values with the transformed values. 

Errors

None

See Also

PEXTransformPoints2D, PEXTransformPoints4D, PEXTransformPoints2DH