kopia lustrzana https://gitlab.com/sane-project/backends
doc: corrections for trailing space and a batch of man pages
Ralph Little
rodzic
cfa36aa47a
commit
79b866619b
|
|
@ -31,39 +31,44 @@ is a floating point value, neutral value being 1.0. If the value is larger than
|
|||
.PP
|
||||
.BR shadow
|
||||
defines the minimum input value that is necessary to create an output value
|
||||
larger than zero. shadow has to be in the range [0..\fBmaxin\fR]. Its default value
|
||||
is 0.
|
||||
larger than zero. shadow has to be in the range
|
||||
.RB "[0.." "maxin" "]."
|
||||
Its default value is 0.
|
||||
.PP
|
||||
.BR highlight
|
||||
defines the maximum input value that produces an output value smaller than
|
||||
maxout. highlight must be in the range [0..maxin] and
|
||||
maxout. highlight must be in the range
|
||||
.RB "[0.." "maxin" "]"
|
||||
and
|
||||
larger than shadow. Its default value is the same as
|
||||
.RB maxin
|
||||
.B maxin
|
||||
(16383 if not set).
|
||||
.PP
|
||||
.BR maxin
|
||||
.B maxin
|
||||
defines the size of the gamma table. The size depends on the scanner/backend.
|
||||
If the scanner uses 8 bit gamma input then
|
||||
.RB maxin
|
||||
.B maxin
|
||||
must be set to 255, 1023 for 10
|
||||
bits, 4095 for 12 bits, and 16383 for 14 bits. The default is 16383. To find
|
||||
out what value
|
||||
.RB maxin
|
||||
.B maxin
|
||||
has to be, call
|
||||
.B scanimage
|
||||
.BR scanimage (1)
|
||||
with a very large gamma table
|
||||
[0]0-[99999]255 and
|
||||
.B scanimage
|
||||
.BR scanimage (1)
|
||||
will print an error message with the needed gamma table size.
|
||||
.PP
|
||||
.BR maxout
|
||||
defines the maximum output value. Take a look at the output of
|
||||
.B scanimage \-h
|
||||
to find out what maxout must be. The default value is 255.
|
||||
.B maxout
|
||||
defines the maximum output value. Take a look at the output of
|
||||
.I scanimage \-h
|
||||
to find out what
|
||||
.B maxout
|
||||
must be. The default value is 255.
|
||||
.PP
|
||||
.SH EXAMPLE
|
||||
.B scanimage \-\-custom\-gamma=yes \-\-gamma\-table
|
||||
.I `gamma4scanimage 1.8 0 11500 16383 255`
|
||||
scanimage \-\-custom\-gamma=yes \-\-gamma\-table
|
||||
`gamma4scanimage 1.8 0 11500 16383 255`
|
||||
>image.pnm
|
||||
|
||||
.SH SEE ALSO
|
||||
|
|
|
|||
|
|
@ -6,24 +6,31 @@ sane\-as6e \- SANE backend for using the Artec AS6E parallel port interface scan
|
|||
.SH DESCRIPTION
|
||||
The
|
||||
.B sane\-as6e
|
||||
library implements a SANE (Scanner Access Now Easy) backend
|
||||
library implements a
|
||||
.B SANE
|
||||
(Scanner Access Now Easy) backend
|
||||
that provides access to Artec AS6E flatbed scanner.
|
||||
.B It requires the as6edriver program in order to operate.
|
||||
The as6edriver program is
|
||||
.B not
|
||||
included with the SANE package.
|
||||
It requires the
|
||||
.B as6edriver
|
||||
program in order to operate. The
|
||||
.B as6edriver
|
||||
program is not included with the
|
||||
.B SANE
|
||||
package.
|
||||
It can be found at
|
||||
.BR http://as6edriver.sourceforge.net.
|
||||
See the as6edriver documentation for technical information.
|
||||
.PP
|
||||
The
|
||||
.I as6edriver
|
||||
.B as6edriver
|
||||
program must be in the path for executables ($PATH). Especially if you run
|
||||
.I saned
|
||||
(the SANE network scanning daemon), take care to setup the path for
|
||||
.I inetd
|
||||
.BR saned (8)
|
||||
(the
|
||||
.B SANE
|
||||
network scanning daemon), take care to setup the path for
|
||||
.BR inetd (8)
|
||||
or
|
||||
.I xinetd
|
||||
.BR xinetd (8)
|
||||
correctly or place the program in a directory that is in the path.
|
||||
|
||||
.PP
|
||||
|
|
@ -35,8 +42,9 @@ correctly or place the program in a directory that is in the path.
|
|||
.SH SEE ALSO
|
||||
.BR sane (7),
|
||||
.BR as6edriver (5),
|
||||
.BR saned (8),
|
||||
.B http://as6edriver.sourceforge.net
|
||||
.BR saned (8)
|
||||
.br
|
||||
.I http://as6edriver.sourceforge.net
|
||||
|
||||
.SH AUTHOR
|
||||
Eugene S. Weiss
|
||||
|
|
|
|||
|
|
@ -24,8 +24,11 @@ CanoScan FS2710S
|
|||
.RE
|
||||
.PP
|
||||
Parallel port and USB scanners are not supported by this backend; see
|
||||
the manual pages for sane\-canon_pp and sane\-canon630u for further
|
||||
information.
|
||||
the manual pages for
|
||||
.BR sane\-canon_pp (5)
|
||||
and
|
||||
.BR sane\-canon630u (5)
|
||||
for further information.
|
||||
.PP
|
||||
IMPORTANT: This is beta code. We tested the code on the scanners listed
|
||||
above, using the computers and operating systems available to us, but we
|
||||
|
|
@ -88,11 +91,10 @@ Example:
|
|||
export SANE_DEBUG_CANON=4
|
||||
|
||||
.SH "SEE ALSO"
|
||||
sane\-scsi(5)
|
||||
.BR sane\-scsi (5)
|
||||
.br
|
||||
http://www.rzg.mpg.de/~mpd/sane/
|
||||
.br
|
||||
doc/canon.install2700F.txt (installation of a CanoScan 2700F
|
||||
.I http://www.rzg.mpg.de/~mpd/sane/doc/canon.install2700F.txt
|
||||
(installation of a CanoScan 2700F)
|
||||
.br
|
||||
.SH AUTHOR
|
||||
Helmut Koeberle, Manuel Panea, and Markus Mertinat; FB620S and FB1200S support
|
||||
|
|
|
|||
|
|
@ -29,15 +29,19 @@ USB scanners. Empty lines and lines starting with a hash mark (#) are
|
|||
ignored. Only one device name can be listed in
|
||||
.IR canon630u.conf .
|
||||
The program
|
||||
.IR sane\-find\-scanner
|
||||
.BR sane\-find\-scanner (1)
|
||||
helps to find out the correct device. Under Linux, such a device name
|
||||
could be
|
||||
.I /dev/usb/scanner0
|
||||
for example. See sane\-usb(5) for details.
|
||||
for example. See
|
||||
.BR sane\-usb (5)
|
||||
for details.
|
||||
.PP
|
||||
This product-specific scanner driver uses the lower-level kernel USB driver
|
||||
"scanner". Check for "Driver=usbscanner" under /proc/bus/usb/devices. If
|
||||
"Driver=(none)", try forcing it with "insmod scanner vendor=0x04a9 product=0x2204"
|
||||
"scanner". Check for "Driver=usbscanner" under
|
||||
.IR /proc/bus/usb/devices.
|
||||
If "Driver=(none)", try forcing it with
|
||||
.I "insmod scanner vendor=0x04a9 product=0x2204"
|
||||
.SH NOTES
|
||||
.PP
|
||||
Due to Canon's unwillingness to provide scanner documentation, this
|
||||
|
|
@ -49,10 +53,16 @@ This driver requires the ability to send USB Control Messages, available in
|
|||
kernel 2.4.12 or later.
|
||||
.PP
|
||||
Some users have reported that this driver doesn't work at all. This seems
|
||||
to be a hardware specific issue, although I don't know what exactly the
|
||||
to be a hardware specific issue, although I dsane\-uson't know what exactly the
|
||||
problem is. If you are having problems, please send me the info in
|
||||
/proc/bus/usb/devices, /proc/pci, the kernel scanner.c driver version from
|
||||
/var/log/messages, and the output from "SANE_DEBUG_CANON630U=12 scanimage > /dev/null"
|
||||
.IR /proc/bus/usb/devices,
|
||||
.IR /proc/pci,
|
||||
the kernel
|
||||
.I scanner.c
|
||||
driver version from
|
||||
.IR /var/log/messages,
|
||||
and the output from
|
||||
.I "SANE_DEBUG_CANON630U=12 scanimage > /dev/null"
|
||||
.PP
|
||||
.SH FILES
|
||||
.TP
|
||||
|
|
@ -85,8 +95,12 @@ environment variable ends with the directory separator character, then
|
|||
the default directories are searched after the explicitly specified
|
||||
directories. For example, setting
|
||||
.B SANE_CONFIG_DIR
|
||||
to "/tmp/config:" would result in directories "tmp/config", ".", and
|
||||
"@CONFIGDIR@" being searched (in this order).
|
||||
to "/tmp/config:" would result in directories
|
||||
.IR tmp/config,
|
||||
.IR ".",
|
||||
and
|
||||
.I "@CONFIGDIR@"
|
||||
being searched (in this order).
|
||||
.TP
|
||||
.B SANE_DEBUG_CANON630U
|
||||
If the library was compiled with debug support enabled, this
|
||||
|
|
@ -97,9 +111,11 @@ Example:
|
|||
.br
|
||||
SANE_DEBUG_CANON630U=12 scanimage > /dev/null
|
||||
.SH "SEE ALSO"
|
||||
sane(7), sane\-usb(5), sane\-find\-scanner(1)
|
||||
.BR sane (7),
|
||||
.BR sane\-usb (5),
|
||||
.BR sane\-find\-scanner (1)
|
||||
.br
|
||||
http://canon-fb630u.sourceforge.net/
|
||||
.I http://canon-fb630u.sourceforge.net/
|
||||
.br
|
||||
.SH AUTHOR
|
||||
Nathan Rutman
|
||||
|
|
|
|||
|
|
@ -7,7 +7,9 @@ sane\-cardscan \- SANE backend for Corex CardScan usb scanners
|
|||
.SH DESCRIPTION
|
||||
The
|
||||
.B sane\-cardscan
|
||||
library implements a SANE (Scanner Access Now Easy) backend which
|
||||
library implements a
|
||||
.B SANE
|
||||
(Scanner Access Now Easy) backend which
|
||||
provides access to the Corex CardScan 800c & 600c small-format scanners.
|
||||
|
||||
The backend supports only grayscale and color modes and media of
|
||||
|
|
@ -26,12 +28,15 @@ Selects the mode for the scan. Options are "Gray" and "Color".
|
|||
.RE
|
||||
.PP
|
||||
.SH CONFIGURATION FILE
|
||||
The configuration file "cardscan.conf" is used to tell the backend how to look
|
||||
The configuration file
|
||||
.I cardscan.conf
|
||||
is used to tell the backend how to look
|
||||
for scanners, and provide options controlling the operation of the backend.
|
||||
This file is read each time the frontend asks the backend for a list
|
||||
of scanners, generally only when the frontend starts. If the configuration
|
||||
file is missing, the backend will use a set of compiled defaults, which
|
||||
are identical to the default configuration file shipped with SANE.
|
||||
are identical to the default configuration file shipped with
|
||||
.BR SANE .
|
||||
.PP
|
||||
Scanners can be specified in the configuration file in 2 ways:
|
||||
.PP
|
||||
|
|
@ -64,8 +69,9 @@ Older scanners do not support this request, and must be set to 0.
|
|||
.RE
|
||||
|
||||
.SH ENVIRONMENT
|
||||
The backend uses a single environment variable, SANE_DEBUG_CARDSCAN, which
|
||||
enables debugging output to stderr. Valid values are:
|
||||
The backend uses a single environment variable,
|
||||
.BR SANE_DEBUG_CARDSCAN,
|
||||
which enables debugging output to stderr. Valid values are:
|
||||
.PP
|
||||
.RS
|
||||
5 Errors
|
||||
|
|
@ -106,8 +112,8 @@ The hardware to build this driver was provided to the author by:
|
|||
Jeff Kowalczyk <jtk a t yahoo d o t com>
|
||||
|
||||
.SH "SEE ALSO"
|
||||
sane(7),
|
||||
sane\-usb(5)
|
||||
.BR sane (7),
|
||||
.BR sane\-usb (5)
|
||||
|
||||
.SH AUTHOR
|
||||
m. allan noah: <kitno455 a t gmail d o t com>
|
||||
|
|
|
|||
|
|
@ -22,7 +22,9 @@ Print the currently installed version of libsane on the standard output.
|
|||
.TP 8
|
||||
.B \-\-help OPTION
|
||||
Print a short usage message. If OPTION is specified, help for that option
|
||||
(e.g. \-\-libs) is printed (if available).
|
||||
(e.g.
|
||||
.BR \-\-libs)
|
||||
is printed (if available).
|
||||
.TP 8
|
||||
.B \-\-libs
|
||||
Print the additional libraries that are necessary to link a
|
||||
|
|
@ -47,5 +49,6 @@ Print the exec\-prefix used during compilation of libsane.
|
|||
.SH "SEE ALSO"
|
||||
.BR sane (7)
|
||||
.SH AUTHOR
|
||||
This manual page was written by Julien BLACHE <jblache@debian.org>, for the
|
||||
Debian GNU/Linux system (but may be used by others).
|
||||
This manual page was written by Julien BLACHE
|
||||
.RI < jblache@debian.org >,
|
||||
for the Debian GNU/Linux system (but may be used by others).
|
||||
|
|
|
|||
|
|
@ -6,13 +6,16 @@ sane\-coolscan \- SANE backend for Nikon film-scanners
|
|||
|
||||
.SH ABOUT THIS FILE
|
||||
|
||||
This file is a short description of the coolscan-backend for sane!
|
||||
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.
|
||||
library implements a
|
||||
.B 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.
|
||||
|
||||
|
|
@ -21,7 +24,7 @@ library implements a SANE backend that provides the interface to the following N
|
|||
The configuration file for this backend resides in
|
||||
.IR @CONFIGDIR@/coolscan.conf .
|
||||
|
||||
Its contents is a list of device names that correspond to Nikon Coolscan scanners. Empty lines
|
||||
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:
|
||||
|
||||
|
|
@ -32,15 +35,16 @@ shown below:
|
|||
.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 have to set the
|
||||
permissions of that device, have a look at sane\-scsi.
|
||||
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:
|
||||
http://andreas.rick.free.fr/sane/autofocus.html.
|
||||
.I http://andreas.rick.free.fr/sane/autofocus.html.
|
||||
|
||||
|
||||
|
||||
|
|
@ -63,46 +67,47 @@ The shared library implementing this backend:
|
|||
.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:
|
||||
SANE_DEBUG_COOLSCAN values
|
||||
requests all debug output to be printed. Smaller levels reduce verbosity.
|
||||
|
||||
Examples:
|
||||
|
||||
on bash:
|
||||
On bash:
|
||||
.br
|
||||
export SANE_DEBUG_COOLSCAN=8
|
||||
|
||||
on csh:
|
||||
On csh:
|
||||
.br
|
||||
setenv SANE_DEBUG_COOLSCAN 8
|
||||
|
||||
.SH BUGS
|
||||
|
||||
The autofocus command does not work with some SCSI card/driver combinations
|
||||
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
|
||||
The dust-removal is not working yet.
|
||||
|
||||
.SH SEE ALSO
|
||||
|
||||
.TP
|
||||
.I http://andreas.rick.free.fr/sane/
|
||||
The homepage of this backend
|
||||
The homepage of this backend.
|
||||
.TP
|
||||
.I http://www.sema.be/coolscan/
|
||||
The original version of the coolscan backend by Didier
|
||||
The original version of the coolscan backend by Didier.
|
||||
.PP
|
||||
sane(7), sane\-scsi(5)
|
||||
.BR sane (7),
|
||||
.BR sane\-scsi (5)
|
||||
|
||||
.SH THANKS TO
|
||||
|
||||
.PP
|
||||
Didier Carlier \- For writing the original Coolscan backend (without it I would not have started this)
|
||||
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.
|
||||
All the other people working on
|
||||
.BR SANE .
|
||||
|
||||
.SH AUTHOR
|
||||
Andreas Rick
|
||||
|
|
|
|||
|
|
@ -36,44 +36,59 @@ 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.
|
||||
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
|
||||
Valid command line options and their syntax can be listed by using:
|
||||
.PP
|
||||
.RS
|
||||
scanimage \-\-help \-d coolscan2:<interface>:<device>
|
||||
.RE
|
||||
.PP
|
||||
where <interface> and <device> specify the device in question, as in the
|
||||
configuration file (see next section). The \-d parameter and its argument
|
||||
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
|
||||
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 scanimage:
|
||||
syntax with which they must be supplied to
|
||||
.BR scanimage (1):
|
||||
.TP
|
||||
.I \-\-frame <n>
|
||||
.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
|
||||
.I \-\-subframe <x>
|
||||
.B \-\-subframe <x>
|
||||
This option shifts the scan window by the specified amount (default
|
||||
unit is mm).
|
||||
.TP
|
||||
.I \-\-infrared=yes/no
|
||||
.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 batch\-count=2 to obtain the
|
||||
IR information.
|
||||
If you use
|
||||
.BR scanimage (1),
|
||||
perform a batch scan with
|
||||
.B batch\-count=2
|
||||
to obtain the IR information.
|
||||
.TP
|
||||
.I \-\-depth <n>
|
||||
.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
|
||||
|
|
@ -81,36 +96,36 @@ 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
|
||||
.B \-\-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
|
||||
.B \-\-ae\-wb
|
||||
.TP
|
||||
.I \-\-ae
|
||||
.B \-\-ae
|
||||
Perform a pre-scan to calculate exposure values automatically.
|
||||
.I \-\-ae\-wb
|
||||
.B \-\-ae\-wb
|
||||
will maintain the white balance, while
|
||||
.I \-\-ae
|
||||
.B \-\-ae
|
||||
will adjust each channel separately.
|
||||
.TP
|
||||
.I \-\-exposure
|
||||
.B \-\-exposure
|
||||
Multiply all exposure times with this value. This allows exposure
|
||||
correction without modifying white balance.
|
||||
.TP
|
||||
.I \-\-load
|
||||
.B \-\-load
|
||||
Load the next slide when using the slide loader.
|
||||
.TP
|
||||
.I \-\-eject
|
||||
.B \-\-eject
|
||||
Eject the film strip or mounted slide when using the slide loader.
|
||||
.TP
|
||||
.I \-\-reset
|
||||
.B \-\-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
|
||||
.B \-\-eject
|
||||
does not work.
|
||||
|
||||
.SH CONFIGURATION FILE
|
||||
|
|
@ -127,7 +142,7 @@ 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
|
||||
devices with known identifiers. This is the default action when no
|
||||
configuration file is present.
|
||||
.TP
|
||||
.I a line of the form <interface>:<device>
|
||||
|
|
@ -157,7 +172,11 @@ 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)
|
||||
.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
|
||||
|
|
|
|||
|
|
@ -5,7 +5,9 @@ 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
|
||||
library implements a
|
||||
.B 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
|
||||
|
|
@ -31,49 +33,63 @@ LS-8000 ED IEEE 1394
|
|||
.ft R
|
||||
.RE
|
||||
|
||||
Please send mail to sane-devel@alioth-lists.debian.net to report successes
|
||||
or failures.
|
||||
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 scanimage or through GUI elements in xscanimage or xsane.
|
||||
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
|
||||
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 \-d parameter and its argument
|
||||
can be omitted to obtain information on the first scanner identified. Use
|
||||
the command
|
||||
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
|
||||
to list all devices recognized by your SANE installation.
|
||||
.PP
|
||||
to list all devices recognized by your
|
||||
.B 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:
|
||||
syntax with which they must be supplied to
|
||||
.BR scanimage (1):
|
||||
.TP
|
||||
.I \-\-frame <n>
|
||||
.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
|
||||
.I \-\-subframe <x>
|
||||
.B \-\-subframe <x>
|
||||
This option shifts the scan window by the specified amount (default
|
||||
unit is mm).
|
||||
.TP
|
||||
.I \-\-infrared=yes/no
|
||||
.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 batch\-count=2 to obtain the
|
||||
IR information.
|
||||
If you use scanimage, perform a batch scan with
|
||||
.B batch\-count=2
|
||||
to obtain the IR information.
|
||||
.TP
|
||||
.I \-\-depth <n>
|
||||
.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
|
||||
|
|
@ -81,43 +97,45 @@ 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
|
||||
.B \-\-autofocus
|
||||
Perform autofocus operation. Unless otherwise specified by the other options (
|
||||
.I \-\-focus\-on\-centre
|
||||
.B \-\-focus\-on\-centre
|
||||
and friends), focusing is performed on the centre of the selected scan area.
|
||||
.TP
|
||||
.I \-\-ae\-wb
|
||||
.B \-\-ae\-wb
|
||||
.TP
|
||||
.I \-\-ae
|
||||
.B \-\-ae
|
||||
Perform a pre-scan to calculate exposure values automatically.
|
||||
.I \-\-ae\-wb
|
||||
.B \-\-ae\-wb
|
||||
will maintain the white balance, while
|
||||
.I \-\-ae
|
||||
.B \-\-ae
|
||||
will adjust each channel separately.
|
||||
.TP
|
||||
.I \-\-exposure
|
||||
.B \-\-exposure
|
||||
Multiply all exposure times with this value. This allows exposure
|
||||
correction without modifying white balance.
|
||||
.TP
|
||||
.I \-\-load
|
||||
.B \-\-load
|
||||
Load the next slide when using the slide loader.
|
||||
.TP
|
||||
.I \-\-eject
|
||||
.B \-\-eject
|
||||
Eject the film strip or mounted slide when using the slide loader.
|
||||
.TP
|
||||
.I \-\-reset
|
||||
.B \-\-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
|
||||
.B \-\-eject
|
||||
does not work.
|
||||
|
||||
.SH CONFIGURATION FILE
|
||||
The configuration file @CONFIGDIR@/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.
|
||||
the
|
||||
.B SANE
|
||||
distribution should work without being edited.
|
||||
|
||||
Each line in the configuration file is either of the following, where all
|
||||
entries are case-sensitive:
|
||||
|
|
@ -133,7 +151,9 @@ configuration file is present.
|
|||
.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.
|
||||
module in the kernel and appear to
|
||||
.B SANE
|
||||
as SCSI devices.
|
||||
|
||||
.SH FILES
|
||||
.TP
|
||||
|
|
@ -157,10 +177,16 @@ 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)
|
||||
.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
|
||||
Currently, the
|
||||
.B 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
|
||||
|
|
@ -174,8 +200,12 @@ 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.
|
||||
No real bugs currently known, please report any to the
|
||||
.B SANE
|
||||
developers' list.
|
||||
|
||||
.SH AUTHORS
|
||||
coolscan3 written by A. Zummo (a.zummo@towertech.it), based heavily on
|
||||
coolscan2 written by Andr\['a]s Major (andras@users.sourceforge.net).
|
||||
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 ).
|
||||
|
|
|
|||
24
doc/sane.man
24
doc/sane.man
|
|
@ -44,7 +44,7 @@ contains backends, documentation, networking support, and the
|
|||
command line frontend
|
||||
.BR scanimage (1).
|
||||
The frontends
|
||||
.BR xscanimage (1),
|
||||
.BR xscanimage (1),
|
||||
.BR xcam (1),
|
||||
and
|
||||
.BR scanadf (1)
|
||||
|
|
@ -227,7 +227,7 @@ Supports the CanoScan LiDE 70 USB scanner. See
|
|||
for details.
|
||||
.TP
|
||||
.B canon_pp
|
||||
Supports the CanoScan FB330P, FB630P, N340P and N640P parallel port
|
||||
Supports the CanoScan FB330P, FB630P, N340P and N640P parallel port
|
||||
scanners. See
|
||||
.BR sane\-canon_pp (5)
|
||||
for details.
|
||||
|
|
@ -241,7 +241,7 @@ for details.
|
|||
Supports Nikon Coolscan film-scanners. See
|
||||
.BR sane\-coolscan (5),
|
||||
.BR sane\-coolscan2 (5)
|
||||
and
|
||||
and
|
||||
.BR sane\-coolscan3 (5)
|
||||
for details.
|
||||
.TP
|
||||
|
|
@ -390,7 +390,7 @@ Supports some Mustek ScanExpress USB flatbed scanners. See
|
|||
for details.
|
||||
.TP
|
||||
.B mustek_usb2
|
||||
Supports scanners using the SQ113 chipset like the Mustek BearPaw 2448 TA Pro
|
||||
Supports scanners using the SQ113 chipset like the Mustek BearPaw 2448 TA Pro
|
||||
USB flatbed scanner. See
|
||||
.BR sane\-mustek_usb2 (5)
|
||||
for details.
|
||||
|
|
@ -433,7 +433,7 @@ Epson, and Canon. See
|
|||
for details.
|
||||
.TP
|
||||
.B plustek_pp
|
||||
Supports Plustek parallel port flatbed scanners using the Plustek ASIC P96001,
|
||||
Supports Plustek parallel port flatbed scanners using the Plustek ASIC P96001,
|
||||
P96003, P98001 and P98003, which includes some
|
||||
models from Plustek, KYE/Genius, Primax. See
|
||||
.BR sane\-plustek_pp (5)
|
||||
|
|
@ -475,7 +475,7 @@ Supports the Microtek ScanMaker 3840 USB scanner. See
|
|||
for details.
|
||||
.TP
|
||||
.B snapscan
|
||||
Supports AGFA SnapScan flatbed scanners including some which are
|
||||
Supports AGFA SnapScan flatbed scanners including some which are
|
||||
rebadged to other brands. See
|
||||
.BR sane\-snapscan (5)
|
||||
for details.
|
||||
|
|
@ -496,11 +496,11 @@ Supports Tamarack Artiscan flatbed scanners. See
|
|||
for details.
|
||||
.TP
|
||||
.B teco1 teco2 teco3
|
||||
Supports some TECO scanners, usually sold under the Relisys, Trust,
|
||||
Supports some TECO scanners, usually sold under the Relisys, Trust,
|
||||
Primax, Piotech, Dextra names. See
|
||||
.BR sane\-teco1 (5),
|
||||
.BR sane\-teco2 (5)
|
||||
and
|
||||
and
|
||||
.BR sane\-teco3 (5)
|
||||
for details.
|
||||
.TP
|
||||
|
|
@ -593,12 +593,12 @@ backends by dynamic loading. See
|
|||
.B net
|
||||
The
|
||||
.B SANE
|
||||
network daemon
|
||||
network daemon
|
||||
.BR saned (8)
|
||||
provides access to scanners located on different
|
||||
computers in connection with the net backend. See
|
||||
.BR sane\-net (5)
|
||||
and
|
||||
and
|
||||
.BR saned (8).
|
||||
.TP
|
||||
.B pnm
|
||||
|
|
@ -685,7 +685,7 @@ There are some links on how to find out about the protocol of a scanner:
|
|||
.PP
|
||||
If you start writing a backend or frontend or any other part of
|
||||
.BR SANE,
|
||||
please contact the sane\-devel mailing list for coordination so
|
||||
please contact the sane\-devel mailing list for coordination so
|
||||
that work is not duplicated.
|
||||
|
||||
.SH "FILES"
|
||||
|
|
@ -710,7 +710,7 @@ sure that it is detected by your operating system. For SCSI and USB scanners,
|
|||
use the
|
||||
.BR sane\-find\-scanner (1)
|
||||
utility.
|
||||
It prints one line for each scanner it has detected and some comments (#).
|
||||
It prints one line for each scanner it has detected and some comments (#).
|
||||
If
|
||||
.BR sane\-find\-scanner (1)
|
||||
finds your scanner only as root but not as normal user, the permissions for
|
||||
|
|
|
|||
Ładowanie…
Reference in New Issue