sane-coolscan.5

sane-coolscan(5)         SANE Scanner Access Now Easy         sane-coolscan(5)

NAME

       sane-coolscan - SANE backend for Nikon film-scanners

ABOUT THIS FILE

       This file is a short description of the coolscan backend for SANE.

DESCRIPTION

       The  sane-coolscan  library implements a SANE backend that provides the
       interface to the following Nikon Coolscan Film  scanners:  Nikon  LS20,
       LS30, LS1000, LS2000.

       Even  though  the  backend has worked for a number of people, there are
       still  some  problems,  especially  in  combination  with   some   SCSI
       card/drivers  (AHA-1505/aha152x.o)  and  the  autofocus  command.   You
       should consider this backend 'alpha' and be careful when using  it  the
       first time.

CONFIGURATION

       The   configuration   file   for   this  backend  resides  in  /usr/lo-
       cal/etc/sane.d/coolscan.conf.

       Its content is a list of device names that correspond to Nikon Coolscan
       scanners.  Empty  lines and lines starting with a hash mark (#) are ig-
       nored. A sample configuration file is shown below:

        #scsi Vendor Model Type
        scsi Nikon * Scanner
        /dev/scanner

       The special device name must be a generic SCSI device or a  symlink  to
       such  a  device.   To find out to which device your scanner is assigned
       and how you can set the permissions of that  device,  have  a  look  at
       sane-scsi(5).

SCSI ADAPTER TIPS

       Some  SCSI-adapters  and  low-level  SCSI drivers do not work correctly
       with this backend and the Coolscan scanners. These  systems  hang  when
       the  autofocus  command is send to the Scanner.  To see a list of which
       card/driver combinations work or don't work have a look at:  http://an-
       dreas.rick.free.fr/sane/autofocus.html.

FILES

       The backend configuration file:
              /usr/local/etc/sane.d/coolscan.conf

       The static library implementing this backend:
              /usr/local/lib/sane/libsane-coolscan.a

       The shared library implementing this backend:
              /usr/local/lib/sane/libsane-coolscan.so (present on systems that
              support dynamic loading)

ENVIRONMENT

       SANE_DEBUG_COOLSCAN
              If the library was compiled with debug support enabled, this en-
              vironment  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.

              Examples:

              On bash:
              export SANE_DEBUG_COOLSCAN=8

              On csh:
              setenv SANE_DEBUG_COOLSCAN 8

BUGS

       The autofocus command does not work with some SCSI card/driver combina-
       tions.

       The gamma table is not implemented for the LS1000 yet.

       The dust-removal is not working yet.

SEE ALSO

       sane(7), sane-scsi(5)

       http://andreas.rick.free.fr/sane/
              The homepage of this backend.

       http://www.sema.be/coolscan/
              The original version of the coolscan backend by Didier.

THANKS TO

       Didier Carlier - For writing the original Coolscan backend (without  it
       I would not have started this).

       Oliver Rauch - For adapting xsane so quickly to the infrared stuff.

       All the other people working on SANE.

AUTHOR

       Andreas Rick

EMAIL-CONTACT

       andreas.rick@free.fr

                                  13 Jul 2008                 sane-coolscan(5)