NAME

DoRotate − Create a rotation geometric transformation object

SYNOPSIS

C:

DtObject DoRotate(axis, angle)
DtAxis axis;
DtReal angle;

FORTRAN:

INTEGER∗4 DOROT(AXIS, ANGLE)
INTEGER∗4 AXIS
REAL∗8 ANGLE

DESCRIPTION

DoRotate creates a rotation geometric transformation object that modifies the current transformation matrix attribute. 

The parameter axis specifies the coordinate axis about which the rotation is to take place.  Possible values are:

DcXAxis <DCXAX>

DcYAxis <DCYAX>

DcZAxis <DCZAX>

The parameter angle specifies the angle of rotation.  It may take any positive or negative floating point value.  Positive rotations are determined by the right-hand rule; when looking down a given axis from the direction of positive infinity towards the origin, positive rotations are counterclockwise. 

By default, angle is measured in radians. You can change the unit of measure to degrees by using DsSetAngleUnits <DSSAU> to set the angle units to DcAngleDegrees <DCAD>. 

SEE ALSO

DoLookAtFrom(3D), DoScale(3D), DoShear(3D), DoTransformMatrix(3D), DoTranslate(3D), DsInqAngleUnits(3D), DsSetAngleUnits(3D)

September 02, 1992