~ubuntu-branches/ubuntu/saucy/sane-backends/saucy

« back to all changes in this revision

Viewing changes to doc/sane-genesys.man

  • Committer: Bazaar Package Importer
  • Author(s): Robert Ancell
  • Date: 2011-02-14 14:28:56 UTC
  • mfrom: (1.2.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20110214142856-6gxjetg88q9zctid
Tags: 1.0.22-0ubuntu1
* New upstream release
* debian/control:
  - Use standards version 3.9.1
* debian/patches/allow_dll.d_symlinks.patch:
* debian/patches/fix_epson2_cancel.patch:
* debian/patches/fix_epson2_commands.patch:
* debian/patches/fix_xerox_mfp_color_mode.patch:
* debian/patches/genesys_disable_raw_data_log.patch:
* debian/patches/no_translations.patch:
* debian/patches/saned_exit_avahi_process.patch:
* debian/patches/scsi_perfection_2450.patch:
* debian/patches/scsi_scanjet_4c.patch:
* debian/patches/xerox_mfp_new_ids.patch:
  - Applied upstream
* debian/watch:
  - Dropped, the URL is not consistent between releases

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.TH "sane\-genesys" "5" "6 Oct 2009" "@PACKAGEVERSION@" "SANE Scanner Access Now Easy"
 
1
.TH "sane\-genesys" "5" "26 Dec 2010" "@PACKAGEVERSION@" "SANE Scanner Access Now Easy"
2
2
.IX sane\-genesys
3
3
.SH "NAME"
4
 
sane\-genesys \- SANE backend for GL646 and GL841 based USB flatbed scanners
 
4
sane\-genesys \- SANE backend for GL646, GL841, GL843, GL847 and GL124 based USB flatbed scanners
5
5
.SH "DESCRIPTION"
6
6
The
7
7
.B sane\-genesys
8
8
library implements a SANE (Scanner Access Now Easy) backend that provides
9
 
access to USB flatbed scanners based on the Genesys GL646 and GL841 chips.
 
9
access to USB flatbed scanners based on the Genesys GL646, GL841 and GL847 chips.
10
10
At present, the following scanners are known to work with this backend:
11
11
.PP 
12
12
.RS
 
13
Canon LiDE 35/40/50/60/100/110/200/210
 
14
.br
 
15
Hewlett-Packard HP2300C/HP3670/HP3690
 
16
.br
13
17
Medion MD5345/MD6228/MD6274
14
18
.br 
15
 
Visioneer OneTouch 7100
16
 
.br
17
 
Hewlett-Packard HP2300C
18
 
.br 
19
 
Visioneer Strobe XP100 (rev3)/XP200/XP300/Roadwarrior
20
 
.br
21
 
Canon LiDE 35/40/50/60
 
19
Panasonic KV-SS080
 
20
.br
 
21
Plustek OpticBook 3600
22
22
.br
23
23
Pentax DSmobile 600
24
24
.br
25
 
Syscan/Ambir DocketPORT 485/487/665/685
 
25
Syscan/Ambir DocketPORT 467/485/487/665/685
 
26
.br
 
27
Visioneer OneTouch 7100/Strobe XP100 (rev3)/XP200/XP300/Roadwarrior
26
28
.br
27
29
Xerox Travel Scanner 100
28
30
.RE
40
42
or syslog) to the sane\-devel mailing list. Even if the scanner's name is only
41
43
slightly different from the models mentioned above, please let me know.
42
44
.PP 
43
 
If you own a scanner that isn't detected by the genesys backend but has a GL646
44
 
or GL841 chipset, you can try to add it to the backend. 
 
45
If you own a scanner that isn't detected by the genesys backend but has a GL646,
 
46
GL841, GL843 or GL847 chipset, you can try to add it to the backend. 
45
47
.PP 
46
48
.SH "CALIBRATION"
47
49
To give correct image quality, sheet fed scanners need to be calibrated using the
55
57
.SH EXTRAS SCAN OPTIONS
56
58
 
57
59
.B \-\-lamp\-off\-time number
 
60
.RS
58
61
        The lamp will be turned off after the given time (in minutes). A value of 0 means that the lamp won't be turned off.
 
62
.RE
59
63
 
60
64
.B \-\-threshold  percent
 
65
.RS
61
66
        0..100% (in steps of 1). Select minimum brightness to get a white point. Pixels
62
67
whith brightness below that value will be scanned as black.
 
68
.RE
63
69
 
64
70
.B \-\-disable-interpolation yes|no
 
71
.RS
65
72
        When using high resolutions where the horizontal resolution is smaller than vertical resolution,
