rotate(3G)

NAME
     rotate, rot - rotates the current matrix

FORTRAN 77 SPECIFICATION
     subroutine rotate(a, axis)
     integer*4 a
     character axis

     subroutine rot(a, axis)
     real a
     character axis

PARAMETERS
     a      expects the angle of rotation.

     axis   expects the relative axis of rotation.  There are three character
            literal values for this parameter:

            'x' indicates the x-axis.

            'y' indicates the y-axis.

            'z' indicates the z-axis.

DESCRIPTION
     rotate and rot specify an angle (a) and an axis of rotation (axis).  The
     angle given to rotate is an integer and is specified in tenths of degrees
     according to the right-hand rule.  The angle given to rot is a floating
     point value and is specified in degrees according to the right-hand rule.

     The angle and axis are used to compute a 4x4 rotation matrix, which then
     premultiplies the current matrix, as specified by mmode.  Thus if T is
     the current matrix, and R is the rotation matrix computed by rotate or
     rot, T is replaced with R*T.  The current matrix is the top matrix on the
     transformation stack if mmode is MSINGL, the top matrix on the ModelView
     matrix stack if mmode is MVIEWI, the Projection matrix if mmode is
     MPROJE, or the Texture matrix if mmode is MTEXTU.

     All objects drawn after rotate or rot is called while mmode is either
     MSINGL or MVIEWI are rotated.  Use pushma and popmat to preserve and
     restore the unrotated coordinate system.

SEE ALSO
     mmode, popmat, pushma, scale, transl