


sane-agfafocus(5)                               sane-agfafocus(5)


NNAAMMEE
       sane-agfafocus - SANE backend for AGFA Focus flatbed scan-
       ners

DDEESSCCRRIIPPTTIIOONN
       The ssaannee--aaggffaaffooccuuss  library  implements  a  SANE  (Scanner
       Access  Now  Easy)  backend  that  provides access to AGFA
       Focus flatbed scanners. At present, the following scanners
       are supported from this backend:

              AGFA Focus GS Scanner (6 bit gray scale) (untested)
              AGFA Focus Lineart Scanner (lineart) (untested)
              AGFA Focus II (8 bit gray scale) (untested)
              AGFA Focus Color (24 bit color 3-pass)
              AGFA Focus Color Plus (24 bit color 3-pass)

              Siemens S9036 (8 bit gray scale) (untested)

       The driver supports line art, 6bpp and  8bpp  gray,  18bpp
       and 24bpp color scans.

       If you own a scanner other than the ones listed above that
       works with this backend, please let us know by sending the
       scanner's  model  name,  SCSI id, and firmware revision to
       _s_a_n_e_-_d_e_v_e_l_@_m_o_s_t_a_n_g_._c_o_m.

       All of these scanners are  pre-SCSI-2,  and  do  not  even
       report  properly  to SCSI Inquiry.  This is typically evi-
       dent in SCSI bus scans, where the  scanner  will  come  up
       with only garbage as vendor and models strings.


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  either  the  path-name for the special
       device that corresponds to a SCSI scanner. For SCSI  scan-
       ners,  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.
       See sane-scsi(5) for details.

CCOONNFFIIGGUURRAATTIIOONN
       The contents of the  _a_g_f_a_f_o_c_u_s_._c_o_n_f  file  is  a  list  of
       device  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




                           17 Oct 1998                          1





sane-agfafocus(5)                               sane-agfafocus(5)


FFIILLEESS
       _/_e_t_c_/_s_a_n_e_._d_/_a_g_f_a_f_o_c_u_s_._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_i_b_/_l_i_b_s_a_n_e_-_a_g_f_a_f_o_c_u_s_._a
              The static library implementing this backend.

       _/_u_s_r_/_l_i_b_/_l_i_b_s_a_n_e_-_a_g_f_a_f_o_c_u_s_._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 /etc/sane.d.  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 "/etc/sane.d" being searched
              (in this order).

       SSAANNEE__DDEEBBUUGG__AAGGFFAAFFOOCCUUSS
              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.  SANE_DEBUG_UMAX values


              Number  Remark

               0       print important errors (printed each time)
               1       print errors
               2       print sense
               3       print warnings
               4       print scanner-inquiry
               5       print informations
               6       print less important informations
               7       print called procedures
               8       print reader_process messages
               10      print called sane-init-routines
               11      print called sane-procedures
               12      print sane infos
               13      print sane option-control messages




                           17 Oct 1998                          2





sane-agfafocus(5)                               sane-agfafocus(5)


MMIISSSSIINNGG FFUUNNCCTTIIOONNAALLIITTYY
       Uploading  of  dither  matrices  and  tonecurves  has been
       implemented, but so far has not proven to  be  useful  for
       anything.   For  this  reason these options have been dis-
       abled.


BBUUGGSS
       The scanners that do not support disconnect have  problems
       with SCSI timeouts if the SCSI bus gets loaded, eg. if you
       do a kernel build at the same time as scanning.  To see if
       your  scanner supports disconnect, run "SANE_DEBUG_AGFAFO-
       CUS=128 scanimage -L" in sh and look for the "disconnect:"
       line)


DDEEBBUUGG
       If you have problems with SANE not detecting your scanner,
       make sure the Artec backend is  disabled.   Somehow,  this
       backend  causes  at  least  my scanner not to respond cor-
       rectly to SCSI inquiry commands.

       If you encounter a bug please set the environment variable
       SANE_DEBUG_AGFAFOCUS  to  128  and  try  to regenerate the
       problem. Then send me a report with the log attached.

       if you encounter a SCSI bus error or trimmed  and/or  dis-
       placed  images  please  also  set the environment variable
       SANE_DEBUG_SANEI_SCSI to 128 before sendme the report.


TTOODDOO
       MMoorree ssccaannnneerrss??

              The AGFA ACS and ARCUS scanners are similar to  the
              FOCUS  scanners.   The  driver  could  probably  be
              extended to support these scanners without too many
              changes.   I  do  not have access to such scanners,
              and cannot add support for it.  However, if you are
              in possession of such a scanner, I could be helpful
              in adding support for these scanners.

              The AGFA HORIZON scanners are SCSI-2 scanners,  and
              it  would probably be easier to support these scan-
              ners in a SCSI-2 compliant backend.

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


AAUUTTHHOORR
       Ingo Schneider and Karl Anders ygard.





                           17 Oct 1998                          3


