2003-09-23 15:30:05 +00:00
|
|
|
|
<HTML>
|
|
|
|
|
|
<HEAD>
|
|
|
|
|
|
<TITLE>sane-coolscan2.5</TITLE>
|
|
|
|
|
|
</HEAD>
|
2003-09-24 17:24:12 +00:00
|
|
|
|
<BODY BGCOLOR=#FFFFFF TEXT=#000000><H1 ALIGN=CENTER><IMG SRC="/images/sane.png" HEIGHT=117 WIDTH=346></H1>
|
2003-09-23 15:30:05 +00:00
|
|
|
|
<H1>sane-coolscan2.5</H1>
|
|
|
|
|
|
<HR>
|
|
|
|
|
|
<PRE>
|
|
|
|
|
|
<!-- Manpage converted by man2html 3.0.1 -->
|
|
|
|
|
|
<B><A HREF="sane-coolscan2.5.html">sane-coolscan2(5)</A></B> SANE Scanner Access Now Easy <B><A HREF="sane-coolscan2.5.html">sane-coolscan2(5)</A></B>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
|
<H2>NAME</H2><PRE>
|
|
|
|
|
|
sane-coolscan2 - SANE backend for Nikon Coolscan film scanners
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
|
<H2>DESCRIPTION</H2><PRE>
|
|
|
|
|
|
The library implements a SANE (Scanner Access Now Easy) backend that
|
|
|
|
|
|
provides access to Nikon Coolscan film scanners. Some functions of
|
|
|
|
|
|
this backend should be considered <B>beta-quality</B> software. Most functions
|
|
|
|
|
|
have been stable for a long time, but of course new development can not
|
|
|
|
|
|
and will not function properly from the very first day. Please report
|
|
|
|
|
|
any strange behaviour to the maintainer of the backend.
|
|
|
|
|
|
|
|
|
|
|
|
At present, the following scanners are known to work with this backend:
|
|
|
|
|
|
|
|
|
|
|
|
Model: Connection Type
|
|
|
|
|
|
--------------------------- -------------------
|
|
|
|
|
|
LS-30 (Coolscan III) SCSI
|
|
|
|
|
|
LS-2000 SCSI
|
|
|
|
|
|
LS-40 ED (Coolscan IV) USB
|
|
|
|
|
|
LS-4000 ED IEEE 1394
|
|
|
|
|
|
LS-8000 ED IEEE 1394
|
|
|
|
|
|
|
|
|
|
|
|
Please send mail to the backend author (andras@users.sourceforge.net)
|
|
|
|
|
|
to report successes or failures.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
|
<H2>OPTIONS</H2><PRE>
|
|
|
|
|
|
The options the backend supports can either be selected through command
|
|
|
|
|
|
line options to programs like scanimage or through GUI elements in
|
|
|
|
|
|
xscanimage or xsane.
|
|
|
|
|
|
|
|
|
|
|
|
Valid command line options and their syntax can be listed by using
|
|
|
|
|
|
scanimage --help -d coolscan2:<interface>:<device>
|
|
|
|
|
|
where <interface> and <device> specify the device in question, as in
|
|
|
|
|
|
the configuration file (see next section). The "-d" parameter and its
|
|
|
|
|
|
argument can be omitted to obtain information on the first scanner
|
|
|
|
|
|
identified. Use the command
|
|
|
|
|
|
scanimage -L
|
|
|
|
|
|
to list all devices recognized by your SANE installation.
|
|
|
|
|
|
|
|
|
|
|
|
The options should be fully described by the description or tooltips
|
|
|
|
|
|
given by frontend. Here is a description of some of the most important
|
|
|
|
|
|
options, in the syntax with which they must be supplied to scanimage:
|
|
|
|
|
|
|
|
|
|
|
|
<I>--frame</I> <I><n></I>
|
|
|
|
|
|
This option specifies which frame to operate on, if a motorized
|
|
|
|
|
|
film strip feeder or APS adapter are used. The frame number <I><n></I>
|
|
|
|
|
|
ranges from 1 to the number of frames available, which is sensed
|
|
|
|
|
|
each time the backend is initialized (usually each time you
|
|
|
|
|
|
start the frontend).
|
|
|
|
|
|
|
|
|
|
|
|
<I>--subframe</I> <I><x></I>
|
|
|
|
|
|
This option shifts the scan window by the specified amount
|
|
|
|
|
|
(default unit is mm).
|
|
|
|
|
|
|
|
|
|
|
|
<I>--infrared=yes/no</I>
|
|
|
|
|
|
If set to "yes", the scanner will read the infrared channel,
|
|
|
|
|
|
thus allowing defect removal in software. The infrared image is
|
|
|
|
|
|
read during a second scan, with no options altered. The backend
|
|
|
|
|
|
must not be restarted between the scans. If you use scanimage,
|
|
|
|
|
|
perform a batch scan with batch-count=2 to obtain the IR infor-
|
|
|
|
|
|
mation.
|
|
|
|
|
|
|
|
|
|
|
|
<I>--depth</I> <I><n></I>
|
|
|
|
|
|
Here <n> can either be 8 or the maximum number of bits supported
|
|
|
|
|
|
by the scanner (10, 12, or 14). It specifies whether or not the
|
|
|
|
|
|
scanner reduces the scanned data to 8 bits before sending it to
|
|
|
|
|
|
the backend. If 8 bits are used, some information and thus image
|
|
|
|
|
|
quality is lost, but the amount of data is smaller compared to
|
|
|
|
|
|
higher depths. Also, many imaging programs and image formats
|
|
|
|
|
|
cannot handle depths greater than 8 bits.
|
|
|
|
|
|
|
|
|
|
|
|
<I>--autofocus</I>
|
|
|
|
|
|
Perform autofocus operation. Unless otherwise specified by the
|
|
|
|
|
|
other options ( <I>--focus-on-centre</I> and friends), focusing is per-
|
|
|
|
|
|
formed on the centre of the selected scan area.
|
|
|
|
|
|
|
|
|
|
|
|
<I>--ae-wb</I>
|
|
|
|
|
|
|
|
|
|
|
|
<I>--ae</I> Perform a pre-scan to calculate exposure values automatically.
|
|
|
|
|
|
<I>--ae-wb</I> will maintain the white balance, while <I>--ae</I> will adjust
|
|
|
|
|
|
each channel separately.
|
|
|
|
|
|
|
|
|
|
|
|
<I>--exposure</I>
|
|
|
|
|
|
Multiply all exposure times with this value. This allows expo-
|
|
|
|
|
|
sure correction without modifying white balance.
|
|
|
|
|
|
|
|
|
|
|
|
<I>--load</I> Load the next slide when using the slide loader.
|
|
|
|
|
|
|
|
|
|
|
|
<I>--eject</I>
|
|
|
|
|
|
Eject the film strip or mounted slide when using the slide
|
|
|
|
|
|
loader.
|
|
|
|
|
|
|
|
|
|
|
|
<I>--reset</I>
|
|
|
|
|
|
Reset scanner. The scanner will perform the same action as when
|
|
|
|
|
|
power is turned on: it will eject the film strip and calibrate
|
|
|
|
|
|
itself. Use this whenever the scanner refuses to load a film
|
|
|
|
|
|
strip properly, as a result of which <I>--eject</I> does not work.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
|
<H2>CONFIGURATION FILE</H2><PRE>
|
|
|
|
|
|
The configuration file /usr/local/etc/sane.d/coolscan2.conf specifies
|
|
|
|
|
|
the device(s) that the backend will use. Owing to the nature of the
|
|
|
|
|
|
supported connection types SCSI, USB, and IEEE 1394, the default con-
|
|
|
|
|
|
figuration file supplied with the SANE distribution should work without
|
|
|
|
|
|
being edited.
|
|
|
|
|
|
|
|
|
|
|
|
Each line in the configuration file is either of the following, where
|
|
|
|
|
|
all entries are case-sensitive:
|
|
|
|
|
|
|
|
|
|
|
|
<I>blank</I> <I>or</I> <I>starting</I> <I>with</I> <I>a</I> <I>'#'</I> <I>character</I>
|
|
|
|
|
|
These lines are ignored, thus '#' can be used to include com-
|
|
|
|
|
|
ments.
|
|
|
|
|
|
|
|
|
|
|
|
<I>containing</I> <I>only</I> <I>the</I> <I>word</I> <I>"auto"</I>
|
|
|
|
|
|
This instructs the backend to probe for a scanner by scanning
|
|
|
|
|
|
the buses for devices with know identifiers. This is the action
|
|
|
|
|
|
taken when no configuration file is present.
|
|
|
|
|
|
|
|
|
|
|
|
<I>a</I> <I>line</I> <I>of</I> <I>the</I> <I>form</I> <I><interface>:<device></I>
|
|
|
|
|
|
Here <interface> can be one of "scsi" or "usb", and <device> is
|
|
|
|
|
|
the device file of the scanner. Note that IEEE 1394 devices are
|
|
|
|
|
|
handled by the SBP-2 module in the kernel and appear to SANE as
|
|
|
|
|
|
SCSI devices.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
|
<H2>FILES</H2><PRE>
|
|
|
|
|
|
<I>/usr/local/lib/sane/libsane-coolscan2.a</I>
|
|
|
|
|
|
The static library implementing this backend.
|
|
|
|
|
|
|
|
|
|
|
|
<I>/usr/local/lib/sane/libsane-coolscan2.so</I>
|
|
|
|
|
|
The shared library implementing this backend (present on systems
|
|
|
|
|
|
that support dynamic loading).
|
|
|
|
|
|
|
|
|
|
|
|
<I>/usr/local/etc/sane.d/coolscan2.conf</I>
|
|
|
|
|
|
Configuration file for this backend, read each time the backend
|
|
|
|
|
|
is initialized.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
|
<H2>ENVIRONMENT</H2><PRE>
|
|
|
|
|
|
<B>SANE_DEBUG_COOLSCAN2</B>
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
|
<H2>SEE ALSO</H2><PRE>
|
|
|
|
|
|
<B><A HREF="sane-scsi.5.html">sane-scsi(5)</A></B>, <B><A HREF="sane-usb.5.html">sane-usb(5)</A></B>, <B><A HREF="scanimage.1.html">scanimage(1)</A></B>, <B><A HREF="xscanimage.1.html">xscanimage(1)</A></B>, <B><A HREF="xsane.1.html">xsane(1)</A></B>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
|
<H2>BUGS</H2><PRE>
|
|
|
|
|
|
Currently, the SANE protocol does not allow automatically updating
|
|
|
|
|
|
options whenever the hardware changes. Thus the number of choices for
|
|
|
|
|
|
the <B>--frame</B> option will be fixed when the backend is initialized (usu-
|
|
|
|
|
|
ally when the user runs the frontend). In particular, if there is no
|
|
|
|
|
|
film strip in the automatic film strip feeder when the backend is ini-
|
|
|
|
|
|
tialized, the frame option will not appear at all. Also, restarting the
|
|
|
|
|
|
frontend after swapping film adapters is strongly recommended.
|
|
|
|
|
|
|
|
|
|
|
|
Linux kernels prior to 2.4.19 had a patch that truncated INQUIRY data
|
|
|
|
|
|
from IEEE 1394 scanners to 36 bytes, discarding vital information about
|
|
|
|
|
|
the scanner. The IEEE 1394 models therefore only work with 2.4.19 or
|
|
|
|
|
|
later.
|
|
|
|
|
|
|
|
|
|
|
|
No real bugs currently known, please report any to the backend main-
|
|
|
|
|
|
tainer or the SANE developers' email list.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
|
<H2>AUTHORS</H2><PRE>
|
2003-10-15 08:58:04 +00:00
|
|
|
|
The backend is written and maintained by Andr<64>s Major
|
2003-09-23 15:30:05 +00:00
|
|
|
|
(andras@users.sourceforge.net).
|
|
|
|
|
|
|
2004-05-18 18:21:25 +00:00
|
|
|
|
sane-backends 1.0.14-cvs 22/08/2002 <B><A HREF="sane-coolscan2.5.html">sane-coolscan2(5)</A></B>
|
2003-09-23 15:30:05 +00:00
|
|
|
|
</PRE>
|
|
|
|
|
|
<HR>
|
|
|
|
|
|
<ADDRESS>
|
|
|
|
|
|
Man(1) output converted with
|
|
|
|
|
|
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
|
|
|
|
|
|
</ADDRESS>
|
|
|
|
|
|
</BODY>
|
|
|
|
|
|
</HTML>
|
