@DATABASE ESCUtil
@$VER 1.73 (31/12/97)
@FONT Xen.font 11
@AUTHOR Stephan Rusdorf 
@NODE "Main" "Documentation for ESCUtil"


                  @{b}ESCUtil@{ub}

     The EPSON Stylus Color Utility for the Amiga
             Version 1.73beta (31.12.1997)
                 by Stephan Rusdorf

English Documentation: (by Willem Schaaij)
          
               @{"Introduction   " link INTRODUCTION}
               @{"Distribution   " link DISTRIBUTION}
               @{"Features       " link FEATURES}
               @{"Requirements   " link REQUIREMENTS}
               @{"Installation   " link INSTALLATION}
               @{"Locale         " link LOCALE}

               @{"How to use     " link USING}

               @{"History        " link HISTORY}
               @{"Known Bugs     " link BUGS}
               @{"Future         " link FUTURE}
               @{"Statistics     " link STATS}
               @{"Thanks         " link THANKS}
               @{"Author         " link AUTHOR}  

@ENDNODE
          
@NODE INTRODUCTION "Introduction"

@{b}Introduction@{ub}

Because there was not a tool like this one available for
the Amiga and my new printer (an EPSON Stylus Color 800),
I wrote one myself.

Because it's more fun to code a program than to write the
documentation, there was only a simple doc available.
Many users of ESCUtil wrote me however to write some more
documentation, because the program and its use, needed more
explanation and leaves otherwise too much questions open.

Therefore I came to the point that I've pursuaded myself to
write more extended documentation in guideform and here it
is.

@ENDNODE

@NODE DISTRIBUTION "Distribution"

@{b}Distribution@{ub}

This Program is email-ware.
So, if you use it please send an email to the author.
Bug-Reports and suggestions are welcome (per email).

It is @{b}not allowed@{ub} to include this program in any
package (pd or commercial) without permission of the
author.

It is @{b}not allowed@{ub} to spread a modified archive.

It is @{b}allowed@{ub} to distribute this program on the
AminetCD and MeetingPearlsCD.

It is @{b}allowed@{ub} to distribute this program with the
Turboprint package from IrseeSoft.

@ENDNODE

@NODE FEATURES "Features"

@{b}Features@{ub}

ESCUtil does about the same as the programs for the PC or
Mac do, which are included in the printer package.

The supported printers and implemented functions are shown
in the following table:

  ------------------------------------------------------------
 | Prt.\\Action| NozzleCheck  Headcleaning  Calibration  Setup |
  ------------------------------------------------------------
 | ESC        |     X             X             X         X   |
 | ESC2       |     X             -             X         X   |
 | ESC2s      |     X             X             X         X   |
 | ES820      |     X             X             X         X   |
 | ESC500     |     X             -             -         X   |
 | ESC200     |     X             -             -         X   |
 | ESC400     |     X             X             X         X   |
 | ESC600     |     X             X             X         X   |
 | ESC800     |     X             X             X         X   |
 | ESPhoto    |     X             X             X         X   |
 | ESPro      |     X             X             X         X   |
 | ESPro XL   |     X             X             X         X   |
 | ES300      |            +++++ NOT SUPPORTED YET +++++      |
  ------------------------------------------------------------

Note: The missing X's are under construction (-).


It seems that the setup mode doesn't work for the ESC400 and ESPhoto,
but this is not supported in the PC-software too.

About software-controlled interrogation of ink capacity I don't have
any information. If I could get my hands on the required developer-
information, I will support this.

@ENDNODE

@NODE REQUIREMENTS "Requirements"

@{b}Requirements@{ub}

 - EPSON Stylus (Color) Series Printer
 - AmigaOS 2.04 or later and 68020+ CPU
 - MagicWB-like Workbench colors >=8

@ENDNODE

@NODE INSTALLATION "Installation"

