270 lines
8.6 KiB
HTML
270 lines
8.6 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of sane-coolscan2</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>sane-coolscan2</H1>
|
|
Section: SANE Scanner Access Now Easy (5)<BR>Updated: 11 Jul 2008<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="ixAAB"></A>
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
sane-coolscan2 - SANE backend for Nikon Coolscan film scanners
|
|
<A NAME="lbAC"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
The
|
|
<B>sane-coolscan2</B>
|
|
|
|
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.
|
|
<P>
|
|
<P>
|
|
|
|
At present, the following scanners are known to work with this backend:
|
|
<P>
|
|
|
|
<DL COMPACT><DT id="1"><DD>
|
|
|
|
<PRE>
|
|
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
|
|
</PRE>
|
|
|
|
|
|
</DL>
|
|
|
|
<P>
|
|
Please send mail to the backend author (<A HREF="mailto:andras@users.sourceforge.net">andras@users.sourceforge.net</A>) to
|
|
report successes or failures.
|
|
<P>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
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.
|
|
<P>
|
|
Valid command line options and their syntax can be listed by using
|
|
<DL COMPACT><DT id="2"><DD>
|
|
scanimage --help -d coolscan2:<interface>:<device>
|
|
</DL>
|
|
|
|
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
|
|
<DL COMPACT><DT id="3"><DD>
|
|
scanimage -L
|
|
</DL>
|
|
|
|
to list all devices recognized by your SANE installation.
|
|
<P>
|
|
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:
|
|
<DL COMPACT>
|
|
<DT id="4"><I>--frame <n></I>
|
|
|
|
<DD>
|
|
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).
|
|
<DT id="5"><I>--subframe <x></I>
|
|
|
|
<DD>
|
|
This option shifts the scan window by the specified amount (default
|
|
unit is mm).
|
|
<DT id="6"><I>--infrared=yes/no</I>
|
|
|
|
<DD>
|
|
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 information.
|
|
<DT id="7"><I>--depth <n></I>
|
|
|
|
<DD>
|
|
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.
|
|
<DT id="8"><I>--autofocus</I>
|
|
|
|
<DD>
|
|
Perform autofocus operation. Unless otherwise specified by the other options (
|
|
<I>--focus-on-centre</I>
|
|
|
|
and friends), focusing is performed on the centre of the selected scan area.
|
|
<DT id="9"><I>--ae-wb</I>
|
|
|
|
<DD>
|
|
<DT id="10"><I>--ae</I>
|
|
|
|
<DD>
|
|
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.
|
|
<DT id="11"><I>--exposure</I>
|
|
|
|
<DD>
|
|
Multiply all exposure times with this value. This allows exposure
|
|
correction without modifying white balance.
|
|
<DT id="12"><I>--load</I>
|
|
|
|
<DD>
|
|
Load the next slide when using the slide loader.
|
|
<DT id="13"><I>--eject</I>
|
|
|
|
<DD>
|
|
Eject the film strip or mounted slide when using the slide loader.
|
|
<DT id="14"><I>--reset</I>
|
|
|
|
<DD>
|
|
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.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>CONFIGURATION FILE</H2>
|
|
|
|
The configuration file @CONFIGDIR@/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 configuration file supplied with
|
|
the SANE distribution should work without being edited.
|
|
<P>
|
|
Each line in the configuration file is either of the following, where all
|
|
entries are case-sensitive:
|
|
<DL COMPACT>
|
|
<DT id="15"><I>blank or starting with a '#' character</I>
|
|
|
|
<DD>
|
|
These lines are ignored, thus '#' can be used to include comments.
|
|
<DT id="16"><I>containing only the word auto</I>
|
|
|
|
<DD>
|
|
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.
|
|
<DT id="17"><I>a line of the form <interface>:<device></I>
|
|
|
|
<DD>
|
|
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.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="18"><I>@LIBDIR@/libsane-coolscan2.a</I>
|
|
|
|
<DD>
|
|
The static library implementing this backend.
|
|
<DT id="19"><I>@LIBDIR@/libsane-coolscan2.so</I>
|
|
|
|
<DD>
|
|
The shared library implementing this backend (present on systems that
|
|
support dynamic loading).
|
|
<DT id="20"><I>@CONFIGDIR@/coolscan2.conf</I>
|
|
|
|
<DD>
|
|
Configuration file for this backend, read each time the backend is
|
|
initialized.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>ENVIRONMENT</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="21"><B>SANE_DEBUG_COOLSCAN2</B>
|
|
|
|
<DD>
|
|
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.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<A HREF="/cgi-bin/man/man2html?5+sane-scsi">sane-scsi</A>(5), <A HREF="/cgi-bin/man/man2html?5+sane-usb">sane-usb</A>(5), <A HREF="/cgi-bin/man/man2html?1+scanimage">scanimage</A>(1), <A HREF="/cgi-bin/man/man2html?1+xscanimage">xscanimage</A>(1), <A HREF="/cgi-bin/man/man2html?1+xsane">xsane</A>(1)
|
|
<P>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
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 (usually when the user
|
|
runs the frontend). In particular, if there is no film strip in the
|
|
automatic film strip feeder when the backend is initialized, the frame option
|
|
will not appear at all. Also, restarting the frontend after swapping film
|
|
adapters is strongly recommended.
|
|
<P>
|
|
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.
|
|
<P>
|
|
No real bugs currently known, please report any to the backend maintainer
|
|
or the SANE developers' email list.
|
|
<P>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>AUTHORS</H2>
|
|
|
|
The backend is written and maintained by András Major
|
|
(<A HREF="mailto:andras@users.sourceforge.net">andras@users.sourceforge.net</A>).
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="22"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="23"><A HREF="#lbAC">DESCRIPTION</A><DD>
|
|
<DT id="24"><A HREF="#lbAD">OPTIONS</A><DD>
|
|
<DT id="25"><A HREF="#lbAE">CONFIGURATION FILE</A><DD>
|
|
<DT id="26"><A HREF="#lbAF">FILES</A><DD>
|
|
<DT id="27"><A HREF="#lbAG">ENVIRONMENT</A><DD>
|
|
<DT id="28"><A HREF="#lbAH">SEE ALSO</A><DD>
|
|
<DT id="29"><A HREF="#lbAI">BUGS</A><DD>
|
|
<DT id="30"><A HREF="#lbAJ">AUTHORS</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:06:04 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|