Description:
------------

This is EPSCAN, my first public release of a scanning program for
EPSON scanners on Linux.  It contains a driver, as well as an
X-windows front-end.  I have only tested it on an EPSON
ES-1200C/GT-9000 scanner, but it should work for any of the
ES-{300-800}C / GT-{1000-6500} models as well.  (Could anyone who has
one of these other models confirm or deny this for me?  Thanks.)

*NOTE*: EPSCAN only supports scanners attached to a SCSI port.  The
parallel port interface isn't supported since our scanner isn't set up
that way.  The driver is written modularly, so it should be very easy
to integrate a parallel driver if someone wants to write one.

The X-windows front-end allows changing all the scanner settings,
previewing the page, and selecting only a region to be scanned.

Please read the file "epscan.manual", in this directory, for
documentation on using EPSCAN. Installation instructions are below. 

Requirements: 
-------------
Linux 2.x
X Windows
Qt library version >= 1.1 
libtiff version >= 3.4
g++ version >= 2.7.2

You can get the Qt library from http://www.troll.no.   Of
course EPSCAN may work with older versions of Linux, and g++;
this is just what I developed it with.

Files:
------
epscan.manual		-- This is where to find the full program
			   documentation. It is also available inside the
		           program by clicking on Help.
README			-- This file.
FAQ			-- Answers to common problems
configure		-- configure script
Imakefile		-- Imakefile for epscan
driver/Scsi.*		-- Scsi device driver.
driver/Scanner.*	-- The scanner driver code.
*.{cc,h}		-- source code.


Installation: 
------------- 

1) Run configure as "./configure" in the epscan directory.  By
default, the install dirctory will be /usr/local, but you can change
this by passing "--prefix /some/other/dir" to ./configure.  If you
don't have a supported scanner but want to try epscan anyway, run
./configure with the "--enable-DUMMY" command line option.  This
causes the real scanner driver to be replaced with a dummy scanner
driver.  Run "./configure --help" to see the other command line
options available.

2) Run "make depend"

3) Run "make"

4) Optional.  You can try epscan now, before installing it, by just
typing "./epscan &".  You will get a warning message about a missing
help file which you can ignore.

5) As root, run "make install".  This will install epscan in
/usr/local/bin, and the epscan help file in /usr/local/lib/epscan/.
You can replace "/usr/local" with some other directory by using the
"--prefix" option to the configure script.  

Now type "epscan &" from your xterm.


Please report any bugs, problems, or suggestions to me at
ajenkins@cs.umass.edu.  Also, I'd appreciate hearing from anyone who
is using it, even if you're not having problems, especially if you
have some scanner other than the one I have.


Acknowledgments:
 ---------------- 

I used the Qt library for the X frontend.  Qt is a very nice C++ GUI
library.  I highly recommend it if you're interested in X programming
with C++.  If interested, check out Troll Tech's home page at
http://www.troll.no.

Thanks to Tim D. Gilman for releasing his qprogress widget for Qt,
which I used in this program.

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., 675 Mass Ave,
Cambridge, MA 02139, USA.


Author:
-------
Adam P. Jenkins <ajenkins@cs.umass.edu>

