Name

PEXRotateGeneral

Synopsis

int PEXRotateGeneral(PEXCoord ∗point1, PEXCoord ∗point2, double angle, PEXMatrix matrix_return)

Arguments

point1endpoint of line segment defining rotation axis

point2endpoint of line segment defining rotation axis

angleangle of the rotation in radians

matrix_return
matrix into which rotation matrix is stored

Returns

Zero if successful; otherwise, one of the following:

PEXBadAxis - the endpoints are coincident

Description

This routine formats a matrix for a right-handed rotation about an arbitrary axis.  The rotation axis is defined by the line segment joining the two points.  The angle is in radians and is measured counter-clockwise when looking from the first point to second point along the specified axis. 

Returns unsuccessfully if the points are coincident. 

Errors

None

See Also