home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / unix / volume4 / quickplot / part1 / README < prev   
Encoding:
Text File  |  1986-11-30  |  6.1 KB  |  136 lines
  1. /*
  2.  * It is the intent of the author that this software may  be
  3.  * distributed and used freely, without restriction.  If you
  4.  * make improvements or enhancements,  I would appreciate  a
  5.  * copy.
  6.  
  7.  * The author makes no warranty,  express or implied, as  to
  8.  * the functioning or  suitability of the  software for  any
  9.  * purpose, and  the fact  of distribution  implies no  such
  10.  * warranty.   The  author  assumes  no  responsibility  for
  11.  * himself or others in connection with this software of any
  12.  * use of it (i.e., you may  use it freely, but don't  blame
  13.  * me if something goes wrong).
  14.  
  15.  * Duane H. Hesser, Teltone Corporation
  16.  * ....uw-beaver!tikal!sysad
  17.  * ....uw-beaver!tikal!dhh
  18.  */
  19.  
  20. "lplot"  is  a  plot(3)  filter  for  Printronix  P300   (or
  21. equivalent) printers.  "quickplot"  is a plot(3) filter  for
  22. any ascii  terminal.   "Quickplot" can  be used  to  display
  23. simple low-resolution plots, but is probably more useful for
  24. previewing plot streams before plotting on a real  plottting
  25. device.
  26.  
  27. "lplot" accepts  the  arguments  which  the  4.2BSD  printer
  28. spooler sends  to plot  filters (hostname,  user, and  pixel
  29. sizes), and  thus may  be used  in /etc/printcap  on  4.2BSD
  30. systems as the "g" filter  for a printer.  (These  arguments
  31. are optional.)  Please see  the  supplied manual  pages  for
  32. further information about behavior and available options.
  33.  
  34. These programs have been compiled sucessfully under BSD  4.2
  35. on a  Pyramid, and  BSD 4.2  and 4.1  on Vax  750's.   There
  36. should be little  to prevent their  compilation on any  Unix
  37. system which has the plot(3) library. (ummm... you will also
  38. need some form of bzero() and bcopy()).
  39.  
  40. CAVEATS: "quickplot" needs the termcap library; it would not
  41. be difficult  to  do without  it.   "lplot"  requires  about
  42. 104kbytes for the output array (no raster file is used),  so
  43. machines with limited data space  will need to restrict  the
  44. plotting area  (cut  down the  array  size), or  modify  the
  45. point() and output()  routines to use  some sort of  virtual
  46. array with disk buffering.  BEWARE your line printer driver.
  47. Some drivers like to do a bit of processing on the data sent
  48. to them,  assuming that  you  want backspaces  and  carriage
  49. returns handled  specially, for  example.   The driver  must
  50. pass lplot  output  untainted by  its  own  pre-conceptions.
  51.  
  52. "lplot" assumes that the paper in the printer is  positioned
  53. at line 1,  rather than at  the fold, so  that printing  (or
  54. plotting) begins at the first line on the page.  This  means
  55. that it assumes 780  dots vertically, rather  than 792.   If
  56. this doesn't suit your  situation (and you find  top-of-form
  57. creeping), change YDOTS in "defs.h".  Horizontal dot density
  58. is 60 dots  per inch, vertical  dot density is  72 dots  per
  59. inch, and array space  is provided to  permit plotting on  a
  60. full page of 132 column by 11 inch printer paper.   Although
  61. the space()  routine  maps  its arguments  into  an  8  inch
  62. plotting area in the lower left corner of the page, plotting
  63. is  permitted  outside  that  range.    (Note:   "quickplot"
  64. truncates data outside the mapped area, which is taken to be
  65. the full terminal screen.)
  66.  
  67. MAKEFILES:
  68. There are 3 makefiles: one  for "lplot" one for  "quickplot"
  69. and one to control the other two.  The latter is "Makefile".
  70. If you type "make" by itself, the following list of  targets
  71. will be printed:
  72.  
  73.         Use:
  74.         make all             to update lplot and quickplot
  75.         make new             to make both from scratch
  76.         make clean           to remove .o files
  77.         make bclean          to remove binaries and .o files
  78.         make lplot           to make only lplot
  79.         make quickplot       to make only quickplot
  80.         make install         to update and install both
  81.         make install_l       to update and install lplot
  82.         make install_q       to update and install quickplot
  83.  
  84. You should edit "Makefile" to  set BIN (the directory  where
  85. the binaries are to be installed), and MAN (where the manual
  86. pages are to be copied).  As delivered, BIN=/usr/public/bin,
  87. MAN=/usr/man/manp.
  88.  
  89. You should also check the DEFINES.  Then type "make new"  to
  90. make both binaries (or "make install" if your want to do the
  91. whole thing  in one  swell  foop).   The DEFINES  should  be
  92. changed  in   Makefile.lplot   and   Makefile.quickplot   as
  93. appropriate.  "make install" will install the binaries,  and
  94. make a link to "lplot" called "rlplot".  "rlplot"  activates
  95. the 'rotate' option, which causes the plot to be rotated  90
  96. degress ccw.  We  use this in /etc/printcap  for one of  our
  97. printers in which we use 8 1/2 x 11 paper, with  appropriate
  98. pixel sizes, to  cause the  long dimension of  the paper  to
  99. appear "horizontal" to the plot.  If you don't have the  4.2
  100. spooler, don't use  narrow paper, or  just plain don't  need
  101. rotated  plots,  you  may  wish  to  delete  this  from  the
  102. makefile.
  103.  
  104. Note: the rather strange makefile setup is intended to  keep
  105. track of which  binary is  being created.   Loading  "lplot"
  106. with  object  files  created   with  QUICKPLOT  defined   is
  107. ineffective.  Use separate directories if you prefer.
  108.  
  109. DEFINES:
  110. define BIGENDIAN if  you are  compiling for  a machine  with
  111. mad-hatter byte-order (3,2,1,0,7,6,5,4...) like Pyramids and
  112. 68000's.  Leave it out for Vaxes.
  113.  
  114. define DEBUG to compile in some debugging code.  This is set
  115. in the  delivered makefiles,  and compiles  in a  '-d'  flag
  116. which permits 3  levels of debugging  output (controlled  by
  117. the 1,2,4  bits in  the single-  digit following  argument).
  118. '-d 1' outputs the decoded and scaled plot stream  commands,
  119. and can be useful for debugging plot streams; the  remaining
  120. bits are useful only for program debug.
  121.  
  122. define QUICKPLOT  to compile  "quickplot"; leave  it out  to
  123. compile  "lplot".    These  are   set  up  already  in   the
  124. appropriate makefiles.
  125.  
  126. All other defines are in "defs.h", and should not need to be
  127. changed unless you have a printer with different dot density
  128. or perhaps a different graphics code, etc.
  129.  
  130. ONE LAST THING
  131. The sources in  this distribution are  created with 4  space
  132. tabstops.  They contain comment-commands for later  versions
  133. of "vi" to set tabstops appropriately; if this doesn't  work
  134. for you, set tabstops manually to 4, use "expand -4", or run
  135. them thru a sed script or "indent".
  136.