INTRODUCTION:
-------------

  Gimp-Print includes a Ghostscript driver based on the IJS protocol.
  It requires GNU Ghostscript 6.53 or above, AFPL Ghostscript 7.04 or
  above, or ESP Ghostscript 7.05 or above.  IJS is an initiative to
  improve the quality and ease of use of printing with Ghostscript.
  It permits adding or upgrading drivers without recompiling
  Ghostscript.  An IJS driver runs in a separate process that
  communicates with Ghostscript via an IPC channel.  The Gimp-Print
  IJS driver may be used with AFPL Ghostscript, as it runs in a
  separate process.


AUTHOR:
-------

  The original Ghostscript stp driver was originally written by Henryk
  Richter (buggs@comlab.uni-rostock.de), and was integrated into
  Gimp-Print during the 3.1 development series.  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.

  The IJS driver was originally written by Russell Lang, and
  incorporated into Gimp-Print in early 2002.  This driver corresponds
  with the IJS protocol 0.32.


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 OF THE IJS GIMPPRINT DRIVER:
----- --- ------------ -- --- --- --------- -------

   GNU Ghostscript 6.53 and beyond, and AFPL Ghostscript 7.04 and
   beyond, are required in order to use this driver.  These
   instructions correspond to GNU Ghostscript 6.53.

   You must first build Ghostscript itself with support for the IJS
   driver.  This is done as follows, within the Ghostscript source
   directory:

   cd ghostscript-6.53
   ./configure --with-ijs
   make
   make install

   The Ghostscript installation (as of 6.53, and likely 7.04) does not
   install certain files that are required to build the IJS driver.
   This should be fixed in future Ghostscript releases.  To build and
   install these files, you need to have the "aclocal", "autoconf",
   and "automake" packages installed.  These are not normally
   installed by default on most Linux and UNIX systems.  You may
   install them from your distribution, or download them from
   ftp.gnu.org.  After these packages are installed, run:

   cd ghostscript-6.53/ijs
   autoconf
   ./configure
   make
   make install

   You will perhaps get error messages during the autoconf process.
   The important point is that the configure works correctly.  This
   will install the necessary header files and libraries.

   After the IJS core files and Ghostscript are installed, you can
   build and install the IJS driver within the Gimp-Print package.
   This is done as follows, within the Gimp-Print source directory:

   ./configure --with-ghostscript
   make
   make install

   or

   ./configure --with-ghostscript --with-foomatic
   make
   make install

   if you also want to have the Foomatic data for the IJS driver
   (see the README file in the main directory of this package).

   If you do not wish to build the Gimp Print plugin, you may run

   ./configure --with-ghostscript --without-gimp

   ./configure --with-ghostscript --with-foomatic --without-gimp


OPTIONS:
--------

Overview
--------

Most of the Gimp-Print specific options are bundled together into a
single option that is passed in as a special "-sIjsParams" parameter,
and the normal Ghostscript "-s" and "-d" flags, indicating whether an
option is a string or a number, are not used in this special
parameter.

The device name is "ijs" (-sDEVICE=ijs).  In addition, the location of
the driver program must be specified.  This will typically be
/usr/local/bin/ijsgimpprint; the parameter in this case is
-sIjsServer=/usr/local/bin/ijsgimpprint .

Also, -dIjsUseOutputFD should be specified whenever output from
Ghostscript will go to stdout or into a pipe.  It may be specified in
all other cases, with only a slight performance degradation.

The -sIjsParams parameter contains a single string containing a
comma-separated list of sub-options:

-sIjsParams=Option1=Value1,Option2=Value2

and so forth.

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. The driver name used
by Foomatic is "gimp-print-ijs".


Printer Model Selection:
------- ----- ----------

-sDeviceManufacturer=vendor -sDeviceModel=name

