


sane-hp(5)                                             sane-hp(5)


NNAAMMEE
       sane-hp - SANE backend for HP ScanJet scanners

DDEESSCCRRIIPPTTIIOONN
       The  ssaannee--hhpp library implements a SANE (Scanner Access Now
       Easy) backend that provides access to HP ScanJet scanners.
       At present, the following scanners are known positively to
       work with this backend:

              Model:        Product id:
              ----------    -----------
              ScanJet IIcx  C2500A 3332
              ScanJet IIp   C1790A
              ScanJet 3C    C2520A 3503
              ScanJet 4C    C2520A
              HP 6100       C2520A 3644
              ScanJet 3P    ??????
              ScanJet 4P    C1130A 3540
              PhotoSmart    C5100A
              ScanJet 5P    C5110A

       The PhotoSmart scanner support seems to have some problems
       (reported by Peter Kirchgessner <Pkirchg@aol.com>):

       o Scanning photos (paper): supported from 75 to 300 dpi.
              Problems:  (1)  aquire preview moves the photo into
              the scanner.  Start scan then  scans  while  moving
              the photo out of the scanner. The image is mirrored
              top to bottom.  This problem also occurs when scan-
              ning slides/negatives.  Would be nice to be able to
              mirror the image when reading it in.  (2)  Halftone
              and   lineart   scanning   not  supported  (scanner
              firmware?).  The output file  out.pnm  is  a  true-
              color  file  with  wrong header (P4 instead of P6).
              (3) Setting the scan geometry  length  to  a  value
              larger  than  the  current photo, the bottom of the
              image is filled with rubbish.

       o Scanning slides: supported from 100 to 2400 dpi.
              Problems: (1) Scanning at less than 300  dpi  keeps
              the  image  length  fixed  while the image width is
              scaled (scanner firmware?). I dont care about that.
              Noone  will use that. (2) Halftone/Lineart scanning
              not supported (scanner firmware?).

       o Scanning negatives: supported from 100 to 2400 dpi.
              Problems: (1) When scanning strips with 5 negatives
              of  size 24x36mm, the 5th image shows wrong colours
              (scanner firmware?).  (2) Halftone/Lineart scanning
              not  supported  (scanner  firmware?).  (3) Would be
              nice to show the images inverse.

       o General problems.
              (1)   When    changing    the    scanner    between



                           20 July 1998                         1





sane-hp(5)                                             sane-hp(5)


              slide/negative/photo-mode,   xscanimage   must   be
              restarted to show the possible scan resolutions and
              scan  geometries.  (2) The Windows 95 software that
              comes with the scanner has two advantages: (a) show
              negatives  as  positives  (b)  quite good automatic
              adjustment of brightness/contrast

       If you own a ScanJet scanner other than  the  ones  listed
       above,  please  let  us know if your model works with this
       backend.  To do this, send a mail with the relevant infor-
       mation for your scanner to _s_a_n_e_-_d_e_v_e_l_@_m_o_s_t_a_n_g_._c_o_m.

DDEEVVIICCEE NNAAMMEESS
       This backend expects device names of the form:

              _s_p_e_c_i_a_l

       Where _s_p_e_c_i_a_l is the UNIX path-name for the special device
       that corresponds to the scanner.  The special device  name
       must  be  a  generic  SCSI  device  or a symlink to such a
       device.  Under Linux, such a device name could be _/_d_e_v_/_s_g_a
       or _/_d_e_v_/_s_g_e, for example.

CCOONNFFIIGGUURRAATTIIOONN
       The contents of the _h_p_._c_o_n_f file is a list of device names
       that correspond to HP ScanJet scanners.  Empty  lines  and
       lines starting with a hash mark (#) are ignored.  A sample
       configuration file is shown below:

              /dev/scanner
              # this is a comment
              /dev/sge

FFIILLEESS
       _@_C_O_N_F_I_G_D_I_R_@_/_h_p_._c_o_n_f
              The backend configuration file (see  also  descrip-
              tion of SSAANNEE__CCOONNFFIIGG__DDIIRR below).

       _@_L_I_B_D_I_R_@_/_l_i_b_s_a_n_e_-_h_p_._a
              The static library implementing this backend.

       _@_L_I_B_D_I_R_@_/_l_i_b_s_a_n_e_-_h_p_._s_o
              The  shared library implementing this backend (pre-
              sent on systems that support dynamic loading).

EENNVVIIRROONNMMEENNTT
       SSAANNEE__CCOONNFFIIGG__DDIIRR
              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
              configuration  file  is  searched  in  two  default
              directories: first, the current  working  directory



                           20 July 1998                         2





sane-hp(5)                                             sane-hp(5)


              (".") and then in @CONFIGDIR@.  If the value of the
              environment variable ends with the directory  sepa-
              rator  character,  then the default directories are
              searched after the  explicitly  specified  directo-
              ries.   For  example,  setting  SSAANNEE__CCOONNFFIIGG__DDIIRR  to
              "/tmp/config:"   would   result   in    directories
              "tmp/config", ".", and "@CONFIGDIR@" being searched
              (in this order).

       SSAANNEE__DDEEBBUUGG__HHPP
              If the library  was  compiled  with  debug  support
              enabled,  this  environment  variable  controls the
              debug level for this backend.  E.g., a value of 128
              requests  all  debug output to be printed.  Smaller
              levels reduce verbosity.

SSEEEE AALLSSOO
       sane-scsi(5)

AAUUTTHHOORR
       David Mosberger

       The backend is derived from hhppssccaannppbbmm(1) (see sources  for
       copyright).

BBUUGGSS
       This  is  a minimal backend.  E.g., at present there is no
       support for down-loadable tone maps.





























                           20 July 1998                         3


