Stylus Photo R800 Photo Image Print System for Linux Description

Copyright (C) SEIKO EPSON CORPORATION 2004.

Note :
     About the latest information, please refer to our Web page.
     http://www.epkowa.co.jp/


Contents
1   License Agreement
2   Version Up Record
3   Products Description
4   Installation Method
5   Operation
5.1  ekpd
5.1.1  The operation method
5.1.2  Setup
5.2  ekpstm
5.2.1  The operation method
5.3   pips-spr800
5.3.1   The operation method
5.3.2    Specification for the options
5.3.3    Default value for optional settings
5.3.4    Combination of options
5.3.5    Specification for pipsrc
5.3.6    libspr800.so Specification
6  Size of the Paper and Margin
7  Handling Instructions
8  Acknowledgement


1  License Agreement

This package contains source code covered by the GNU General Public
License and the GNU Library General Public License (see ./COPYING and
./COPYING.LIB for their terms) and object code distributed under the
terms of the EPSON KOWA Public Licence (see ./COPYING.KOWA for
details).

All object code contained in the sources are Copyright EPSON KOWA
Corporation and SEIKO EPSON Corporation.


2  Version Up Record

Contents moved to ./ChangeLog.


3  Products Description

This software is a Printer Driver (filter) for the high quality print
with SEIKO EPSON Color Ink Jet Printer from the Linux.


4  Installation Method

(1).... Installing a rpm file
Executes the rpm command to complete the installation.
-----------------
rpm -ivh pips-spr800-2.6.2-1.i386.rpm
-----------------

Depends on the distribution, dependent errors may occur.
Execution of the rpm command shown below may helps you to avoid the
error.
-----------------
rpm -i --nodeps pips-spr800-2.6.2-1.i386.rpm
-----------------

(2).... Setting after the installation
It is necessary to describe a setup for using pips-spr800 to
/etc/printcap.  Usually although it is automatically added at the time
of installation, when it is not described by a certain factor or setup
is changed, please execute Setup script.

Setup is interactively performed by setup script.
Execute the following commands and set up according to messages.

 # /usr/local/EPKowa/SPR800/setup

When you set up manually without using script, please refer to the
following.

Setting example
    1     spr800:\
    2        :lp=/var/ekpd/ekplp0:\
    3        :sh:\
    4        :if=/usr/local/EPKowa/SPR800/filter-spr800:\
    5        :sd=/var/spool/lpd/spr800:\
    6        :mx#0:

    1:Printer name
    2:Specify the printer port
    3:Control the cover sheet
    4:Specify the input filter
    5:Specify the spool directory
    6:Specify the maximum file size for spooling(Set 0 for the unlimited value)

Additionally, the following description is added to
/etc/services. This is also automatically added at the time of
installation.

    cbtd     35586/tcp

Finally, correct "PrinterDevicePath" entry of /etc/ekpdrc. Please
describe the path to the device driver of the port where the printer
is connected after '='.

(Example) Default setting value

          PrinterDevicePath = /dev/usb/lp0

* When LPRng is being used for a printing spooler, setup is not
  reflected if LPRng is not re-started after installation or a setup
  ,please be careful.

  The re-starting method of LPRng (It may change with systems.)
  -----------------
  (Redhat)
  /etc/rc.d/init.d/lpd restart

  (Debian)
  /etc/init.d/lpd restart
  -----------------


5  Operation

5.1  ekpd

5.1.1  The operation method

In order to use a printer, it is necessary to start ekpd first. ekpd
performs two-way communication with a printer. Usually, it starts
automatically when starting of Linux. When it has not started, please
execute the following commands by root authority.

  -----------------
  (Redhat)
  # /etc/rc.d/init.d/ekpd start

  (Debian)
  # /etc/init.d/ekpd start
  -----------------

There are the following options in a command.

    start       start ekpd
    stop        stop ekpd
    restart     restart ekpd

5.1.2  Setup

Setup of ekpd is described in /etc/ekpdrc. Setting items are as
follows. (The inside of a parenthesis is a default)

PrinterName
The printer name described in printcap  (spr800)

PrinterDevicePath
Path to the connection place device driver of a printer (/dev/usb/lp0)