This option must be supplied.  There is no default.  The IJS driver
requires the vendor (it's part of the protocol), but the ijsgimpprint
driver ignores it.  It should be CANON, EPSON, LEXMARK, or
HEWLETT-PACKARD.

The list of available printers is quite long; the current complete
list is in the NEWS file at top level.  The Driver Name (e. g. pcl-2)
listed is the name that should be used.

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

-sIjsParams=Quality=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
-sIjsParams=Quality, 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.  The available Quality settings for each resolution are
described in the next section.

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 Quality settings are supported on printers other than
the Stylus Pro (5000, 5500, 7000, 7500, 9000, 9500, and 10000)
printers.  Quality settings 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, 17, *)
360swuni         360 DPI Unidirectional                   (7, 17)
360hq            360 DPI High Quality                     (7, 8, 17)
360hquni         360 DPI High Quality Unidirectional      (7, 8, 17)

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)

2880x2880sw      2880 x 2880 DPI                          (18)

(*) This setting 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 most printers 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, C80, and C82; and Stylus Photo 950, 960,
    2100, 2200, and PM-950C and PM-970C

(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, C41, C42, C60, C61, and C62; the
    Stylus Color 480, 580, 680, 740, 760, 777, 860, 880, 83, and 1160,
    and the Stylus Photo 750, 780, 785, 790, 810, 820, 825, 830, 870,
    875, 890, 895, 900, 915, 925, 1270, 1280, 1290, and 2000P, and the
    Stylus Scan 2000 and 2500.

(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, Stylus Color Pro,
    Stylus Color Pro XL, 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, C61, C62, C70, C80, and C82, the Stylus Color 680,
    777, 880, 83, and 980, and Stylus Photo 780, 790, 810, 820, 825,
    830, 890, 900, 915, 925, 950, 960, 1280, and 1290.  This
    resolution is offered on the Stylus Photo 2100 and 2200, but it
    actually prints at 2880x1440 DPI.

(16) Works on Epson Stylus Photo 825, 830, 925, 950, 960, 2100, 2200;
    Stylus C61, C62, C70, C80, C82 ; Stylus Pro 7600 and 9600.  This
    resolution is not supported by Epson on the C70 and C80, but it
    works correctly on at least some such printers.

(17) These settings print at particularly high speed on the Epson
    Stylus Photo 950, 960, 2100, and 2200, and PM-950C and PM-970C
    when printing in Four Color Standard or Three Color Composite
    modes, or when printing in monochrome or grayscale with any ink
    type other than Two Level Grayscale, Seven Color Photo, or
    Quadtone.

(18) Works on the Epson PM-970C


The Stylus Pro printers (Stylus Pro 5000, 5500, 7000, 7500, 7600,
9000, 9500, 9600, and 10000) support additional microweave modes known
as Full Overlap (FOL), Four Pass, and FOL2.  The Stylus Pro 5500,
7500, 7600, 9500, 9600, and 10000 additionally have a mode called MW2.
These modes can only be used at certain resolutions.  Stylus Pro
printers support the following Quality settings:

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

In addition, the Stylus Pro 7600 and 9600 printers support the
following Quality settings:

2880x720dpi       2880 x 720 DPI
2880x720uni       2880 x 720 DPI Unidirectional
2880x720mw        2880 x 720 DPI Microweave
2880x720mwuni     2880 x 720 DPI Microweave Unidirectional
2880x720fol       2880 x 720 DPI FOL
2880x720foluni    2880 x 720 DPI FOL Unidirectional
2880x720fourp     2880 x 720 DPI Four Pass
2880x720fourpuni  2880 x 720 DPI Four Pass Unidirectional

1440x1440dpi      1440 x 1440 DPI
1440x1440uni      1440 x 1440 DPI Unidirectional
1440x1440mw       1440 x 1440 DPI Microweave
1440x1440mwuni    1440 x 1440 DPI Microweave Unidirectional
1440x1440fol      1440 x 1440 DPI FOL
1440x1440foluni   1440 x 1440 DPI FOL Unidirectional
1440x1440fourp    1440 x 1440 DPI Four Pass
1440x1440fourpuni 1440 x 1440 DPI Four Pass Unidirectional

2880x1440dpi      2880 x 1440 DPI
2880x1440uni      2880 x 1440 DPI Unidirectional
2880x1440mw       2880 x 1440 DPI Microweave
2880x1440mwuni    2880 x 1440 DPI Microweave Unidirectional
2880x1440fol      2880 x 1440 DPI FOL
2880x1440foluni   2880 x 1440 DPI FOL Unidirectional
2880x1440fourp    2880 x 1440 DPI Four Pass
2880x1440fourpuni 2880 x 1440 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):

300x300dpi       300x300 DPI
300x300dmt       300x300 DPI DMT
600x600dpi       600x600 DPI
600x600dmt       600x600 DPI DMT
1200x600dpi      1200x600 DPI
1200x1200dpi     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):

