407 lines
14 KiB
HTML
407 lines
14 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of sane-epson</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>sane-epson</H1>
|
|
Section: SANE Scanner Access Now Easy (5)<BR>Updated: 11 Jul 2008<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-epson - SANE backend for EPSON scanners
|
|
<A NAME="lbAC"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
The
|
|
<B>sane-epson</B>
|
|
|
|
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</B>
|
|
|
|
software! Most functions have been stable for a long time, but of
|
|
course new development can not and often times will not function properly from
|
|
the very first day. Please report any strange behavior to the
|
|
maintainer of the backend.
|
|
<P>
|
|
|
|
At present, the following scanners are known to work with this backend:
|
|
<P>
|
|
|
|
<DL COMPACT><DT id="1"><DD>
|
|
|
|
<PRE>
|
|
Model: Connection Type
|
|
--------------------------- -------------------
|
|
GT-5000 SCSI, parallel
|
|
GT-6000 parallel
|
|
GT-6500 SCSI (use only the line "scsi" in epson.conf)
|
|
ActionScanner II SCSI, parallel
|
|
GT-7000 SCSI
|
|
Perfection 636 SCSI
|
|
Perfection 636U USB
|
|
Perfection 610 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
|
|
Expression 636 / GT-9500 SCSI
|
|
Expression 1600 USB, SCSI, IEEE-1394
|
|
Expression 1680 USB, SCSI, IEEE-1394
|
|
CX-3200 USB
|
|
CX-5200 USB
|
|
</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 backend author (<A HREF="mailto:khk@khk.net">khk@khk.net</A>) 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 epson
|
|
</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>--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>--speed</I>
|
|
|
|
option can improve the scan speed in monochrome mode. Valid options are
|
|
"yes" or "no", the "yes" option will speed up the scan if this option
|
|
is supported.
|
|
<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>--gamma-table</I>
|
|
|
|
parameter can be used to download a user defined gamma table. The option
|
|
takes 256 values from the range 0-255. In color mode this option equally
|
|
affects the red, green, and blue channel.
|
|
<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 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
|
|
<I>--preview-speed</I>
|
|
|
|
options will increase the scan speed if this is supported by the
|
|
scanner. Valid options are "yes" and "no", the default is "no".
|
|
<P>
|
|
<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>--quick-format</I>
|
|
|
|
option lets the user select a scan area with predefined sizes. Valid
|
|
parameters are "CD", "A5 portrait", "A5 landscape", "Letter", "A4" and
|
|
"max". The default is "max", which selects the largest possible area.
|
|
<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>
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>CONFIGURATION FILE</H2>
|
|
|
|
The configuration file @CONFIGDIR@/epson.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>
|
|
A device file that is preceded by the string "USB" is treated as a scanner
|
|
connected via the Universal Serial Bus. The correct special device file has
|
|
to be created prior to using it with Sane. See the USB documentation for
|
|
more information about how to set up the USB subsystem and the required
|
|
device files.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="7"><I>@LIBDIR@/libsane-epson.a</I>
|
|
|
|
<DD>
|
|
The static library implementing this backend.
|
|
<DT id="8"><I>@LIBDIR@/libsane-epson.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="9"><B>SANE_DEBUG_EPSON</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="10"><B>SANE_DEBUG_EPSON_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="11"><B>SANE_EPSON_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?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>
|
|
The Perfection 600, Perfection 650, Perfection 660, Perfection 1250 and
|
|
Perfection 1260 are not supported by this backend.
|
|
<P>
|
|
<A NAME="lbAK"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
<P>
|
|
The package is actively maintained by Karl Heinz Kremer (<A HREF="mailto:khk@khk.net">khk@khk.net</A>). The
|
|
software is based on work by Christian Bucher and Kazuhiro Sasayama
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="12"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="13"><A HREF="#lbAC">DESCRIPTION</A><DD>
|
|
<DT id="14"><A HREF="#lbAD">OPTIONS</A><DD>
|
|
<DT id="15"><A HREF="#lbAE">CONFIGURATION FILE</A><DD>
|
|
<DT id="16"><A HREF="#lbAF">FILES</A><DD>
|
|
<DT id="17"><A HREF="#lbAG">ENVIRONMENT</A><DD>
|
|
<DT id="18"><A HREF="#lbAH">SEE ALSO</A><DD>
|
|
<DT id="19"><A HREF="#lbAI">BUGS</A><DD>
|
|
<DT id="20"><A HREF="#lbAJ">UNSUPPORTED DEVICES</A><DD>
|
|
<DT id="21"><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>
|