diff options
Diffstat (limited to 'src/ghost/README')
-rw-r--r-- | src/ghost/README | 1245 |
1 files changed, 1245 insertions, 0 deletions
diff --git a/src/ghost/README b/src/ghost/README new file mode 100644 index 0000000..a9193b6 --- /dev/null +++ b/src/ghost/README @@ -0,0 +1,1245 @@ +INTRODUCTION: +------------- + + Gimp-Print 4.2 includes an associated Ghostscript driver, which is + named `stp'. That name originally referred to Epson Stylus Photo + printers; this is the first Ghostscript driver which supported those + printers with high quality. The same driver now supports many Canon, + HP, and Lexmark printers. + + This driver works with GhostScript 5.10, 5.50, and 6.51. It should + work with any later releases on the 6.5x GNU Ghostscript line, such + as 6.52XS. Due to incompatibilities between the Aladdin Free Public + License (AFPL) and the GNU General Public License (GPL), this driver + may not be combined and distributed with versions of GhostScript not + covered by the GPL. We will not fix bugs reported against + combinations of this driver with AFPL-only versions of GhostScript. + + +AUTHOR: +------- + + This Ghostscript frontend was originally written by Henryk Richter + (buggs@comlab.uni-rostock.de); it since has been fully integrated + into gimp-print. Gimp-Print itself was originally written by Michael + Sweet <mike@easysw.com>, who released up to version 2.0; Robert + Krawitz released version 3.0. The gimp-print development team + (http://gimp-print.sourceforge.net) now maintains the entire package. + + +LICENSE: +-------- + + This program is free software; you can redistribute it and/or modify it + under the terms of the GNU General Public License as published by the Free + Software Foundation; either version 2 of the License, or (at your option) + any later version. + + This program is distributed in the hope that it will be useful, but + WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY + or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License + for more details. + + You should have received a copy of the GNU General Public License + along with this program; if not, write to the Free Software + Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. + + +BUILD AND INSTALLATION: +----- --- ------------- + +1) Get a recent Ghostscript (5.10, 5.50, or 6.51 or its successors) + and prepare the sources as described in the documentation (don`t + forget zlib, libpng and libjpeg when downloading the source) for + compiling + +2) If you are using Ghostscript 5.50 or 6.51, you have two choices. + The recommended (newer) method follows. This method builds the stp + driver by linking against the libgimpprint library that is + installed on your system. If you wish to use the older method (or + you're using Ghostscript 5.10), which actually installs all of the + Gimp-Print source files into your Ghostscript source tree, please + skip to step 7. We strongly recommend that all Ghostscript users, + except for those who cannot upgrade from 5.10, use the new method. + + +3) The recommended (newer) method requires you to build and install + Gimp-print, and links against the installed libgimpprint.so or + libgimpprint.a. Run + + ./configure + make + make install + + in the top level directory (../.. from here). + + "make install" typically needs to be run as root. You may also + need to run "ldconfig" as root following "make install". + + You may optionally run + + ./configure --without-gimp + + if you do not wish to build the Gimp Print plugin. Note that you + do *not* need to run "./configure --with-ghost" as before. + +4) Copy the file "gdevstp.c" from this directory into the Ghostscript + source directory. Depending upon the version of Ghostscript you + use, this may be either the top level of your Ghostscript source + distribution, or the "src/" subdirectory. + +5) Edit the file "contrib.mak" (in either the top level or src/ + subdirectory, depending upon your version of Ghostscript) by adding + the contents of "contrib.mak.addon", which should have been created + by running configure. Be careful to add *exactly* the contents of + this file; if you cut and paste it, you may find that the tab + characters in contrib.mak.addon get transformed into spaces, and as + a result when you run 'make' it will fail. + + If you reinstall Gimp-Print in a new location (by using configure + --prefix, configure --exec-prefix, or configure --includedir), you + must edit the contrib.mak file appropriately. The contrib.mak.addon + file in this directory is automatically updated by running configure. + +6) Skip to step 11. + + +7) If you are using Ghostscript 5.10, or prefer to use the old, tried + and true method for building the driver, run + + ./configure --with-ghost + make + + in the top level directory (../.. from here). + + You may optionally run + + ./configure --without-gimp --with-ghost + + if you do not wish to build the Gimp Print plugin. + +8) Copy all "*.c" and "*.h" files from this directory to the + Ghostscript source directory. Depending upon the version of + Ghostscript you use, this may be either the top level of your + Ghostscript source distribution, or the "src/" subdirectory. + +9) If you are using Ghostscript 5.50 or 6.51: edit the file + "contrib.mak" (in either the top level or src/ subdirectoy, + depending upon your version of Ghostscript) by adding the contents + of "contrib.mak.addon.old". Be careful to add *exactly* the + contents of this file; if you cut and paste it, you may find that + the tab characters in contrib.mak.addon get transformed into + spaces, and as a result when you run 'make' it will fail. + +10) If you are using Ghostscript 5.10: edit the file "devs.mak" (in + either the top level or src/ subdirectoy, depending upon your + version of Ghostscript) by adding the contents of + "devs.mak.addon-5.10". Be careful to add *exactly* the contents of + this file; if you cut and paste it, you may find that the tab + characters in contrib.mak.addon get transformed into spaces, and as + a result when you run 'make' it will fail. + + +11) Add "$(DD)stp.dev" to the line "DEVICE_DEVS6=..." in the makefile + used by Ghostscript (this is usually accessible as "makefile" in + the top level Ghostscript source, but that is normally just a + symbolic link to a system-specific makefile, such as unix-gcc.mak). + If there are multiple lines that start with DEVICE_DEVS6=, you may + add this to any such line. If there is no DEVICE_DEVS6= line, you + may add it to any other DEVICE_DEVSx line that is present. + +12) Compile and install gs as described in the Ghostscript + documentation. After a successful compiler run you get a new + driver named "stp". Check this by calling "gs -h" with the newly + compiled Ghostscript. + +The distribution includes a utility named "escputil" that performs +many utility functions, such as head cleaning, nozzle alignment, and +the like, for Epson Stylus printers. This is normally compiled by +"make" and installed by "make install". + + +DEBIAN: +------- + +Debian users can try the following (contributed by Stuart Miles and +updated by Dan Christensen <jdc@julian.uwo.ca>): versions are current +as of 5 October 2000. The Debian installation procedure is being +extensively redone as of February 2001. + +As of version 5.50 and 6.61, the current Debian packages in testing +(woody) and unstable (sid) are linked with libgimpprint, thus +saving you the effort of doing any patching yourself! Because it +uses a shared object (libgimpprint.so), you may upgrade the +gimp-print drivers simply by installing a newer version of the +libgimpprint library. + +NOTE: the script 'scripts/make-deb.sh' does the following for you. + It is probably better to upgrade to a new 5.50 or 6.51 release; + only use this if you are running stable (potato) or earlier. + +Download the debianised sources for gs-aladdin and libjpeg to the +directory containing the print-x.xxx directory: + +# apt-get source gs libjpeg62 + +(Make sure you have a deb-src entry in /etc/apt/sources.list first! +See the sources.list(5) man page for more info on setting up apt.) + +The name of the libjpeg package may vary. + +This will download the .dsc, orig.tar.gz and diff.gz files, unpack and +patch the files for you. + +Rename the libjpegxxx (currently libjpeg6b-6b) directory to libjpeg. + +To compile gs you will also need the following installed: + +# apt-get install sharutils zlib1g-dev svgalibg1-dev libpng2-dev vflib2-dev + +The name of the packages may vary. The above corresponds to + +sharutils 4.2.1-2 shar, unshar, uuencode, uudecode +zlib1g-dev 1.1.3-11 compression library - development +svgalibg1-dev 1.4.1-2 Shared, non-x, graphics library used by Ghos +libpng2-dev 1.0.8-1 PNG library - development +vflib2-dev 2.25.1-5 Vector Font Library for Japanese Character C + +but current versions (and possibly older versions) will probably +work as well. + +Next do the following: + +# mkdir gs-x.xx/contrib/stp +# cd print-x.xxx/Ghost +# cp gdevstp* *.mak.addon* ../../gs-x.xx/contrib/stp +# cp README ../../gs-x.xx/contrib/stp/README.stp +# cp debian-patch ../../gs-x.xx/debian +# cp debian-patch-stp ../../gs-x.xx/debian/patches/stp +# cd ../../gs-x.xx/debian +# patch < debian-patch [patches control and rules files] +# chmod u+x addentry [maybe this should be fixed in the tar file?] +# cd .. [now we are in gs-x.xx] +# debian/rules binary + +The rules script will copy the sourcefiles and README.stp into the +main gs directory, patch contrib.mak, add the stp entry to +unix-gcc.mak, compile gs, package it all up as a .deb package +(gs-stp_5.10-9.1_i386.deb) and put the resulting file in the directory +above gs. + +To install it: + +# cd .. +# dpkg -i gs-stp_5.10-9.1_i386.deb + +If you have gs or gs-aladdin installed, it will be removed. + +DISCLAIMER: + +This is not an official Debian package. This method works for at +least one person. To be really neat and tidy other files need +modifying to ensure that this custom package gets marked as such and +_not_ an official package. The only problem I've found is that I +the gs-pdfencrypt insists on having gs installed rather than gs-stp. +If you know how to fix this, please update this README. + + +OPTIONS: +-------- + +Overview: +--------- + +Options for the stp driver are given in normal Ghostscript +manner. The resolution of the image calculated by Ghostscript is not +bound to the resolution of the printer output. It is for example +possible to specify "-r360" to gs and print the output in 1440x720 +dpi (see below for driver parameter). The result is a somewhat faster +operation of the driver. + +The driver will not permit use of invalid settings. + +The options for this driver are very complex. We strongly recommend +use of a printer management system such as Foomatic rather than +configuring a spooler manually with this driver. + + +Printer Model Selection: +------- ----- ---------- + +-sModel=name + +This option must be supplied. There is no default. + +bjc-30 CANON BJC 30 +bjc-50 CANON BJC 50 +bjc-55 CANON BJC 55 +bjc-80 CANON BJC 80 +bjc-85 CANON BJC 85 +bjc-210 CANON BJC 210 +bjc-240 CANON BJC 240 +bjc-250 CANON BJC 250 +bjc-1000 CANON BJC 1000 +bjc-2000 CANON BJC 2000 +bjc-3000 CANON BJC 3000 +bjc-4300 CANON BJC 4300 +bjc-4400 CANON BJC 4400 photo +bjc-6000 CANON BJC 6000 +bjc-6100 CANON BJC 6100 +bjc-7000 CANON BJC 7000 +bjc-7100 CANON BJC 7100 +bjc-8200 CANON BJC 8200 +bjc-s400 CANON S400 +bjc-s450 CANON S450 +bjc-s800 CANON S800 +bjc-s4500 CANON S4500 +escp2-c20sx EPSON Stylus C20SX +escp2-c20ux EPSON Stylus C20UX +escp2-c40sx EPSON Stylus C40SX +escp2-c40ux EPSON Stylus C40UX +escp2-c60 EPSON Stylus C60 +escp2-c70 EPSON Stylus C70 +escp2-c80 EPSON Stylus C80 +escp2 EPSON Stylus Color +escp2-pro EPSON Stylus Color Pro +escp2-pro-xl EPSON Stylus Color Pro XL +escp2-400 EPSON Stylus Color 400 +escp2-440 EPSON Stylus Color 440 +escp2-460 EPSON Stylus Color 460 +escp2-480 EPSON Stylus Color 480 +escp2-500 EPSON Stylus Color 500 +escp2-580 EPSON Stylus Color 580 +escp2-600 EPSON Stylus Color 600 +escp2-640 EPSON Stylus Color 640 +escp2-660 EPSON Stylus Color 660 +escp2-670 EPSON Stylus Color 670 +escp2-680 EPSON Stylus Color 680 +escp2-740 EPSON Stylus Color 740 +escp2-760 EPSON Stylus Color 760 +escp2-777 EPSON Stylus Color 777 +escp2-800 EPSON Stylus Color 800 +escp2-850 EPSON Stylus Color 850 +escp2-860 EPSON Stylus Color 860 +escp2-880 EPSON Stylus Color 880 +escp2-83 EPSON Stylus Color 83 +escp2-900 EPSON Stylus Color 900 +escp2-980 EPSON Stylus Color 980 +escp2-1160 EPSON Stylus Color 1160 +escp2-1500 EPSON Stylus Color 1500 +escp2-1520 EPSON Stylus Color 1520 +escp2-3000 EPSON Stylus Color 3000 +escp2-photo EPSON Stylus Photo +escp2-700 EPSON Stylus Photo 700 +escp2-ex EPSON Stylus Photo EX +escp2-720 EPSON Stylus Photo 720 +escp2-750 EPSON Stylus Photo 750 +escp2-780 EPSON Stylus Photo 780 +escp2-785 EPSON Stylus Photo 785EPX +escp2-790 EPSON Stylus Photo 790 +escp2-810 EPSON Stylus Photo 810 +escp2-820 EPSON Stylus Photo 820 +escp2-870 EPSON Stylus Photo 870 +escp2-875 EPSON Stylus Photo 875 +escp2-890 EPSON Stylus Photo 890 +escp2-895 EPSON Stylus Photo 895 +escp2-1200 EPSON Stylus Photo 1200 +escp2-1270 EPSON Stylus Photo 1270 +escp2-1280 EPSON Stylus Photo 1280 +escp2-1290 EPSON Stylus Photo 1290 +escp2-2000 EPSON Stylus Photo 2000P +escp2-5000 EPSON Stylus Pro 5000 +escp2-5500 EPSON Stylus Pro 5500 +escp2-7000 EPSON Stylus Pro 7000 +escp2-7500 EPSON Stylus Pro 7500 +escp2-9000 EPSON Stylus Pro 9000 +escp2-9500 EPSON Stylus Pro 9500 +escp2-10000 EPSON Stylus Pro 10000 +escp2-scan2000 EPSON Stylus Scan 2000 +escp2-scan2500 EPSON Stylus Scan 2500 +pcl-340 HP DeskJet 340 +pcl-400 HP DeskJet 400 +pcl-500 HP DeskJet 500 +pcl-501 HP DeskJet 500C +pcl-520 HP DeskJet 520 +pcl-540 HP DeskJet 540C +pcl-550 HP DeskJet 550C +pcl-560 HP DeskJet 560C +pcl-600 HP DeskJet 600/600C (Single Cartridge) +pcl-601 HP DeskJet 600 series (2 Cartridge) +pcl-690 HP DeskJet 690 series (Photo-Ink capable) +pcl-750 HP DesignJet 750 +pcl-810 HP DeskJet 810C +pcl-812 HP DeskJet 812C +pcl-840 HP DeskJet 840C +pcl-842 HP DeskJet 842C +pcl-845 HP DeskJet 845C +pcl-850 HP DeskJet 850C +pcl-855 HP DeskJet 855C +pcl-870 HP DeskJet 870C +pcl-890 HP DeskJet 890C +pcl-895 HP DeskJet 895C +pcl-900 HP DeskJet 900 series +pcl-P1000 HP PhotoSmart P1000 +pcl-1100 HP DeskJet 1100C +pcl-P1100 HP PhotoSmart P1100 +pcl-1120 HP DeskJet 1120C +pcl-1200 HP DeskJet 1200C +pcl-1220 HP DeskJet 1220C +pcl-1600 HP DeskJet 1600C +pcl-2000 HP DeskJet 2000 series +pcl-2500 HP DeskJet 2500 series +pcl-2 HP LaserJet II series +pcl-3 HP LaserJet III series +pcl-4 HP LaserJet 4 series +pcl-4v HP LaserJet 4V, 4Si +pcl-5 HP LaserJet 5 series +pcl-5si HP LaserJet 5Si +pcl-6 HP LaserJet 6 series +lexmark-4076 Lexmark 4076 (PCL printer) +lexmark-z42 Lexmark Z42 +lexmark-z43 Lexmark Z43 +lexmark-z52 Lexmark Z52 + +Most or all of the Epson Stylus printers are fully functional. The +others vary. In particular, all of the listed Epson Stylus Photo +printers print in full 6-color photo mode; most of the others do not. +The color output has also been better tuned for Epson Stylus printers +than for others. + + +Print Resolution Selection: +----- ---------- ---------- + +-sQuality=quality + +The meaning of this is model-specific. Two names are listed for each +resolution; the first (short) name is the value that must be passed to +-sQuality, and the second (long) name is descriptive. Each printer +has its own default value; for most printers, this is a reasonable 300 +or 360 DPI resolution. + + +For Epson Stylus printers: + +Within each specified resolution, the quality is generally listed from +worst to best (and generally higher quality means lower speed). For +example, 360 DPI Unidirectional is usually better than 360 DPI. +Characteristics of specific models and individual printers may affect +the orderings to some degree; on many printers, with certain papers, +unidirectional printing will improve quality substantially more than +using an otherwise better quality printing mode. + +The difference between different quality settings lies in the number +of passes made over each line. "High" and "Highest" quality settings +perform more passes, printing fewer dots with each pass over the same +line and using different nozzles for each pass. This reduces banding +effects, but requires more time. + +"Microweave" modes use algorithms within the printer to generate the +sequence of rows printed. These algorithms generally only work well +at low printing resolutions. Many printers do not support this kind +of printing at resolutions of 720 DPI and above, and some printers +that do actually print just one row (using just one nozzle per color) +at a time. While this particular use will produce extremely high +quality (no banding whatsoever, normally), it is extremely slow and +may eventually damage the print head due to ink pooling. All printers +that we are aware of have no such trouble at 360 DPI. + +We generally recommend the following resolutions for the following +purposes: + +360x90 Fast economy draft output on plain paper (output will be very +360x120 banded and not very dark). + +180 Economy draft output on plain paper (output will not be very + dark). + +360x180 Draft output on plain paper (output will not be solidly +360x240 black); economy draft output on good quality inkjet paper. + +360 Standard quality output on plain paper (output will be + solidly black); draft output on good quality inkjet paper. + +720x360 High quality output on plain paper; standard output on good + quality inkjet paper. + +720 Maximum quality on plain paper; high quality on good inkjet + paper; proofs on photo-quality paper. On many printers, + there will be little difference between this and 720x360 on + plain paper. + +1440x720 High quality on photo paper; use 1440x720 Highest Quality to + reduce microbanding if needed. While this will work on plain + paper, it usually offers little improvement over 720 DPI. + +2880x720 Highest quality on photo paper. While this may yield + slightly improved quality, it will generally not be markedly + superior to 1440x720 Highest Quality, except on the Stylus + Color 980 and Stylus C70 and C80, where it may yield a + noticeable improvement. It takes as long to print as + 1440x720 highest quality, but twice as long to generate the + output. + +1440x1440 An unsupported mode that offers higher quality than 2880x720 + for certain types of images on very high quality paper. It + does not appear to offer any advantage on smooth tones, but + fine detail (particularly vertical, and to a lesser extent + near-horizontal) it shows noticeable improvement. It takes + as long to print as 2880x720. 1440x1440 highest quality + takes twice as long to print. + +2880x1440 An unsupported mode that may offer higher quality than + 2880x720 for certain types of images on very high quality + paper. Experiments conducted thus far demonstrate little if + any improvement over 1440x1440. It takes twice as long to + print as 2880x720 or 1440x1440, and as long to print as + 1440x1440 highest quality. + + +The following resolutions are supported on printers other than the +Stylus Pro (5000, 5500, 7000, 7500, 9000, 9500, and 10000) printers. +Resolutions for those printers are listed in a later section. Please +see the notes at the end of this section. + +360x90dpi 360 x 90 DPI Fast Economy Draft (1) + +180dpi 180 DPI Economy Draft (2) + +360x180dpi 360 x 180 DPI Draft (2) +360x180sw 360 x 180 DPI Draft (3) + +360x120dpi 360 x 120 DPI Economy Draft (4) +360x120sw 360 x 120 DPI Economy Draft (5) + +360x240dpi 360 x 240 DPI Draft (4) +360x240sw 360 x 240 DPI Draft (5) + +360dpi 360 DPI (6) +360uni 360 DPI Unidirectional (6) +360mw 360 DPI Microweave (6, *) +360mwuni 360 DPI Microweave Unidirectional (6) +360sw 360 DPI (7, *) +360swuni 360 DPI Unidirectional (7) +360hq 360 DPI High Quality (7, 8) +360hquni 360 DPI High Quality Unidirectional (7, 8) + +720x360sw 720 x 360 DPI (9, 10) +720x360swuni 720 x 360 DPI Unidirectional (9, 10) + +720mw 720 DPI Microweave (11) +720mwuni 720 DPI Microweave Unidirectional (11) +720sw 720 DPI (9) +720swuni 720 DPI Unidirectional (9) +720hq 720 DPI High Quality (9) +720hquni 720 DPI High Quality Unidirectional (9) +720hq2 720 DPI Highest Quality (9) + +1440x720mw 1440 x 720 DPI Microweave (12) +1440x720mwuni 1440 x 720 DPI Microweave Unidirectional (12) +1440x720sw 1440 x 720 DPI (13) +1440x720swuni 1440 x 720 DPI Unidirectional (13, 14) +1440x720hq 1440 x 720 DPI Highest Quality (13) + +2880x720sw 2880 x 720 DPI (15) +2880x720swuni 2880 x 720 DPI Unidirectional (15) + +1440x1440sw 1440 x 1440 DPI (16) +1440x1440hq2 1440 x 1440 DPI Highest Quality (16) + +2880x1440sw 2880 x 1440 DPI (16) + +(*) This resolution is the default on all printers supporting this + setting. + +(1) Works on printers that have a basic vertical spacing of 1/90". + This includes the Stylus Color, Stylus Color 440, 460, 600, 640, + 660, 670, and 1500, and Stylus Photo, Stylus Photo 700, 720, and + EX. + +(2) Works on printers most that have a basic vertical spacing of 1/90, + 1/180, or 1/360 inch. This includes Stylus Color, Stylus Color + 440, 460, 600, 640, 660, 670, 800, 850, 900, 980, 1500, 1520, + 3000, and Stylus Photo, Stylus Photo 700, 720 and EX. + +(3) Works on Stylus C70 and C80. + +(4) Works on older printers with dot spacing of 1/120 inch. This + includes the Stylus Color Pro, Pro XL, 400, and 500. + +(5) Works on newer printers with dot spacing of 1/120 inch. This + includes the Stylus C20, C40, and C60, the Stylus Color 480, 580, + 680, 740, 760, 777, 860, 880, 83, and 1160, and the Stylus Photo + 750, 780, 785, 790, 810, 820, 870, 875, 890, 895, 1270, 1280, + 1290, and 2000P, and the Stylus Scan 2000. + +(6) Works on all printers that do not support variable drop sizes. + This includes the Stylus Color, Stylus Color 400, 440, 460, 500, + 600, 640, 660, 800, 850, 1500, 1520, and 3000, and Stylus Color + Pro, and Stylus Photo, Stylus Photo 700, and EX. + +(7) Works on all printers that do support variable drop sizes. This + includes all supported Epson Stylus printers except for those + listed in note (6). + +(8) Recommended only on processors slower than 200 MHz, the system is + heavily loaded with a faster processor, or if problems are + experienced at 720x360. + +(9) Works on all supported printers except for Stylus Color, Stylus + Color Pro, Stylus Color Pro XL, Stylus Color 1500, 1520, and 3000. + +(10) On printers that do not support variable drop size (see note (4)), + this will print as fast as 360 DPI, and faster than 360 DPI High + Quality. It will take twice as long to generate output, which may + be important on a heavily loaded system or a processor slower than + 200 MHz. + +(11) Works on some older printers, including the Stylus Color, Stylus + Color 400, 500, 600, 800, 850, 1500, 1520, and 3000, Stylus Color + Pro, and Stylus Color Pro XL. Not recommended except for the + Stylus Color, Stylus Color 1500, 1520, and 3000. + +(12) Works on Stylus Color 600, 800, 850, 1520, and 3000. Not + recommended unless other 1440x720 modes do not work. + +(13) Works on all printers that support 1440x720 DPI. This includes + all supported printers except for the Stylus Color, Stylus Color + Pro, Pro XL, 400, 440, 460, 480, 500, and 1500, and Stylus Photo. + In addition, this may not work correctly on Stylus Color 1520 and + Stylus Color 3000. + +(14) This is identical to 1440 x 720 Highest Quality (1440x720hq) on + the Stylus Color 900. + +(15) Works on all printers that support 2880x720 DPI. This includes + the Stylus C60, C70, and C80, the Stylus Color 680, 777, 880, 83, + and 980, and Stylus Photo 780, 790, 810, 820, 890, 1280, and 1290. + +(16) Works on Stylus C70 and Stylus C80. These resolutions are not + supported by Epson and may not work on all C70 or C80 printers. + + +The Stylus Pro printers (Stylus Pro 5000, 5500, 7000, 7500, 9000, +9500, and 10000) support additional microweave modes known as Full +Overlap (FOL), Four Pass, and FOL2. The Stylus Pro 5500, 7500, 9500, +and 10000 additionally have a mode called MW2. These modes can only +be used at certain resolutions. Stylus Pro printers support the +following resolutions: + +180dpi 180 DPI + +360dpi 360 DPI +360uni 360 DPI Unidirectional +360mw 360 DPI Microweave +360mwuni 360 DPI Microweave Unidirectional +360fol 360 DPI Full Overlap +360foluni 360 DPI Full Overlap Unidirectional +360fol2 360 DPI FOL2 +360fol2uni 360 DPI FOL2 Unidirectional +360mw2 360 DPI MW2 +360mw2uni 360 DPI MW2 Unidirectional + +720x360dpi 720 x 360 DPI +720x360uni 720 x 360 DPI Unidirectional +720x360fol 720 x 360 DPI FOL +720x360foluni 720 x 360 DPI FOL Unidirectional +720x360fol2 720 x 360 DPI FOL2 +720x360fol2uni 720 x 360 DPI FOL2 Unidirectional +720x360mw2 720 x 360 DPI MW2 +720x360mw2uni 720 x 360 DPI MW2 Unidirectional + +720dpi 720 DPI +720uni 720 DPI Unidirectional +720mw 720 DPI Microweave +720mwuni 720 DPI Microweave Unidirectional +720fol 720 DPI Full Overlap +720foluni 720 DPI Full Overlap Unidirectional +720fourp 720 DPI Four Pass +720fourpuni 720 DPI Four Pass Unidirectional + +1440x720dpi 1440 x 720 DPI +1440x720uni 1440 x 720 DPI Unidirectional +1440x720mw 1440 x 720 DPI Microweave +1440x720mwuni 1440 x 720 DPI Microweave Unidirectional +1440x720fol 1440 x 720 DPI FOL +1440x720foluni 1440 x 720 DPI FOL Unidirectional +1440x720fourp 1440 x 720 DPI Four Pass +1440x720fourpuni 1440 x 720 DPI Four Pass Unidirectional + + +For PCL printers (including Hewlett-Packard and Lexmark 4076): + +150dpi 150x150 DPI (should work on all printers) +300dpi 300x300 DPI (should work on all printers, C-RET on + DJ 850/855/870/890) +600x300dpi 600x300 DPI (DJ 6xx/810/812/840/842/895) +600mono 600x600 DPI monochrome + (DJ 6xx (except 69x) /8xx/1100/1120) +600dpi 600x600 DPI (DJ 69x/840/9xx/1220/2000/2500, + PhotoSmart P1000/P1100, LJ5/5Si/6) + +Note: the higher resolutions of newer PCL printers using "Photo-Ret" are +not yet supported. + + +For Lexmark printers other than the 4076: + +300x600dpi 300 DPI x 600 DPI +600dpi 600 DPI +600hq 600 DPI high quality +600uni 600 DPI Unidirectional +1200dpi 1200 DPI +1200hq 1200 DPI high quality +1200hq2 1200 DPI highest quality +1200uni 1200 DPI Unidirectional +2400x1200dpi 2400 DPI x 1200 DPI (Z52) +2400x1200hq 2400 DPI x 1200 DPI high quality (Z52) +2400x1200hq2 2400 DPI x 1200 DPI highest quality (Z52) + + +For Canon printers: + +1200 DPI printers (BJC 7000, BJC 7100, BJC 8200, BJC 8500): + +300dpi 300x300 DPI +300dmt 300x300 DPI DMT +600dpi 600x600 DPI +600dmt 600x600 DPI DMT +1200x600dpi 1200x600 DPI +1200dpi 1200x1200 DPI + +1440 DPI printers (BJC 1000, BJC 2000, BJC 3000, BJC 4300, BJC 4400, + BJC 5100, BJC 5500, BJC 6000, BJC 6100, BJC 6500, BJC 8200): + +360dpi 360x360 DPI +360dmt 360x360 DPI DMT +720x360dpi 720x360 DPI +720dpi 720x720 DPI +1440x720dpi 1440x720 DPI +1440dpi 1440x1440 DPI + + +Ink Types +--- ----- + +This is printer type specific. The option names are case sensitive. +The option names are case sensitive. Two names are listed for each +resolution; the first (short) name is the value that must be passed to +-sInkType, and the second (long) name is descriptive. Not all ink +types are supported on all printers. + +-sInkType=inktype + + +For Epson and Lexmark (other than the 4076) printers: + +Six color printers can print using four color inks or all six colors. +Six color mode is recommended for photographs. Four color mode may be +useful when printing text with embedded graphics to reduce ink +consumption, or to print higher quality with Ordered, Fast, or Very +Fast dithering (see below). + +The "Composite" modes use only color inks (no black) to produce all +colors and black. These ink types are rarely useful, but on certain +types of paper they may produce a smoother image than that produced by +mixing black ink in. The Epson Stylus Color 1500 cannot mix black ink +with colored inks; on this printer, Three Color Composite must be +used. + +As of this writing (September 2001), no seven color printers are sold +in North America. When such a printer is sold, the Seven Color +Enhanced and Six Color Enhanced Composite modes will utilize all of +these inks. + +Photo7 Seven Color Enhanced +PhotoEnhance Six Color Enhanced Composite +PhotoCMYK Six Color Photo +PhotoCMY Five Color Photo Composite +CMYK Four Color Standard +RGB Three Color Composite + + +For Canon printers: + +Gray Black +RGB Color +CMYK Black/Color +PhotoCMY Photo/Color +PhotoCMYK Photo + + +For PCL (Hewlett-Packard and Lexmark 4076) color printers: + +CMYK Color + Black Cartridges +Photo Color + Photo Cartridges (For Deskjet 69x only) + +Black and white PCL printers (laser printers, in particular) do not +allow any value to be specified for the ink type. + + +Media Types +----- ----- + +This is printer type specific. The option names are case sensitive. +Two names are listed for each resolution; the first (short) name is +the value that must be passed to -sMediaType, and the second (long) name +is descriptive. + +-sMediaType=mediatype + + +For Epson and Lexmark (other than the 4076) inkjet printers: + +Plain Plain Paper +PlainFast Plain Paper Fast Load +Postcard Postcard +GlossyFilm Glossy Film +Transparency Transparencies +Envelope Envelopes +BackFilm Back Light Film +Matte Matte Paper +Inkjet Inkjet Paper +Coated Photo Quality Inkjet Paper +GlossyPhoto Premium Glossy Photo Paper +Luster Premium Luster Photo Paper +Photo Photo Paper +Glossy Photo Quality Glossy Paper +Ilford Ilford Heavy Paper +Other Other + +We have found that glossy photo papers not specifically designed for +Epson printers generally perform poorly in Epson printers. The ink +tends to pool on the paper, causing muddy shadows and possibly leaving +ink on the printer rollers. Use of the highest quality printing modes +(1440x720 highest quality and 2880x720 unidirectional) produces the +best result on such papers, probably because printing is slower and +there is more time for the ink to dry. + + +For Canon printers: + +Plain Plain Paper +Transparency Transparencies +BackFilm Back Print Film +Fabric Fabric Sheets +Envelope Envelope +Coated High Resolution Paper +TShirt T-Shirt Transfers +GlossyFilm High Gloss Film +GlossyPaper Glossy Photo Paper +GlossyCards Glossy Photo Cards +GlossyPro Photo Paper Pro + + +For PCL (Hewlett-Packard and Lexmark 4076) inkjet printers: + +Plain Plain +Bond Bond +Premium Premium +Glossy Glossy/Photo +Transparency Transparency +GlossyQD Quick-dry Photo +TransparencyQD Quick-dry Transparency + +PCL laser printers do not allow specification of any media type. + + +Media Sources +----- ------- + +This is printer type specific. The option names are case sensitive. + +-sInputSlot=mediasource + +For Epson printers: + +Standard Standard +Roll Roll Feed (for certain Stylus Photo and Stylus + Pro models only) + + +For Canon printers: + +Auto Auto Sheet Feeder +Manual Manual with Pause +ManualNP Manual without Pause + + +For PCL (Hewlett-Packard and Lexmark 4076) printers. Different +printers allow different choices out of this set. + +Standard Standard (Feed from printer defined source) +Manual Manual +MultiPurpose Tray 1 +Upper Tray 2 +Lower Tray 3 +LargeCapacity Tray 4 +Portable Portable Sheet Feeder +Desktop Desktop Sheet Feeder +Tray Tray +Tray2 Tray 2 +Optional Optional Source +Auto Autoselect + + +For Lexmark printers other than the 4076: + +Auto Auto Sheet Feeder +Manual Manual with Pause +ManualNP Manual without Pause + + +Media Sizes +----- ----- + +This is printer-specific; we cannot list the correct values for each +printer here. The option names are case-sensitive. Two names are +listed for each resolution; the first (short) name is the value that +must be passed to -sPaperSize, and the second (long) name is +descriptive. This option does not set GhostScript up to use a paper +size other than the default; it only tells the driver to set up the +printer for a different paper size. The default paper size is +'Letter'. + +-sPaperSize=papersize + + + * Common English paper sizes + +Letter Letter 8.5in x 11in +Legal Legal 8.5in x 14in +Tabloid Tabloid 11in x 17in +Executive Executive 7.25in x 10.5in +Postcard Postcard 100mm x 147mm +w216h360 3x5 +w288h432 4x6 +w324h495 Epson 4x6 Photo Paper +w360h504 5x7 +w360h576 5x8 +8x10 8x10 +Statement Manual 5.5in x 8.5in +TabloidExtra 12x18 +SuperB 13x19 + + * Common photographic paper sizes + +w576h864 8x12 Sometimes used for 35 mm +w792h1008 11x14 +w1152h1440 16x20 +w1152h1728 16x24 20x24 for 35 mm +w1440h1728 20x24 +w1440h2160 20x30 24x30 for 35 mm +w1728h2160 24x30 +w1728h2592 24x36 Sometimes used for 35 mm +w2160h2880 30x40 + + International Paper Sizes (mostly taken from BS4000:1968) + + * "A" series: Paper and boards, trimmed sizes + * + * "A" sizes are in the ratio 1 : sqrt(2). A0 has a total area + * of 1 square metre. Everything is rounded to the nearest + * millimetre. Thus, A0 is 841mm x 1189mm. Every other A + * size is obtained by doubling or halving another A size. + +w4768h6749 4A 1682mm x 2378mm +w3370h4768 2A 1189mm x 1682mm +A0 A0 841mm x 1189mm +A1 A1 594mm x 841mm +A2 A2 420mm x 594mm +A3 A3 297mm x 420mm +A4 A4 210mm x 297mm +A5 A5 148mm x 210mm +A6 A6 105mm x 148mm +A7 A7 74mm x 105mm +A8 A8 52mm x 74mm +A9 A9 37mm x 52mm +A10 A10 26mm x 37mm + + * Stock sizes for normal trims. + * Allowance for trim is 3 millimetres. + +w2437h3458 RA0 860mm x 1220mm +w1729h2437 RA1 610mm x 860mm +w1218h1729 RA2 430mm x 610mm +w864h1218 RA3 305mm x 430mm +w609h864 RA4 215mm x 305mm + + * Stock sizes for bled work or extra trims. + +w2551h3628 SRA0 900mm x 1280mm +w1814h2551 SRA1 640mm x 900mm +w1275h1814 SRA2 450mm x 640mm +w907h1275 SRA3 320mm x 450mm +w637h907 SRA4 225mm x 320mm + + * "B" series: Posters, wall charts and similar items. + +w5669h8016 4B ISO 2000mm x 2828mm +w4008h5669 2B ISO 1414mm x 2000mm +ISOB0 B0 ISO 1000mm x 1414mm +ISOB1 B1 ISO 707mm x 1000mm +ISOB2 B2 ISO 500mm x 707mm +ISOB3 B3 ISO 353mm x 500mm +ISOB4 B4 ISO 250mm x 353mm +ISOB5 B5 ISO 176mm x 250mm +ISOB6 B6 ISO 125mm x 176mm +ISOB7 B7 ISO 88mm x 125mm +ISOB8 B8 ISO 62mm x 88mm +ISOB9 B9 ISO 44mm x 62mm +ISOB10 B10 ISO 31mm x 44mm + +B0 B0 JIS +B1 B1 JIS +B2 B2 JIS +B3 B3 JIS +B4 B4 JIS +B5 B5 JIS +B6 B6 JIS +B7 B7 JIS +B8 B8 JIS +B9 B9 JIS +B10 B10 JIS + + * "C" series: Envelopes or folders suitable for A size stationery. + +C0 C0 917mm x 1297mm +C1 C1 648mm x 917mm +C2 C2 458mm x 648mm +C3 C3 324mm x 458mm +C4 C4 229mm x 324mm +C5 C5 162mm x 229mm +w354h918 B6-C4 125mm x 324mm +C6 C6 114mm x 162mm +DL DL 110mm x 220mm +w229h459 C7-6 81mm x 162mm +C7 C7 81mm x 114mm +C8 C8 57mm x 81mm +C9 C9 40mm x 57mm +C10 C10 28mm x 40mm + + * US CAD standard paper sizes + +ARCHA ArchA 9x12in +ARCHB ArchB 12x18in +ARCHC ArchC 18x24in +ARCHD ArchD 24x36in +ARCHE ArchE 36x48in + + * Foolscap + +w612h936 American foolscap +w648h936 European foolscap + + * Sizes for book production + * The BPIF and the Publishers Association jointly recommend ten + * standard metric sizes for case-bound titles as follows: + +w535h697 Crown Quarto 189mm x 246mm +w569h731 Large Crown Quarto 201mm x 258mm +w620h782 Demy Quarto 219mm x 276mm +w671h884 Royal Quarto 237mm x 312mm +w348h527 Crown Octavo 123mm x 186mm +w365h561 Large Crown Octavo 129mm x 198mm +w391h612 Demy Octavo 138mm x 216mm +w442h663 Royal Octavo 156mm x 234mm + + * Paperback sizes in common usage + +w314h504 Small paperback 111mm x 178mm +w314h513 Penguin small paperback 111mm x 181mm +w365h561 Penguin large paperback 129mm x 198mm + + * Miscellaneous sizes + +w283h420 Hagaki Card 100 x 148 mm +w420h567 Oufuku Card 148 x 200 mm +w340h666 Long 3 Japanese long envelope #3 +w255h581 Long 4 Japanese long envelope #4 +w680h941 Kaku Japanese Kaku envelope #4 +COM10 Commercial 10 US Commercial 10 env +w315h414 A2 Invitation US A2 invitation + + +Color Balancing Values: (min,max,default) +----- --------- ------- ----------------- + +All of the values below are interpreted as being relative to norms for +a particular printer established through testing, not "absolute" +values of any kind. + +-dCyan=xxx xxx: 0.0 ... 4.0 (1.0) +-dMagenta=xxx xxx: 0.0 ... 4.0 (1.0) +-dYellow=xxx xxx: 0.0 ... 4.0 (1.0) + + These three options allow specification of the cyan, magenta, and + yellow levels independently, for rebalancing the levels. Normally, + these should be adjusted to yield neutral gray, but they can be used + for other effects. + +-dBrightness=xxx xxx: 0.0 ... 2.0 (1.0) + + Adjust the brightness of the image. 0.0 gives a fully black image; + 2.0 gives a fully white image. Values greater than 1 will result in + black not being solid and highlights turning white; values less than + 1 will result in white not being perfectly clear and shadows turning + black. + +-dContrast=xxx xxx: 0.0 ... 4.0 (1.0) + + Adjust the contrast of the image. 0.0 gives a solid gray for the + entire image, the exact gray depending upon the brightness chosen. + +-dGamma=xxx xxx: 0.1 ... 4.0 (1.0) + + Adjust the gamma of the image, over and above the printer-specific + correction. Gamma less than 1.0 will result in a darker image; gamma + greater than 1.0 will result in a lighter image. Unlike brightness, + gamma adjustment does not change the endpoints; it merely changes the + shape of the input->output curve. + +-dDensity=xxx xxx: 0.1 ... 2.0 (1.0) + + Adjust the amount of ink deposited on the paper. If you've chosen + the correct paper type and you're getting ink bleeding through the + paper or puddling, try reducing the density to the lowest value you + can while still achieving solid black. If you're not getting solid + black, even with the contrast and brightness at 1.0, try increasing + the density. + + All of the printers supported here actually need less than 100% ink + density in most cases, so the actual density is something other than + the nominal density setting. The effective density setting cannot go + above 100%, so if a value specified will result in an excessively + high density level, it will be silently limited to 1.0. + +-dSaturation=xxx xxx: 0.0 ... 9.0 (1.0) + + Adjust the brilliance of colors. 0.0 results in pure grayscale; + using this with -dColor=1 is one way of getting grayscale (see below + under -dColor for a full discussion). Saturation of less than 1.0 + results in more muted colors; saturation of greater than 1.0 results + in more vibrant colors. Very high saturation often results in very + strange effects, including posterization and banding that might not + be expected. For normal purposes, the saturation should generally be + less than 1.5. + + +Dithering Algorithms: +--------- ----------- + +The option names are case sensitive. Two names are listed for each +resolution; the first (short) name is the value that must be passed to +-sDither, and the second (long) name is descriptive. + +-sDither=algorithm + +Adaptive Adaptive Hybrid +Ordered Ordered +Fast Fast +VeryFast Very Fast +Floyd Hybrid Floyd-Steinberg + +For highest quality, we recommend use of Adaptive Hybrid dithering. +For continuous tone images, Ordered works just as well and is somewhat +faster. Ordered dithering yields noticeably inferior results with +text and intricate line art, particularly at high resolutions. + +Fast dithering, which is a simplified version of ordered dither, is +significantly faster, but color accuracy is worse, particularly on six +color printers and printer using variable dot sizes. On simple four +color printers, the quality is quite reasonable, although color +printing will show more speckling in dark tones than Ordered dither. +For single dot size printers, printing grayscale, this algorithm +yields almost identical results to Ordered with some performance +improvement. On three color printers, the results should be very +similar to Ordered. + +Very Fast is even faster than Fast, with even more loss of quality. +It shows even more speckling, and the output is heavily patterned. On +laser printers, and possibly on certain kinds of text and line art, +Very Fast dithering may actually yield the best quality. + +Error diffusion algorithms (Hybrid Floyd-Steinberg is such an +algorithm) perform very well at high densities, and are capable of +rendering very fine detail well, but they tend to exhibit artifacts in +the form of "waves" or "worms" of dots which results in noticeable +texturing in pale areas. Furthermore, pale areas immediately adjacent +to white take a while to "build up" sufficient error to print at all. +This is sometimes called "tearing". Its use is not recommended. + + +Output Type +------ ---- + +-dColor=x x: 0 ... 2 (1 on color printers, 0 otherwise) + +0 Grayscale +1 Color +2 Black and white + + Choose color vs. grayscale output. Color output is the default. + Choosing -dColor=0 results in only black ink (no color ink) being + used, which is faster and usually results in the most accurate + grayscale, but at the expense of smoothness. If you want composite + color (using a mixture of color and black inks to produce gray), use + -dColor=1 and -dSaturation=0.0 (see -dSaturation above). + + In addition, using -dColor=0 uses luminance (perceived brightness) of + red, green, and blue to choose output levels. Blue of a given + intensity is perceived to be much darker than red, which in turn + appears darker than green. -dColor=1 and -dSaturation=0.0 does not + use luminance. + + -dColor=2 prints only black and white (thresholding). This option + always uses Fast dithering unless you specify Very Fast. + + +Image type (to optimize the dither): +----- ---- --- -------- --- -------- + +-dImageType=x x: 0 ... 2 (0) +Select the image type most representative of what's being printed. + +0 Line art (color or gray scale) +1 Primarily solid colors or smooth gradients (color or gray scale) +2 Continuous-tone photographs (color or gray scale) + +Option 0 is the fastest. It generates strong, but not particularly +accurate, colors. There may be some fairly sharp color transitions in +this mode. + +Option 1 generates more accurate colors, but is slower. + +Option 2 generates the most accurate colors, but is considerably +slower. + +Note that any of the modes may be used with either color or black & +white output. If black and white output is requested, but a color +mode used, composite color will be printed. This generally offers +smoother tone, but less purity of gray or black, than pure black ink. +Furthermore, it is possible to tune the color of the gray (to achieve +warmer or cooler effects) using the color controls in this fashion. + +Specifying a lower GhostScript resolution (with -r) results in faster +color conversion. For example, if you print at 1440x720 DPI, but +specify a Ghostscript resolution of 360 DPI (with -r360), output will +be significantly faster and there will be much less difference in +performance between the three image type options. + + +EXAMPLES: +--------- + +Example 1 (print charts to file, color, 360 dpi): +gs -sDEVICE=stp -sModel=escp2-ex -dDensity=1.6 -dGamma=1.5 -dSaturation=0.9 \ + -dBrightness=.4 -dImageType=1 -sOutputFile=itsyourchoice.prn foo.ps + +Example 2 (print color photograph to /dev/lp0 at maximum quality): +gs -q -dSAFER -dNOPAUSE -sDEVICE=stp -sModel=escp2-870 -dDensity=0.8 \ + -r1440x720 -sQuality=1440x720hq -dImageType=2 -sOutputFile=/dev/lp0 foo.ps + +Example 3 (print pure black text to stdout) +gs -q -dSAFER -dNOPAUSE -sDEVICE=stp -sModel=escp2-660 -dDensity=0.8 -r720 \ + -sQuality=720sw -dColor=2 -sOutputFile=- foo.ps |