| 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). |