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 /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 ignored. 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://andreas.rick.free.fr/sane/autofocus.html.

FILES

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

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

       The shared library implementing this backend:
              /usr/lib/x86_64-linux-gnu/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 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.

              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 combinations.

       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)