| 1 |
.TH sane\-epsonds 5 "29 Mar 2015" "" "SANE Scanner Access Now Easy" |
| 2 |
.IX sane\-epsonds |
| 3 |
.SH NAME |
| 4 |
sane\-epsonds \- SANE backend for EPSON ESC/I-2 scanners |
| 5 |
.SH DESCRIPTION |
| 6 |
The |
| 7 |
.B sane\-epsonds |
| 8 |
library implements a SANE (Scanner Access Now Easy) backend that provides access |
| 9 |
to Epson ESC/I-2 scanners. |
| 10 |
.PP |
| 11 |
Valid command line options and their syntax can be listed by using |
| 12 |
.PP |
| 13 |
.RS |
| 14 |
scanimage \-\-help \-d epsonds |
| 15 |
.RE |
| 16 |
.PP |
| 17 |
Not all devices support all options. |
| 18 |
.TP |
| 19 |
.I Scan Mode |
| 20 |
The |
| 21 |
.B \-\-mode |
| 22 |
switch selects the basic mode of operation of the scanner. Valid choices |
| 23 |
are Lineart, Gray and Color. The Lineart mode is black and white only, |
| 24 |
Gray will produce 256 levels of gray or more depending on the scanner |
| 25 |
and Color means 24 bit color mode or more depending on the scanner. |
| 26 |
Some scanners will internally use 36 bit color, their external interface |
| 27 |
however may only support 24 bits. |
| 28 |
|
| 29 |
The |
| 30 |
.B \-\-depth |
| 31 |
option selects the bit depth the scanner is using. This option is only |
| 32 |
available for scanners that support more than one bit depth. Older |
| 33 |
scanners will always transfer the image in 8bit mode. Newer scanners |
| 34 |
allow one to select either 8 bits, 12 or 14 bits per color channel. For a |
| 35 |
color scan this means an effective color depth of 36 or 42 bits over |
| 36 |
all three channels. The valid choices depend on the scanner model. |
| 37 |
|
| 38 |
The |
| 39 |
.B \-\-resolution |
| 40 |
switch selects the resolution for a scan. Some EPSON scanners will scan in |
| 41 |
any resolution between the lowest and highest possible value. The list |
| 42 |
reported by the scanner can be displayed using the "\-\-help \-d epson" |
| 43 |
parameters to |
| 44 |
.BR scanimage (1). |
| 45 |
|
| 46 |
The geometry options |
| 47 |
.B \-l \-t \-x \-y |
| 48 |
control the scan area: |
| 49 |
.B \-l |
| 50 |
sets the top left x coordinate, |
| 51 |
.B \-t |
| 52 |
the top left y coordinate, |
| 53 |
.B \-x |
| 54 |
selects the width and |
| 55 |
.B \-y |
| 56 |
the height of the scan area. All parameters are specified in millimeters. |
| 57 |
|
| 58 |
The |
| 59 |
.B \-\-source |
| 60 |
option selects the scan source. Valid options depend on the installed |
| 61 |
options. The default is "Flatbed". |
| 62 |
|
| 63 |
The |
| 64 |
.B \-\-eject |
| 65 |
option ejects the sheet in the ADF. |
| 66 |
|
| 67 |
The |
| 68 |
.B \-\-adf-mode |
| 69 |
option select the ADF mode (simplex/duplex). |
| 70 |
|
| 71 |
.SH CONFIGURATION FILE |
| 72 |
The configuration file |
| 73 |
.I /etc/sane.d/epsonds.conf |
| 74 |
specifies the device(s) that the backend will use. Possible connection types are: |
| 75 |
.TP |
| 76 |
.B USB |
| 77 |
For not automatically detected USB scanners, their VENDOR and PRODUCT ID can |
| 78 |
be specified manually in the config file. |
| 79 |
More information about valid syntax for USB devices can be found in |
| 80 |
.BR sane\-usb (5). |
| 81 |
.TP |
| 82 |
.B Network (not yet supported) |
| 83 |
Network scanners can be auto-discovered if |
| 84 |
.B autodiscovery |
| 85 |
is specified after |
| 86 |
.B net |
| 87 |
keyword. An IP address to connect to can also be used. |
| 88 |
.SH FILES |
| 89 |
.TP |
| 90 |
.I /usr/lib/x86_64-linux-gnu/sane/libsane\-epsonds.a |
| 91 |
The static library implementing this backend. |
| 92 |
.TP |
| 93 |
.I /usr/lib/x86_64-linux-gnu/sane/libsane\-epsonds.so |
| 94 |
The shared library implementing this backend (present on systems that |
| 95 |
support dynamic loading). |
| 96 |
.SH ENVIRONMENT |
| 97 |
.TP |
| 98 |
.B SANE_DEBUG_EPSONDS |
| 99 |
If the library was compiled with debug support enabled, this |
| 100 |
environment variable controls the debug level for this backend. E.g., |
| 101 |
a value of 128 requests all debug output to be printed. Smaller |
| 102 |
levels reduce verbosity. Values around 11-16 will usually be enough for |
| 103 |
a bug report. |
| 104 |
|
| 105 |
.SH "SEE ALSO" |
| 106 |
|
| 107 |
.BR sane\-usb (5), |
| 108 |
.BR scanimage (1), |
| 109 |
.BR xscanimage (1), |
| 110 |
.BR xsane (1) |
| 111 |
|
| 112 |
.SH AUTHOR |
| 113 |
|
| 114 |
The backend is written by Alessandro Zummo. |