sane-hpsj5s.5

sane-hpsj5s(5)           SANE Scanner Access Now Easy           sane-hpsj5s(5)

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 sup-
       ports 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 alias-
       ing artifacts.

FILES

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

       /usr/local/lib/sane/libsane-hpsj5s.a
              The static library implementing this backend.

       /usr/local/lib/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 direc-
              tories are separated by a colon (`:'), under OS/2, they are sep-
              arated 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
              /usr/local/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 directo-
              ries.  For example, setting  SANE_CONFIG_DIR  to  "/tmp/config:"
              would    result    in    directories    tmp/config,    .,    and
              /usr/local/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)