summaryrefslogtreecommitdiff
path: root/doc/sane-teco3.man
diff options
context:
space:
mode:
Diffstat (limited to 'doc/sane-teco3.man')
-rw-r--r--doc/sane-teco3.man154
1 files changed, 154 insertions, 0 deletions
diff --git a/doc/sane-teco3.man b/doc/sane-teco3.man
new file mode 100644
index 0000000..a2b041d
--- /dev/null
+++ b/doc/sane-teco3.man
@@ -0,0 +1,154 @@
+.TH sane\-teco3 5 "14 Jul 2008" "@PACKAGEVERSION@" "SANE Scanner Access Now Easy"
+.IX sane\-teco3
+.SH NAME
+sane\-teco3 \- SANE backend for TECO / RELISYS scanners
+.SH DESCRIPTION
+The
+.B sane\-teco3
+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 RELYSIS, 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 Scorpio VM3552 tested
+ Plustek OpticPro 2400SP VM3552 untested
+ PIOTECH Splendeur 3024 VM3552 tested
+ Trust Imagery 2400 SP VM3552 tested
+ Trust Imagery 4800 SP+ VM3552 tested
+ Trust Imagery 9600 SP VM3552 untested
+.fi
+.ft R
+.RE
+
+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 teco3
+.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 1200, 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 1024 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 1024 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 1024 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@/teco3.conf supports only one information: the device name to use (eg /dev/scanner).
+
+
+.SH FILES
+.TP
+.I @LIBDIR@/libsane\-teco3.a
+The static library implementing this backend.
+.TP
+.I @LIBDIR@/libsane\-teco3.so
+The shared library implementing this backend (present on systems that
+support dynamic loading).
+
+
+.SH ENVIRONMENT
+.TP
+.B SANE_DEBUG_TECO3
+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
+
+Not much.
+
+
+.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/#teco3