summaryrefslogtreecommitdiff
path: root/doc/sane-coolscan.man
blob: 7f73dd4c4a3e371ab3d1ea21150b2ddf5f87580e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
.TH sane\-coolscan 5 "13 Jul 2008" "@PACKAGEVERSION@" "SANE Scanner Access Now Easy"
.IX sane\-coolscan

.SH NAME
sane\-coolscan \- SANE backend for Nikon film-scanners

.SH ABOUT THIS FILE

This file is a short description of the coolscan backend for
.BR 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.

.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 careful when using it the first time.

.SH CONFIGURATION

The configuration file for this backend resides in
.IR @CONFIGDIR@/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:

.nf
 #scsi Vendor Model Type
 scsi Nikon * Scanner
 /dev/scanner
.fi

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
.BR sane\-scsi (5).

.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 don't work have a look at:
.I http://andreas.rick.free.fr/sane/autofocus.html.

.SH FILES
.TP
The backend configuration file:
.I @CONFIGDIR@/coolscan.conf
.TP
The static library implementing this backend:
.I @LIBDIR@/libsane\-coolscan.a
.TP
The shared library implementing this backend:
.I @LIBDIR@/libsane\-coolscan.so
(present on systems that support dynamic loading)

.SH ENVIRONMENT

.TP
.B 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:
.br
export SANE_DEBUG_COOLSCAN=8

On csh:
.br
setenv SANE_DEBUG_COOLSCAN 8

.SH BUGS

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.

.SH SEE ALSO
.BR sane (7),
.BR sane\-scsi (5)

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

.SH THANKS TO
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.

.SH AUTHOR
Andreas Rick

.SH EMAIL-CONTACT
.I andreas.rick@free.fr