66
73
data is expanded by software to preserve picture geometry. This can be disbled by this option to get
67
74
real scanned data.
 
75
.RE
68
76
 
69
77
.B \-\-color-filter None|Red|Green|Blue
 
78
.RS
70
79
        When using gray or lineart this option selects the used color. Using a color filter
71
80
will give a monochrome scan. CIS based scanners can to true gray when no filter (None value) is
72
81
selected.
 
82
.RE
 
83
 
 
84
.PP
 
85
Additionally, several 'software' options are exposed by the backend. These
 
86
are reimplementations of features provided natively by larger scanners, but
 
87
running on the host computer. This enables smaller machines to have similar
 
88
capabilites. Please note that these features are somewhat simplistic, and 
 
89
may not perform as well as the native implementations. Note also that these 
 
90
features all require that the driver cache the entire image in memory. This 
 
91
will almost certainly result in a reduction of scanning speed.
 
92
.PP
 
93
.B \-\-swcrop 
 
94
.RS
 
95
        Requests the driver to detect the extremities of the paper within the larger 
 
96
image, and crop the empty edges. 
 
97
.RE
 
98
.PP
 
99
.B \-\-swdeskew 
 
100
.RS
 
101
        Requests the driver to detect the rotation of the paper within the larger 
 
102
image, and counter the rotation.
 
103
.RE
 
104
.PP
 
105
.B \-\-swdespeck  \-\-despeck X
 
106
.RS
 
107
        Requests the driver to find and remove dots of X diameter or smaller from the 
 
108
image, and fill the space with the average surrounding color.
73
109
 
74
110
.PP
75
111
.SH "SYSTEM ISSUES"
129
165
increase the verbosity of the output. If the debug level is set to 1 or higher,
130
166
some debug options become available that are normally hidden. Handle them with
131
167
care. This will print messages related to core genesys functions.
 
168
.TP
 
169
.B SANE_DEBUG_GENESYS_LOW
 
170
This environment variable controls the debug level for low level functions
 
171
common to all genesys ASICs.
132
172
.TP 
133
173
.B SANE_DEBUG_GENESYS_GL646
134
174
This environment variable controls the debug level for the specific GL646 code
137
177
.B SANE_DEBUG_GENESYS_GL841
138
178
This environment variable controls the debug level for the specific GL841 code
139
179
part.
 
180
.TP 
 
181
.B SANE_DEBUG_GENESYS_GL843
 
182
This environment variable controls the debug level for the specific GL843 code
 
183
part.
 
184
.TP 
 
185
.B SANE_DEBUG_GENESYS_GL847
 
186
This environment variable controls the debug level for the specific GL847 code
 
187
part.
 
188
.TP 
 
189
.B SANE_DEBUG_GENESYS_GL124
 
190
This environment variable controls the debug level for the specific GL124 code
 
191
part.
140
192
 
141
193
 
142
194
Example (full and highly verbose output for gl646): 
143
195
.br
144
196
export SANE_DEBUG_GENESYS=255
145
197
.br
 
198
export SANE_DEBUG_GENESYS_LOW=255
 
199
.br
146
200
export SANE_DEBUG_GENESYS_GL646=255
147
201
 
148
202
.SH CREDITS
149
203
  
150
 
Jack McGill for donating several sheetfed scanners, which made possible to add support
151
 
for them in the genesys backend.
 
204
Jack McGill for donating several sheetfed and flatbed scanners, which made possible to add support
 
205
for them in the genesys backend:
 
206
.RS
 
207
Hewlett-Packard HP3670
 
208
.br 
 
209
Visioneer Strobe XP100 (rev3)/XP200/XP300/Roadwarrior
 
210
.br
 
211
Canon LiDE 200
 
212
.br
 
213
Pentax DSmobile 600
 
214
.br
 
215
Syscan/Ambir DocketPORT 467/485/487/665/685
 
216
.br
 
217
Xerox Travel Scanner 100
 
218
.RE
 
219
.TP
 
220
cncsolutions (http://www.cncsolutions.com.br) sponsored and supported the work on the Panasonic KV-SS080.
 
221
.br
152
222
 
153
223
.SH "SEE ALSO"
154
224
.BR sane (7),
174
244
 
175
245
Powersaving isn't implemented for gl646 based scanner.
176
246
.br
 
247
.TP
 
248
This backend will be much slower if not using libusb-1.0. So be sure that sane-backends is built with the --enable-libusb_1_0 option.
 
249
.br
177
250
 
178
251
.SH "BUGS"
179
252
Currently no known bug.
180
253
.PP 
181