360x360dpi       360x360 DPI
360x360dmt       360x360 DPI DMT
720x360dpi       720x360 DPI
720x720dpi       720x720 DPI
1440x720dpi      1440x720 DPI
1440x1440dpi     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
-sIjsParams=InkType, and the second (long) name is descriptive.  Not
all ink types are supported on all printers.

-sIjsParams=InkType=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.

PhotoCMYK7      Seven Color Photo (CcMmYKk, for the Epson Stylus
                Photo 2100 and 2200, and Stylus Pro 7600 and 9600)
Photo7J         Seven Color Photo (CcMmYyK, for the Epson PM-950C and
                PM-970C)
PhotoEnhanceJ   Six Color Photo Composite (CcMmYy, for the Epson
                PM-950C and PM-970C)
PhotoCMYK       Six Color Photo
PhotoCMY        Five Color Photo Composite
CMYK            Four Color Standard
RGB             Three Color Composite
Quadtone        Quadtone grayscale inks (special third party inksets
                designed to produce superior results for grayscale
                images)
Gray2           Two Level Grayscale (Kk, for the Epson stylus Photo
                2100 and 2200, and Stylus Pro 7600 and 9600)


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 -sIjsParams=MediaType, and the second
(long) name is descriptive.

-sIjsParams=MediaType=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.

-sIjsParams=MediaSource=mediasource

Epson printers without a roll feed mechanism should not have this set.

For Epson printers with a roll feed mechanism without a paper cutter
(Stylus Photo 785, 825, 870, 875, 890, 895, 900, 915, 1200, 1270,
1280, 1290):

Standard        Standard
Roll            Roll Feed

For Epson printers with a roll feed mechanism with a paper cutter
(Stylus Photo 925, 950, 960, 2100, 2200):

Standard        Standard
RollCutPage     Roll feed, cut each page
RollCutNone     Roll feed, do not cut

For Epson Stylus Pro printers without a roll feed mechanism (Stylus
Pro 5000, 5500):

CutSheet1       Cut sheet bin 1
CutSheet2       Cut sheet bin 2
CutSheetAuto    Cut sheet autoselect
ManualSelect    Manual selection

For Epson Stylus Pro printers with a roll feed mechanism (Stylus Pro
7000, 7500, 7600, 9000, 9500, 9600, 10000, 10600):

Standard        Standard
Roll            Roll Feed


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 (for known Ghostscript paper sizes)
  or
