SANE2TWAIN V0.90
================

This is the 1st beta release of sane2twain, an open source twain dsm that will
enable programs like PMView and Maul Publisher to acquire images from your
scanner.

This version can:-
- Preview images.
- Select an area.
- Zoom in and out.
- Set a number of options, depending on the scanner.
- Display progress indicators.
- Scan.

The application is provided so that you can

1) Tell me which options your scanner provides (see below)
2) Tell me if this works on your computer.
3) Express an interest. Should I continue with this, or am I wasting my time?
4) Do some scanning on the OS/2 or eCS platform.

HELPING
=======
This version is imperfect, and some options appear to cause a crash. NOW is
the time for other interested parties to help enhance this project. This is of
particular importance as I have now run out of funds and must continue with
Maul Publisher. Please consider helping in the following areas:-

* Testing and debugging.
* Prettier GUI layout and graphical buttons.
* Customising scanner options.
* Writing a Help Manual.
* Translating to other languages.
* Making a warpin package, and general installation.
* Writing a review of this program for an e-newsletter such as os2voice.
* Upload this version to hobbes - my ISP appears to be blacklisted, and until
  I change provider I will not be able to upload it.

Thank you
=========
The development of this program was funded in large part by Maul Publisher
maintenance subscriptions. I would like to personally thank all of those who
contributed, and I look forward to be able to provide other OS/2 apps and
features in the future.

INSTALLATION
============
The easiest way to get your scanner working is to install tame. Please note that changes have occurred,
and that the following alpha version files need to be wiped.
c:/os2/dll/twainos2.dll
c:/os2/dll/twainos2.ini
c:/os2/dll/twainos2.msg
(...where c: is the bootdrive)

Tame is available from
http://www.smedley.info/sane.html

1)  Download and install tame V1.04b or later, and get your scanner to work
    according to the instructions. If you have a snapscan scanner, you will
    need to find the snapxxx.bin firmware file for your scanner, and add an
    entry in snapscan.conf.

2)  Replace libsane.dll with the one in this package, or you may get crashes.

3)  Copy twainos2.dll to /os2/dll in your bootdrive. This will normally be
    c:/os2/dll

4)  Create a new folder called twainos2 in the /os2/dll directory. This will
    normally be c:/os2/dll/twainos2

5)  Copy twainos2/*.* from the zip archive to /os2/dll/twainos2 (as created
    above).

6)  Add the path to libsane.dll to the libpath entry in config.sys - vital!!
    Don't just copy libsane.dll to the libpath, as libsane needs to be where
    the tame installation put it, and nowhere else!

7)  Ensure that you have a tmp path set in config.sys (SET TEMP=...)

8)  Ensure that you have SANE_CONFIG_DIR set in config.sys
    (SET SANE_CONFIG_DIR=...)

Example
I have tame installed in e:\tame.
my libpath has E:\TAME; added on the end.
SET SANE_CONFIG_DIR=E:\tame\conf

Understanding what all the files do:-

Applications expect to find a copy of twainos2.dll in the libpath and in
c:/os2/dll (or whatever your bootdrive is), and nowhere else!

twainos2.dll will first load twainos2.msg and twainos2.ini from
c:\os2\dll\twainos2. If you have a snapscan scanner, snapscan.dll will be
loaded when you start scanning. This contains options more suited to this
scanner. If you are a programmer, and wish to set up a dll for your own
scanner, please do so, and let me know so that I don't duplicate the effort!

twainos2.dll will then load libsane.dll which it finds by using the libpath.
There must only be one libsane.dll present in your system.

libsane.dll loads configuration files from the path set in the SANE_CONFIG_DIR
setting.

libsane.dll also expects other libraries and files to be present in it's own
folder, which is why it's best to get Tame working first. At least then you
will know that this part is correct.

OPTIONS
=======
sane2twain can write a log file to the TEMP path containing all possible
options for your scanner, the "Save sane options" button is available for
those scanners for which there isn't a specific dll.

I have logfiles for the following:-
avision.txt
epson.txt
genesys.txt
gt68xx.txt
mustek.txt
plustek.txt
snapscan.txt
...and test.txt I have already.

If your scanner is not listed and you would like it supported, please send
files to peter(at)manglais(dot)com

SOURCE
======
The source for sane2twain is available from http://svn.netlabs.org/sane2twain

ERROR LOG
=========
twainos2.dll will now write an error log file to sntw_err.log. On eCS, this
would be something like "c:\var\log\sntw_err.log"
