home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / gnu / gs-2.6.1.4-src.lha / src / amiga / gs-2.6.1.4 / devices.doc < prev    next >
Text File  |  1994-01-27  |  14KB  |  361 lines
  1.    Copyright (C) 1992, 1993 Aladdin Enterprises.  All rights reserved.
  2.  
  3. This file is part of Ghostscript.
  4.  
  5. Ghostscript is distributed in the hope that it will be useful, but
  6. WITHOUT ANY WARRANTY.  No author or distributor accepts responsibility
  7. to anyone for the consequences of using it or for whether it serves any
  8. particular purpose or works at all, unless he says so in writing.  Refer
  9. to the Ghostscript General Public License for full details.
  10.  
  11. Everyone is granted permission to copy, modify and redistribute
  12. Ghostscript, but only under the conditions described in the Ghostscript
  13. General Public License.  A copy of this license is supposed to have been
  14. given to you along with Ghostscript so you can know your rights and
  15. responsibilities.  It should be in a file named COPYING.  Among other
  16. things, the copyright notice and this notice must be preserved on all
  17. copies.
  18.  
  19. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  20.  
  21. This file, devices.doc, gives more detailed documentation about
  22. certain specific devices for which Ghostscript can produce output.
  23.  
  24. For an overview of Ghostscript and a list of the documentation files, see
  25. README.
  26.  
  27. Devices for which this file currently contains documentation:
  28.     SPARCprinter
  29.     HP DeskJet 500C & 550C
  30.     HP PaintJet, XL, and XL300
  31.     DEC LJ250
  32.     Apple Dot Matrix Printer (and Imagewriter)
  33.  
  34. ### ------------------------- The SPARCprinter ------------------------- ###
  35.  
  36. This section was written by Martin Schulte.
  37.  
  38. Introduction
  39. ------------
  40.  
  41. The SPARCprinter is is connected to SPARCStation via a special SBUS card's
  42. video inferface, the picture is composed on the host and only a bitmap is
  43. send to the printer unit.
  44.  
  45. Together with a SPARCprinter, you always buy (as far as I know) software
  46. that enables you to do postscript-printing on your SPARCPrinter.
  47.  
  48. So, the need for a Ghostscript-Interface to the SPARCPrinter seems low,
  49. but on the other hand some Postscript drawings are not correctly printed
  50. with SUN's software: on some pages occured a thin vertical line of rubbish
  51. (reproducable), on some Mathematica drawings the text at the axes wasn't
  52. rotated.
  53.  
  54. I tried all of these with Ghostscript and always got the expected results.
  55.  
  56. However, replacing proprietary software should never be a bad idea.
  57.  
  58. The problem is that there has yet been no effort to make the SPARCPrinter-
  59. driver behave like a BSD output-filter, I made my tests using the script
  60. mentioned under Installation.
  61.  
  62. Installation
  63. ------------
  64.  
  65. Add sparc.dev to DEVICE_DEVS and compile ghostscript as described in
  66. make.doc.
  67.  
  68. Afterwards, you can use the following script (the way of handling standard
  69. input versus filename-arguments doesn't look very clever, has anyone a
  70. better idea ?) to print if you substitute <GSPATH> by the place where you
  71. installed the ghostscript binary:
  72.  
  73. outcmd1='/vol/local/lib/troff2/psxlate -r'
  74. outcmd2='<GSPATH> -I/home/schulte/gs252 -sDEVICE=sparc -sOUTPUTFILE=/dev/lpvi0 -'
  75.  
  76. if [ $# -eq 0 ]
  77. then
  78.   $outcmd1 | $outcmd2
  79. else
  80.   cat $* | $outcmd1 | $outcmd2
  81. fi
  82.  
  83. Problems
  84. --------
  85.  
  86. Since /dev/lpvi can only be opened for exclusive use, another job having
  87. opened it (engine_ctl_sparc or another ghostscript as the most probable
  88. canidates) will cause to stop ghostscript with "Error: /invalidfileaccess
  89. in --.outputpage--"
  90.  
  91. In case of common printer problems like out of paper, a warning describing
  92. the reason will be printed to stdout, the driver will try to access again
  93. and again each five seconds.
  94.  
  95. Due to a problem with the device-driver (in the kernel) the reason of
  96. printer failure is not always correctly reported to program.  This is the
  97. case at least if you open the top cover (Error in the display: E5).  Look
  98. to the display at the printer if a "Printer problem with unknown reason"
  99. is reported.
  100.  
  101. Fatal errors will cause the print-job to be terminated.
  102.  
  103. ### ------------------------------ End --------------------------------- ###
  104.  
  105. ### ------------------- H-P color inkjet printers ---------------------- ###
  106. ###  (DeskJet 500C, DeskJet 550C, PaintJet, PaintJet XL, PaintJet XL300  ###
  107. ###  and the DEC LJ250 which can operate in a Paintjet-compatiblme mode) ###
  108.  
  109. This section was written by George Cameron.
  110.  
  111. Information and tips on usage for the drivers contained in gdevcdj.c
  112. ====================================================================
  113.  
  114. OVERVIEW:
  115.  
  116. There are 6 generic drivers contained in the source module:
  117.  
  118.      1 - cdj500:      HP DeskJet 500C
  119.      2 - cdj550:      HP DeskJet 550C
  120.      3 - pjxl300:     HP PaintJet XL300
  121.      4 - pjtest:      HP PaintJet
  122.      5 - pjxltest:    HP PaintJet XL
  123.      6 - declj250:    DEC LJ250
  124.  
  125.  All of these drivers have 8-bit (monochrome), 16-bit and 24-bit
  126.      (colour) and for the DJ 550C 32-bit, (colour, cmyk mode)
  127.      options in addition to standard colour and mono drivers.
  128.  It is also possible to set various printer-specific parameters
  129.      from the gs command line, eg.
  130.  
  131.   gs -sDEVICE=cdeskjet -sBitsPerPixel=16 -dDepletion=1 -dShingling=2 tiger.ps
  132.  
  133. NB/ The old names cdeskjet, cdjcolor and cdjmono drivers have been retained;
  134.     however, their functionality duplicates that available using the above
  135.     drivers (and cdeskjet is identical to cdj500), ie. we can use:
  136.  
  137.     gs -sDEVICE=cdj500 -dBitsPerPixel=24 ...    for cdjcolor, and
  138.     gs -sDEVICE=cdj500 -dBitsPerPixel=1  ...    for cdjmono
  139.  
  140.  
  141. DEFAULT PAPER SIZE:
  142.  
  143.  If the preprocessor symbol A4 is defined, the default paper size is the
  144.  European A4 size; otherwise it is the U.S. letter size (8.5"x11"). Other
  145.  paper sizes (including A3 for the PaintJet XL and PaintJet XL300) may be
  146.  specified on the command line as explained in the Ghostscript documentation.
  147.  
  148.  
  149. DEFAULT BITS-PER-PIXEL:
  150.  
  151.  If the preprocessor symbol BITSPERPIXEL is defined as an integer (see below
  152.  for the range of allowable values), this number will be used to define the
  153.  default bits-per-pixel (ie. bit depth) for the generic drivers. If the
  154.  symbol is not defined, the default is set to 24 bits per pixel. It is
  155.  of course still possible to specify the value from the command line, as
  156.  described below. Note also that the cdeskjet, cdjcolor and cdjmono
  157.  drivers are unaffected by setting this symbol, as their default settings
  158.  are predefined to be 1, 3 and 24 respectively.
  159.  
  160.  
  161. DESKJET PHYSICAL LIMITS:
  162.  
  163.  Maximum printing width = 2400 dots = 8". The printer manuals say that the
  164.  maximum recommended printing height on the page is 10.3", but since this
  165.  is obviously not true for A4 paper, and I have been unable to detect any
  166.  problems in printing longer page lengths, this would seem to be a rather
  167.  artificial restriction.
  168.  
  169.  All Deskjets have 1/2" unprintable bottom margin, due to the mechanical
  170.  arrangement used to grab the paper. Side margins are approximately 0.25"
  171.  for US Letter paper, and 0.15" for A4.
  172.  
  173.  
  174. COMMAND LINE PARAMETERS:
  175.  
  176.  Several printer 'properties' have been implemented for these printers.
  177.  Those available so far are all integer quantities, and thus may be
  178.  specified as eg.
  179.  
  180.     gs -dBitsPerPixel=32 -dShingling-1 ... 
  181.  
  182.  which sets the BitsPerPixel parameter to 32 and the Shingling parameter
  183.  to 1.
  184.  
  185.  
  186. BITS-PER-PIXEL:
  187.  
  188.  All of the drivers in gdevcdj.c accept a command line option to set the
  189.  BitsPerPixel property. This gives considerable flexibility in choosing
  190.  various trade-offs between speed/quality/colour etc. The valid numbers
  191.  are:
  192.  
  193.     1:    This is a standard Ghostscript monochrome driver, and uses
  194.         black ink (by installing the separate mono cartridge in
  195.         the case of the DeskJet 500C, or automatically for the
  196.         other printers)
  197.  
  198.     3:    A standard Ghostscript colour driver, using internal
  199.         dithering. This is fast to compute and to print, but
  200.         the clustered dithering can lose some detail and
  201.         colour fidelity.
  202.  
  203.     8:    An 'error-diffusion' monochrome driver which uses
  204.         Floyd-Steinberg dithering to print greyscale images.
  205.         The patterns are much more randomised than with the
  206.         normal clustered dithering, but the data files can
  207.         be much larger and somewhat slower to print.
  208.  
  209.     16:    This is a 'cheaper' version of the following (24-bit)
  210.         driver, which generates a Floyd-Steinberg colour dithered
  211.         output using the minimum amount of memory (this may be
  212.         helpful when using IBM PC's when Ghostscript has not
  213.         been compiled usi