-dDEVICEWIDTHPOINTS=x -dDEVICEHEIGHTPOINTS=y
               where x and y are the width and height of the paper
               respectively, in points (1/72")



   * Common English paper sizes

Letter          Letter         8.5in x 11in                     x=612, y=792
Legal           Legal          8.5in x 14in                     x=612, y=1008
Tabloid         Tabloid         11in x 17in                     x=792, y=1224
Executive       Executive     7.25in x 10.5in                   x=522, y=756
Postcard        Postcard       100mm x 147mm                    x=283, y=416
w216h360        3x5                                             x=216, y=360
w288h432        4x6                                             x=288, y=432
w324h495        Epson 4x6 Photo Paper                           x=324, y=495
w360h504        5x7                                             x=360, y=504
w360h576        5x8                                             x=360, y=576
8x10            8x10                                            x=576, y=720
Statement       Manual         5.5in x 8.5in                    x=396, y=612
TabloidExtra    12x18                                           x=864, y=1296
SuperB          13x19                                           x=936, y=1368

   * Common photographic paper sizes

w576h864        8x12   Sometimes used for 35 mm                 x=576, y=864
w792h1008       11x14                                           x=792, y=1008
w1152h1440      16x20                                           x=1152, y=1440
w1152h1728      16x24  20x24 for 35 mm                          x=1152, y=1728
w1440h1728      20x24                                           x=1440, y=1728
w1440h2160      20x30  24x30 for 35 mm                          x=1440, y=2160
w1584h2160      22x30  Common watercolor size                   x=1440, y=2160
w1728h2160      24x30                                           x=1728, y=2160
w1728h2592      24x36  Sometimes used for 35 mm                 x=1728, y=2592
w2160h2880      30x40                                           x=2160, y=2880

   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                   x=4768, y=6749
w3370h4768      2A            1189mm x 1682mm                   x=3370, y=4768
A0              A0             841mm x 1189mm                   x=2384, y=3370
A1              A1             594mm x  841mm                   x=1684, y=2384
A2              A2             420mm x  594mm                   x=1191, y=1684
A3              A3             297mm x  420mm                   x=842, y=1191
A4              A4             210mm x  297mm                   x=595, y=842
A5              A5             148mm x  210mm                   x=420, y=595
A6              A6             105mm x  148mm                   x=297, y=420
A7              A7              74mm x  105mm                   x=210, y=297
A8              A8              52mm x   74mm                   x=148, y=210
A9              A9              37mm x   52mm                   x=105, y=148
A10             A10             26mm x   37mm                   x=73, y=105

   * Stock sizes for normal trims.
   * Allowance for trim is 3 millimetres.

w2437h3458      RA0            860mm x 1220mm                   x=2437, y=3458
w1729h2437      RA1            610mm x  860mm                   x=1729, y=2437
w1218h1729      RA2            430mm x  610mm                   x=1218, y=1729
w864h1218       RA3            305mm x  430mm                   x=864, y=1218
w609h864        RA4            215mm x  305mm                   x=609, y=864

   * Stock sizes for bled work or extra trims.

w2551h3628      SRA0          900mm x 1280mm                    x=2551, y=3628
w1814h2551      SRA1          640mm x  900mm                    x=1814, y=2551
w1275h1814      SRA2          450mm x  640mm                    x=1275, y=1814
w907h1275       SRA3          320mm x  450mm                    x=907, y=1275
w637h907        SRA4          225mm x  320mm                    x=637, y=907

   * "B" series: Posters, wall charts and similar items.

w5669h8016      4B ISO        2000mm x 2828mm                   x=5669, y=8016
w4008h5669      2B ISO        1414mm x 2000mm                   x=4008, y=5669
ISOB0           B0 ISO        1000mm x 1414mm                   x=2834, y=4008
ISOB1           B1 ISO         707mm x 1000mm                   x=2004, y=2834
ISOB2           B2 ISO         500mm x  707mm                   x=1417, y=2004
ISOB3           B3 ISO         353mm x  500mm                   x=1000, y=1417
ISOB4           B4 ISO         250mm x  353mm                   x=708, y=1000
ISOB5           B5 ISO         176mm x  250mm                   x=498, y=708
ISOB6           B6 ISO         125mm x  176mm                   x=354, y=498
ISOB7           B7 ISO          88mm x  125mm                   x=249, y=354
ISOB8           B8 ISO          62mm x   88mm                   x=175, y=249
ISOB9           B9 ISO          44mm x   62mm                   x=124, y=175
ISOB10          B10 ISO         31mm x   44mm                   x=87, y=124

B0              B0 JIS                                          x=2919, y=4127
B1              B1 JIS                                          x=2063, y=2919
B2              B2 JIS                                          x=1459, y=2063
B3              B3 JIS                                          x=1029, y=1459
B4              B4 JIS                                          x=727, y=1029
B5              B5 JIS                                          x=518, y=727
B6              B6 JIS                                          x=362, y=518
B7              B7 JIS                                          x=257, y=362
B8              B8 JIS                                          x=180, y=257
B9              B9 JIS                                          x=127, y=180
B10             B10 JIS                                         x=90, y=127

   * "C" series: Envelopes or folders suitable for A size stationery.

C0              C0            917mm x 1297mm                    x=2599, y=3676
C1              C1            648mm x  917mm                    x=1836, y=2599
C2              C2            458mm x  648mm                    x=1298, y=1836
C3              C3            324mm x  458mm                    x=918, y=1298
C4              C4            229mm x  324mm                    x=649, y=918
C5              C5            162mm x  229mm                    x=459, y=649
w354h918        B6-C4         125mm x  324mm                    x=354, y=918
C6              C6            114mm x  162mm                    x=323, y=459
DL              DL            110mm x  220mm                    x=311, y=623
w229h459        C7-6           81mm x  162mm                    x=229, y=459
C7              C7             81mm x  114mm                    x=229, y=323
C8              C8             57mm x   81mm                    x=161, y=229
C9              C9             40mm x   57mm                    x=113, y=161
C10             C10            28mm x   40mm                    x=79, y=113

   * US CAD standard paper sizes

ARCHA           ArchA          9x12in                           x=648, y=864
ARCHB           ArchB          12x18in                          x=864, y=1296
ARCHC           ArchC          18x24in                          x=1296, y=1728
ARCHD           ArchD          24x36in                          x=1728, y=2592
ARCHE           ArchE          36x48in                          x=2592, y=3456

   * Foolscap

w612h936        American foolscap                               x=612, y=936
w648h936        European foolscap                               x=648, y=936

   * 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             x=535, y=697
w569h731        Large Crown Quarto    201mm x 258mm             x=569, y=731
w620h782        Demy Quarto           219mm x 276mm             x=620, y=782
w671h884        Royal Quarto          237mm x 312mm             x=671, y=884
w348h527        Crown Octavo          123mm x 186mm             x=348, y=527
w365h561        Large Crown Octavo    129mm x 198mm             x=365, y=561
w391h612        Demy Octavo           138mm x 216mm             x=391, y=612
w442h663        Royal Octavo          156mm x 234mm             x=442, y=663

   * Paperback sizes in common usage

w314h504        Small paperback       111mm x 178mm             x=314, y=504
w314h513        Penguin small paperback       111mm x 181mm     x=314, y=513
w365h561        Penguin large paperback       129mm x 198mm     x=365, y=561

   * Miscellaneous sizes

w283h420        Hagaki Card    100 x 148 mm                     x=283, y=420
w420h567        Oufuku Card    148 x 200 mm                     x=420, y=567
w340h666        Long 3         Japanese long envelope #3        x=340, y=666
w255h581        Long 4         Japanese long envelope #4        x=255, y=581
w680h941        Kaku           Japanese Kaku envelope #4        x=680, y=941
COM10           Commercial 10  US Commercial 10 env             x=297, y=684
w315h414        A2 Invitation  US A2 invitation                 x=315, y=414


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.

-sIjsParams=Cyan=xxx       xxx: 0.0 ... 4.0  (1.0)
-sIjsParams=Magenta=xxx    xxx: 0.0 ... 4.0  (1.0)
-sIjsParams=Yellow=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.

-sIjsParams=Brightness=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.

-sIjsParams=Contrast=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.

-sIjsParams=Gamma=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.

-sIjsParams=Density=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.

-sIjsParams=Saturation=xxx xxx: 0.0 ... 9.0  (1.0)

 Adjust the brilliance of colors.  0.0 results in pure grayscale;
 using this with -sProcessColorModel=DeviceRGB is one way of getting
 grayscale (see below under Output Type 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
-sIjsParams=DitherAlgorithm, and the second (long) name is descriptive.

IJS: -sIjsParams=DitherAlgorithm=algorithm

Adaptive        Adaptive Hybrid
EvenTone        EvenTone screening (experimental)
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.

EvenTone dithering is a relatively new screening technology developed
by Raph Levien.  It offers superior smoothness in highlights and
midtones, and increased accuracy in shadows, resulting in
significantly improved results overall.  The version of EvenTone
dithering that we are using is enhanced with some additional
improvements we have made.  It currently only operates with CMYK (4,
6, or 7 color output) with RGB input, and should be considered
experimental.  Note that it is patented (see US patent 5917614), but
it is licensed for use with GPL software.  See
http://www.levien.com/patents.html for more information.

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
------ ----

Black and white: -sProcessColorModel=DeviceGray -dBitsPerSample=1
Grayscale:       -sProcessColorModel=DeviceGray
Color (RGB):     -sProcessColorModel=DeviceRGB
Color (CMYK):    -sProcessColorModel=DeviceCMYK

 Choose color vs. grayscale output.  Color output is the default.
 Choosing -sProcessColorModel=DeviceGray 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 --sProcessColorModel=DeviceRGB and
 -sIjsParams=Saturation=0.0 (see -sIjsParams=Saturation above).

 In addition, using -sProcessColorModel=DeviceGray 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.
 -sProcessColorModel=DeviceRGB and -sIjsParams=Saturation=0.0 does not
 use luminance.

 -sProcessColorModel=DeviceGray -dBitsPerSample=1 prints only black
 and white (thresholding).  This option always uses Fast dithering
 unless you specify Very Fast.

 -sProcessColorModel=DeviceCMYK is useful if you're printing a CMYK
 graphic and want explicit control over the inks.  Generally it yields
 inferior quality, as Gimp-Print has good algorithms for converting
 RGB (screen) into CMYK (inks) that take into account paper type, ink
 type, and other variables.  In CMYK mode, the brightness, contrast,
 and saturation controls do not function.


Image type (to optimize the dither):
----- ---- --- -------- --- --------

-sIjsParams=ImageOptimization=x

Select the image type most representative of what's being printed.

LineArt     Line art (color or gray scale)
Solid       Primarily solid colors or smooth gradients (color or gray scale)
Photograph  Continuous-tone photographs (color or gray scale)

LineArt is the fastest.  It generates strong, but not particularly
accurate, colors.  There may be some fairly sharp color transitions in
this mode.

Solid generates more accurate colors, but is slower.

Photograph 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:
---------

Note that a lot of these options are used for demonstration; generally
adjusting the density is a bad idea.  Also, replace
"/usr/local/bin/ijsgimpprint" with the location where ijsgimpprint is
installed on your system.

Example 1 (print charts to file, using A4 paper, color, 360 dpi):
gs -sDEVICE=ijs -sIjsServer=/usr/local/bin/ijsgimpprint \
   -sDeviceManufacturer=EPSON -sDeviceModel=escp2-ex -sPAPERSIZE=a4 \
   -sOutputFile=itsyourchoice.prn \
   -sIjsParams=Density=1.6,Gamma=1.5,Saturation=0.9,Brightness=0.4,ImageOptimization=Solid \
   foo.ps

Example 2 (print color photograph to /dev/lp0 at maximum quality):
gs -sDEVICE=ijs -sIjsServer=/usr/local/bin/ijsgimpprint \
   -sDeviceManufacturer=EPSON -sDeviceModel=escp2-870 \
   -sOutputFile=/dev/lp0 \
   -sIjsParams='Quality=1440x720hq,MediaType=GlossyPhoto,Density=0.8,ImageOptimization=Photograph' \
   foo.ps

Example 3 (print pure black text to stdout)
gs -sDEVICE=ijs -sIjsServer=/usr/local/bin/ijsgimpprint \
   -sDeviceManufacturer=EPSON -sDeviceModel=escp2-660 -dIjsUseOutputFD \
   -sProcessColorModel=DeviceGray -dBitsPerSample=1 -sOutputFile=- \
   -sIjsParams='Quality=720sw,Density=0.8' foo.ps
