usr/share/man/cat5/plot.0



PLOT(5)              BSD Programmer's Manual              PLOT(5)


N\bNA\bAM\bME\bE
       plot - graphics interface

D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
       Files of this format are produced by routines described in
       _\bp_\bl_\bo_\bt(3X) and _\bp_\bl_\bo_\bt(3F), and  are  interpreted  for  various
       devices  by  commands  described  in _\bp_\bl_\bo_\bt(1G).  A graphics
       file is a stream of plotting instructions.  Each  instruc-
       tion consists of an ASCII letter usually followed by bytes
       of binary information.  The instructions are  executed  in
       order.   A  point is designated by four bytes representing
       the x and y values; each value is a signed  integer.   The
       last  designated  point in an l\bl,\b, m\bm,\b, n\bn,\b, a\ba,\b, or p\bp instruction
       becomes the `current point' for the next instruction.  The
       a\ba  and c\bc instructions change the current point in a manner
       dependent upon the specific device.

       Each of the following descriptions begins with the name of
       the corresponding routine in _\bp_\bl_\bo_\bt(3X).

       m\bm  move: The next four bytes give a new current point.

       n\bn  cont:  Draw  a line from the current point to the point
          given by the next four bytes.

       p\bp  point: Plot the point given by the next four bytes.

       l\bl  line: Draw a line from the point given by the next four
          bytes to the point given by the following four bytes.

       t\bt  label:  Place  the  following  ASCII string so that its
          first character falls on the current point.  The string
          is terminated by a newline.

       a\ba  arc:  The  first  four  bytes give the center, the next
          four give the starting point, and the  last  four  give
          the end point of a circular arc.  The least significant
          coordinate of the end point is used only  to  determine
          the quadrant.  The arc is drawn counter-clockwise.

       c\bc  circle:  The  first  four  bytes give the center of the
          circle, the next two the radius.

       e\be  erase: Start another frame of output.

       f\bf  linemod: Take the following string, up to a newline, as
          the  style  for  drawing further lines.  The styles are
          `dotted,'  `solid,'  `longdashed,'  `shortdashed,'  and
          `dotdashed.'  Effective only in _\bp_\bl_\bo_\bt _\b4_\b0_\b1_\b4 and _\bp_\bl_\bo_\bt _\bv_\be_\br_\b.

       s\bs  space: The next four bytes give the lower  left  corner


7th Edition               April 29, 1991                        1


PLOT(5)              BSD Programmer's Manual              PLOT(5)


          of the plotting area; the following four give the upper
          right corner.  The plot will be magnified or reduced to
          fit the device as closely as possible.

          Space settings that exactly fill the plotting area with
          unity scaling appear below for devices supported by the
          filters  of  _\bp_\bl_\bo_\bt(1G).  The upper limit is just outside
          the plotting area.  In every case the plotting area  is
          taken  to  be square; points outside may be displayable
          on devices whose face isn't square.

          4013      space(0, 0, 780, 780);
          4014      space(0, 0, 3120, 3120);
          ver       space(0, 0, 2048, 2048);
          300, 300s space(0, 0, 4096, 4096);
          450       space(0, 0, 4096, 4096);

S\bSE\bEE\bE A\bAL\bLS\bSO\bO
       plot(1G), plot(3X), plot(3F), graph(1G)

B\bBU\bUG\bGS\bS
       A  _\bl_\ba_\bb_\be_\bl  instruction  immediately  followed  by  a   _\bc_\bo_\bn_\bt
       instruction does the wrong thing on a 4014.


7th Edition               April 29, 1991                        2