Debian Codegraph @

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

raw
1 .TH sane\-teco2 5 "14 Jul 2008" "" "SANE Scanner Access Now Easy"
2 .IX sane\-teco2
3 .SH NAME
4 sane\-teco2 \- SANE backend for TECO / RELISYS scanners
5 .SH DESCRIPTION
6 The
7 .B sane\-teco2
8 library implements a SANE (Scanner Access Now Easy) backend that
9 provides access to some TECO SCSI flatbed scanners. This backend
10 should be considered
11 .B beta-quality
12 software! TECO scanners are sold under
13 various brands like Mustek, Relisys, Piotech, Primax, TRUST.
14 This backend may or may not support yours.
15 .PP
16 The scanners that should work with this backend are:
17 .PP
18 .RS
19 .ft CR
20 .nf
21 Vendor Model TECO model status
22 --------------------------- -------------- -----------
23 Mustek ScanMagic 4830S VM3575 untested
24 Primax Jewel 4800 VM356A good
25 Primax Profi 9600 VM6575 basic
26 Primax Profi 19200 VM6586 good
27 Relisys APOLLO Express 3 VM356A basic
28 Relisys APOLLO Express 6 VM6565 good
29 Relisys APOLLO Express 12 ? untested
30 Relisys AVEC II S3 VM3564 good
31 Relisys AVEC Super 3 VM3575 basic
32 Relisys SCORPIO Pro VM6575 good
33 Relisys SCORPIO Pro-S VM6586 untested
34 Relisys SCORPIO Super 3 VM3575 good
35 .fi
36 .ft R
37 .RE
38
39 For all these scanners, lineart and gray mode work
40 well. However, most of them do not support more than a handful of
41 resolutions in color mode. See the backend home page (under AUTHOR)
42 for the exact status of each scanner.
43
44 Note that the untested scanner will not be directly supported. You
45 should contact the author for that.
46
47 The TECO VM number can usually be found at the back of the
48 scanner. It is also part of the FCC ID.
49
50 The options the backend supports can either be selected through
51 command line options to programs like
52 .BR scanimage (1)
53 or through GUI
54 elements in
55 .BR xscanimage (1),
56 .BR xsane (1),
57 .BR quiteinsane (1)
58 or
59 .BR kooka (1).
60
61 .br
62 If you have any success with a scanner not listed here, or if you notice
63 any strange behavior, please report to the backend maintainer or to
64 the SANE mailing list.
65
66 .SH OPTIONS
67 Valid command line options and their syntax can be listed by using:
68
69 .RS
70 scanimage \-\-help \-d teco2
71 .RE
72
73 .TP
74 .B Scan Mode
75
76 .TP
77 .B \-\-mode Lineart|Gray|Color
78 selects the basic mode of operation of the scanner.
79 The
80 .I Lineart
81 mode is black and white only (1 bit).
82 .I Gray
83 mode will produce 256 levels of gray (8 bits).
84 .I Color
85 will produce a 24 bits color image.
86
87 .TP
88 .B \-\-resolution 1..600
89 Selects the resolution for a scan. The scanner can do all resolutions
90 between 1 and 600, in increments of 1, for
91 .IR Lineart " and " Gray .
92 For
93 .IR Color ,
94 a restricted set of resolutions are available.
95
96 .B Note:
97 All values with vertical resolution in dpi > 300 (300 x 600) or 600 (600 x 1200) result in
98 a wrong proportion for the scan. The proportion can be adjusted with
99 the following
100 .BR convert (1)
101 command from imagemagick:
102 .br
103 .I convert \-geometry (dpi/max_xdpi * 100%)x100%
104 .br
105 max_xdpi is for the vm3575 constant with 300 dpi
106 e.g. 600dpi adjust with: convert \-geometry 200%x100%
107
108 .TP
109 .B \-\-preview
110 requests a preview scan. The resolution used for that scan is 50 dpi
111 (for VM356A and VM6575 75 dpi) and the scan area is the maximum allowed.
112 The scan mode is user selected. The default is "no".
113
114 .TP
115 .B Geometry options
116
117 .TP
118 .B \-l, \-t, \-x, " \-y
119 Control the scan area:
120 .B \-l
121 sets the top left x coordinate,
122 .B \-t
123 the top left y coordinate,
124 .B \-x
125 selects the width and
126 .B \-y
127 the height of the scan area. All parameters are specified in millimeters by default.
128
129
130 .TP
131 .B Enhancement options
132
133 .TP
134 .B \-\-custom\-gamma (no custom gamma option for the VM3564 and VM356A)
135 (color mode only) allows the user to specify a gamma table (see the
136 next 3 parameters).
137
138 .SH OPTIONS FOR COLOR MODE
139 These options are valid for scan mode
140 .I Color
141 only.
142
143 .TP
144 .B \-\-red\-gamma\-table
145 Can be used to download a user defined
146 gamma table for the red channel. The table must be 256 bytes long.
147
148 .TP
149 .B \-\-green\-gamma\-table
150 Can be used to download a user defined
151 gamma table for the green channel. The table must be 256 bytes long.
152
153 .TP
154 .B \-\-blue\-gamma\-table
155 Can be used to download a user defined gamma table
156 for the blue channel. The table must be 256 bytes long.
157
158 .SH OPTIONS ONLY FOR VM3564, VM356A, VM3575 and VM6575
159 These options are only available for VM3564, VM356A, VM3575 and VM6575 models.
160 .TP
161 .B \-\-white\-level\-r 0..64
162 Selects what red radiance level should be
163 considered "white", when scanning some sheets by changing the calibration
164 value loaded into the scanner. Scale 0..64 in steps of 1.
165
166 .TP
167 .B \-\-white\-level\-g 0..64
168 Selects what green radiance level should be
169 considered "white", when scanning some sheets by changing the calibration
170 value loaded into the scanner. Scale 0..64 in steps of 1.
171
172 .TP
173 .B \-\-white\-level\-b 0..64
174 Selects what blue radiance level should be
175 considered "white", when scanning some sheets by changing the calibration
176 value loaded into the scanner. Scale 0..64 in steps of 1.
177
178
179 .SH CONFIGURATION FILE
180 The configuration file
181 .I /etc/sane.d/teco2.conf
182 supports only one item: the device name to use (eg
183 .IR /dev/scanner ).
184
185
186 .SH FILES
187 .TP
188 .I /usr/lib/x86_64-linux-gnu/sane/libsane\-teco2.a
189 The static library implementing this backend.
190 .TP
191 .I /usr/lib/x86_64-linux-gnu/sane/libsane\-teco2.so
192 The shared library implementing this backend (present on systems that
193 support dynamic loading).
194
195
196 .SH ENVIRONMENT
197 .TP
198 .B SANE_DEBUG_TECO2
199 If the library was compiled with debug support enabled, this
200 environment variable controls the debug level for this backend. E.g.,
201 a value of 128 requests all debug output to be printed. Smaller levels
202 reduce verbosity.
203 .TP
204 .B SANE_TECO2_CAL_ALGO
205 Either 0 or 1. Selects the algorithm for the calibration. A
206 value of 1 seems to give better scans on the VM356A, VM3575.
207 Feedback on it is welcome.
208 For VM3564, VM356A, VM3575, VM6575 default 1.
209 For other supported types default 0.
210
211
212 .SH LIMITATIONS
213 The windows TWAIN driver has many more options than this SANE
214 backend. However they are only software adjustments. This backend only
215 implements what the scanner can support.
216
217
218 .SH BUGS
219 Plenty. Parts of this backend are still under development.
220
221
222 .SH "SEE ALSO"
223 .BR sane (7),
224 .BR sane\-scsi (5),
225 .BR scanimage (1),
226 .BR xscanimage (1),
227 .BR xsane (1)
228
229
230 .SH AUTHORS
231 .TP
232 Frank Zago
233 .I http://www.zago.net/sane/#teco2
234 .TP
235 The package is actively maintained by Gerard Klaver.
236 .I http://gkall.hobby.nl/teco2.html
237
238
239
240
241 .SH CREDITS
242
243 Thanks to:
244 .TP
245 Gerard Klaver for his relentless VM3575 testings and contributed a patch to support the VM3564 and VM356A.
246 .TP
247 Mark Plowman for providing the first SCSI traces from a VM3575.
248 .TP
249 Andreas Klaedtke for providing the first SCSI traces from a VM6586 and for his testing, and to Stefan von Dombrowski for his testing.
250 .TP
251 Nicolas Peyresaubes for providing the first SCSI traces from a VM656A and for his testing.
252 .TP
253 Dave Parker for testing the support for the VM6575.
254 .TP
255 Michael Hoeller for testing the support for the VM356A.
256 .TP
257 Christoph Hoeffner for testing the support for the VM3564 (Relisys AVEC II S3 firmware 1.09).