                                                                plot
Chapter 14 Plotting and Reporting Operations

Similar to the area_plot command, the plot function generates a plot of the
current, active map.  The user may designate the plotter, label type and size
and optional pen:set assignments.

plot

    Plots the current map on the specified device.

         plot [-s] [pname] dev scale ltype [sizen] [fname] [-L] 

    This function will cause the current map to be plotted to plotting device
    dev, at a scale of 1:scale, with label type ltype at character size sizen.
    Setting the -s option will initiate a selective plot, and will require an
    associated pen file name from which set:pen correspondence may be derived.
    No option defaults to plotting all objects in pen 1.  In order to utilize a
    pen file, the -s option must be invoked, even if all objects are to be
    plotted (select 0 for all objects).

    When creating an ascii plot file (dev=3), plotter origin is assumed to be
    center unless the -L argument is specified which indicates a lower-left
    origin.  In all other cases, (dev!=3), plot views the config file entry for
    the designated plotter type (plt1_type or plt2_type); if the equivalency
    string begins with the letter L, then the origin will be assumed to be
    lower-left.  If the string value begins with any other character, or has no
    entry at all, then the plot origin will be assumed to be the center.
     
    To abort a plot command (once invoked), press the ESC key; the plotting may
    continue for a short period, as the plotter buffer will continue to
    function, even though the actual function has been stopped.

    The plot function also includes a feature which will automatically roll
    the plotter media to a new frame at the end of the current plot.  This
    allows the user to batch several plots without concern about being present
    to forward the media for the next plot.
    ___________________________________________________________________________
    Options/arguments:

         -s        Implies a selective plot and requires pname
         pname     Pen assignment file name
         dev       Plotter device code, where:
                   0 = screen
                   1 = plotter1
                   2 = plotter2
                   3 = ascii file
         scale     Plot scale denominator (24000 fro 1:24000)
         ltype     Label type, where:
                   0 = none
                   1 = record number
                   2 = serial number
                   3 = first attribute only
                   4 = all attributes (concatenated)



         sizen     Label size where value is character size in mils
         fname     Ascii output file name; used only when dev=3
         -L        Indicates plotter device has lower-left origin (i.e.,
                   HP7545)
    ___________________________________________________________________________
    Example(s):

    To generate a plot of the active map on plotting device 2, using a scale
    of 1:24000, with the first attribute labels displayed at 0.10 inches, for
    all objects, enter:
     
         plot 2 24000 3 100
     
    To selectively plot objects from the current map onto plotting device 1,
    with a scale of 1:36000, with record numbers labeled at 0.15 inches in
    size, using the pen assignments defined in the file pmap, enter:

         plot -s pmap 1 36000 1 150
    ___________________________________________________________________________
    See also:

              header, mlist_create, plot_ascii, p_create, all set_ functions
    ___________________________________________________________________________
