diff options
Diffstat (limited to 'upstream/debian-unstable/man5/sane-teco2.5')
| -rw-r--r-- | upstream/debian-unstable/man5/sane-teco2.5 | 257 |
1 files changed, 257 insertions, 0 deletions
diff --git a/upstream/debian-unstable/man5/sane-teco2.5 b/upstream/debian-unstable/man5/sane-teco2.5 new file mode 100644 index 00000000..5bf3ef8f --- /dev/null +++ b/upstream/debian-unstable/man5/sane-teco2.5 @@ -0,0 +1,257 @@ +.TH sane\-teco2 5 "14 Jul 2008" "" "SANE Scanner Access Now Easy" +.IX sane\-teco2 +.SH NAME +sane\-teco2 \- SANE backend for TECO / RELISYS scanners +.SH DESCRIPTION +The +.B sane\-teco2 +library implements a SANE (Scanner Access Now Easy) backend that +provides access to some TECO SCSI flatbed scanners. This backend +should be considered +.B beta-quality +software! TECO scanners are sold under +various brands like Mustek, Relisys, Piotech, Primax, TRUST. +This backend may or may not support yours. +.PP +The scanners that should work with this backend are: +.PP +.RS +.ft CR +.nf + Vendor Model TECO model status +--------------------------- -------------- ----------- + Mustek ScanMagic 4830S VM3575 untested + Primax Jewel 4800 VM356A good + Primax Profi 9600 VM6575 basic + Primax Profi 19200 VM6586 good + Relisys APOLLO Express 3 VM356A basic + Relisys APOLLO Express 6 VM6565 good + Relisys APOLLO Express 12 ? untested + Relisys AVEC II S3 VM3564 good + Relisys AVEC Super 3 VM3575 basic + Relisys SCORPIO Pro VM6575 good + Relisys SCORPIO Pro-S VM6586 untested + Relisys SCORPIO Super 3 VM3575 good +.fi +.ft R +.RE + +For all these scanners, lineart and gray mode work +well. However, most of them do not support more than a handful of +resolutions in color mode. See the backend home page (under AUTHOR) +for the exact status of each scanner. + +Note that the untested scanner will not be directly supported. You +should contact the author for that. + +The TECO VM number can usually be found at the back of the +scanner. It is also part of the FCC ID. + +The options the backend supports can either be selected through +command line options to programs like +.BR scanimage (1) +or through GUI +elements in +.BR xscanimage (1), +.BR xsane (1), +.BR quiteinsane (1) +or +.BR kooka (1). + +.br +If you have any success with a scanner not listed here, or if you notice +any strange behavior, please report to the backend maintainer or to +the SANE mailing list. + +.SH OPTIONS +Valid command line options and their syntax can be listed by using: + +.RS +scanimage \-\-help \-d teco2 +.RE + +.TP +.B Scan Mode + +.TP +.B \-\-mode Lineart|Gray|Color +selects the basic mode of operation of the scanner. +The +.I Lineart +mode is black and white only (1 bit). +.I Gray +mode will produce 256 levels of gray (8 bits). +.I Color +will produce a 24 bits color image. + +.TP +.B \-\-resolution 1..600 +Selects the resolution for a scan. The scanner can do all resolutions +between 1 and 600, in increments of 1, for +.IR Lineart " and " Gray . +For +.IR Color , +a restricted set of resolutions are available. + +.B Note: +All values with ydpi > 300 (300 x 600) or 600 (600 x 1200) result in +a wrong proportion for the scan. The proportion can be adjusted with +the following +.BR convert (1) +command from imagemagick: +.br +.I convert \-geometry (dpi/max_xdpi * 100%)x100% +.br +max_xdpi is for the vm3575 constant with 300 dpi +e.g. 600dpi adjust with: convert \-geometry 200%x100% + +.TP +.B \-\-preview +requests a preview scan. The resolution used for that scan is 50 dpi +(for VM356A and VM6575 75 dpi) and the scan area is the maximum allowed. +The scan mode is user selected. The default is "no". + +.TP +.B Geometry options + +.TP +.B \-l, \-t, \-x, " \-y +Control the scan area: +.B \-l +sets the top left x coordinate, +.B \-t +the top left y coordinate, +.B \-x +selects the width and +.B \-y +the height of the scan area. All parameters are specified in millimeters by default. + + +.TP +.B Enhancement options + +.TP +.B \-\-custom\-gamma (no custom gamma option for the VM3564 and VM356A) +(color mode only) allows the user to specify a gamma table (see the +next 3 parameters). + +.SH OPTIONS FOR COLOR MODE +These options are valid for scan mode +.I Color +only. + +.TP +.B \-\-red\-gamma\-table +Can be used to download a user defined +gamma table for the red channel. The table must be 256 bytes long. + +.TP +.B \-\-green\-gamma\-table +Can be used to download a user defined +gamma table for the green channel. The table must be 256 bytes long. + +.TP +.B \-\-blue\-gamma\-table +Can be used to download a user defined gamma table +for the blue channel. The table must be 256 bytes long. + +.SH OPTIONS ONLY FOR VM3564, VM356A, VM3575 and VM6575 +These options are only available for VM3564, VM356A, VM3575 and VM6575 models. +.TP +.B \-\-white\-level\-r 0..64 +Selects what red radiance level should be +considered "white", when scanning some sheets by changing the calibration +value loaded into the scanner. Scale 0..64 in steps of 1. + +.TP +.B \-\-white\-level\-g 0..64 +Selects what green radiance level should be +considered "white", when scanning some sheets by changing the calibration +value loaded into the scanner. Scale 0..64 in steps of 1. + +.TP +.B \-\-white\-level\-b 0..64 +Selects what blue radiance level should be +considered "white", when scanning some sheets by changing the calibration +value loaded into the scanner. Scale 0..64 in steps of 1. + + +.SH CONFIGURATION FILE +The configuration file +.I /etc/sane.d/teco2.conf +supports only one item: the device name to use (eg +.IR /dev/scanner ). + + +.SH FILES +.TP +.I /usr/lib/x86_64-linux-gnu/sane/libsane\-teco2.a +The static library implementing this backend. +.TP +.I /usr/lib/x86_64-linux-gnu/sane/libsane\-teco2.so +The shared library implementing this backend (present on systems that +support dynamic loading). + + +.SH ENVIRONMENT +.TP +.B SANE_DEBUG_TECO2 +If the library was compiled with debug support enabled, this +environment variable controls the debug level for this backend. E.g., +a value of 128 requests all debug output to be printed. Smaller levels +reduce verbosity. +.TP +.B SANE_TECO2_CAL_ALGO +Either 0 or 1. Selects the algorithm for the calibration. A +value of 1 seems to give better scans on the VM356A, VM3575. +Feedback on it is welcome. +For VM3564, VM356A, VM3575, VM6575 default 1. +For other supported types default 0. + + +.SH LIMITATIONS +The windows TWAIN driver has many more options than this SANE +backend. However they are only software adjustments. This backend only +implements what the scanner can support. + + +.SH BUGS +Plenty. Parts of this backend are still under development. + + +.SH "SEE ALSO" +.BR sane (7), +.BR sane\-scsi (5), +.BR scanimage (1), +.BR xscanimage (1), +.BR xsane (1) + + +.SH AUTHORS +.TP +Frank Zago +.I http://www.zago.net/sane/#teco2 +.TP +The package is actively maintained by Gerard Klaver. +.I http://gkall.hobby.nl/teco2.html + + + + +.SH CREDITS + +Thanks to: +.TP +Gerard Klaver for his relentless VM3575 testings and contributed a patch to support the VM3564 and VM356A. +.TP +Mark Plowman for providing the first SCSI traces from a VM3575. +.TP +Andreas Klaedtke for providing the first SCSI traces from a VM6586 and for his testing, and to Stefan von Dombrowski for his testing. +.TP +Nicolas Peyresaubes for providing the first SCSI traces from a VM656A and for his testing. +.TP +Dave Parker for testing the support for the VM6575. +.TP +Michael Hoeller for testing the support for the VM356A. +.TP +Christoph Hoeffner for testing the support for the VM3564 (Relisys AVEC II S3 firmware 1.09). |