1sane-epson(5) SANE Scanner Access Now Easy sane-epson(5)
2
3
4
6 sane-epson - SANE backend for EPSON scanners
7
9 The sane-epson library implements a SANE (Scanner Access Now Easy)
10 backend that provides access to Epson flatbed scanners. Some functions
11 of this backend should be considered beta-quality software! Most func‐
12 tions have been stable for a long time, but of course new development
13 can not and often times will not function properly from the very first
14 day. Please report any strange behavior to the maintainer of the back‐
15 end.
16
17 At present, the following scanners are known to work with this backend:
18
19 Model: Connection Type
20 --------------------------- -------------------
21 GT-5000 SCSI, parallel
22 GT-6000 parallel
23 GT-6500 SCSI (use only the line "scsi" in epson.conf)
24 ActionScanner II SCSI, parallel
25 GT-7000 SCSI
26 Perfection 636 SCSI
27 Perfection 636U USB
28 Perfection 610 USB
29 Perfection 640 USB
30 Perfection 1200S SCSI
31 Perfection 1200U USB
32 Perfection 1240 USB, SCSI
33 Perfection 1640 USB, SCSI
34 Perfection 1650 USB
35 Perfection 1660 USB
36 Perfection 2400 USB
37 Perfection 2450 USB, IEEE-1394
38 Expression 636 / GT-9500 SCSI
39 Expression 1600 USB, SCSI, IEEE-1394
40 Expression 1680 USB, SCSI, IEEE-1394
41 CX-3200 USB
42 CX-5200 USB
43 and many more. The official list is on the Sane web site.
44
45 For other scanners the software may or may not work. Please send mail
46 to the backend author (khk@khk.net) to report success with scanners not
47 on the list or problems with scanners that are listed.
48
50 The options the backend supports can either be selected through command
51 line options to programs like scanimage or through GUI elements in pro‐
52 grams like xscanimage or xsane.
53
54 Valid command line options and their syntax can be listed by using
55 scanimage --help -d epson
56 Not all devices support all options.
57
58 Scan Mode
59 The --mode switch selects the basic mode of operation of the
60 scanner. Valid choices are Binary, Gray and Color. The Binary
61 mode is black and white only, Gray will produce 256 levels of
62 gray or more depending on the scanner and Color means 24 bit
63 color mode or more depending on the scanner. Some scanners will
64 internally use 36 bit color, their external interface however
65 may only support 24 bits.
66
67 The --depth option selects the bit depth the scanner is using.
68 This option is only available for scanners that support more
69 than one bit depth. Older scanners will always transfer the
70 image in 8bit mode. Newer scanners allow to select either 8
71 bits, 12 or 14 bits per color channel. For a color scan this
72 means an effective color depth of 36 or 42 bits over all three
73 channels. The valid choices depend on the scanner model.
74
75 The --halftoning switch selects the mode that is used in Binary
76 mode. Valid options are "None", "Halftone A (Hard Tone)",
77 "Halftone B (Soft Tone)", "Halftone C (Net Screen)", "Dither A
78 (4x4 Bayer)", "Dither B (4x4 Spiral)", "Dither C (4x4 Net
79 Screen)", "Dither D (8x4 Net Screen)", "Text Enhanced Technol‐
80 ogy", "Download pattern A", and "Download pattern B".
81
82 The --dropout switch selects the so called dropout color. Vald
83 options are None, Red, Green and Blue. The default is None. The
84 dropout color is used for monochrome scanning and selects the
85 color that is not scanned. This can be used to e.g. scan an
86 original with a colored background.
87
88 The --brightness switch controls the brightness of the scan.
89 Valid options are integer values from -3 to 3. The default is 0.
90 The larger the brightness value, the brighter the image gets. If
91 a user defined table for the gamma correction is selected, the
92 brightness parameter is not available.
93
94 The --sharpness switch sets the sharpness of the image data.
95 Valid options are integer values from -2 to 2, with -2 meaning
96 "Defocus", -1 "Defocus slightly", 0 "Normal", 1 "Sharpen
97 slightly" and 2 "Sharpen".
98
99 The --gamma-correction switch controls the scanner's internal
100 gamma correction. Valid options are "Default", "User defined",
101 "High density printing" "Low density printing" and "High con‐
102 trast printing".
103
104 The --color-correction switch controls the scanner's internal
105 color correction function. Valid options are "No Correction",
106 "Impact-dot printers", "Thermal printers", "Ink-jet printers"
107 and "CRT monitors". The default is "CRT monitors".
108
109 The --resolution switch selects the resolution for a scan. Some
110 EPSON scanners will scan in any resolution between the lowest
111 and highest possible value. The list reported by the scanner can
112 be displayed using the "--help -d epson" parameters to scanim‐
113 age.
114
115 The --mirror option controls the way the image is scanned. By
116 reading the image data from right to left the image is mirrored.
117 Valid options are "yes" and "no". The default is "no".
118
119 The --speed option can improve the scan speed in monochrome
120 mode. Valid options are "yes" or "no", the "yes" option will
121 speed up the scan if this option is supported.
122
123 The --auto-area-segmentation switch activates the automatic area
124 segmentation for monochrome scans. The scanner will try to
125 determine which areas are text and which contain images. The
126 image areas will be halftoned, and the text will be improved.
127 Valid options are "yes" and "no". The default is "yes".
128
129 The --gamma-table parameter can be used to download a user
130 defined gamma table. The option takes 256 values from the range
131 0-255. In color mode this option equally affects the red, green,
132 and blue channel.
133
134 The --red-gamma-table parameter can be used to download a user
135 defined gamma table for the red channel. The valid options are
136 the same as for --gamma-table.
137
138 The --green-gamma-table parameter can be used to download a user
139 defined gamma table for the green channel. The valid options are
140 the same as for --gamma-table.
141
142 The --blue-gamma-table parameter can be used to download a user
143 defined gamma table for the blue channel. The valid options are
144 the same as for --gamma-table.
145
146 The color correction coefficients --cct-1 --cct-2 --cct-3 ...
147 --cct-9 will install color correction coefficients for the user
148 defined color correction. Values are specified as integers in
149 the range -127..127.
150
151 The --preview option requests a preview scan. The frontend soft‐
152 ware automatically selects a low resolution. Valid options are
153 "yes" and "no". The default is "no".
154
155 The --preview-speed options will increase the scan speed if this
156 is supported by the scanner. Valid options are "yes" and "no",
157 the default is "no".
158
159
160 The geometry options -l -t -x -y control the scan area: -l sets
161 the top left x coordinate, -t the top left y coordinate, -x
162 selects the width and -y the height of the scan area. All param‐
163 eters are specified in millimeters.
164
165 The --quick-format option lets the user select a scan area with
166 predefined sizes. Valid parameters are "CD", "A5 portrait", "A5
167 landscape", "Letter", "A4" and "max". The default is "max",
168 which selects the largest possible area.
169
170 The --source option selects the scan source. Valid options
171 depend on the installed options. The default is "Flatbed".
172
173 The --auto-eject option will eject a page after scanning from
174 the document feeder.
175
176 The --film-type option will select the film type for scans with
177 the transparency unit. This option is only activated if the TPU
178 is selected as scan source. Valid options are "Negative Film"
179 and "Positive Film".
180
181 The --focus-position option selects the focus position for all
182 scans. Valid options are "Focus 2.5mm above glass" and "Focus on
183 glass". The focus on the 2.5mm point above the glass is neces‐
184 sary for scans with the transparency unit, so that the scanner
185 can focus on the film if one of the film holders is used. This
186 option is only functional for selected scanners, all other scan‐
187 ners will ignore this option.
188
189
190
192 The configuration file /etc/sane.d/epson.conf specifies the device(s)
193 that the backend will use. Possible connection types are:
194
195 SCSI This is the default, and if nothing else is specified the back‐
196 end software will open a given path as SCSI device. More infor‐
197 mation about valid syntax for SCSI devices can be found in
198 sane-scsi(5).
199 Usually SCSI scanners are configured with a line "scsi EPSON" in
200 this file. In some cases it may be necessary to only use the
201 string "scsi" (e.g. for the GT-6500).
202
203 PIO - Parallel Interface
204 The parallel interface can be configured in two ways: An integer
205 value starting at the beginning of a line will be interpreted as
206 the IO address of the parallel port. To make it clearer that a
207 configured IO address is a parallel port the port address can be
208 preceded by the string "PIO". The PIO connection does not use a
209 special device file in the /dev directory. The IO address can be
210 specified in hex mode (prefixed with "0x").
211
212 USB A device file that is preceded by the string "USB" is treated as
213 a scanner connected via the Universal Serial Bus. The correct
214 special device file has to be created prior to using it with
215 Sane. See the USB documentation for more information about how
216 to set up the USB subsystem and the required device files.
217
219 /usr/lib64/sane/libsane-epson.a
220 The static library implementing this backend.
221
222 /usr/lib64/sane/libsane-epson.so
223 The shared library implementing this backend (present on systems
224 that support dynamic loading).
225
227 SANE_DEBUG_EPSON
228 If the library was compiled with debug support enabled, this
229 environment variable controls the debug level for this backend.
230 E.g., a value of 128 requests all debug output to be printed.
231 Smaller levels reduce verbosity.
232
233 SANE_DEBUG_EPSON_SCSI
234 If the library was compiled with debug support enabled, this
235 environment variable controls the SCSI related debug level for
236 this backend. Only a value of 2 is supported.
237
238 SANE_EPSON_CMD_LVL
239 This allows to override the function or command level that the
240 backend uses to communicate with the scanner. The function level
241 a scanner supports is determined during the initialization of
242 the device. If the backend does not recognize the function level
243 reported by the scanner it will default to function level B3.
244 Valid function levels are A1, A2, B1, B2, B3, B4, B5, B6, B7,
245 B8, D1 and F5. Use this feature only if you know what you are
246 doing!
247
248
250 sane-scsi(5), scanimage(1), xscanimage(1), xsane(1)
251
252
254 None :-) At least none are currently known.
255
256
258 The backend may be used with Epson scanners that are not yet listed
259 under the list of supported devices. A scanner that is not recognized
260 may default to the function level B3, which means that not all func‐
261 tions that the scanner may be capable of are accessible.
262
263 If the scanner is not even recognized as an Epson scanner this is prob‐
264 ably because the device name reported by the scanner is not in the cor‐
265 rect format. Please send this information to the backend maintainer
266 (email address is in the AUTHOR section of this man page or in the
267 AUTHORS file of the SANE distribution).
268
269 The Perfection 600, Perfection 650, Perfection 660, Perfection 1250 and
270 Perfection 1260 are not supported by this backend.
271
272
274 The package is actively maintained by Karl Heinz Kremer (khk@khk.net).
275 The software is based on work by Christian Bucher and Kazuhiro Sasayama
276
277
278
279 11 Jul 2008 sane-epson(5)