2002-11-29 20:15:39 +00:00
|
|
|
.TH sane-coolscan 5 "4 July 2000" "@PACKAGEVERSION@" "SANE Scanner Access Now Easy"
|
2000-08-12 15:11:46 +00:00
|
|
|
.IX sane-coolscan
|
|
|
|
|
|
|
|
.SH NAME
|
2002-11-29 20:15:39 +00:00
|
|
|
sane-coolscan \- SANE backend for Nikon film-scanners
|
2000-08-12 15:11:46 +00:00
|
|
|
|
|
|
|
.SH ABOUT THIS FILE
|
|
|
|
|
|
|
|
This file is a short descripton of the coolscan-backend for sane!
|
|
|
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
|
|
|
The
|
|
|
|
.B sane-coolscan
|
|
|
|
library implements a SANE backend that provides the interface to the following Nikon Coolscan Film scanners: Nikon LS20, LS30, LS1000, LS2000.
|
|
|
|
|
2001-06-10 13:32:31 +00:00
|
|
|
.B 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 carefull when using it the first time.
|
2000-08-12 15:11:46 +00:00
|
|
|
|
|
|
|
.SH CONFIGURATION
|
|
|
|
|
|
|
|
The configuration file for this backend resides in
|
2005-04-12 06:01:14 +00:00
|
|
|
.IR @CONFIGDIR@/coolscan.conf .
|
2000-08-12 15:11:46 +00:00
|
|
|
|
|
|
|
Its contents 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:
|
|
|
|
|
2005-04-12 06:01:14 +00:00
|
|
|
.nf
|
2000-08-12 15:11:46 +00:00
|
|
|
#scsi Vendor Model Type
|
|
|
|
scsi Nikon * Scanner
|
|
|
|
/dev/scanner
|
2005-04-12 06:01:14 +00:00
|
|
|
.fi
|
2000-08-12 15:11:46 +00:00
|
|
|
|
|
|
|
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 have to set the
|
|
|
|
permissions of that device, have a look at sane-scsi.
|
|
|
|
|
|
|
|
.SH 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 dont work have a look at:
|
|
|
|
http://andreas.rick.free.fr/sane/autofocus.html.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
.SH FILES
|
|
|
|
|
2005-04-12 06:01:14 +00:00
|
|
|
.TP
|
2000-08-12 15:11:46 +00:00
|
|
|
The backend configuration file:
|
2005-04-12 06:01:14 +00:00
|
|
|
.I @CONFIGDIR@/coolscan.conf
|
|
|
|
.TP
|
2000-08-12 15:11:46 +00:00
|
|
|
The static library implementing this backend:
|
2005-04-12 06:01:14 +00:00
|
|
|
.I @LIBDIR@/libsane-coolscan.a
|
|
|
|
.TP
|
2001-06-10 15:42:45 +00:00
|
|
|
The shared library implementing this backend:
|
2005-04-12 06:01:14 +00:00
|
|
|
.I @LIBDIR@/libsane-coolscan.so
|
|
|
|
(present on systems that support dynamic loading)
|
2000-08-12 15:11:46 +00:00
|
|
|
|
|
|
|
.SH ENVIRONMENT
|
|
|
|
|
2005-04-12 06:01:14 +00:00
|
|
|
.TP
|
2000-08-12 15:11:46 +00:00
|
|
|
.B SANE_DEBUG_COOLSCAN
|
2005-04-12 06:01:14 +00:00
|
|
|
If the library was compiled with debug support enabled, this environment
|
2000-08-12 15:11:46 +00:00
|
|
|
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_COOLSCAN values
|
|
|
|
|
|
|
|
Examples:
|
2005-04-12 06:01:14 +00:00
|
|
|
|
|
|
|
on bash:
|
|
|
|
.br
|
|
|
|
export SANE_DEBUG_COOLSCAN=8
|
|
|
|
|
|
|
|
on csh:
|
|
|
|
.br
|
|
|
|
setenv SANE_DEBUG_COOLSCAN 8
|
2000-08-12 15:11:46 +00:00
|
|
|
|
|
|
|
.SH BUGS
|
|
|
|
|
2005-04-12 06:01:14 +00:00
|
|
|
The autofocus command does not work with some SCSI card/driver combinations
|
|
|
|
.PP
|
|
|
|
The gamma table is not implemented for the LS1000 yet.
|
|
|
|
.PP
|
|
|
|
The dust-removal is not working yet
|
2000-08-12 15:11:46 +00:00
|
|
|
|
|
|
|
.SH SEE ALSO
|
|
|
|
|
2005-04-12 06:01:14 +00:00
|
|
|
.TP
|
|
|
|
.I http://andreas.rick.free.fr/sane/
|
|
|
|
The homepage of this backend
|
|
|
|
.TP
|
|
|
|
.I http://www.sema.be/coolscan/
|
|
|
|
The original version of the coolscan backend by Didier
|
|
|
|
.PP
|
2005-11-24 20:17:43 +00:00
|
|
|
sane(7), sane-scsi(5)
|
2000-08-12 15:11:46 +00:00
|
|
|
|
|
|
|
.SH THANKS TO
|
|
|
|
|
2005-04-12 06:01:14 +00:00
|
|
|
.PP
|
|
|
|
Didier Carlier \- For writing the original Coolscan backend (without it I would not have started this)
|
|
|
|
.PP
|
|
|
|
Oliver Rauch \- For adapting xsane so quickly to the infrared stuff.
|
|
|
|
.PP
|
|
|
|
All the other people working on SANE.
|
2000-08-12 15:11:46 +00:00
|
|
|
|
|
|
|
.SH AUTHOR
|
|
|
|
Andreas Rick
|
|
|
|
|
|
|
|
.SH EMAIL-CONTACT
|
|
|
|
andreas.rick@free.fr
|