PLOT(5,F)                   AIX Technical Reference                   PLOT(5,F)



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



PURPOSE

Provides the graphics interface.

DESCRIPTION

The tplot commands interpret these graphics files for various devices,
performing the plotting instructions in the order that they appear.

A graphics file consists of a stream of plotting instructions.  Each
instruction consists of an ASCII letter usually followed by bytes of binary
information.  A point is designated by 4 bytes representing the x and y values;
each value is a two-byte signed integer.  The last designated point in an l, m,
n, or p instruction becomes the current point for the next instruction.

The following table lists each of the plot instructions and the corresponding
plot subroutines.

Instr    Sub       Description

a        arc       Draws the arc described by the following 12 bytes.  The
                   first 4 bytes describe the center point (x, y) of the arc or
                   circle.  The second 4 bytes describe the beginning point of
                   the arc.  The third 4 bytes describe the ending point of the
                   arc.  Arcs are drawn counterclockwise.  The results are
                   unpredictable if the three points do not really form an arc.

c        circle    Draws a circle whose center point is defined by the first 4
                   bytes, and whose radius is given as an integer in the
                   following two bytes.

e        erase     Starts another frame of output.

f        linemod   Uses the following string, terminated by a new-line
                   character, as the style for drawing further lines.  The
                   styles are dotted, solid, long-dashed, short-dashed, and
                   dot-dashed.

l        line      Draws a line from the point designated by the next 4 bytes
                   to the point designated by the following 4 bytes.

m        move      The next 4 bytes designate a new current point.

n        cont      Draws a line from the current point to the point designated
                   by the next 4 bytes.





Processed November 7, 1990         PLOT(5,F)                                  1

PLOT(5,F)                   AIX Technical Reference                   PLOT(5,F)



Instr    Sub       Description

p        point     Plots the point designated by the next 4 bytes.

s        space     The next 4 bytes designate the lower left corner of the
                   plotting area; followed by 4 bytes for the upper right
                   corner.  The plot is magnified or reduced to fit the device
                   as closely as possible.

t        label     Places the following ASCII string so that its first
                   character falls on the current point.  A new-line character
                   terminates the string.


The space setting

  space(0, 0, 480, 432);

exactly fills the plotting area with unity scaling for the IBM Personal
Computer Graphics Printer.  The upper limit is immediately outside the plotting
area, which is taken to be square.  Points outside the plotting area can be
displayed on devices that do not have square displays.

RELATED INFORMATION

In this book:  "plot" and "TERM."

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



























Processed November 7, 1990         PLOT(5,F)                                  2