kopia lustrzana https://gitlab.com/sane-project/website
308 wiersze
16 KiB
HTML
308 wiersze
16 KiB
HTML
<HTML>
|
|
<HEAD>
|
|
<TITLE>sane-epson.5</TITLE>
|
|
</HEAD>
|
|
<BODY BGCOLOR=#FFFFFF TEXT=#000000><H1 ALIGN=CENTER><IMG SRC="/images/sane.png" HEIGHT=117 WIDTH=346></H1>
|
|
<H1>sane-epson.5</H1>
|
|
<HR>
|
|
<PRE>
|
|
<!-- Manpage converted by man2html 3.0.1 -->
|
|
<B><A HREF="sane-epson.5.html">sane-epson(5)</A></B> SANE Scanner Access Now Easy <B><A HREF="sane-epson.5.html">sane-epson(5)</A></B>
|
|
|
|
|
|
</PRE>
|
|
<H2>NAME</H2><PRE>
|
|
sane-epson - SANE backend for EPSON scanners
|
|
|
|
|
|
</PRE>
|
|
<H2>DESCRIPTION</H2><PRE>
|
|
The <B>sane-epson</B> library implements a SANE Scanner Access Now Easy) back-
|
|
end 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.
|
|
|
|
At present, the following scanners are known to work with this backend:
|
|
|
|
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
|
|
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 backend author (<I>khk@khk.net</I>) 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 epson
|
|
|
|
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>--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>--speed</B> 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.
|
|
|
|
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>--gamma-table</B> 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.
|
|
|
|
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 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 <B>--preview-speed</B> options will increase the scan speed if this
|
|
is supported by the scanner. 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>--quick-format</B> 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.
|
|
|
|
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.
|
|
|
|
|
|
</PRE>
|
|
<H2>CONFIGURATION FILE</H2><PRE>
|
|
The configuration file <I>/usr/local/etc/sane.d/epson.conf</I> specifies the
|
|
device(s) that the backend will use. Possible connection types are:
|
|
|
|
<I>SCSI</I> 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).
|
|
|
|
<I>PIO</I> <I>-</I> <I>Parallel</I> <I>Interface</I>
|
|
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").
|
|
|
|
<I>USB</I> 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.
|
|
|
|
|
|
</PRE>
|
|
<H2>FILES</H2><PRE>
|
|
<I>/usr/local/lib/sane/libsane-epson.a</I>
|
|
The static library implementing this backend.
|
|
|
|
<I>/usr/local/lib/sane/libsane-epson.so</I>
|
|
The shared library implementing this backend (present on systems
|
|
that support dynamic loading).
|
|
|
|
|
|
</PRE>
|
|
<H2>ENVIRONMENT</H2><PRE>
|
|
<B>SANE_DEBUG_EPSON</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_EPSON_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_EPSON_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="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).
|
|
|
|
The Perfection 600, Perfection 650, Perfection 660, Perfection 1250 and
|
|
Perfection 1260 are not supported by this backend.
|
|
|
|
|
|
</PRE>
|
|
<H2>AUTHOR</H2><PRE>
|
|
The package is actively maintained by Karl Heinz Kremer (<I>khk@khk.net</I>).
|
|
The software is based on work by Christian Bucher and Kazuhiro
|
|
Sasayama.
|
|
|
|
11 Jul 2008 <B><A HREF="sane-epson.5.html">sane-epson(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>
|