LINUX Scannerdriver for Epson GT and ES Scanner with SCSI Interface

*-----------------------------------------------------------------------
This Software ist Copyrighted by me (see Author) and may be 
redistributed without charge. If you want to use it in commercial
way, you have to contact me.
You can put in on CDrom if you want, if the package is complete,
including this README File.

			    NO WARRANTY

     BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
REPAIR OR CORRECTION.

     IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.

This is a Package of two Tools to scan with Epson SCSI Scanners

First is a commandline tool to access the scanner via the
generic scsi interface.

Second is a motif based interface for the above tool. the tool
has very much options, which are not very selve explaining, so 
i work mostly with the motif interface.

*-----------------------------------------------------------------------
installation:
type "make" in the directory where you extraced the archive
the programs "scan" an "ep_scan" are generated. If you dont want
to use the motiv Interface, do "make ep_scan" to generate the
scanning application only.
to compile the "scan" motif interface you need an correct motif
installation.
In the distribution dynamic and static linked versions are included
the program "scan" is dyn linked, "scan.static" is the same statically
linked.


*-----------------------------------------------------------------------
scanner tool "ep_scan"

this is the main scanning application, which can be used separatly from
the motif interface.
the tool has very much options, try ep_scan -? to see them. the opions
are not protectet against mismatch, they are transmittet to the scanner
as you give them. if they make no sense, the scanner answeres with
an error condition.
take special care about the scanning area, because the width value
must be a multiple of 8, otherwise the scanner answers with
"error setting scanner area". this also occures, if the area given
is too large.

first of all "ep_scan" searches the devices /dev/sg0 ... /dev/sg7
for an connected scanner device. all devices are opened, and on
success an inquiry command is issued. if the inquiry string contains
"EPSON SCANNER" at the correct location, the scanner is found.
otherwise you see "scan: no EPSON Scanner found".

your scanner schoud first be found at boot  (or insmod) time, when scsi 
devices are queryd. if it is found at boot time, but the "ep_scan" tool
cant find, you may forgot to compile generic scsi support into your
kernel. please check if the device files /dev/sg(0..7) are available and
are accessible for you (read AND write) 

Try to scan with the following options:
./ep_scan -r 50 -w 424 -h 560 -f -o scan.ppm

if all works fine, you shoud get a scan of the full scanable area in
50 dpi in full color into the file scan.ppm.
you can take a look at the result with xli :
xli scan.ppm -dispgamma 1

*-----------------------------------------------------------------------
motif interface "scan"

required tools:

-  ppmquant
-  ppmtoxpm
-  viewer for pbm/ppm/pnm Images for example xli or xv

these tools must be reached in your PATH.

required environment:

-  Kernel with scsi generic support (checkt with 2.0.27,2.0.36 and 2.2.10)
-  devices named /dev/sg0 to /dev/sgx  (x may be 2,3,4,5,6 or 7)
   for generic SCSI access
-  for use of motif interface - motiv 2.0 is needed.


if the motif scan application is startet, it first invokes
the following command:

  ep_scan -q /tmp/scan.ident

this command querys the availabe resolutions of the connected
scanner an writes them to the given file. If the scanner cannot
be found, you see an errormessage on stdout. in this case the
resolutions listbox is empty!


*------------------------------------------------------------------------
Author:

Ulrich Roehr
Gustav Adolf Str. 13
63452 Hanau (Germany)

Fax +49 6181 990239

e-Mail ulrich.roehr@ascom.de  (job)


