NAME

       sane-hpsj5s - SANE backend for HP ScanJet 5S sheet-fed scanner

DESCRIPTION

       The  sane-hpsj5s library implements a SANE (Scanner Access Now Easy) backend that provides
       access to a parallel port Hewlett-Packard ScanJet 5S scanner.

       IMPORTANT: this is alpha code. Don't expect this to work  correctly.  Many  functions  are
       missing, others contain errors. In some cases, your computer might even hang. It cannot be
       excluded (although I consider it extremely improbable) that your scanner will be damaged.

       LIMITATIONS: For now this backend  works  only  on  Linux.   This  limitation  is  due  to
       dependence on the libieee1284(3) library. If your system supports libieee1284(3) too, this
       backend should work. If you ported libieee1284(3) for your platform, please let  me  know.
       Your  system should support EPP (or EPP+ECP) mode to operate this scanner. Future versions
       will support ECP and SPP (Nibble and Byte) modes also. It's planned  to  support  scanners
       not  only  at daisy-chain position 0, but anywhere. Support for multiple scanners could be
       implemented too.

       Current version implements only gray scale scanning. True Color  and  B/W  modes  are  not
       supported for now.

       That  said,  TESTERS  ARE  WELCOME.  Send  your  bug  reports and comments to Max Vorobiev
       <pcwizard@yandex.ru>.

DEVICE NAMES

       This backend expects device names of the form:

              special

       Where special is the parallel port name in form, libieee1284(3) expects. It  seems  to  be
       system dependent. Under Linux it's parport0, parport1, etc.

CONFIGURATION

       The  contents  of  the  hpsj5s.conf  file is a list of parport names that correspond to HP
       ScanJet 5S scanners.  Empty lines and lines starting with a hash  mark  (#)  are  ignored.
       Only  one  device  name can be listed in hpsj5s.conf for this moment. Future versions will
       support daisy chain selection.

TIPS

       It seems that HP ScanJet 5S scanner uses software noise correction.  This  feature,  along
       with  gamma correction and calibration, are not implemented for now.  They will be handled
       in future versions.  Native resolution for this scanner  is  300  DPI.   Other  modes  may
       present aliasing artifacts.

FILES

       /etc/sane.d/hpsj5s.conf
              The backend configuration file (see also description of SANE_CONFIG_DIR below).

       /usr/lib/x86_64-linux-gnu/sane/libsane-hpsj5s.a
              The static library implementing this backend.

       /usr/lib/x86_64-linux-gnu/sane/libsane-hpsj5s.so
              The  shared  library  implementing  this  backend  (present on systems that support
              dynamic loading).

ENVIRONMENT

       SANE_CONFIG_DIR
              This environment variable specifies the list of directories that  may  contain  the
              configuration  file.   On  *NIX  systems,  the directories are separated by a colon
              (`:'), under OS/2, they are separated by a semi-colon (`;').  If this  variable  is
              not  set, the configuration file is searched in two default directories: first, the
              current working directory (".") and then in  /etc/sane.d.   If  the  value  of  the
              environment  variable ends with the directory separator character, then the default
              directories are searched after the explicitly specified directories.  For  example,
              setting  SANE_CONFIG_DIR  to "/tmp/config:" would result in directories tmp/config,
              ., and /etc/sane.d being searched (in this order).

       SANE_DEBUG_HPSJ5S
              If the library was compiled with debug support enabled, this  environment  variable
              controls  the  debug  level  for  this  backend.   Higher debug levels increase the
              verbosity of the output.

SEE ALSO

       sane(7), libieee1284(3)
       http://hpsj5s.sourceforge.net
       http://cyberelk.net/tim/libieee1284

AUTHOR

       Max Vorobiev
       Man page mostly based on canon.man.

                                           13 Jul 2008                             sane-hpsj5s(5)