scale(3G)

NAME
     scale - scales and mirrors the current matrix

FORTRAN 77 SPECIFICATION
     subroutine scale(x, y, z)
     real x, y, z

PARAMETERS
     x   expects the scale factor in the x direction.

     y   expects the scale factor in the y direction.

     z   expects the scale factor in the z direction.

DESCRIPTION
     scale modifies the current matrix, causing it to shrink, expand, or
     mirror coordinates that it transforms.  Values with a magnitude greater
     than 1 result in expansion; values with a magnitude less than 1 cause
     shrinkage.  Negative values result in mirrored coordinates.

     The x, y, and z scale factors are used to compute a 4x4 scale matrix,
     which then premultiplies the current matrix, as specified by mmode.  Thus
     if T is the current matrix, and S is the matrix computed by scale, T is
     replaced with S*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 scale is called while mmode is either MSINGL or
     MVIEWI are scaled.  Use pushma and popmat to preserve and restore the
     unscaled coordinate system.

SEE ALSO
     mmode, popmat, pushma, rotate, transl

NOTES
     Matrices that negate coordinates, such as scale (-1.0, 1.0, 1.0), reverse
     the directional order of a polygon's points and can cause the opposite of
     what is intended.