From 0387fd0e23b0a56bbe203c761b960f2e35e6e664 Mon Sep 17 00:00:00 2001 From: Frank Zago Date: Sat, 31 Aug 2002 15:49:16 +0000 Subject: [PATCH] added teco2 backend. --- doc/Makefile.in | 8 +-- doc/sane-teco2.man | 167 +++++++++++++++++++++++++++++++++++++++++++++ doc/sane.man | 7 +- 3 files changed, 175 insertions(+), 7 deletions(-) create mode 100644 doc/sane-teco2.man diff --git a/doc/Makefile.in b/doc/Makefile.in index 82ae457d7..e95b8d553 100644 --- a/doc/Makefile.in +++ b/doc/Makefile.in @@ -48,8 +48,8 @@ SECT5 = sane-abaton.5 sane-agfafocus.5 sane-apple.5 sane-as6e.5 sane-dll.5 \ sane-snapscan.5 sane-canon.5 sane-coolscan.5 sane-bh.5 sane-dc240.5 \ sane-umax_pp.5 sane-umax1220u.5 sane-sm3600.5 sane-usb.5 \ sane-mustek_usb.5 sane-sceptre.5 sane-canon_pp.5 sane-canon630u.5 \ - sane-teco1.5 sane-teco3.5 sane-test.5 sane-sp15c.5 sane-coolscan2.5 \ - sane-hpsj5s.5 + sane-teco1.5 sane-teco2.5 sane-teco3.5 sane-test.5 sane-sp15c.5 \ + sane-coolscan2.5 sane-hpsj5s.5 SECT7 = sane.7 MANPAGES = $(SECT1) $(SECT5) $(SECT7) READMES = README AUTHORS COPYING ChangeLog LEVEL2 LICENSE NEWS PROBLEMS \ @@ -85,8 +85,8 @@ DISTFILES = Makefile.in backend-writing.txt descriptions.txt \ sane-st400.man sane-tamarack.man sane-umax.man sane-umax1220u.man \ sane-umax_pp.man sane-usb.man sane-v4l.man sane.man sane.png \ sane.tex saned.man scanimage.man sane-sceptre.man sane-canon_pp.man \ - sane-teco1.man sane-teco3.man sane-test.man sane-sp15c.man sane-hpsj5s.man \ - gamma4scanimage.man + sane-teco1.man sane-teco2.man sane-teco3.man sane-test.man sane-sp15c.man \ + sane-hpsj5s.man gamma4scanimage.man .PHONY: all clean depend dist distclean html html-man install \ install-mostang sane-html uninstall diff --git a/doc/sane-teco2.man b/doc/sane-teco2.man new file mode 100644 index 000000000..2ca3c73af --- /dev/null +++ b/doc/sane-teco2.man @@ -0,0 +1,167 @@ +.TH sane-teco2 5 "19 March 2002" +.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 alpha-quality +software! TECO scanners are sold under +various brands like Relisys, Piotech, TRUST. This backend may or +may not support yours. +.PP +The scanners that should work with this backend are: +.PP +.RS + Vendor Model TECO model status +.br +---------------------- -------------- ----------- +.br + Relisys Scorpio Super 3 VM3575 tested + Apollo Express 6 VM656A tested + Scorpio Pro-S VM6586 tested + +.RE + +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 scanimage or through GUI +elements in xscanimage or xsane. + +.br +If you have any success with a scanner not listed here, or if you have +any strange behavior, please report to the backend maintainer or to +the SANE mailing list. + +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 +selects the basic mode of operation of the scanner valid choices are +.I Black & White +, +.I Grayscale +and +.I Color +The Black & White mode is black and white only (1 bit). Grayscale +will produce 256 levels of gray (8 bits). Color will produce a 24 bits +color image. + +.TP +.B --resolution +selects the resolution for a scan. The scanner can do all resolutions +between 1 and 600, in increments of 1. + + +.TP +.B Geometry options + +.TP +.B -l -t -x -y +control the scan area: -l sets the top left x coordinate, -t the top +left y coordinate, -x selects the width and -y the height of the scan +area. All parameters are specified in millimeters by default. + + +.TP +.B Enhancement options + +.TP +.B --custom-gamma +(color mode only) allows the user to specify a gamma table (see the +next 3 parameters). + +.TP +.B --red-gamma-table +(color mode only) 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 +(color mode only) 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 +(color mode only) can be used to download a user defined gamma table +for the blue channel. The table must be 256 bytes long. + + +.TP +.B --preview +requests a preview scan. The resolution used for that scan is 22 dpi +and the scan area is the maximum allowed. The scan mode is user +selected. The default is "no". + + +.SH CONFIGURATION FILE +The configuration file @CONFIGDIR@/teco2.conf supports only one information: the device name to use (eg /dev/scanner). + + +.SH FILES +.TP +.I @LIBDIR@/libsane-teco2.a +The static library implementing this backend. +.TP +.I @LIBDIR@/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. + + +.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" + +sane\-scsi(5), scanimage(1), xscanimage(1), xsane(1), sane(7) + + +.SH AUTHOR + +The package is actively maintained by Frank Zago. + http://fz.eryx.net/sane/#teco2 + +.SH CREDITS + +Thanks to: +.TP +Gerard Klaver for his relentless VM3575 testings. +.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. diff --git a/doc/sane.man b/doc/sane.man index 9c6ca10b0..4e142556a 100644 --- a/doc/sane.man +++ b/doc/sane.man @@ -262,9 +262,10 @@ sane-st400(5) for details. The SANE tamarack backend supports Tamarack Artiscan flatbed scanners. See sane-tamarack(5) for details. .TP -.B teco1 teco3 -The SANE teco1 and teco3 backends support some TECO scanners, usually -sold under the RELISYS name. See sane-teco1(5) and sane-teco3(5) for details. +.B teco1 teco2 teco3 +The SANE teco1, teco2 and teco3 backends support some TECO scanners, +usually sold under the Relisys, Trust, Primax, Piotech, Dextra +names. See sane-teco1(5), sane-teco2(5) and sane-teco3(5) for details. .TP .B umax The sane-umax backend provides access to several UMAX-SCSI-scanners and some