@{b}Installation@{ub}

 - Decrunch the archive
 - Copy the directory to your favorite spot (disk/harddisk)
 - if you want to use another language, copy one of the
   included catalogs to SYS:locale/catalogs/<your language>
   Look also at @{"Locale" link LOCALE}

@ENDNODE

@NODE LOCALE "Supported languages"

@{b}Languages@{ub}

Following languages are supported at the moment:

- English     (build in)
- German      (Stephan Rusdorf)
- French      (Gilles Vigner)
- Italian     (Gabriele Greco)
- Dutch       (Willem Schaaij)
- Spain       (D.Domínguez)
- Swedish     (Krister Larsson)
- Hungarian   (Varga Lajos)

  Again thanks to all translators.

To use another language you have to set this language
through the workbench Preferences and you must copy the
catalog to the directory SYS:Locale/Catalogs/<your language>

@ENDNODE

@NODE BUGS "Known bugs"

@{b}Known bugs@{ub}

- Problems with the MWB colors on non-MWB-workbenches
- Reported problems with the locale (foreign languages)
- Calibration for ES820 and IIs is not yet correct
  (I hope this is fixed in V1.72)

@ENDNODE

@NODE FUTURE "Future"

@{b}Future@{ub}

- Support for more printers
- New functions (suggestions?)
- Removing bugs
- Interrogation of ink capacity for the new models

@ENDNODE

@NODE HISTORY "History"

