home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 531.lha / postdj / postdj.doc < prev    next >
Text File  |  1991-07-03  |  5KB  |  144 lines
  1. Postscript Deskjet (Plus, 500) printing driver (PostDJ, with Post V1.6)
  2. =======================================================================
  3.  
  4. Eric Kennedy
  5.  
  6. Based heavily on PostLJ,
  7. Copyright Adrian Aylward 1990, 1991.
  8.  
  9. This documentation adapted from Adrian Aylward's documentation for PostLJ.
  10.  
  11. You may freely copy, use and modify this program (postdj).  The source is
  12. included in the distribution.
  13.  
  14. The program calls the PostScript interpreter library to render a series of
  15. PostScript files to Deskjet printer connected to the parallel port.  It
  16. supports all the possible page sizes, i portrait or landscape orientation.
  17.  
  18. It has been tested on a Deskjet Plus.  It will likely work with the other
  19. current models in the Deskjet family or emulations thereof.
  20.  
  21. It is run from the CLI command line. There is no workbench startup.
  22.  
  23. The CLI interface is very simple.  No attempt has been made to provide fancy
  24. keywords for the options; if you can't remember them write yourself a script.
  25.  
  26. There are no status checks on the printer device, so it the output hangs
  27. check that your printer is plugged in and switched on.  Is is advisable
  28. to switch the printer on before starting, otherwise the first few characters
  29. may be lost, and the printout corrupted.
  30.  
  31.  
  32. Changes from PostLJ
  33. ===================
  34.  
  35. Two new options, -x and -y have been added.  -xnn shifts the image
  36. left nn pixels;  -ymm shifts the image up mm pixels.  The data contained in
  37. the leftmost nn pixels and the topmost mm pixels is simply discarded, as the
  38. Deskjet is not capable of printing in those regions.  Default is -x75 -y24, as
  39. these settings have provided the best printouts on my Deskjet Plus.  This
  40. shifts the printout left 0.25" and up 0.08".  You may need to experiment
  41. to find the best values for your printer and software.
  42.  
  43. Certain options in PostLJ that pertain to the Laserjet but are not applicable
  44. to the DeskJet (such as number of copies) have simply been left alone.  I
  45. think the Deskjet ignores them anyway.
  46.  
  47. Note that PostDJ does nothing to correct for the dead space at the bottom
  48. of the page.  If your image runs onto the bottom 0.25" or so, it will
  49. spill over onto the next page.  Just keep in mind the printable area of the
  50. Deskjet when you are composing your page, and you'll be fine.
  51.  
  52. The -xnn shift is not precise.  PostDJ rounds the nn parameter to the
  53. nearest multiple of 8.  Thus, to achieve a 0.25" shift, the image is
  54. actually shifted 72 pixels, or 0.24".  In my experience, this error is smaller
  55. than the slop inherent in the Deskjet paper handling, anyway, so I opted not
  56. to dive in and twiddle all the bits necessary to shift the page a fraction of
  57. a byte.
  58.  
  59. It is possible to specify values for -x or -y larger than the size of
  60. the output page.  In this case, a blank page will be printed.  If you get
  61. blank pages, run postdj with -x0 -y0 to make sure there is something there
  62. to print.
  63.  
  64.  
  65. Usage
  66. =====
  67.  
  68.     postband [-options ...] [files...] [TO tofile] [MEM fhlv..]
  69.  
  70. The filename defaults to "par:" the parallel device handler.  You can specify
  71. an alternative name if you want to save the output in a file, or send it to
  72. a different handler.
  73.  
  74. The options are indicated by an initial "-".  They are single letters,
  75. followed by a numeric value.
  76.  
  77.     page size
  78.         s0   legal
  79.         s1   letter
  80.         s2   executive
  81.        *s3   A4  (default)
  82.         s4   COM-10
  83.         s5   monarch
  84.         s6   C5
  85.         s7   DL
  86.  
  87.     page orientation
  88.        *l0   portrait  (default)
  89.         l1   landscape
  90.  
  91.     begin printing at page number
  92.        *b0   all pages
  93.         b999 any value from 1 to 9999
  94.  
  95.     end printing at page number
  96.        *e0   all pages
  97.         e999 any value from 1 to 9999
  98.  
  99.     number of copies
  100.        *n0   use #copies, or 1 if zero or more than 99 (default).
  101.         n99  any value from 1 to 99
  102.  
  103.     graphics compression
  104.         c0   disabled
  105.         c1   enabled  (default)
  106.     
  107.     Horizontal shift
  108.         x75  shift left 0.25"  (default)
  109.         xnn  shift left any value from 0 to 10000
  110.         
  111.     Vertical shift
  112.         y24  shift up 0.08" (default)
  113.         xmm  shift left any value from 0 to 10000
  114.  
  115.     If you have an earlier model Deskjet that does not support graphics
  116.     compression (the original model, I think) you must disable it.
  117.  
  118. The "files..." are the PostScript files to be interpreted.  Usually these
  119. will be the standard startup "init.ps" followed the by file you wish to
  120. print.
  121.  
  122. The TO filename defaults to "par:" the parallel device handler.  You can
  123. specify an alternative name if you want to save the output in a file, or
  124. send it to a different handler.
  125.  
  126. The MEM options are passed directly to Post.  Up to 5 are allowed; later
  127. values override earlier values.  See the file post.doc for details.
  128.  
  129. For example, to print pages 10 through 15 (inclusive) of a document on
  130. a Deskjet connected to the serial port, in letter format, landscape
  131. orientation:
  132.  
  133.     postdj-s1 -l1 -b10e15 init.ps doc.ps to ser:
  134.  
  135.  
  136. A more common invocation of postdj would be
  137.  
  138.     postdj -s1 init.ps doc.ps to par:
  139.  
  140.  
  141. This assumes american-style 8.5"x11" paper, and the deskjet attached
  142. to the parallel port.
  143.  
  144.