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.

Thanks to "Jordi Martinez Marin" <jordimm@jet.es> for bug reports and
fixes to get Epscan working on SuSE and with Qt 2.x.

Thanks to Preston F. Crow for bug reports to get configure to work
with Redhat 6.1's setup and newer versions of Qt.

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>

