


sane-microtek2(5)                               sane-microtek2(5)


NNAAMMEE
       sane-microtek2  -  SANE backend for Microtek scanners with
       SCSI-2 command set

DDEESSCCRRIIPPTTIIOONN
       The ssaannee--mmiiccrrootteekk22  library  implements  a  SANE  (Scanner
       Access  Now  Easy)  backend  that  provides access to some
       Microtek scanners with a SCSI-2 command set.  This backend
       should be considered alpha.

       There  exists  a  different  backend for Microtek scanners
       with SCSI-1 command set.  Refer  to  sane-microtek(5)  for
       details.

       At present, the following scanners are known positively to
       work with this backend:

              Vendor     Product id:     Remark:
              --------   --------------  -----------
              Microtek   E3plus          all modes ok
              Microtek   X6              all modes ok
              Microtek   ScanMaker 330   all modes ok
              Microtek   ScanMaker 630   all modes ok
              Microtek   ScanMaker 636   all modes ok
              Microtek   Phantom 636     all modes ok
              Vobis      HighScan        all modes ok

       If you own a Microtek scanner with SCSI-2 interface  other
       than  the  ones  listed above, it may or may not work with
       SANE!


FFRROONNTTEENNDD OOPPTTIIOONNSS
       This backend dynamically enables the options for the fron-
       tend,  that  are supported by the scanner in dependence of
       the scanning-mode and other options. Not supported options
       are disabled.

       The    following    options    are    supported   by   the
       Microtek2-driver:

       Color, grayscale, halftone and lineart scans.

       Highlight, midtone, shadow, contrast, brightness, exposure
       time  control,  gamma  correction, threshold (dependent of
       the scan mode)

       Transparency media adapter, automatic document feeder


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



                           06 Nov 1998                          1





sane-microtek2(5)                               sane-microtek2(5)


       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  configuration  file  for  this  backend  resides   in
       _/_u_s_r_/_l_o_c_a_l_/_e_t_c_/_s_a_n_e_._d_/_m_i_c_r_o_t_e_k_2_._c_o_n_f.   Its  contents is a
       list of device names that correspond to Microtek  scanners
       with SCSI-2 interface. Empty lines and lines starting with
       a hash mark (#) are ignored.

       The configuration file may also contain options. Currently
       two options are supported:

              option dump <n>
              option strip-height <n>

       If  _o_p_t_i_o_n  _d_u_m_p  _<_n_>  is  enabled additional informations
       about the SCSI commands that are sent to the  scanner  are
       printed  to  stderr.  This  option is primarily useful for
       debugging purpose.

       If n=1 the contents of the command blocks and the  results
       for  the  INQUIRY  and READ SCANNER ATTRIBUTES command are
       printed to stderr.

       If n=2 the contents of the command blocks  for  all  other
       SCSI  commands are printed to stderr, too. If n=3 the con-
       tents of the gamma table is printed, too. If n=4 all  scan
       data is additionally printed to stderr.

       The default is n=1.

       The  _o_p_t_i_o_n  _s_t_r_i_p_-_h_e_i_g_h_t  _<_n_>  ,  where <n> is a floating
       point number, limits the amount of data that is read  from
       the  scanner  with one read command.  The unit is inch and
       <n> defaults to 1.0, if this option is not set in the con-
       figuration  file.  If  less than <n> inch of data fit into
       the SCSI buffer, then the smaller value is used  and  this
       option has no effect.

       If  your system has a big SCSI buffer and you want to make
       use of the whole buffer, increase the value for  <n>.  For
       example,  if <n> is set to 14.0, no restrictions apply for
       scanners with a letter, legal or A4 sized scan area.

       At present the options apply to all devices in the config-
       uration file and cannnot be set on a per device basis.

       A sample configuration file is shown below:

              option dump 1



                           06 Nov 1998                          2





sane-microtek2(5)                               sane-microtek2(5)


              option strip-height 1.0
              /dev/scanner
              # this is a comment
              /dev/sge

       This backend also supports the new configuration file for-
       mat which makes it easier to detect scanners under  Linux.
       If  you  have only one scanner it would be best to use the
       configuration file for this backend, that  is  distributed
       with SANE. This file is shown below:

              option dump 1
              option strip-height 14.0
              scsi * * Scanner

       In this case all SCSI-Scanners should be detected automat-
       ically.


FFIILLEESS
       _/_u_s_r_/_l_o_c_a_l_/_e_t_c_/_s_a_n_e_._d_/_m_i_c_r_o_t_e_k_2_._c_o_n_f
              The backend configuration file.

       _/_u_s_r_/_l_o_c_a_l_/_l_i_b_/_l_i_b_s_a_n_e_-_m_i_c_r_o_t_e_k_2_._a
              The static library implementing this backend.

       _/_u_s_r_/_l_o_c_a_l_/_l_i_b_/_l_i_b_s_a_n_e_-_m_i_c_r_o_t_e_k_2_._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__DDEEBBUUGG__MMIICCRROOTTEEKK22
              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. To see error messages on
              stderr set SANE_DEBUG_MICROTEK2 to 1  (Remark:  The
              whole debugging levels should be better revised).
              E.g. just say:
              export SANE_DEBUG_MICROTEK2=128

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

AAUUTTHHOORR
       Bernd Schroeder










                           06 Nov 1998                          3


