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 , 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 ): 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