DummyDevicePath
The path to FIFO file for a printing data input (/var/ekpd/ekplp0)

CommandServerPort
The port number for communication       (35586)

Interactive setting can also be used with setting script
(/usr/local/EPKowa/SPR800/setup).

5.2  ekpstm

5.2.1  The operation method

It can also start automatically when printing start. add the machine
to which the printer is connected to the access list of X servers by
xhost for starting automatically.  The following commands are executed
after login.

    # xhost <Machine name>

* This work may be required also when using  in a PC (local machine).
  Execute the following commands after login in case.

    # xhost $HOSTNAME

  We recommend you to write these commands to .xinitrc, since it is
  troublesome to execute them each time .

5.3   pips-spr800

5.3.1   The operation method

The utility(GUI) for the X-Window environment starts from the command line
'pips-spr800' on the X-Window environment.

* It is necessary to set up the locale at the time of printing after
  installation.  Start GUI utility, in order to set up the
  locale. Whenever it is started, it memorizes its language setup
  (LANG). At the time of printing, the setup is used for
  printing. Please notice that documents may cause character
  transformation when the locale is not correctly set up at the time
  of printing.

The 'common' button which performs following operations is located on the
bottom of the window.
  [Save]:Save the current settings and keep the settings for the next
  operation. All the users use the saved settings.
  [Print]: Start the print with the current settings.
  [Quit]: End the operation.

The following settings are available from the 'I/O Settings'.
  [Input]: Specify the PNG file(non-interlaced).
  [Output]: Specify the ESC/P code output file.

The following settings are available from the 'Paper Settings'.
  [Paper Size]: Select the size of paper a printer is supporting.
  [Paper Source]: Select the paper source.
  [Auto Cut]: Selects the way roll paper gets cut.

The following settings are available from the 'Layout Setting'
  [Fit to Page]: Select to activate the Fit to Page setting.
  [Reduce/Enlarge]: Specify the enlargement or reduction of input image with %.
  (10 to 400)
  [Margin]: Specify the margin in millimeter. (0 to maximum value of right
  margin)
  [Multi Page]: Select the number of pages to print on one sheet of paper.

The following settings are available from the 'Main Settings'.
  [Media Type]: Select the paper type which is supported by the printer.
  [Halftone]: Select the Halftone method.
  [Input Resolution]: Select the input resolution.
  [Quality]: Specify the print quality.
  [Micro Weave]: Select the Micro Weave print on or off.
  [High Speed]: Select the bi-directional print on or off.
  [Ink]: Select the color printing or the monochrome printing.
  [Gloss Optimizer]: Specify the Gloss Optimizer print

The following settings are available from the 'Color Management'.
  [Mode]: Select the color mode.
  [Brightness]: Adjust the brightness.(-50 to +50)
  [Contrast]: Adjust the contrast.(-50 to +50)
  [Saturation]: Adjust the saturation.(-50 to +50)
  [Cyan]: Adjust the density of the Cyan ink.(-50 to +50)
  [Magenta]: Adjust the density of the Magenta ink.(-50 to +50)
  [Yellow]: Adjust the density of the Yellow ink.(-50 to +50)

The following settings are available from the 'Utility'.
  [Status Monitor]: Activate status monitor.
  [Nozzle Check]: Print a nozzle check pattern.
  [Head Cleaning]: Execute head cleaning.
  [Print Head Alignment]: Execute print head alignment.

  See "5.3.3. Default value for optional settings" for the
  default value of each option.

Also, the setting can completed on the command line without starting
the GUI.  In this case,

 set the command
  pips-spr800 [option] input_file
 or
  pips-spr800 [option] < input_file

Then specify the PNG file for the input_file.
The output is a standard output. Depends on the combination of the
optional settings, settings may canceled or may not correctly effect
the system. Start the GUI and check the setting value.

If you can set the paper size from the application's property, set the
same size of the paper to the application's property as the setting
used in this software. The print job is proceeded with reference to
upper left corner of the paper. The print area set margin to the left,
right, top and bottom of the paper.
Please refer to '6. Paper size and Margin' for more details.

5.3.2    Specification for the options

- Start Mode
  Format    -ui n1
  Parameter  n1 =  X   Start the GUI
                   C   Operate on the command line
  Specify whether the GUI is started.

