README for the Umax scanner driver version 0.4
==============================================

The umax scanner driver is still in its infancy.  It still has
plenty of bugs.  The driver doesn't have nearly as much
functionality as we would like, and the documentation is still
limited; mostly this file, a TODO file, and a man page for the
uamx command.  Linux 2.0 works better with UMAX scanners than
previous versions, because SCSI error handling has been improved,
and UMAX scanners more or less assume that they are the only
active device on the SCSI bus and like to reset it on a regular
basis.  You will find that things work best if you have a separate
SCSI adaptor for the scanner; I've now got a BusLogic adaptor
that works perfectly well with the scanner.

Not all Umax scanners appear to be correctly supported; I
have a UMAX Vista-S6, which works; the Vista-S6E doesn't yet.
Let me know which models work and which don't.

In any case, proceed at your own risk.

If you are still interested, you should build the driver with
the command "make"

Copy the binary somewhere useful, such as /usr/local/bin/

Go ahead and look at some of the other programs that accompany
the umax driver; there's a GUI to run the driver and two
programs you can use to turn your scanner into a "photocopier"
in conjunction with your printer.  They are even more under
development.

Run the umax driver as a user who is able to read and write
the /dev/sg? device the scanner is mounted on.  If you aren't
sure which device that is, you can run umax as root and let
it find the scanner:
	umax -lv > /dev/null
will tell you where it finds the scanner, or if it doesn't
find the scanner.

Report any problems to the maintainer, Michael K. Johnson,
johnsonm@redhat.com

In order to print the version number, use
	umax -V
In order to get help, use
	umax -H

In order to get a scan at all, you have to choose the scan
mode: lineart (1-bit), greyscale (8-bit), or rgb color
(24-bit). Even with the Windows drivers for this scanner, the
8-bit color scans are done as 24-bit scans and dithered to 8
bits; use the pnmquant program to do this for you if you need
it done.  The command line options are -l for lineart, -g for
greyscale, and -r for rgb.  Shouldn't be too hard to remember.

The output is pnm: Portable aNyMap.  That is, lineart scans
are output as pbm (Portable BitMap), greyscale scans are output
as pgm (Portable GreyMap), and color scans are output as ppm
(Portable PixMap).

I recommend the pbm tools (either the netpbm or pbmplus
versions) and possibly an image manipulation toolset such
as ImageMagick or The GIMP for doing image manipulation
when you are done scanning.
