home *** CD-ROM | disk | FTP | other *** search
/ Encyclopedia of Graphics File Formats Companion / GFF_CD.ISO / formats / brl / spec / plot3.txt < prev    next >
Text File  |  1994-06-01  |  7KB  |  199 lines
  1.  
  2.  
  3.  
  4. PLOT3(5)                  FILE FORMATS                   PLOT3(5)
  5.  
  6.  
  7.  
  8. NAME
  9.      plot3 - 3-D and color graphic plotting interface
  10.  
  11. DESCRIPTION
  12.      Files of this  format  are  produced  by  programs  such  as
  13.      pixhist3d-pl(1), using the routines described in libplot3(3)
  14.      and are interpreted for various devices by standard programs
  15.      described  in  plot(1G), as well as additional programs such
  16.      as pl-fb(1).  The format of  output  from  libplot3  differs
  17.      from  that of libplot only in the addition of 3-D primatives
  18.      and color.  A graphics file is a stream of plotting instruc-
  19.      tions.  Each instruction consists of an ASCII letter usually
  20.      followed by bytes of binary information.   The  instructions
  21.      are  executed in order.  A point is designated by four bytes
  22.      representing the x and y values; each value is a signed  16-
  23.      bit  integer.  These integers are written with the most sig-
  24.      nificant byte first.  Three-dimensional data have  an  addi-
  25.      tional  z  value,  which  is  assumed  to  be  zero for two-
  26.      dimensional instructions.  The last designated point  in  an
  27.      l,  m, n, p, L, M, N, or P instruction becomes the ``current
  28.      point'' for the next instruction.
  29.  
  30.      Each of the following descriptions begins with the  name  of
  31.      the corresponding routine in libplot3(3).
  32.  
  33.      m  move:  The next four bytes give a new current point.
  34.  
  35.      n  cont:  Draw a line from the current point  to  the  point
  36.         given by the next four bytes.  See plot(1G).
  37.  
  38.      p  point:  Plot the point given by the next four bytes.
  39.  
  40.      l  line:  Draw a line from the point given by the next  four
  41.         bytes to the point given by the following four bytes.
  42.  
  43.      t  label:  Place the following  ASCII  string  so  that  its
  44.         first  character  falls on the current point.  The string
  45.         is terminated by a new-line.
  46.  
  47.      a  arc:  The first four bytes give the center, the next four
  48.         give  the  starting point, and the last four give the end
  49.         point of a circular arc.  The least  significant  coordi-
  50.         nate  of the end point is used only to determine the qua-
  51.         drant.  The arc is drawn counter-clockwise.
  52.  
  53.      c  circle:  The first four bytes give the center of the cir-
  54.         cle,  the  next two the radius.  Circles and arcs are not
  55.         supported on all devices.
  56.  
  57.      e  erase:  Start another frame of output.
  58.  
  59.      f  linmod:  Take the following string, up to a new-line,  as
  60.  
  61.  
  62.  
  63. Sun Release 4.1       Last change: BRL/CAD                      1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PLOT3(5)                  FILE FORMATS                   PLOT3(5)
  71.  
  72.  
  73.  
  74.         the  style  for  drawing  further  lines.  The styles are
  75.         ``dotted'', ``solid'',  ``longdashed'',  ``shortdashed'',
  76.         and  ``dotdashed''.   Effective  only  for the -T4014 and
  77.         -Tver options of plot(1G) (TEKTRONIX  4014  terminal  and
  78.         Versatec plotter).
  79.  
  80.      s  space:  The next four bytes give the lower left corner of
  81.         the  plotting  area;  the  following  four give the upper
  82.         right corner.  The plot will be magnified or  reduced  to
  83.         fit the device as closely as possible.
  84.  
  85.      The following were added at BRL.   Three-dimensional  primi-
  86.      tives  have  their  z  values ignored when displayed on two-
  87.      dimensional devices.
  88.  
  89.      C  color:  The next three bytes give respectively the inten-
  90.         sities  (0..255)  of the three color components (additive
  91.         colors red, green, and blue if  a  terminal;  subtractive
  92.         colors  cyan, magenta, and yellow if hardcopy) to be used
  93.         for subsequent plotting.  The initial color is assumed to
  94.         be  (255,255,255), which is white on a terminal and black
  95.         on  hardcopy.   Color  specifications  are  ignored   for
  96.         black-and-white devices.
  97.  
  98.      M  3move:  The next six bytes give a new current point.
  99.  
  100.      N  3cont:  Draw a line from the current point to  the  point
  101.         given by the next six bytes.  See plot(1G).
  102.  
  103.      P  3point:  Plot the point given by the next six bytes.
  104.  
  105.      L  3line:  Draw a line from the point given by the next  six
  106.         bytes to the point given by the following six bytes.
  107.  
  108.      S  3space:  The next six bytes give the  minimum  corner  of
  109.         the  plotting  area;  the  following six give the maximum
  110.         corner.  The plot will be magnified or reduced to fit the
  111.         device as closely as possible.
  112.  
  113.      F  3flush:
  114.  
  115.      x  double_point:  The double-precision version of point.
  116.  
  117.      v  double_line:  The double-precision version of line.
  118.  
  119.      o  double_move:  The double-precision version of move.
  120.  
  121.      q  double_cont:  The double-precision version of cont.
  122.  
  123.      w  double_space:  The double-precision version of space.
  124.  
  125.      i  double_circle:  The double-precision version of circle.
  126.  
  127.  
  128.  
  129. Sun Release 4.1       Last change: BRL/CAD                      2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. PLOT3(5)                  FILE FORMATS                   PLOT3(5)
  137.  
  138.  
  139.  
  140.      r  double_arc:  The double-precision version of arc.
  141.  
  142.      W  double_3space:   The  double-precision,  3_D  version  of
  143.         space.
  144.  
  145.      X  double_3point:   The  double-precision,  3_D  version  of
  146.         point.
  147.  
  148.      O  double_3move:  The double-precision, 3_D version of move.
  149.  
  150.      Q  double_3cont:  The double-precision, 3_D version of cont.
  151.  
  152.      V  double_3line:  The double-precision, 3_D version of line.
  153.  
  154.      Space settings that exactly  fill  the  plotting  area  with
  155.      unity  scaling  appear  below  for  devices supported by the
  156.      filters of plot(1G).  The upper limit is  just  outside  the
  157.      plotting  area,  except  for  the Megatek which displays the
  158.      entire range of possible coordinates.   In  every  case  the
  159.      plotting  area  is taken to be square; points outside may be
  160.      displayable on devices whose face is not square.
  161.  
  162.           DASI 300          space(0, 0, 4096, 4096);
  163.           DASI 300s         space(0, 0, 4096, 4096);
  164.           DASI 450          space(0, 0, 4096, 4096);
  165.           TEKTRONIX 4014    space(0, 0, 3120, 3120);
  166.           Versatec plotter  space(0, 0, 2048, 2048);
  167.           Megatek display   space(-32768, -32768, 32767, 32767);
  168.  
  169. SEE ALSO
  170.      libplot3(3), plot(3), plot(5).
  171.      graph(1G),  plot(1G)  in  the  UNIX  System  User  Reference
  172.      Manual.
  173.  
  174. AUTHOR
  175.      Douglas A. Gwyn made the 3-D and color extensions  to  UNIX-
  176.      plot.
  177.  
  178. SOURCE
  179.      SECAD/VLD Computing Consortium, Bldg 394
  180.      The U. S. Army Ballistic Research Laboratory
  181.      Aberdeen Proving Ground, Maryland  21005
  182.  
  183. BUG REPORTS
  184.      Reports of bugs or problems should be  submitted  via  elec-
  185.      tronic mail to <CAD@BRL.MIL>.
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195. Sun Release 4.1       Last change: BRL/CAD                      3
  196.  
  197.  
  198.  
  199.