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