diff --git a/backend/coolscan2.c b/backend/coolscan2.c index 49c2636c1..7d38d3e73 100644 --- a/backend/coolscan2.c +++ b/backend/coolscan2.c @@ -1,7 +1,7 @@ /* ========================================================================= */ /* SANE - Scanner Access Now Easy. - coolscan2.c , version CVS + coolscan2.c , version 0.1.5 This file is part of the SANE package. @@ -56,8 +56,8 @@ /* Revision log: - 0.1.4, 22/04/2002, andras: first version to be included in SANE CVS 0.1.5, 26/04/2002, andras: lots of minor fixes related to saned + 0.1.4, 22/04/2002, andras: first version to be included in SANE CVS */ /* ========================================================================= */ diff --git a/doc/Makefile.in b/doc/Makefile.in index 23389d38c..c3131e672 100644 --- a/doc/Makefile.in +++ b/doc/Makefile.in @@ -48,7 +48,7 @@ SECT5 = sane-abaton.5 sane-agfafocus.5 sane-apple.5 sane-as6e.5 sane-dll.5 \ sane-snapscan.5 sane-canon.5 sane-coolscan.5 sane-bh.5 sane-dc240.5 \ sane-umax_pp.5 sane-umax1220u.5 sane-sm3600.5 sane-usb.5 \ sane-mustek_usb.5 sane-sceptre.5 sane-canon_pp.5 sane-canon630u.5 \ - sane-teco1.5 sane-test.5 sane-sp15c.5 + sane-teco1.5 sane-test.5 sane-sp15c.5 sane-coolscan2.5 SECT7 = sane.7 MANPAGES = $(SECT1) $(SECT5) $(SECT7) READMES = README AUTHORS COPYING ChangeLog LEVEL2 LICENSE NEWS PROBLEMS \ @@ -71,8 +71,8 @@ DISTFILES = Makefile.in backend-writing.txt doxygen-sanei.conf html.sty \ net.tex \ releases.txt sane-abaton.man sane-agfafocus.man sane-apple.man \ sane-artec.man sane-as6e.man sane-avision.man sane-bh.man \ - sane-canon.man sane-canon630u.man sane-coolscan.man sane-dc210.man \ - sane-dc240.man \ + sane-canon.man sane-canon630u.man sane-coolscan.man sane-coolscan2.man \ + sane-dc210.man sane-dc240.man \ sane-dc25.man sane-dll.man sane-dmc.man sane-epson.man \ sane-find-scanner.man sane-fujitsu.man sane-gphoto2.man sane-hp.man \ sane-logo.png sane-logo2.jpg sane-matsushita.man sane-microtek.man \ diff --git a/doc/descriptions/coolscan2.desc b/doc/descriptions/coolscan2.desc index 09179890e..7c3f3dc76 100644 --- a/doc/descriptions/coolscan2.desc +++ b/doc/descriptions/coolscan2.desc @@ -12,7 +12,7 @@ :backend "coolscan2" :version "0.1.5" :status :beta -; :manpage "sane-template" +:manpage "sane-coolscan2" :url "http://coolscan2.sourceforge.net/" :devicetype :scanner diff --git a/doc/sane-coolscan2.man b/doc/sane-coolscan2.man new file mode 100644 index 000000000..1d7e2f2b2 --- /dev/null +++ b/doc/sane-coolscan2.man @@ -0,0 +1,175 @@ +.TH sane-coolscan2 5 "03/05/2002" +.IX sane-coolscan2 +.SH NAME +sane-coolscan2 - SANE backend for Nikon Coolscan film scanners +.SH DESCRIPTION +The +.sane-coolscan2 +library implements a SANE (Scanner Access Now Easy) backend that +provides access to Epson flatbed 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. Please report any strange behavior to the +maintainer of the backend. + +.PP +At present, the following scanners are known to work with this backend: +.PP +.RS +Model: Connection Type +.br +--------------------------- ------------------- +.br +LS-30 (Coolscan III) SCSI +.br +LS-40 ED (Coolscan IV) USB +.RE + +.PP +The following scanners should work with this backend, but are unconfirmed: +.PP +.RS +Model: Connection Type +.br +--------------------------- ------------------- +.br +LS-4000 ED IEEE 1394 +.br +LS-8000 ED IEEE 1394 +.RE + +Please send mail to the backend author (andras@users.sourceforge.net) to +report successes or failures. + +.SH OPTIONS +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 +.RS +scanimage --help -d coolscan2:: +.RE +where and 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 +.RS +scanimage -L +.RE +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: +.TP +.I --frame +This option specifies which frame to operate on, if a motorized film strip +feeder or APS adapter are used. The frame number +.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). +.TP +.I --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. +It will not therefore not work with scanimage, only +with graphical frontends. +.TP +.I --depth +Here 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 +.I --autofocus +Perform autofocus operation. Unless otherwise specified by the other options ( +.I --focus-on-centre +and friends), focusing is performed on the centre of the selected scan area. +.TP +.I --ae-wb +.TP +.I --ae +Perform a pre-scan to calculate exposure values automatically. +.I --ae-wb +will maintain the white balance, while +.I --ae +will adjust each channel separately. +.TP +.I --eject +Eject the film strip. +.TP +.I --reset +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 +does not work. + +.SH CONFIGURATION FILE +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. + +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 know identifiers. This is the action taken when no +configuration file is present. +.TP +.I a line of the form : +Here can be one of "scsi" or "usb", and 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 @LIBDIR@/libsane-coolscan2.a +The static library implementing this backend. +.TP +.I @LIBDIR@/libsane-coolscan2.so +The shared library implementing this backend (present on systems that +support dynamic loading). +.TP +.I @CONFIGDIR@/coolscan2.conf +Configuration file for this backend, read each time the backend is +initialized. + +.SH ENVIRONMENT +.TP +.B SANE_DEBUG_COOLSCAN2 +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" +sane\-scsi(5), sane\-usb(5), scanimage(1), xscanimage(1), 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 frame option +will not appear at all. Also, restarting the frontend after swapping film +adapters is strongly recommended. + +No real bugs currently known, please report any to the backend maintainer +or the SANE developers' email list. + +.SH AUTHORS +The backend is written and maintained by András Major +(andras@users.sourceforge.net).