kopia lustrzana https://gitlab.com/sane-project/website
351 wiersze
17 KiB
HTML
351 wiersze
17 KiB
HTML
<HTML>
|
|
<HEAD>
|
|
<TITLE>sane-epson2.5</TITLE>
|
|
</HEAD>
|
|
<BODY BGCOLOR=#FFFFFF TEXT=#000000><H1 ALIGN=CENTER><IMG SRC="/images/sane.png" HEIGHT=117 WIDTH=346></H1>
|
|
<H1>sane-epson2.5</H1>
|
|
<HR>
|
|
<PRE>
|
|
<!-- Manpage converted by man2html 3.0.1 -->
|
|
<B><A HREF="sane-epson2.5.html">sane-epson2(5)</A></B> SANE Scanner Access Now Easy <B><A HREF="sane-epson2.5.html">sane-epson2(5)</A></B>
|
|
|
|
|
|
</PRE>
|
|
<H2>NAME</H2><PRE>
|
|
sane-epson2 - SANE backend for EPSON scanners
|
|
|
|
|
|
</PRE>
|
|
<H2>DESCRIPTION</H2><PRE>
|
|
The <B>sane-epson2</B> 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.
|
|
|
|
Because <B>sane-epson</B> and <B>sane-epson2</B> 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</I> or perhaps by commenting out the options in <I>epson.conf</I> or
|
|
<I>epson2.conf.</I>
|
|
|
|
At present, the following scanners are known to work with this backend:
|
|
|
|
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
|
|
and many more. The official list is on the Sane web site.
|
|
|
|
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.
|
|
|
|
|
|
</PRE>
|
|
<H2>OPTIONS</H2><PRE>
|
|
The options the backend supports can either be selected through command
|
|
line options to programs like <B><A HREF="scanimage.1.html">scanimage(1)</A></B> or through GUI elements in
|
|
programs like <B><A HREF="xscanimage.1.html">xscanimage(1)</A></B> or <B><A HREF="xsane.1.html">xsane(1)</A></B>.
|
|
|
|
Valid command line options and their syntax can be listed by using
|
|
|
|
scanimage --help -d epson2
|
|
|
|
Not all devices support all options.
|
|
|
|
<I>Scan</I> <I>Mode</I>
|
|
The <B>--mode</B> 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</B> 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</B> 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 Technol-
|
|
ogy", "Download pattern A", and "Download pattern B".
|
|
|
|
The <B>--dropout</B> 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</B> 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</B> 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</B> switch controls the scanner's internal
|
|
gamma correction. Valid options are "Default", "User defined",
|
|
"High density printing" "Low density printing" and "High con-
|
|
trast printing".
|
|
|
|
The <B>--color-correction</B> 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</B> 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 <B>scanim-</B>
|
|
<B><A HREF="age.1.html">age(1)</A></B>.
|
|
|
|
The <B>--threshold</B> switch selects the minimum brightness to get a
|
|
white point.
|
|
|
|
The <B>--mirror</B> 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</B> 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</B> 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</B> 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</B> 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</B> 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</B> <B>--cct-2</B> <B>--cct-3</B> <B>...</B>
|
|
<B>--cct-9</B> will install color correction coefficients for the user
|
|
defined color correction. Values are specified as integers in
|
|
the range -127..127.
|
|
|
|
The <B>--preview</B> option requests a preview scan. The frontend soft-
|
|
ware automatically selects a low resolution. Valid options are
|
|
"yes" and "no". The default is "no".
|
|
|
|
The geometry options <B>-l</B> <B>-t</B> <B>-x</B> <B>-y</B> control the scan area: <B>-l</B> sets
|
|
the top left x coordinate, <B>-t</B> the top left y coordinate, <B>-x</B>
|
|
selects the width and <B>-y</B> the height of the scan area. All param-
|
|
eters are specified in millimeters.
|
|
|
|
The <B>--source</B> option selects the scan source. Valid options
|
|
depend on the installed options. The default is "Flatbed".
|
|
|
|
The <B>--auto-eject</B> option will eject a page after scanning from
|
|
the document feeder.
|
|
|
|
The <B>--film-type</B> 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</B> 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 neces-
|
|
sary 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 scan-
|
|
ners will ignore this option.
|
|
|
|
The <B>--bay</B> option selects which bay to scan
|
|
|
|
The <B>--eject</B> option ejects the sheet in the ADF.
|
|
|
|
The <B>--adf-mode</B> option select the ADF mode (simplex/duplex).
|
|
|
|
|
|
</PRE>
|
|
<H2>CONFIGURATION FILE</H2><PRE>
|
|
The configuration file <I>/usr/local/etc/sane.d/epson2.conf</I> specifies the
|
|
device(s) that the backend will use. Possible connection types are:
|
|
|
|
<B>SCSI</B> This is the default, and if nothing else is specified the back-
|
|
end software will open a given path as SCSI device. More infor-
|
|
mation about valid syntax for SCSI devices can be found in
|
|
<B><A HREF="sane-scsi.5.html">sane-scsi(5)</A></B>.
|
|
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).
|
|
|
|
<B>PIO</B> <B>-</B> <B>Parallel</B> <B>Interface</B>
|
|
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</I> directory. The IO address can be
|
|
specified in hex mode (prefixed with "0x").
|
|
|
|
<B>USB</B> 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
|
|
<B><A HREF="sane-usb.5.html">sane-usb(5)</A></B>.
|
|
|
|
<B>Network</B>
|
|
Network scanners can be auto-discovered if <B>autodiscovery</B> is
|
|
specified after <B>net</B> keyword. An IP address to connect to can
|
|
also be used.
|
|
|
|
|
|
</PRE>
|
|
<H2>FILES</H2><PRE>
|
|
<I>/usr/local/lib/sane/libsane-epson2.a</I>
|
|
The static library implementing this backend.
|
|
|
|
<I>/usr/local/lib/sane/libsane-epson2.so</I>
|
|
The shared library implementing this backend (present on systems
|
|
that support dynamic loading).
|
|
|
|
|
|
</PRE>
|
|
<H2>ENVIRONMENT</H2><PRE>
|
|
<B>SANE_DEBUG_EPSON2</B>
|
|
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.
|
|
|
|
<B>SANE_DEBUG_EPSON2_SCSI</B>
|
|
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.
|
|
|
|
<B>SANE_DEBUG_EPSON2_NET</B>
|
|
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 out-
|
|
put to be printed. Smaller levels reduce verbosity.
|
|
|
|
<B>SANE_EPSON2_CMD_LVL</B>
|
|
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!
|
|
|
|
|
|
</PRE>
|
|
<H2>SEE ALSO</H2><PRE>
|
|
<B><A HREF="sane-scsi.5.html">sane-scsi(5)</A></B>, <B><A HREF="sane-usb.5.html">sane-usb(5)</A></B>, <B><A HREF="scanimage.1.html">scanimage(1)</A></B>, <B><A HREF="xscanimage.1.html">xscanimage(1)</A></B>, <B><A HREF="xsane.1.html">xsane(1)</A></B>
|
|
|
|
|
|
</PRE>
|
|
<H2>BUGS</H2><PRE>
|
|
None :-) At least none are currently known.
|
|
|
|
|
|
</PRE>
|
|
<H2>UNSUPPORTED DEVICES</H2><PRE>
|
|
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 func-
|
|
tions that the scanner may be capable of are accessible.
|
|
|
|
If the scanner is not even recognized as an Epson scanner this is prob-
|
|
ably because the device name reported by the scanner is not in the cor-
|
|
rect 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).
|
|
|
|
|
|
</PRE>
|
|
<H2>AUTHOR</H2><PRE>
|
|
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.
|
|
|
|
22 Jan 2009 <B><A HREF="sane-epson2.5.html">sane-epson2(5)</A></B>
|
|
</PRE>
|
|
<HR>
|
|
<ADDRESS>
|
|
Man(1) output converted with
|
|
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
|
|
</ADDRESS>
|
|
</BODY>
|
|
</HTML>
|