PEXRotate Utility

Synopsis

 
   int PEXRotate(
       int axis,
       double angle,
       PEXMatrix matrix_return
   )

Arguments

axis: The axis about which you want the rotation to occur (PEXXAxis, PEXYAxis or PEXZAxis).
angle: Angle of the rotation in radians.
matrix_return: Matrix into which rotation matrix is stored.

Returns

Zero if successful; otherwise, one of the following:

PEXBadAxis: Invalid axis value specified.

Description

Invoke PEXRotate to create a rotation matrix about the specified axis.

The resulting matrix rotates by the angle specified in radians about the origin.

This utility returns unsuccessfully if the specified axis is not one defined.

Errors

None.

See Also

PEXRotate2D
PEXRotateGeneral

For a list of modeling transformation utilities, see Modeling Transformation Utilities. For a list of related topics, see PEXlib Utilities.