sane-hpsj5s

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 ex‐
   cluded (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  direc
          tory  (".")  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 or
          der).

   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)