- Paper size
  Format    -ms n1
  Parameter  n1 =   A4        A4  210x297 mm
                    B5        B5  182x257 mm
                    A5        A5  148x210 mm
                    LT        Letter  8 1/2x11 in
                    LGL       Legal  8 1/2x14 in
                    EXE       Executive 7 1/4x10 1/2 in
                    HLT       Half Letter 5 1/2x8 1/2 in
                    A6        A6 Index card 105x148 mm
                    INDEX5    Index card  5x8 in
                    INDEX8    Index card  8x10 in
                    ENV10     Envelope #10  4 1/8x9 1/2 in
                    ENVDL     Envelope DL  110x220 mm
                    ENVC6     Envelope C6  114x162 mm
                    ENV5X8    Envelope 132x220 mm
                    4X6FULL   Photo Paper 4x6 in No Perforations
                    PP100     10x15 cm Photo
                    PP200     20x30 cm Photo
                    L         3.5x5 in (9x13 cm)
                    2L        5x7 in (13x18 cm)
                    PANORAM   Panoramic 210x594 mm
                    4X6       4x6 100x152 mm
                    LL        3.5x5 in(Landscape)  13x9 cm
                    NC        Business card 89x50 mm
  Specify the size of the paper.

- Media
  Format    -mt n1
  Parameter  n1 =   PLAIN      Plain Paper
                    SFINE      Photo Quality Ink Jet Paper
                    ARCMATT    Archival Matte Paper
                    PMMATT     Matte Paper - Heavyweight
                    PMPHOTO    Premium Glossy Photo Paper
                    PSGLOS     Premium Semigloss Photo Paper
  Specify the type of the paper.

- Auto Cut (Cannot be used with Stylus Photo R800)
  Format    -ac n1
  Parameter     n1 =   NONE     Not cut
  This designates the cutting method. However, this cannot be used
  if microweave is set to OFF.

  * With 2 cuts, printing is done by leaving a gap between images,
    and cutting is done at the two points
    before and after, so in that case there is an 18 mm cutting edge.

- Resolution
  Format    -re n1
  Parameter  n1 =   360       360dpi
                    720       720dpi
  Specify the resolution.

- Print quality
  Format    -ql n1
  Parameter  n1 =  STD360      Standard (360dpi)
                   SFINE720    Super Fine (720dpi)
                   PHOTO1440   Photo (1440dpi)
                   SPHOTO1440  Super Photo (1440dpi)
                   SPHOTO2880  Super Photo (2880dpi)
  Specify the quality of the print.

- Micro Weave print
  Format    -mw n1
  Parameter  n1 =  ON          Micro Weave on
                   OFF         Micro Weave off
  Specify whether the Micro Weave print is used.

- High Speed print
  Format    -hs n1
  Parameter  n1 =  ON          High Speed Print
                   OFF         Simplex Print
  Specify whether the High Speed print is used.

- Halftone
  Format    -ht n1
  Parameter  n1 =  ED          High Quality Halftoning
                   DB          High Speed Halftoning
  Specify the Halftone method.

- Print Scale
  Format    -sc n1
  Parameter  n1 = [10 - 400]
  Specify the enlargement or reduction of input image.

- Ink
  Format    -in n1
  Parameter  n1 =  COLOR     Color Print
                   MONO      Black Print
  Specify the Color or the Black print.

- Color mode
  Format    -cc n1
  Parameter  n1 =   PHOTO    Photo - realistic
                    GRAPH    Vivid color
                    NONE     No adjustment
  Adjust the color mode.

- Brightness
  Format    -br n1
  Parameter  n1 = [-50 - 50]
  Adjust the the brightness.

- Contrast
  Format    -co n1
  Parameter  n1 = [-50 - 50]
  Adjust the contrast.

- Saturation
  Format    -sa n1
  Parameter  n1 = [-50 - 50]
  Adjust the saturation.

- Density
  Format    -st n1 n2 n3
  Parameter   n1 = [-50 - 50]   Cyan density adjustment
              n2 = [-50 - 50]   Magenta density adjustment
              n3 = [-50 - 50]   Yellow density adjustment
  Adjust the ink density.

