NAME

       PLOTIT - A line-drawing routine, described in terms of "pen moves".  Most calls to PLOTIT
       specify whether the "pen" should be up (not drawing) or down (drawing) and then move it to
       a designated position in the metacode coordinate system.  The polylines resulting from the
       pen moves are buffered; some calls to PLOTIT just cause the SPPS polyline buffer to be
       flushed.

STATUS

       Metacode units are no longer used in NCAR Graphics; thus, PLOTIT is considered an obsolete
       routine.

       The current recognized coordinate systems are GKS world coordinates, GKS normalized device
       coordinates, NCAR Graphics fractional coordinates, and NCAR Graphics user coordinates.
       See the NCAR Graphics User Document "NCAR Graphics Fundamentals, UNIX Version" for a
       description of these coordinate systems.

       PLOTIT continues to be provided for compatibility of early NCAR Graphics codes.  If you
       are writing new code, we suggest that you use the routine PLOTIF which uses fractional
       coordinates.

       The following definition of the Metacode Coordinate System is included for the purpose of
       interpreting and converting codes:

       The metacode coordinates of a point are integers IMX and IMY between 0 and 32767
       inclusive.  The area addressed is a square in a "metacode space" that is usually mapped
       into a square subset of the addressable area of the plotting device.  Metacode coordinates
       were used in calls to the routine PLOTIT and are returned in calls to FL2INT.

SYNOPSIS

       CALL PLOTIT (IX,IY,IP)

C-BINDING SYNOPSIS

       #include <ncarg/ncargC.h>

       void c_plotit(int ix, int iy, int ip);

DESCRIPTION

       IX          (an input expression of type INTEGER) is the X metacode coordinate of the
                   point to which the plotter pen is to be moved.

       IY          (an input expression of type INTEGER) is the Y metacode coordinate of the
                   point to which the plotter pen is to be moved.

       IP          (an input expression of type INTEGER) determines whether the movement of the
                   plotter pen to the point (IX,IY) will occur with the pen up (IP = 0), or with
                   the pen down (IP = 1).  If IP = 2, no pen move occurs, but the SPPS polyline
                   buffer is flushed.  For historical reasons, a "CALL PLOTIT (0,0,0)" will also
                   flush the buffer.

                   The size of the SPPS polyline buffer can be changed by calling the parameter-
                   setting routine SETUSV to set the parameter 'PB'.  The legal range of 'PB' is
                   between 2 and 50.  For example, to set 'PB' to 2, use "CALL SETUSV ('PB',2)".

                   The SPPS polyline buffer is provided to increase drawing efficiency.

C-BINDING DESCRIPTION

       The C-binding argument descriptions are the same as the FORTRAN argument descriptions.

ACCESS

       To use PLOTIT or c_plotit, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c,
       preferably in that order.

SEE ALSO

       Online: gpl, fl2int, plotif, setusv, getusv, sflush, frstpt, vector, line, curve, spps,
       spps_converters

       Hardcopy: NCAR Graphics Fundamentals, UNIX Version; User's Guide for NCAR GKS-0A Graphics

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research
       The use of this Software is governed by a License Agreement.