@{b}History@{ub}

 V1.73- hungarian catalog included (Thanks to Varga Lajos)
      - fixed some problems with the mouse events
      - windows opens in the middle of the visible screen
        (Thanks to Bahman Moallem)
      - other little bugfixes
      - headcleanig support for ESPro(XL)

 V1.72- changed the calibration for ESC2s and ES820
        (I hope it works now)

 V1.71- removed pitch setting for ESC (not supported by the printer)
      - added setup for ESPro and ESPro XL
      - added calibration for ESPro and ESPro XL
      - changed nozzlecheck for ESC2 to 20 nozzles
      - added nozzlecheck for ESC200/ESC500

 V1.7 - internal changes
      - added a little documentation

 V1.69- Printer setup support for ESC2s and ES820
      - Nozzlecheck for ESC2, ESC2s, ES820

 V1.68- Calibration support for ESCII finished but not tested

 V1.67- Bugfixes, internal changes

 V1.66- Calibration support for ESCII (under construction)
        (3 of 5 finished)
        (this is the most complex calibration of all printers)
      - "More"-Gadget for an "About" window

 V1.65- Calibration support for ESCII (under construction)
        (1 of 5 finished)

 V1.64- Calibration support for ESCIIs/820

 V1.63- overworked gui (gfx and icon by Tilo Steiner)

 V1.62- device is now used in shared mode
      - real wbstart

 V1.6 - bugfix for ESC-Printersetup (didn't save correct)
        (Thanks to K.Reiser and pRIMEl)
      - bugfix for ESC/Pro-nozzlecheck
      - bugfix for ESPhoto support
      - spanish readme included (Thanks to D. Domínguez)
      - .cd file included - Please send me your translation

 V1.56- full Epson Stylus Photo support (but not tested)
        (please write if you have one!)
      - nozzlecheck for ESC and Stylus Pro
      - head cleaning for ESCIIs and Stylus820

 V1.54- started to support the ESC2 (printerprefs)
      - corrected the wrong order of infobox strings

 V1.52- removed a bug when calibrating the ESC
      - added verify pattern for ESC400/600/800

 V1.5 - improved fontsensitivity again
      - removed some bugs (ESC support)
      - editable devicename for output device
        (devicename will not be saved in this version)
      - more texts with locale support

 V1.44- removed some enforcer hits
      - included Dutch catalog from Willem Schaaij

 V1.43- improved fontsensitivity
      - multidevice support
      - bugfixes
      - support a special mode for catalog development
      - included swedish catalog from Krister Larsson
      - included french catalog from Gilles Vigner

 V1.4 - more texts with locale-support
      - now check the printerstatus before sending data

 V1.3 - added support for ESC (calibration and head cleaning)
      - reworked some requesters
      - included spanish catalog from D.Dominguez
        (added texts in V1.3 are in english)

 V1.2 - added load config when program starts
        and save config when program quits
      - fixed a bug when opening libraries
        (ESC-Util wants to open V39 instead of V38
         Thanks to Ken Green)

 V1.1 - added support for printer-setup
        (Font, Chartable, Printdirection, Autolinefeed, Network I/F,
         I/F-Mode, Economy-Mode, Smallfont, Printspeed)
      - added support for ESC/200/500/400
      - improve the gui (i hope now it is more fontsensitve)
      - localized (german and english)
      - only one program for all printers

 V1.0 - first public release

@ENDNODE


@NODE STATS "Statistics"

@{b}Statistics@{ub}

  ----------------------
 | Printer | # of Users |
  ----------------------
 | ESC     |    10      |
 | ESC2    |     6      |
 | ESC2s   |     4      |
 | ES820   |     2      |
 | ESC500  |     4      |
 | ESC200  |     3      |
 | ESC400  |     6      |
 | ESC600  |    14      |
 | ESC800  |     8 (+me)|
 | ESPhoto |     1      |
 | ESPro   |     2      |
 | ES300   |     3      |
 | unknown |     2      |
  ----------------------

A total of 65 users have mailed me.


@ENDNODE

@NODE THANKS "Thanks"

@{b}Thanks@{ub}

 A lot to Willem Schaaij for
  - sending me some sources for supporting ESC/Pro/II(s)
  - testing the ESC-support
  - verifying and correcting the english catalog
  - his Dutch catalog
  - his english, improved translation of the documentation
  - some other tips

 To Tilo Steiner for his nice graphics
 To Steven Woelk for testing the 600-version (only V1.0).
 To D.Domínguez for the spanish catalog (included)
                and the translation of the documentation
 To Krister Larsson for the swedish catalog (included)
 To Gilles Vigner for the french catalog (included)
 To Gabriele Greco for the italian catalog (included)
 To Varga Lajos for the hungarian catalog (included)
 To Johan Otterstrom for testing compatibility with the Draco
 To Bahman Moallem for his tips
 To EPSON for their fantastic printers but not for the
    non-existing developer support. What's the problem?

and to all other who sent suggestions, bug reports and email.

@ENDNODE

@NODE AUTHOR "The Author"

@{b}The Author@{ub}


The producer of this bytes is:

Stephan Rusdorf

email: sru@informatik.tu-chemnitz.de

Suggestions, comments, bugreports and new catalogs are welcome.
 - they will be included in the next public version.

@ENDNODE

@NODE USING "Using"

@{b}Using ESCUtil:@{ub}

               @{"Nozzlecheck   " link NOZZLECHECK}
               @{"Headcleaning  " link HEADCLEANING}
               @{"Calibration   " link CALIBRATION}
               @{"Printer Setup " link PRTSETUP}

               @{"Preferences   " link PREFS}

@ENDNODE

@NODE NOZZLECHECK "Nozzlecheck"

@{b}Nozzlecheck@{ub}

The nozzlecheck uses all nozzles of the available printhead(s).
In this way you can easily see if all nozzles are perfectly
working. Intermittent or not correctly printed lines are the
result of clogged nozzles or an empty ink-cartridge. You may
have to use the Headcleaning option or to change the specific
ink-cartridge. See also @{"HeadCleaning" link HEADCLEANING}.

You may use the Nozzlecheck several times after eachother to
test or trying to actuate some clogged nozzles, otherwise it's
better to use the Headcleaning option.


Depending on the printer type there will be several horizontal
lines printed. The newest models (* ESC400/600/800/Photo) have
a different output, namely stepwise.


@ENDNODE

@NODE HEADCLEANING "Headcleaning"

@{b}Cleaning the printhead(s)@{ub}

At Power-On, it's normal for every EPSON inkjet printer to
clean the printhead(s) automatically once.

But in spite of it, it is possible that there are stripes or
errors in the printout. The cause of this could be that there
are some clogged nozzles in one or more printheads. The best
way to sort this out is to use the @{"NozzleCheck" link NOZZLECHECK}. 


To be certain you may use the Nozzlecheck several times, but do
@{b}never@{ub} use the Headcleaning option more than 3 times per head
after eachother. Otherwise there would be a lot ink spilled and
the result could then be worse then before 1). If the printout
has still errors, it may be necessary to change the specific
ink-cartridge. It's also possible that a ink-cartridge is empty.


