PLOT(3x,L)                  AIX Technical Reference                  PLOT(3x,L)



-------------------------------------------------------------------------------
plot



PURPOSE

Performs graphic output.

LIBRARY

Graphics Libraries (libplot.a, libprint.a, lib300.a, and others)

SYNTAX



                void openpl ( )             void move (x, y)
                                            int x, y;
                void erase ( )
                                            void cont (x, y)
                void label (s)              int x, y;
                char *s;
                                            void point (x, y)
                void line (x1, y1, x2, y2)  int x, y;
                int  x1, y1, x2, y2;
                                            void linemod (s)
                void circle (x, y, r)       char *s;
                int x, y, r;
                                            void space (x0, y0, x1, y1)
                void arc (x, y, x0, y0, x1, int x0, y0, x1, y1;
                int x, y, x0, y0, x1, y1;
                                            void closepl ( )



DESCRIPTION

The plot subroutine family generates graphic output in a relatively
device-independent manner.  The space subroutine must be used before any of
these functions to declare the amount of space necessary.  The openpl
subroutine must be used before any of the others to open the device for
writing.  The closepl subroutine flushes the output.

The circle subroutine draws a circle of radius r with center at the point
(x, y).  The arc subroutine draws an arc of a circle with center at the point
(x, y) between the points (x0, y0) and (x1, y1).  String parameters to the
label and linemod subroutines are terminated by null characters and must not
contain new-line characters.  See "plot" for a description of the effect of the
remaining functions.

These routines appear in several separate libraries.  The routines in the



Processed November 8, 1991         PLOT(3x,L)                                 1






PLOT(3x,L)                  AIX Technical Reference                  PLOT(3x,L)



libplot.a library generate device-independent output.  The tplot command
interprets this output for a specific device.

The other versions of these routines each generate output for a specific
device.  You should normally redirect the output of libprint.a to the printer.
You can save the output of libprint.a in a regular file and print it later.
See the "Files" section below for a list of all the device-dependent routines.

See the tplot command in the AIX Operating System Commands Reference for
information on how to code the outputs from the different library routines for
printing.

On an IBM Graphics Printer, the horizontal distance between points is not the
same as the vertical distance between points.  This means that arcs and circles
are drawn as ellipses.  Similarly, drawing a square (with four calls to the
line subroutine) produces a rectangle.  To adjust for this, call the space
subroutine with appropriate scaling factors.

EXAMPLES

1. To print plotting instructions from libprint.a using tplot:

      libprint.out | tplot -Tprint

   where libprint.out is an executable obtained from linking the libprint.a
   graphics library to a source code containing plot subroutines such as
   circle() and line().

2. To produce device-independent output using libplot.a and tplot:

      libplot.out | tplot -Tworkstation

   where libplot.out is an executable obtained from linking the libplot.a
   graphics library to a source code containing plot subroutines such as
   cirle() and line().  workstation can be any device name supported by tplot.

FILES

/usr/lib/libplot.a  For tplot filters
/usr/lib/libprint.a For an IBM PC Graphics Printer
/usr/lib/lib300.a   For DASI 300
/usr/lib/lib300s.a  For DASI 300s
/usr/lib/lib450.a   For DASI 450
/usr/lib/lib4014.a  For Tektronix 4014
/usr/lib/librt0.a   For a vt100 terminal.
/usr/lib/libdumb.a  For a generic printer.

RELATED INFORMATION

In this book:  "plot."

The graph and tplot commands in AIX Operating System Commands Reference.



Processed November 8, 1991         PLOT(3x,L)                                 2