summaryrefslogtreecommitdiff
path: root/doc/sane-teco1.man
diff options
context:
space:
mode:
Diffstat (limited to 'doc/sane-teco1.man')
-rw-r--r--doc/sane-teco1.man197
1 files changed, 197 insertions, 0 deletions
diff --git a/doc/sane-teco1.man b/doc/sane-teco1.man
new file mode 100644
index 0000000..acb4985
--- /dev/null
+++ b/doc/sane-teco1.man
@@ -0,0 +1,197 @@
+.TH sane\-teco1 5 "14 Jul 2008" "@PACKAGEVERSION@" "SANE Scanner Access Now Easy"
+.IX sane\-teco1
+.SH NAME
+sane\-teco1 \- SANE backend for TECO / RELISYS scanners
+.SH DESCRIPTION
+The
+.B sane\-teco1
+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 RELISYS, PIOTECH, 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
+---------------------- -------------- -----------
+ Relisys AVEC 2400 VM3520 tested
+ Relisys AVEC 2412 VM3520+ tested
+ Relisys AVEC 4800 VM4530 untested
+ Relisys AVEC 4816 VM4530+ untested
+ Relisys RELI 2400 VM3530 untested
+ Relisys RELI 2412 VM3530+ tested
+ Relisys RELI 2412 VM3530+ untested
+ Relisys RELI 4816 VM4540 tested
+ Relisys RELI 4830 VM4542 tested
+ Relisys RELI 9600 VM6530 untested
+ Relisys RELI 9612 VM6530* untested
+ Relisys RELI 9624 VM6530+ untested
+ Relisys RELI 9630 VM6540 untested
+ Relisys RELI DS15 VM3440 untested
+ Relisys RELI DS6 VM3420 untested
+ Dextra DF-600P VM3510 tested
+ Dextra DF-4830T VM4542 untested
+ Dextra DF-1200T+ VM3530+ untested
+ Dextra DF-9624 VM6530+ untested
+.fi
+.ft R
+.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. "sane\-find\-scanner \-v" will also show the
+scsi inquiry, and if it is a TECO scanner, the name will be there too.
+
+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 teco1
+.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 \-\-dither
+(Black & White only) select the dither mask to use. Possible values are
+.I Line art
+,
+.I 2x2
+,
+.I 3x3
+,
+.I 4x4 bayer
+,
+.I 4x4 smooth
+,
+.I 8x8 bayer
+,
+.I 8x8 smooth
+,
+.I 8x8 horizontal
+and
+.I 8x8 vertical
+
+
+.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@/teco1.conf supports only one information: the device name to use (eg /dev/scanner).
+
+
+.SH FILES
+.TP
+.I @LIBDIR@/libsane\-teco1.a
+The static library implementing this backend.
+.TP
+.I @LIBDIR@/libsane\-teco1.so
+The shared library implementing this backend (present on systems that
+support dynamic loading).
+
+
+.SH ENVIRONMENT
+.TP
+.B SANE_DEBUG_TECO1
+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
+
+None known.
+
+
+.SH "SEE ALSO"
+
+sane\-scsi(5), scanimage(1), xscanimage(1), xsane(1), sane(7)
+
+
+.SH AUTHOR
+.TP
+The package is actively maintained by Frank Zago.
+.I http://www.zago.net/sane/#teco
+
+.SH CREDITS
+
+Thanks to Gerard Delafond for the VM4542 support.
+Thanks to Jean-Yves Simon for the VM3510 support.