sane-hpsj5s.5

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

NAME

       sane-hpsj5s - SANE backend for HP ScanJet 5S sheetfed scanner

DESCRIPTION

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

       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 unprobable) that your scanner will be damaged.

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

       Current  version implements only gray scale scaning. 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 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 scaner uses software noise correction. This
       feature is not implemented for now. So does gamma correction and  cali-
       bration.   I'll  handle  it  in future versions.  Native resolution for
       this scaner is 300 DPI. Other modes could be jagged in some ways.

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.  Under UNIX, the directories
              are separated by a colon (`:'), under OS/2, they  are  separated
              by a semi-colon (`;').  If this variable is not set, the config-
              uration 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).

       SEE ALSO
              sane(7)
              http://hpsj5s.sourceforge.net
              http://cyberelk.net/tim/libieee1284

AUTHOR

       Max Vorobiev
       Man page mostly based on canon.man

sane-backends 1.0.17              24 Feb 2002                   sane-hpsj5s(5)