Debian Codegraph @

upstream/debian-unstable/man5/sane-epson2.5

raw
1 .TH sane\-epson2 5 "22 Jan 2009" "" "SANE Scanner Access Now Easy"
2 .IX sane\-epson2
3 .SH NAME
4 sane\-epson2 \- SANE backend for EPSON scanners
5 .SH DESCRIPTION
6 The
7 .B sane\-epson2
8 library implements a SANE (Scanner Access Now Easy) backend that
9 provides access to Epson flatbed scanners. This library supports
10 a similar set of scanners as the sane\-epson driver but was
11 developed to support a wider range of connections to the scanner;
12 include network access.
13 .PP
14 Because
15 .B sane\-epson
16 and
17 .B sane\-epson2
18 drivers support many of the same devices, if one
19 driver gives you problems you may try disabling it to try the other.
20 This can be done by removing the driver name from the
21 .I dll.conf
22 or perhaps by commenting out the options in
23 .I epson.conf
24 or
25 .I epson2.conf.
26 .PP
27 At present, the following scanners are known to work with this backend:
28 .PP
29 .RS
30 .ft CR
31 .nf
32 Model: Connection Type
33 --------------------------- -------------------
34 ActionScanner II SCSI, parallel
35 AcuLaser CX11 Series USB, Network
36 AcuLaser CX21 Series USB, Network
37 CX-3200 USB
38 CX-3600 USB
39 CX-3650 USB
40 CX-4050 USB
41 CX-4600 USB
42 CX-4800 USB
43 CX-5000 USB
44 CX-5200 USB
45 CX-5400 USB
46 CX-6300 USB
47 CX-6400 USB
48 CX-6500 USB
49 CX-6600 USB
50 DX-3800 USB
51 DX-5000 USB
52 DX-5050 USB
53 DX-6000 USB
54 DX-7400 USB
55 ES-300C SCSI, parallel
56 ES-300GS SCSI
57 ES-600C parallel
58 ES-1200C parallel
59 Expression 636 SCSI
60 Expression 800 SCSI
61 Expression 1600 USB, SCSI, IEEE-1394
62 Expression 1680 USB, SCSI, IEEE-1394
63 FilmScan 200 SCSI
64 GT-5000 SCSI, parallel
65 GT-5500 SCSI
66 GT-6000 parallel
67 GT-6500 parallel
68 GT-7000 SCSI
69 GT-8000 SCSI
70 GT-8500 SCSI
71 Perfection 610 USB
72 Perfection 636S SCSI
73 Perfection 636U USB
74 Perfection 640 USB
75 Perfection 1200S SCSI
76 Perfection 1200U USB
77 Perfection 1240 USB, SCSI
78 Perfection 1640 USB, SCSI
79 Perfection 1650 USB
80 Perfection 1660 USB
81 Perfection 2400 USB
82 Perfection 2450 USB, IEEE-1394
83 Perfection 3200 USB
84 Perfection 4870 USB
85 Perfection 4990 USB
86 RX-425 USB
87 RX-500 USB
88 RX-600 USB
89 RX-700 USB
90 V700 USB, IEEE-1394
91 V750 USB, IEEE-1394
92 .fi
93 .ft R
94 and many more. The official list is on the Sane web site.
95 .RE
96
97 For other scanners the software may or may not work. Please send mail to
98 the sane-backend mailing list to report success with scanners not on
99 the list or problems with scanners that are listed.
100 .SH OPTIONS
101 The options the backend supports can either be selected through command line
102 options to programs like
103 .BR scanimage (1)
104 or through GUI elements in programs like
105 .BR xscanimage (1)
106 or
107 .BR xsane (1).
108
109 Valid command line options and their syntax can be listed by using
110 .PP
111 .RS
112 scanimage \-\-help \-d epson2
113 .RE
114 .PP
115 Not all devices support all options.
116 .TP
117 .I Scan Mode
118 The
119 .B \-\-mode
120 switch selects the basic mode of operation of the scanner. Valid choices
121 are Binary, Gray and Color. The Binary mode is black and white only,
122 Gray will produce 256 levels of gray or more depending on the scanner
123 and Color means 24 bit color mode or more depending on the scanner.
124 Some scanners will internally use 36 bit color, their external interface
125 however may only support 24 bits.
126
127 The
128 .B \-\-depth
129 option selects the bit depth the scanner is using. This option is only
130 available for scanners that support more than one bit depth. Older
131 scanners will always transfer the image in 8bit mode. Newer scanners
132 allow one to select either 8 bits, 12 or 14 bits per color channel. For a
133 color scan this means an effective color depth of 36 or 42 bits over
134 all three channels. The valid choices depend on the scanner model.
135
136 The
137 .B \-\-halftoning
138 switch selects the mode that is used in Binary mode. Valid options
139 are "None", "Halftone A (Hard Tone)", "Halftone B (Soft Tone)", "Halftone C
140 (Net Screen)", "Dither A (4x4 Bayer)", "Dither B (4x4 Spiral)", "Dither C
141 (4x4 Net Screen)", "Dither D (8x4 Net Screen)", "Text Enhanced Technology",
142 "Download pattern A", and "Download pattern B".
143
144 The
145 .B \-\-dropout
146 switch selects the so called dropout color. Valid options are None,
147 Red, Green and Blue. The default is None. The dropout color is used for
148 monochrome scanning and selects the color that is not scanned. This can
149 be used to e.g. scan an original with a colored background.
150
151 The
152 .B \-\-brightness
153 switch controls the brightness of the scan. Valid options are integer
154 values from \-3 to 3. The default is 0. The larger the brightness value,
155 the brighter the image gets. If a user defined table for the gamma
156 correction is selected, the brightness parameter is not available.
157
158 The
159 .B \-\-sharpness
160 switch sets the sharpness of the image data. Valid options are integer
161 values from \-2 to 2, with \-2 meaning "Defocus", \-1 "Defocus slightly",
162 0 "Normal", 1 "Sharpen slightly" and 2 "Sharpen".
163
164 The
165 .B \-\-gamma\-correction
166 switch controls the scanner's internal gamma correction. Valid options are
167 "Default", "User defined", "High density printing" "Low density printing"
168 and "High contrast printing".
169
170 The
171 .B \-\-color\-correction
172 switch controls the scanner's internal color correction function. Valid
173 options are "No Correction", "Impact\-dot printers", "Thermal printers",
174 "Ink\-jet printers" and "CRT monitors". The default is "CRT monitors".
175
176 The
177 .B \-\-resolution
178 switch selects the resolution for a scan. Some EPSON scanners will scan in
179 any resolution between the lowest and highest possible value. The list
180 reported by the scanner can be displayed using the "\-\-help \-d epson"
181 parameters to
182 .BR scanimage (1).
183
184 The
185 .B \-\-threshold
186 switch selects the minimum brightness to get a white point.
187
188 The
189 .B \-\-mirror
190 option controls the way the image is scanned. By reading the image data
191 from right to left the image is mirrored. Valid options are "yes" and
192 "no". The default is "no".
193
194 The
195 .B \-\-auto\-area\-segmentation
196 switch activates the automatic area segmentation for monochrome scans. The
197 scanner will try to determine which areas are text and which contain
198 images. The image areas will be halftoned, and the text will be
199 improved. Valid options are "yes" and "no". The default is "yes".
200
201 The
202 .B \-\-red\-gamma\-table
203 parameter can be used to download a user defined gamma table for the
204 red channel. The valid options are the same as for \-\-gamma\-table.
205
206 The
207 .B \-\-green\-gamma\-table
208 parameter can be used to download a user defined gamma table for the
209 green channel. The valid options are the same as for \-\-gamma\-table.
210
211 The
212 .B \-\-blue\-gamma\-table
213 parameter can be used to download a user defined gamma table for the
214 blue channel. The valid options are the same as for \-\-gamma\-table.
215
216 The
217 .B --wait-for-button
218 parameter can be used to wait until the button on the scanner is
219 pressed to actually start the scan process.
220
221 The color correction coefficients
222 .B \-\-cct\-1 \-\-cct\-2 \-\-cct\-3 ... \-\-cct\-9
223 will install color correction coefficients for the user defined color
224 correction. Values are specified as integers in the range \-127..127.
225
226 The
227 .B \-\-preview
228 option requests a preview scan. The frontend software automatically selects a low
229 resolution. Valid options are "yes" and "no". The default is "no".
230
231 The geometry options
232 .B \-l \-t \-x \-y
233 control the scan area:
234 .B \-l
235 sets the top left x coordinate,
236 .BR \-t
237 the top left y coordinate,
238 .BR \-x
239 selects the width and
240 .BR \-y
241 the height of the scan area. All parameters are specified in millimeters.
242
243 The
244 .B \-\-source
245 option selects the scan source. Valid options depend on the installed
246 options. The default is "Flatbed".
247
248 The
249 .B \-\-auto\-eject
250 option will eject a page after scanning from the document feeder.
251
252 The
253 .B \-\-film\-type
254 option will select the film type for scans with the transparency
255 unit. This option is only activated if the TPU is selected as scan
256 source. Valid options are "Negative Film" and "Positive Film".
257
258 The
259 .B \-\-focus\-position
260 option selects the focus position for all scans. Valid options are "Focus
261 2.5mm above glass" and "Focus on glass". The focus on the 2.5mm point
262 above the glass is necessary for scans with the transparency unit, so
263 that the scanner can focus on the film if one of the film holders is used.
264 This option is only functional for selected scanners, all other scanners
265 will ignore this option.
266
267 The
268 .B \-\-bay
269 option selects which bay to scan.
270
271 The
272 .B \-\-eject
273 option ejects the sheet in the ADF.
274
275 The
276 .B \-\-adf-mode
277 option select the ADF mode (simplex/duplex).
278
279 .SH CONFIGURATION FILE
280 The configuration file
281 .I /etc/sane.d/epson2.conf
282 specifies the device(s) that the
283 backend will use. Possible connection types are:
284 .TP
285 .B SCSI
286 This is the default, and if nothing else is specified the backend software will
287 open a given path as SCSI device. More information about valid syntax for SCSI
288 devices can be found in
289 .BR sane\-scsi (5).
290 .br
291 Usually SCSI scanners are configured with a line "scsi EPSON" in this file. In
292 some cases it may be necessary to only use the string "scsi" (e.g. for the GT-6500).
293 .TP
294 .B PIO \- Parallel Interface
295 The parallel interface can be configured in two ways: An integer value starting
296 at the beginning of a line will be interpreted as the IO address of the parallel
297 port. To make it clearer that a configured IO address is a parallel port the
298 port address can be preceded by the string "PIO". The PIO connection does not
299 use a special device file in the
300 .I /dev
301 directory. The IO address can be specified
302 in hex mode (prefixed with "0x").
303 .TP
304 .B USB
305 For USB scanners not automatically detect, their VENDOR and PRODUCT ID can
306 be specified manually in the config file.
307 More information about valid syntax for USB devices can be found in
308 .BR sane\-usb (5).
309 .TP
310 .B Network
311 Network scanners can be auto-discovered if
312 .B autodiscovery
313 is specified after
314 .B net
315 keyword. An IP address to connect to can also be used.
316 .SH FILES
317 .TP
318 .I /usr/lib/x86_64-linux-gnu/sane/libsane\-epson2.a
319 The static library implementing this backend.
320 .TP
321 .I /usr/lib/x86_64-linux-gnu/sane/libsane\-epson2.so
322 The shared library implementing this backend (present on systems that
323 support dynamic loading).
324 .SH ENVIRONMENT
325 .TP
326 .B SANE_DEBUG_EPSON2
327 If the library was compiled with debug support enabled, this
328 environment variable controls the debug level for this backend. E.g.,
329 a value of 128 requests all debug output to be printed. Smaller
330 levels reduce verbosity.
331 .TP
332 .B SANE_DEBUG_EPSON2_SCSI
333 If the library was compiled with debug support enabled, this
334 environment variable controls the SCSI related debug level for this backend.
335 Only a value of 2 is supported.
336 .TP
337 .B SANE_DEBUG_EPSON2_NET
338 If the library was compiled with debug support enabled, this
339 environment variable controls the network related debug level for this
340 backend. E.g., a value of 128 requests all debug output to be printed.
341 Smaller levels reduce verbosity.
342 .TP
343 .B SANE_EPSON2_CMD_LVL
344 This allows one to override the function or command level that the backend
345 uses to communicate with the scanner. The function level a scanner
346 supports is determined during the initialization of the device. If
347 the backend does not recognize the function level reported by the
348 scanner it will default to function level B3. Valid function levels
349 are A1, A2, B1, B2, B3, B4, B5, B6, B7, B8, D1 and F5. Use this feature
350 only if you know what you are doing!
351
352 .SH "SEE ALSO"
353
354 .BR sane\-scsi (5),
355 .BR sane\-usb (5),
356 .BR scanimage (1),
357 .BR xscanimage (1),
358 .BR xsane (1)
359
360 .SH BUGS
361
362 None :-) At least none are currently known.
363
364 .SH UNSUPPORTED DEVICES
365 The backend may be used with Epson scanners that are not yet listed
366 under the list of supported devices. A scanner that is not recognized
367 may default to the function level B3, which means that not all
368 functions that the scanner may be capable of are accessible.
369
370 If the scanner is not even recognized as an Epson scanner this is
371 probably because the device name reported by the scanner is not in the
372 correct format. Please send this information to the backend maintainer
373 (email address is in the AUTHOR section of this man page or in the
374 AUTHORS file of the SANE distribution).
375
376 .SH AUTHOR
377
378 The package is written by Alessandro Zummo and is based on previous
379 work done by Karl Hienz Kremer in the epson package as well as based
380 on work by Christian Bucher and Kazuhiro Sasayama.