
JSane is a Java-based frontend for the SANE (Scanner Access Now Easy) scanner
backend program.  An external viewer program such as PMView is required to
print scanned images, and a fax program such as Faxworks Pro is needed for faxing.

It was written for personnal use and is provided here "as is".

It has only been tested on my system (a PP180 cpu with 64k ram with a SCSI-based
HP-4p flatbed color scanner) using Java 1.1.4.  See the accompanying text file,
notes.txt, for acknowledgements and other information.  Copyright information is in
the text file, about.txt.

Features include a preview mode with cropping, and multi-page
files for faxing.

------------------------ Installation ------------------------------

Installation is manual.

1.  Install Java 1.1.4 or better.

2.  Obtain and install Freedman's OS2SANE verion 0.66 Release one including
    the associated ASPI router by Dorau. (sane661.zip)

3. The following files must be in a working directory such as "D:\Jsane":
     jsane.jar - the Jsane Java archive file.
     about.doc - a text file used by Jsane.
     notes.doc - a text file used by Jane.

     scanimage.exe - the SANE backend program
     libsane.dll   - a library file for scanimage.exe
     hp.conf       - a configuration file for scanimage.exe (for HP scanners)

   The first three files, my version of hp.conf, this readme file, and a sample cmd
   file are included in this distribution.  The last three files are from the
   installation of the SANE program.
   
4. Additional files that can be created by the program include:
     jsane.ini   - Initialization file
     Default.set - Default settings
     Fax.set     - Fax settings

------------------------ Running Jsane ------------------------------
1a. If jsane.jar is in the Java classpath, then the program may be executed from
    the working directory by the command line:

       java Jsane

1b. Otherwise a command file that adds jsane.jar to the classpath is an alternative:

       set classpath=%classpath%jsane.jar;
       java Jsane

2.  On initial startup, a request is made to create an Images subdirectory.
    Also, a Default settings file, Default.set, and a Fax settings file, Fax.set
    should be saved from the "Settings" menu if they do not exist.
    Important: The "*.set" extensions are added internally and should not be
    typed.

    For example, to save new Fax settings:
      a.   Change the Directory to the one desired for saving fax images.
      b.   Set the resolution to 200 x 200 dpi, and
      c.   enter "Fax" when requested by the "Settings->save" menu

---------------------------------------------------------------
Frank Schmittroth (July 1998)
franks@owt.com