The time needed for a Headcleaning procedure could take about
2 minutes, depending on the printer type.

Some printer models have the possibility to clean the black-
and color-heads separately.


@{b}Note: Cleaning of a printhead uses ink!@{ub}

1) @{b}Tip:@{ub} If this is the case, there is a possible solution:
 Power-Off the printer or disconnect it from the net. On most
 printer models it's possible to unlock the cartridges by softly
 pushing a small kind of lever on the left side of the ink-
 cartridges. Pushing this gentle downwards and at the same time
 moving the cartridge(s) gently to the left, you may see the
 ink-loading system with a kind of sponges which could be over-
 saturated with ink. Try to absorb the ink with a piece of
 kitchenpaper i.e. Move the inkcartridge(s) to the original
 position till they are locked again. Power-On the printer to
 continue. @{b}Warning: The risc of this action is fully yours!@{ub}  
    

@ENDNODE

@NODE CALIBRATION "Calibration"

@{b}Calibration@{ub}

When the printed output continuously shows stripes or irregu-
larities, it is also possible that the printhead(s) needs
Calibration.

The best way to solve this, is to Calibrate the printhead(s).

Calibration prints a specific sheet of patterns. You have to
check these patterns for the best aligned ones. Take the number
corresponding to the best aligned couple.

                                             |    |
P.e:                                         |    |
     ------------    correct alignment       |    |
                                        OR:  |     |
     ------______    bad alignment           |     |
                                             |     |

                                            OK    BAD                                   

Use the number you have found, controlling the Slider to this
value. Use the OK-button to save this value to the printer.

Some models have several Calibration options for each printmode.
Use the same procedure for each separately. The principle is
however the same.

When the Calibaration procedure is ready, you @{b}must switch-off@{ub}
the printer with the Power-Off key, to save the parameters into
the printer.

@ENDNODE

@NODE PRTSETUP "Printer Setup"

@{b}Printer Setup@{ub}

The meaning of this Setup is to change the default settings of
the printer to yours.

There are some differences and different options per printer-
model to change.

Per example:

   - Character table
   - Font
   - Pitch

   - Print direction
   - Auto Linefeed
   - Network Mode
   - Economy
   - Condensed
   - etc.

Further specific information about these you should be able to
find in your printers manual.

It is possible that the Printer Preferences are being overuled
by some printer applications. In that case the changes made here
seems to have no effect, but that's not completely true.  Most
of these kind of programs have build-in options to control them.

@ENDNODE

@NODE PREFS "Preferences"

@{b}Preferences of ESC-Util@{ub}

You can change the defaults to your taste and type of printer.


Prefs to change:

@{u}Choice of the used printer@{uu}

Please, choose the correct model!  Because of the differences
of the printers, there could be otherwise unpredictable results.

Printers not shown here are not implemented.


@{u}Choice of printerdevice@{uu}

To accomodate different Amiga-hardware configurations, you may
choose here the printerdevice you want to use. It is also
possible to use not displayed devices, they can be used by
typing their name in the Text-inputfield (*) manually.
The given device here is not saved now.

The Preferences of ESC-Util should be confirmed by using the
OK-button and would be saved in a config.file when ESC-Util
is closed/quitted (except *).

@ENDNODE
