


sane-microtek(5)                                 sane-microtek(5)


NNAAMMEE
       sane-microtek - SANE backend for Microtek scanners

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k  library  implements  a  SANE  (Scanner
       Access Now Easy) backend that provides access to  Microtek
       scanners.   At present, the following hardware is known to
       work with this backend:

              Microtek ScanMaker E2, E3, E6
              Microtek ScanMaker II, IIG, IIHR, IISP, III
              Microtek ScanMaker 600GS, 600ZS (see bug notes)
              Agfa Arcus II (but not the "Arcus")
              Vobis "Highscreen Realscan"

              Transparent Media Adapter
              Document AutoFeeder

       The driver supports line art,  halftone,  8bpp  gray,  and
       24bpp  color  scans  at  normal and "expanded" resolutions
       (i.e. 1200x1200 on an E6), fast scans for color  previews,
       and downloadable gamma tables.

       The  driver does nnoott support the newest Microtek scanners,
       such as the V330 and V660, which use a new and  very  dif-
       ferent  SCSI-II command set.  For those, try the alternate
       mmiiccrrootteekk22 backend.

       If you own a Microtek scanner other than the  ones  listed
       above,  tell  us  what happens --- see the BBUUGGSS section at
       the end of this document.

       Although this manual page is generally updated  with  each
       release, up-to-date information on new releases and extra-
       neous helpful hints are available from the  backend  home-
       page:
              hhttttpp::////wwwwww..mmiirr..ccoomm//mmtteekk//


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 _m_i_c_r_o_t_e_k_._c_o_n_f file is a list of device



                           July 24 1998                         1





sane-microtek(5)                                 sane-microtek(5)


       names that correspond to Microtek 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

       The configuration file may also contain the special  token
       _n_o_p_r_e_c_a_l_.   Including  this will disable logic which tries
       to avoid scanner precalibration.



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_._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).

       _/_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_._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_._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
              (".")  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 spec-
              ified  directories.  For example, setting SSAANNEE__CCOONN--
              FFIIGG__DDIIRR to "/tmp/config:" would result in  directo-
              ries "tmp/config", ".", and "/usr/local/etc/sane.d"
              being searched (in this order).

       SSAANNEE__DDEEBBUUGG__MMIICCRROOTTEEKK
              If the library was compiled with debugging  support
              enabled,  this  environment  variable  controls the
              debug level for  this  backend.   A  value  of  128
              requests  maximally  copious  debug output; smaller
              levels reduce verbosity.






                           July 24 1998                         2





sane-microtek(5)                                 sane-microtek(5)


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


AAUUTTHHOORR
       Matt Marjanovic


BBUUGGSS
       Known bugs/limitations are:

              Brightness and contrast broken.
              The 600GS is grayscale only, and will  lock  up  if
              you  select  color.   (Unfortunately, the 600GS and
              600ZS are indistinguishable by software.)

       i.e. don't complain about  these  ---  but  if  brightness
       and/or contrast ddoo work for you, please tell me.

       If  your scanner locks up, try setting the _n_o_p_r_e_c_a_l option
       in the configuration file, and see if it  helps.   (If  it
       does, report it.)

       Send  lengthy  bug  reports and new scanner information to
       mmtteekk--bbuuggss@@mmiirr..ccoomm.  Bug reports and new scanner  inquiries
       should  include an error log file.  You can generate copi-
       ous stderr output by setting the SANE_DEBUG_MICROTEK envi-
       ronment variable described above.  For example:

              setenv SANE_DEBUG_MICROTEK 128

       More  general  comments,  suggestions, and inquiries about
       frontends or SANE should go to ssaannee--ddeevveell@@mmoossttaanngg..ccoomm, the
       SANE Developers mailing list.























                           July 24 1998                         3


