kopia lustrzana https://gitlab.com/sane-project/backends
381 wiersze
13 KiB
Groff
381 wiersze
13 KiB
Groff
.TH sane\-epson2 5 "22 Jan 2009" "@PACKAGEVERSION@" "SANE Scanner Access Now Easy"
|
|
.IX sane\-epson2
|
|
.SH NAME
|
|
sane\-epson2 \- SANE backend for EPSON scanners
|
|
.SH DESCRIPTION
|
|
The
|
|
.B sane\-epson2
|
|
library implements a SANE (Scanner Access Now Easy) backend that
|
|
provides access to Epson flatbed scanners. This library supports
|
|
a similar set of scanners as the sane\-epson driver but was
|
|
developed to support a wider range of connections to the scanner;
|
|
include network access.
|
|
.PP
|
|
Because
|
|
.B sane\-epson
|
|
and
|
|
.B sane\-epson2
|
|
drivers support many of the same devices, if one
|
|
driver gives you problems you may try disabling it to try the other.
|
|
This can be done by removing the driver name from the
|
|
.I dll.conf
|
|
or perhaps by commenting out the options in
|
|
.I epson.conf
|
|
or
|
|
.I epson2.conf.
|
|
.PP
|
|
At present, the following scanners are known to work with this backend:
|
|
.PP
|
|
.RS
|
|
.ft CR
|
|
.nf
|
|
Model: Connection Type
|
|
--------------------------- -------------------
|
|
ActionScanner II SCSI, parallel
|
|
AcuLaser CX11 Series USB, Network
|
|
AcuLaser CX21 Series USB, Network
|
|
CX-3200 USB
|
|
CX-3600 USB
|
|
CX-3650 USB
|
|
CX-4050 USB
|
|
CX-4600 USB
|
|
CX-4800 USB
|
|
CX-5000 USB
|
|
CX-5200 USB
|
|
CX-5400 USB
|
|
CX-6300 USB
|
|
CX-6400 USB
|
|
CX-6500 USB
|
|
CX-6600 USB
|
|
DX-3800 USB
|
|
DX-5000 USB
|
|
DX-5050 USB
|
|
DX-6000 USB
|
|
DX-7400 USB
|
|
ES-300C SCSI, parallel
|
|
ES-300GS SCSI
|
|
ES-600C parallel
|
|
ES-1200C parallel
|
|
Expression 636 SCSI
|
|
Expression 800 SCSI
|
|
Expression 1600 USB, SCSI, IEEE-1394
|
|
Expression 1680 USB, SCSI, IEEE-1394
|
|
FilmScan 200 SCSI
|
|
GT-5000 SCSI, parallel
|
|
GT-5500 SCSI
|
|
GT-6000 parallel
|
|
GT-6500 parallel
|
|
GT-7000 SCSI
|
|
GT-8000 SCSI
|
|
GT-8500 SCSI
|
|
Perfection 610 USB
|
|
Perfection 636S SCSI
|
|
Perfection 636U USB
|
|
Perfection 640 USB
|
|
Perfection 1200S SCSI
|
|
Perfection 1200U USB
|
|
Perfection 1240 USB, SCSI
|
|
Perfection 1640 USB, SCSI
|
|
Perfection 1650 USB
|
|
Perfection 1660 USB
|
|
Perfection 2400 USB
|
|
Perfection 2450 USB, IEEE-1394
|
|
Perfection 3200 USB
|
|
Perfection 4870 USB
|
|
Perfection 4990 USB
|
|
RX-425 USB
|
|
RX-500 USB
|
|
RX-600 USB
|
|
RX-700 USB
|
|
V700 USB, IEEE-1394
|
|
V750 USB, IEEE-1394
|
|
.fi
|
|
.ft R
|
|
and many more. The official list is on the Sane web site.
|
|
.RE
|
|
|
|
For other scanners the software may or may not work. Please send mail to
|
|
the sane-backend mailing list to report success with scanners not on
|
|
the list or problems with scanners that are listed.
|
|
.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 programs like
|
|
.BR xscanimage (1)
|
|
or
|
|
.BR xsane (1).
|
|
|
|
Valid command line options and their syntax can be listed by using
|
|
.PP
|
|
.RS
|
|
scanimage \-\-help \-d epson2
|
|
.RE
|
|
.PP
|
|
Not all devices support all options.
|
|
.TP
|
|
.I Scan Mode
|
|
The
|
|
.B \-\-mode
|
|
switch selects the basic mode of operation of the scanner. Valid choices
|
|
are Binary, Gray and Color. The Binary mode is black and white only,
|
|
Gray will produce 256 levels of gray or more depending on the scanner
|
|
and Color means 24 bit color mode or more depending on the scanner.
|
|
Some scanners will internally use 36 bit color, their external interface
|
|
however may only support 24 bits.
|
|
|
|
The
|
|
.B \-\-depth
|
|
option selects the bit depth the scanner is using. This option is only
|
|
available for scanners that support more than one bit depth. Older
|
|
scanners will always transfer the image in 8bit mode. Newer scanners
|
|
allow one to select either 8 bits, 12 or 14 bits per color channel. For a
|
|
color scan this means an effective color depth of 36 or 42 bits over
|
|
all three channels. The valid choices depend on the scanner model.
|
|
|
|
The
|
|
.B \-\-halftoning
|
|
switch selects the mode that is used in Binary mode. Valid options
|
|
are "None", "Halftone A (Hard Tone)", "Halftone B (Soft Tone)", "Halftone C
|
|
(Net Screen)", "Dither A (4x4 Bayer)", "Dither B (4x4 Spiral)", "Dither C
|
|
(4x4 Net Screen)", "Dither D (8x4 Net Screen)", "Text Enhanced Technology",
|
|
"Download pattern A", and "Download pattern B".
|
|
|
|
The
|
|
.B \-\-dropout
|
|
switch selects the so called dropout color. Valid options are None,
|
|
Red, Green and Blue. The default is None. The dropout color is used for
|
|
monochrome scanning and selects the color that is not scanned. This can
|
|
be used to e.g. scan an original with a colored background.
|
|
|
|
The
|
|
.B \-\-brightness
|
|
switch controls the brightness of the scan. Valid options are integer
|
|
values from \-3 to 3. The default is 0. The larger the brightness value,
|
|
the brighter the image gets. If a user defined table for the gamma
|
|
correction is selected, the brightness parameter is not available.
|
|
|
|
The
|
|
.B \-\-sharpness
|
|
switch sets the sharpness of the image data. Valid options are integer
|
|
values from \-2 to 2, with \-2 meaning "Defocus", \-1 "Defocus slightly",
|
|
0 "Normal", 1 "Sharpen slightly" and 2 "Sharpen".
|
|
|
|
The
|
|
.B \-\-gamma\-correction
|
|
switch controls the scanner's internal gamma correction. Valid options are
|
|
"Default", "User defined", "High density printing" "Low density printing"
|
|
and "High contrast printing".
|
|
|
|
The
|
|
.B \-\-color\-correction
|
|
switch controls the scanner's internal color correction function. Valid
|
|
options are "No Correction", "Impact\-dot printers", "Thermal printers",
|
|
"Ink\-jet printers" and "CRT monitors". The default is "CRT monitors".
|
|
|
|
The
|
|
.B \-\-resolution
|
|
switch selects the resolution for a scan. Some EPSON scanners will scan in
|
|
any resolution between the lowest and highest possible value. The list
|
|
reported by the scanner can be displayed using the "\-\-help \-d epson"
|
|
parameters to
|
|
.BR scanimage (1).
|
|
|
|
The
|
|
.B \-\-threshold
|
|
switch selects the minimum brightness to get a white point.
|
|
|
|
The
|
|
.B \-\-mirror
|
|
option controls the way the image is scanned. By reading the image data
|
|
from right to left the image is mirrored. Valid options are "yes" and
|
|
"no". The default is "no".
|
|
|
|
The
|
|
.B \-\-auto\-area\-segmentation
|
|
switch activates the automatic area segmentation for monochrome scans. The
|
|
scanner will try to determine which areas are text and which contain
|
|
images. The image areas will be halftoned, and the text will be
|
|
improved. Valid options are "yes" and "no". The default is "yes".
|
|
|
|
The
|
|
.B \-\-red\-gamma\-table
|
|
parameter can be used to download a user defined gamma table for the
|
|
red channel. The valid options are the same as for \-\-gamma\-table.
|
|
|
|
The
|
|
.B \-\-green\-gamma\-table
|
|
parameter can be used to download a user defined gamma table for the
|
|
green channel. The valid options are the same as for \-\-gamma\-table.
|
|
|
|
The
|
|
.B \-\-blue\-gamma\-table
|
|
parameter can be used to download a user defined gamma table for the
|
|
blue channel. The valid options are the same as for \-\-gamma\-table.
|
|
|
|
The
|
|
.B --wait-for-button
|
|
parameter can be used to wait until the button on the scanner is
|
|
pressed to actually start the scan process.
|
|
|
|
The color correction coefficients
|
|
.B \-\-cct\-1 \-\-cct\-2 \-\-cct\-3 ... \-\-cct\-9
|
|
will install color correction coefficients for the user defined color
|
|
correction. Values are specified as integers in the range \-127..127.
|
|
|
|
The
|
|
.B \-\-preview
|
|
option requests a preview scan. The frontend software automatically selects a low
|
|
resolution. Valid options are "yes" and "no". The default is "no".
|
|
|
|
The geometry options
|
|
.B \-l \-t \-x \-y
|
|
control the scan area:
|
|
.B \-l
|
|
sets the top left x coordinate,
|
|
.BR \-t
|
|
the top left y coordinate,
|
|
.BR \-x
|
|
selects the width and
|
|
.BR \-y
|
|
the height of the scan area. All parameters are specified in millimeters.
|
|
|
|
The
|
|
.B \-\-source
|
|
option selects the scan source. Valid options depend on the installed
|
|
options. The default is "Flatbed".
|
|
|
|
The
|
|
.B \-\-auto\-eject
|
|
option will eject a page after scanning from the document feeder.
|
|
|
|
The
|
|
.B \-\-film\-type
|
|
option will select the film type for scans with the transparency
|
|
unit. This option is only activated if the TPU is selected as scan
|
|
source. Valid options are "Negative Film" and "Positive Film".
|
|
|
|
The
|
|
.B \-\-focus\-position
|
|
option selects the focus position for all scans. Valid options are "Focus
|
|
2.5mm above glass" and "Focus on glass". The focus on the 2.5mm point
|
|
above the glass is necessary for scans with the transparency unit, so
|
|
that the scanner can focus on the film if one of the film holders is used.
|
|
This option is only functional for selected scanners, all other scanners
|
|
will ignore this option.
|
|
|
|
The
|
|
.B \-\-bay
|
|
option selects which bay to scan
|
|
|
|
The
|
|
.B \-\-eject
|
|
option ejects the sheet in the ADF.
|
|
|
|
The
|
|
.B \-\-adf-mode
|
|
option select the ADF mode (simplex/duplex).
|
|
|
|
.SH CONFIGURATION FILE
|
|
The configuration file
|
|
.I @CONFIGDIR@/epson2.conf
|
|
specifies the device(s) that the
|
|
backend will use. Possible connection types are:
|
|
.TP
|
|
.B SCSI
|
|
This is the default, and if nothing else is specified the backend software will
|
|
open a given path as SCSI device. More information about valid syntax for SCSI
|
|
devices can be found in
|
|
.BR sane\-scsi (5).
|
|
.br
|
|
Usually SCSI scanners are configured with a line "scsi EPSON" in this file. In
|
|
some cases it may be necessary to only use the string "scsi" (e.g. for the GT-6500).
|
|
.TP
|
|
.B PIO \- Parallel Interface
|
|
The parallel interface can be configured in two ways: An integer value starting
|
|
at the beginning of a line will be interpreted as the IO address of the parallel
|
|
port. To make it clearer that a configured IO address is a parallel port the
|
|
port address can be preceded by the string "PIO". The PIO connection does not
|
|
use a special device file in the
|
|
.I /dev
|
|
directory. The IO address can be specified
|
|
in hex mode (prefixed with "0x").
|
|
.TP
|
|
.B USB
|
|
For USB scanners not automatically detect, their VENDOR and PRODUCT ID can
|
|
be specified manually in the config file.
|
|
More information about valid syntax for USB devices can be found in
|
|
.BR sane\-usb (5).
|
|
.TP
|
|
.B Network
|
|
Network scanners can be auto-discovered if
|
|
.B autodiscovery
|
|
is specified after
|
|
.B net
|
|
keyword. An IP address to connect to can also be used.
|
|
.SH FILES
|
|
.TP
|
|
.I @LIBDIR@/libsane\-epson2.a
|
|
The static library implementing this backend.
|
|
.TP
|
|
.I @LIBDIR@/libsane\-epson2.so
|
|
The shared library implementing this backend (present on systems that
|
|
support dynamic loading).
|
|
.SH ENVIRONMENT
|
|
.TP
|
|
.B SANE_DEBUG_EPSON2
|
|
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.
|
|
.TP
|
|
.B SANE_DEBUG_EPSON2_SCSI
|
|
If the library was compiled with debug support enabled, this
|
|
environment variable controls the SCSI related debug level for this backend.
|
|
Only a value of 2 is supported.
|
|
.TP
|
|
.B SANE_DEBUG_EPSON2_NET
|
|
If the library was compiled with debug support enabled, this
|
|
environment variable controls the network related debug level for this
|
|
backend. E.g., a value of 128 requests all debug output to be printed.
|
|
Smaller levels reduce verbosity.
|
|
.TP
|
|
.B SANE_EPSON2_CMD_LVL
|
|
This allows one to override the function or command level that the backend
|
|
uses to communicate with the scanner. The function level a scanner
|
|
supports is determined during the initialization of the device. If
|
|
the backend does not recognize the function level reported by the
|
|
scanner it will default to function level B3. Valid function levels
|
|
are A1, A2, B1, B2, B3, B4, B5, B6, B7, B8, D1 and F5. Use this feature
|
|
only if you know what you are doing!
|
|
|
|
.SH "SEE ALSO"
|
|
|
|
.BR sane\-scsi (5),
|
|
.BR sane\-usb (5),
|
|
.BR scanimage (1),
|
|
.BR xscanimage (1),
|
|
.BR xsane (1)
|
|
|
|
.SH BUGS
|
|
|
|
None :-) At least none are currently known.
|
|
|
|
.SH UNSUPPORTED DEVICES
|
|
The backend may be used with Epson scanners that are not yet listed
|
|
under the list of supported devices. A scanner that is not recognized
|
|
may default to the function level B3, which means that not all
|
|
functions that the scanner may be capable of are accessible.
|
|
|
|
If the scanner is not even recognized as an Epson scanner this is
|
|
probably because the device name reported by the scanner is not in the
|
|
correct format. Please send this information to the backend maintainer
|
|
(email address is in the AUTHOR section of this man page or in the
|
|
AUTHORS file of the SANE distribution).
|
|
|
|
.SH AUTHOR
|
|
|
|
The package is written by Alessandro Zummo and is based on previous
|
|
work done by Karl Hienz Kremer in the epson package as well as based
|
|
on work by Christian Bucher and Kazuhiro Sasayama.
|