- Margin
  Format    -mg n1 n2
  Parameter   n1 = [0 - right(maximum)]     Left margin
              n2 = [0 - bottom(maximum)]    Top margin
  Specify the margin in millimeter.

- Paper Source
  Format    -ps n1
  Parameter   n1 = AUTO     Auto Sheet Feeder
                   T4AUTO   Sheet Feeder-No Margins
                   ROLL     Roll Paper
                   TROLL    Roll Paper (Banner)
  Select a paper feed method.

- Fit to Page
  Format    -ft n1
  Parameter   n1 = ON
                   OFF
  Specify whether the fit to page print is used.

- Multi Page
  Format    -mp n1
  Parameter   n1 = 1     Normal printing
                   2     Print 2 pages in one piece of paper
                   4     Print 4 pages in one piece of paper
  Specify whether the multi page print is used.
  This function is available only when printing a Postscript file
  using the lpr command. It cannot be available when printing using a
  GUI tool.

- Clear Ink
  Format    -ci n1
  Parameter   n1 = OFF     Clear ink off
                   ON      Clear ink on
                   AUTO    Clear ink automatic
                   FULL    Clear ink full
  Specify a gloss optimizer method.
  "AUTO" is effective when printing Postscript file by a lpr command.
  Cannot select "AUTO" when printing it from GUI.

  * Gloss Optimizer
    Select how to print with the gloss optimizer ink. Selecting Gloss Optimizer
    enables you to improve the print quality when printing on a plain paper or
    photo paper. You can select the following modes:

    mode | description
    -----+-------------------------------------------------------------------
    ON   | Prints with the gloss optimizer ink on the image and text data.
    OFF  | Prints with other than the gloss optimizer ink.
    AUTO | Prints with the gloss optimizer ink on the image data.
    FULL | Prints with the gloss optimizer ink on the full-page within the printable area.


