468 lines
15 KiB
HTML
468 lines
15 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of sane-epson2</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>sane-epson2</H1>
|
|
Section: SANE Scanner Access Now Easy (5)<BR>Updated: 22 Jan 2009<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="ixAAB"></A>
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
sane-epson2 - SANE backend for EPSON scanners
|
|
<A NAME="lbAC"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
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.
|
|
<P>
|
|
|
|
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>
|
|
|
|
<P>
|
|
|
|
At present, the following scanners are known to work with this backend:
|
|
<P>
|
|
|
|
<DL COMPACT><DT id="1"><DD>
|
|
|
|
<PRE>
|
|
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
|
|
</PRE>
|
|
|
|
|
|
and many more. The official list is on the Sane web site.
|
|
</DL>
|
|
|
|
<P>
|
|
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.
|
|
<A NAME="lbAD"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
The options the backend supports can either be selected through command line
|
|
options to programs like scanimage or through GUI elements in programs like
|
|
xscanimage or xsane.
|
|
<P>
|
|
Valid command line options and their syntax can be listed by using
|
|
<DL COMPACT><DT id="2"><DD>
|
|
scanimage --help -d epson2
|
|
</DL>
|
|
|
|
Not all devices support all options.
|
|
<DL COMPACT>
|
|
<DT id="3"><I>Scan Mode</I>
|
|
|
|
<DD>
|
|
The
|
|
<I>--mode</I>
|
|
|
|
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.
|
|
<P>
|
|
The
|
|
<I>--depth</I>
|
|
|
|
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.
|
|
<P>
|
|
The
|
|
<I>--halftoning</I>
|
|
|
|
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".
|
|
<P>
|
|
The
|
|
<I>--dropout</I>
|
|
|
|
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.
|
|
<P>
|
|
The
|
|
<I>--brightness</I>
|
|
|
|
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.
|
|
<P>
|
|
The
|
|
<I>--sharpness</I>
|
|
|
|
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".
|
|
<P>
|
|
The
|
|
<I>--gamma-correction</I>
|
|
|
|
switch controls the scanner's internal gamma correction. Valid options are
|
|
"Default", "User defined", "High density printing" "Low density printing"
|
|
and "High contrast printing".
|
|
<P>
|
|
The
|
|
<I>--color-correction</I>
|
|
|
|
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".
|
|
<P>
|
|
The
|
|
<I>--resolution</I>
|
|
|
|
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 scanimage.
|
|
<P>
|
|
The
|
|
<I>--threshold</I>
|
|
|
|
switch selects the minimum brightness to get a white point.
|
|
<P>
|
|
The
|
|
<I>--mirror</I>
|
|
|
|
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".
|
|
<P>
|
|
The
|
|
<I>--auto-area-segmentation</I>
|
|
|
|
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".
|
|
<P>
|
|
The
|
|
<I>--red-gamma-table</I>
|
|
|
|
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.
|
|
<P>
|
|
The
|
|
<I>--green-gamma-table</I>
|
|
|
|
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.
|
|
<P>
|
|
The
|
|
<I>--blue-gamma-table</I>
|
|
|
|
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.
|
|
<P>
|
|
The
|
|
<I>--wait-for-button</I>
|
|
|
|
parameter can be used to wait until the button on the scanner is
|
|
pressed to actually start the scan process.
|
|
<P>
|
|
The color correction coefficients
|
|
<I>--cct-1 --cct-2 --cct-3 ... --cct-9</I>
|
|
|
|
will install color correction coefficients for the user defined color
|
|
correction. Values are specified as integers in the range -127..127.
|
|
<P>
|
|
The
|
|
<I>--preview</I>
|
|
|
|
option requests a preview scan. The frontend software automatically selects a low
|
|
resolution. Valid options are "yes" and "no". The default is "no".
|
|
<P>
|
|
The geometry options
|
|
<I>-l -t -x -y</I>
|
|
|
|
control the scan area: -l sets the top left x coordinate, -t the top
|
|
left y coordinate, -x selects the width and -y the height of the scan
|
|
area. All parameters are specified in millimeters.
|
|
<P>
|
|
The
|
|
<I>--source</I>
|
|
|
|
option selects the scan source. Valid options depend on the installed
|
|
options. The default is "Flatbed".
|
|
<P>
|
|
The
|
|
<I>--auto-eject</I>
|
|
|
|
option will eject a page after scanning from the document feeder.
|
|
<P>
|
|
The
|
|
<I>--film-type</I>
|
|
|
|
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".
|
|
<P>
|
|
The
|
|
<I>--focus-position</I>
|
|
|
|
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.
|
|
<P>
|
|
The
|
|
<I>--bay</I>
|
|
|
|
option selects which bay to scan
|
|
<P>
|
|
The
|
|
<I>--eject</I>
|
|
|
|
option ejects the sheet in the ADF.
|
|
<P>
|
|
The
|
|
<I>--adf-mode</I>
|
|
|
|
option select the ADF mode (simplex/duplex).
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>CONFIGURATION FILE</H2>
|
|
|
|
The configuration file @CONFIGDIR@/epson2.conf specifies the device(s) that the
|
|
backend will use. Possible connection types are:
|
|
<DL COMPACT>
|
|
<DT id="4"><I>SCSI</I>
|
|
|
|
<DD>
|
|
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 <A HREF="/cgi-bin/man/man2html?5+sane-scsi">sane-scsi</A>(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).
|
|
<DT id="5"><I>PIO - Parallel Interface</I>
|
|
|
|
<DD>
|
|
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 /dev directory. The IO address can be specified
|
|
in hex mode (prefixed with "0x").
|
|
<DT id="6"><I>USB</I>
|
|
|
|
<DD>
|
|
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 <A HREF="/cgi-bin/man/man2html?5+sane-usb">sane-usb</A>(5).
|
|
<DT id="7"><I>Network</I>
|
|
|
|
<DD>
|
|
Network scanners can be auto-discovered if
|
|
<I>autodiscovery</I>
|
|
|
|
is specified after
|
|
<I>net</I>
|
|
|
|
keyword. An IP address to connect to can also be used.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="8"><I>@LIBDIR@/libsane-epson2.a</I>
|
|
|
|
<DD>
|
|
The static library implementing this backend.
|
|
<DT id="9"><I>@LIBDIR@/libsane-epson2.so</I>
|
|
|
|
<DD>
|
|
The shared library implementing this backend (present on systems that
|
|
support dynamic loading).
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>ENVIRONMENT</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="10"><B>SANE_DEBUG_EPSON2</B>
|
|
|
|
<DD>
|
|
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.
|
|
<DT id="11"><B>SANE_DEBUG_EPSON2_SCSI</B>
|
|
|
|
<DD>
|
|
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.
|
|
<DT id="12"><B>SANE_DEBUG_EPSON2_NET</B>
|
|
|
|
<DD>
|
|
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.
|
|
<DT id="13"><B>SANE_EPSON2_CMD_LVL</B>
|
|
|
|
<DD>
|
|
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!
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<P>
|
|
<A HREF="/cgi-bin/man/man2html?5+sane-scsi">sane-scsi</A>(5), <A HREF="/cgi-bin/man/man2html?5+sane-usb">sane-usb</A>(5), <A HREF="/cgi-bin/man/man2html?1+scanimage">scanimage</A>(1), <A HREF="/cgi-bin/man/man2html?1+xscanimage">xscanimage</A>(1), <A HREF="/cgi-bin/man/man2html?1+xsane">xsane</A>(1)
|
|
<P>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
<P>
|
|
None :-) At least none are currently known.
|
|
<P>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>UNSUPPORTED DEVICES</H2>
|
|
|
|
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.
|
|
<P>
|
|
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).
|
|
<P>
|
|
<A NAME="lbAK"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
<P>
|
|
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
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="14"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="15"><A HREF="#lbAC">DESCRIPTION</A><DD>
|
|
<DT id="16"><A HREF="#lbAD">OPTIONS</A><DD>
|
|
<DT id="17"><A HREF="#lbAE">CONFIGURATION FILE</A><DD>
|
|
<DT id="18"><A HREF="#lbAF">FILES</A><DD>
|
|
<DT id="19"><A HREF="#lbAG">ENVIRONMENT</A><DD>
|
|
<DT id="20"><A HREF="#lbAH">SEE ALSO</A><DD>
|
|
<DT id="21"><A HREF="#lbAI">BUGS</A><DD>
|
|
<DT id="22"><A HREF="#lbAJ">UNSUPPORTED DEVICES</A><DD>
|
|
<DT id="23"><A HREF="#lbAK">AUTHOR</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:06:04 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|