diff options
Diffstat (limited to 'upstream/debian-bookworm/man5/sane-coolscan3.5')
-rw-r--r-- | upstream/debian-bookworm/man5/sane-coolscan3.5 | 204 |
1 files changed, 204 insertions, 0 deletions
diff --git a/upstream/debian-bookworm/man5/sane-coolscan3.5 b/upstream/debian-bookworm/man5/sane-coolscan3.5 new file mode 100644 index 00000000..ebcfbe45 --- /dev/null +++ b/upstream/debian-bookworm/man5/sane-coolscan3.5 @@ -0,0 +1,204 @@ +.TH sane\-coolscan3 5 "11 Jul 2008" "" "SANE Scanner Access Now Easy" +.IX sane\-coolscan3 +.SH NAME +sane\-coolscan3 \- SANE backend for Nikon Coolscan film scanners +.SH DESCRIPTION +The +.B sane\-coolscan3 +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 +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. + +.PP +At present, the following scanners are known to work with this backend: +.PP +.RS +.ft CR +.nf +Model: Connection Type +--------------------------- ------------------- +LS-30 (Coolscan III) SCSI +LS-40 ED (Coolscan IV) USB +LS-50 ED (Coolscan V) USB +LS-2000 SCSI +LS-4000 ED IEEE 1394 +LS-8000 ED IEEE 1394 +.fi +.ft R +.RE + +Please send mail to +.I sane-devel@alioth-lists.debian.net +to report successes or failures. + +.SH OPTIONS +The options the backend supports can either be selected through command line +options to programs like +.BR scanimage (1) +or through GUI elements in +.BR xscanimage (1) +or +.BR xsane (1). + +Valid command line options and their syntax can be listed by using: +.PP +.RS +scanimage \-\-help \-d coolscan3:<interface>:<device> +.RE +.PP +where <interface> and <device> specify the device in question, as in the +configuration file (see next section). The +.B \-d +parameter and its argument can be omitted to obtain information on the +first scanner identified. Use the command: +.PP +.RS +scanimage \-L +.RE +.PP +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 +.BR scanimage (1): +.TP +.B \-\-frame <n> +This option specifies which frame to operate on, if a motorized film strip +feeder or APS adapter are used. The frame number +.I <n> +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). +.TP +.B \-\-subframe <x> +This option shifts the scan window by the specified amount (default +unit is mm). +.TP +.B \-\-infrared=yes/no +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 +.B \-\-batch\-count=2 +to obtain the IR information. +.TP +.B \-\-depth <n> +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. +.TP +.B \-\-autofocus +Perform autofocus operation. Unless otherwise specified by the other options ( +.B \-\-focus\-on\-centre +and friends), focusing is performed on the centre of the selected scan area. +.TP +.B \-\-ae\-wb +.TP +.B \-\-ae +Perform a pre-scan to calculate exposure values automatically. +.B \-\-ae\-wb +will maintain the white balance, while +.B \-\-ae +will adjust each channel separately. +.TP +.B \-\-exposure +Multiply all exposure times with this value. This allows exposure +correction without modifying white balance. +.TP +.B \-\-load +Load the next slide when using the slide loader (SF\-200 bulk loader only). +.TP +.B \-\-eject +Eject the film strip or mounted slide when using the slide loader. +.TP +.B \-\-reset +Reset scanner. The scanner will perform the same action as when power is +turned on: it will eject the film strip (with the SF\-200 bulk loader) +and calibrate itself. Use this +whenever the scanner refuses to load a film strip properly, as a result of +which +.B \-\-eject +does not work. + +.SH CONFIGURATION FILE +The configuration file +.I /etc/sane.d/coolscan3.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. + +Each line in the configuration file is either of the following, where all +entries are case-sensitive: +.TP +.I blank or starting with a '#' character +These lines are ignored, thus '#' can be used to include comments. +.TP +.I containing only the word """auto""" +This instructs the backend to probe for a scanner by scanning the buses for +devices with known identifiers. This is the default action when no +configuration file is present. +.TP +.I a line of the form <interface>:<device> +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. + +.SH FILES +.TP +.I /usr/lib/x86_64-linux-gnu/sane/libsane\-coolscan3.a +The static library implementing this backend. +.TP +.I /usr/lib/x86_64-linux-gnu/sane/libsane\-coolscan3.so +The shared library implementing this backend (present on systems that +support dynamic loading). +.TP +.I /etc/sane.d/coolscan3.conf +Configuration file for this backend, read each time the backend is +initialized. + +.SH ENVIRONMENT +.TP +.B SANE_DEBUG_COOLSCAN3 +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. + +.SH "SEE ALSO" +.BR sane\-scsi (5), +.BR sane\-usb (5), +.BR scanimage (1), +.BR xscanimage (1), +.BR xsane (1) + +.SH BUGS +Currently, the SANE protocol does not allow automatically updating options +whenever the hardware changes. Thus the number of choices for the +.B \-\-frame +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 +.B \-\-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 SANE developers' list. + +.SH AUTHORS +coolscan3 written by A. Zummo +.RI < a.zummo@towertech.it >, +based heavily on coolscan2 written by Andr\['a]s Major +.RI < andras@users.sourceforge.net >. |