Those items that is not changed its optional settings is set as
default settings. However, you can adjust the default settings of the
items listed below in the resource file [.pipsrc]. The value from the
option is set as the value to the each parameter. (see "6.5
Specification for pipsrc")

5.3.3    Default value for optional settings

Start mode:         Start the GUI
Paper size:         A4
Reduce/Enlarge:     100
Ink:                Color
Paper type:         Plain paper
Halftone:           High Speed Halftoning
Resolution:         360
Quality:            STD360
Micro Weave print:  OFF
High Speed print:   ON
Color - mode:       Photo - realistic
Brightness:         0
Contrast:           0
Saturation:         0
Cyan:               0
Magenta :           0
Yellow :            0
Left Margin:        3
Top Margin:         3
Paper Source:       AUTO
Fit to Page:        OFF
Multi Page:         1
Clear Ink:          OFF

5.3.4    Combination of options

The list shown below indicates the combination of the option that is
available to the Photo Image Print System for Stylus Photo R800.
Refer to the list when changing the options from the command line.

 Color/Mono print
       Media        Resolution  Quality    Micro   High    Halftone Clear            Color                 Output
                                           Weave   Speed            Ink              mode                  resolution
                                                                                     (Color print only)    (reference)
       -mt          -re         -ql        -mw     -hs     -ht                       -cc
       ------------ ----------- --------   ------- ------- -----    ---------------- --------------------- ------------
 *     PLAIN        360         STD360     OFF     ON      DB       OFF              PHOTO/GRAPH/NONE      360*360
                    360         SFINE720   ON      ON/OFF  DB       OFF/ON           PHOTO/GRAPH/NONE      720*720
                    720         SFINE720   ON      ON/OFF  DB       OFF/ON           PHOTO/GRAPH/NONE      720*720
                    720         PHOTO1440  ON      ON/OFF  ED       OFF/ON           PHOTO/GRAPH/NONE      1440*720

       SFINE        720         PHOTO1440  ON      ON/OFF  ED       OFF              PHOTO/GRAPH/NONE      1440*720

       ARCMATT      720         PHOTO1440  ON      ON/OFF  ED       OFF              PHOTO/GRAPH/NONE      1440*720
                    720         SPHOTO1440 ON      ON/OFF  ED       OFF              PHOTO/GRAPH/NONE      1440*1440

       PMMATT       720         PHOTO1440  ON      ON/OFF  ED       OFF              PHOTO/GRAPH/NONE      1440*720
                    720         SPHOTO1440 ON      ON/OFF  ED       OFF              PHOTO/GRAPH/NONE      1440*1440

       PMPHOTO      720         PHOTO1440  ON      ON/OFF  ED       OFF/AUTO/FULL    PHOTO/GRAPH/NONE      1440*720
                    720         SPHOTO1440 ON      ON/OFF  ED       OFF/AUTO/FULL    PHOTO/GRAPH/NONE      1440*1440
                    720         SPHOTO2880 ON      ON/OFF  ED       OFF/AUTO/FULL    PHOTO/GRAPH/NONE      2880*1440

       PSGLOS       720         PHOTO1440  ON      ON/OFF  ED       OFF/AUTO/FULL    PHOTO/GRAPH/NONE      1440*720
                    720         SPHOTO1440 ON      ON/OFF  ED       OFF/AUTO/FULL    PHOTO/GRAPH/NONE      1440*1440
                    720         SPHOTO2880 ON      ON/OFF  ED       OFF/AUTO/FULL    PHOTO/GRAPH/NONE      2880*1440

       (*) When T4AUTO/ROLL/TROLL is chosen by Paper Source, cannot use it

5.3.5    Specification for pipsrc

This product uses a text-base setting file called pipsrc so that the
user can save their optional setting values. To create the pipsrc file
in the directory, start the GUI from the root and press the save
button.

The pipsrc file is used for the supplementation of the items that is
not specified its option on the command line, and is also used for the
default setting value of GUI settings.

Do not change the data of pipsrc file directly. Change the settings
using the GUI. If you need to change the data of the pipsrc file
directly, refer to the list below.

The printer name is listed first in the pipsrc file. Two fields are
related to each lines with '=' .

   Paper size
       media size = n1

   Paper type
       media type = n1

   Resolution
       resolution = n1

   Quality
       quality level = n1

   Micro Weave print
       micro weave = n1

   High - Speed print
       high speed = n1

   Halftone
       half tone = n1

   Print scale
       scale = n1

   Ink
       ink = n1

   Color mode
       color correction = n1

   Brightness
       brightness = n1

   Contrast
       contrast = n1

   Saturation
       saturation = n1

   Density
       strength = n1, n2, n3

   Margin
       margin = n1, n2

   Paper Source
       papersource = n1

   Fit to Page
       fit2page = n1

   Multi Page
       multipage = n1

   Clear Ink
       clearink = n1

5.3.6    libspr800.so Specification

Refer to the libspr800.readme file for the specification.


6  Size of the Paper and Margin

The base point to print with Photo Image Print System is upper left
corner (0,0) of the paper.
However, the default margins are provided to the printer settings. The
outside edge of the image is cut off if it exceeds the value of the
default margins.

The size of the each paper and the margin is listed below.

[Auto Sheet Feeder]
PaperSize                             | Paper Size(1mm)| Margin(1mm)
Name                                  | Width  Height  | Left     Top   Right   Bottom
--------------------------------------|----------------|------------------------------
A4  210x297 mm                        | 210    297     | 3        3     3       20
B5  182x257 mm                        | 182    257     | 3        3     3       20
A5  148x210 mm                        | 148    210     | 3        3     3       20
Letter  8 1/2x11 in                   | 216    279     | 3        3     3       20
Legal  8 1/2x14 in                    | 216    356     | 3        3     3       20
Executive 7 1/4x10 1/2 in             | 184    267     | 3        3     3       20
Half Letter 5 1/2x8 1/2 in            | 140    216     | 3        3     3       20
A6 Index card 105x148 mm              | 105    148     | 3        3     3       20
Index card  5x8 in                    | 127    203     | 3        3     3       20
Index card  8x10 in                   | 203    254     | 3        3     3       20
Envelope #10  4 1/8x9 1/2 in          | 105    241     | 3        3     3       20
Envelope DL  110x220 mm               | 110    220     | 3        3     3       20
Envelope C6  114x162 mm               | 114    162     | 3        3     3       20
Envelope 132x220 mm                   | 132    220     | 3        3     3       20
Photo Paper 4x6 in No Perforations    | 102    152     | 3        3     3       20
10x15 cm Photo                        | 100    150     | 3        3     3       20
20x30 cm Photo                        | 216    338     | 3        14    3       20
3.5x5 in (9x13 cm)                    | 89     127     | 3        3     3       20
5x7 in (13x18 cm)                     | 127    178     | 3        3     3       20
Panoramic 210x594 mm                  | 210    594     | 3        3     3       20

[Sheet Feeder-No Margins]
PaperSize                             | Paper Size(1mm)| Margin(1mm)
Name                                  | Width  Height  | Left     Top   Right   Bottom
--------------------------------------|----------------|--------------------------------
A4  210x297 mm                        | 210    297     | 0        0     0       0
Index card  5x8 in                    | 127    203     | 0        0     0       0
Index card  8x10 in                   | 203    254     | 0        0     0       0
Photo Paper 4x6 in No Perforations    | 102    152     | 0        0     0       0
10x15 cm Photo                        | 100    150     | 0        0     0       0
3.5x5 in (9x13 cm)                    | 89     127     | 0        0     0       0
5x7 in (13x18 cm)                     | 127    178     | 0        0     0       0
Panoramic 210x594 mm                  | 210    594     | 0        0     0       0

[Roll Paper]
PaperSize                             | Paper Size(1mm)| Margin(1mm)
Name                                  | Width  Height  | Left     Top   Right   Bottom
--------------------------------------|----------------|------------------------------
A4  210x297 mm                        | 210    297     | 3        0     3       0
B5  182x257 mm                        | 182    257     | 3        0     3       0
A5  148x210 mm                        | 148    210     | 3        0     3       0
Executive 7 1/4x10 1/2 in             | 184    267     | 3        0     3       0
Half Letter 5 1/2x8 1/2 in            | 140    216     | 3        0     3       0
A6 Index card 105x148 mm              | 105    148     | 3        0     3       0
Index card  5x8 in                    | 127    203     | 3        0     3       0
Index card  8x10 in                   | 203    254     | 3        0     3       0
4x6 100x152 mm                        | 100    152     | 3        0     3       0
10x15 cm Photo                        | 100    150     | 3        0     3       0
3.5x5 in (9x13 cm)                    | 89     127     | 3        0     3       0
3.5x5 in(Landscape)  13x9 cm          | 127    89      | 3        0     3       0
5x7 in (13x18 cm)                     | 127    178     | 3        0     3       0
Business card 89x50 mm                | 89     50      | 3        0     3       0
Panoramic 210x594 mm                  | 210    594     | 3        0     3       0

[Roll Paper (Banner)]
PaperSize                             | Paper Size(1mm)| Margin(1mm)
Name                                  | Width  Height  | Left     Top   Right   Bottom
--------------------------------------|----------------|------------------------------
A4  210x297 mm                        | 210    297     | 0        0     0       0
4x6 100x152 mm                        | 100    152     | 0        0     0       0
10x15 cm Photo                        | 100    150     | 0        0     0       0
3.5x5 in (9x13 cm)                    | 89     127     | 0        0     0       0
3.5x5 in(Landscape)  13x9 cm          | 127    89      | 0        0     0       0
5x7 in (13x18 cm)                     | 127    178     | 0        0     0       0
Business card 89x50 mm                | 89     50      | 0        0     0       0
Panoramic 210x594 mm                  | 210    594     | 0        0     0       0


7  Handling Instructions

- The print data of this software may get large as it operates the
high-quality print, and lpr may return the error. In this case, add
the -rs option to lpr.  Please refer the lpr(1) on the manual about
the details on lpr. If still the problem is not solved, install the
extra memory or set the Swap. This is the end of this document.

(Example)
 $ lpr -rs -P <Printer> <PostScript File>

- When this product is used as a filter, the line not intended might
be printed.  This case is occured because the Postscript file is
converted into the PNG file with Ghostscript (henceforth GS) .It does
not depend on this product.  It is confirmed generating with GS v5.10
not with v5.50.


8  Acknowledgement

    We appreciate the following people who cooperate with us for the
    development of this product.

    Nobby N Hirano <nobby@nmail.hiug.ne.jp>
    Toshihiro Yamagishi <toshihiro@turbolinux.co.jp>
    Nozomi Satou <nozomi@esd.spr.epson.co.jp>

***End of file
