kopia lustrzana https://gitlab.com/sane-project/backends
181 wiersze
4.6 KiB
Groff
181 wiersze
4.6 KiB
Groff
.TH sane\-stv680 5 "11 Jul 2008" "@PACKAGEVERSION@" "SANE Scanner Access Now Easy"
|
|
.IX sane\-stv680
|
|
.SH NAME
|
|
sane\-stv680 \- SANE backend for STV680 camera's
|
|
.SH DESCRIPTION
|
|
The
|
|
.B sane\-stv680
|
|
library implements a SANE (Scanner Access Now Easy) backend that
|
|
provides access to some STV680 cameras. This backend
|
|
should be considered
|
|
.B beta-quality
|
|
software! STV680 cameras are sold under
|
|
various brands like Aiptek.
|
|
This backend may or may not support yours.
|
|
.PP
|
|
The cameras that should work with this backend are:
|
|
.PP
|
|
.ft CR
|
|
.nf
|
|
Vendor Model USB vendor id USB product id status
|
|
------------------------ ------------- -------------- --------
|
|
AIPTEK stv680 0x0553 0x0202 basic
|
|
Konica e-mini 0x04c8 0x0722 untested
|
|
DigitalDream l'espion XS 0x1183 0x0001 untested
|
|
Creative WebCam Go mini 0x041e 0x4007 untested
|
|
.fi
|
|
.ft R
|
|
|
|
For all these cameras, see the backend home page (under AUTHOR)
|
|
for the exact status of each camera.
|
|
|
|
For startup of this backend check that if present the stv680 kernel module is
|
|
removed or disabled.
|
|
.br
|
|
Also before using, enable the backend by editing the
|
|
.I @CONFIGDIR@/dll.conf
|
|
file, change #stv680 to stv680.
|
|
|
|
For problems with the untested cameras, you should contact the author for that.
|
|
|
|
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 xcam (1).
|
|
For both programs use the
|
|
.B \-B
|
|
option needed for size buffer.
|
|
|
|
Some frontends examples:
|
|
|
|
.br
|
|
.BR xcam (1)
|
|
.RS
|
|
xcam \-B
|
|
.RE
|
|
|
|
.BR scanimage (1):
|
|
for writing in batch mode to a file or to a new file each time:
|
|
|
|
.RS
|
|
scanimage \-B \-d stv680:libusb:001:002 \-\-batch=out.ppm \-\-batch-count 5 \-\-mode "Color RGB"
|
|
.RE
|
|
.RS
|
|
scanimage \-B \-d stv680:libusb:001:002 \-\-batch=out%d.ppm \-\-batch-count 5 \-\-mode "Color RGB"
|
|
.RE
|
|
|
|
.br
|
|
If you have any success with a camera not listed here, or if you observe
|
|
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 stv680
|
|
.RE
|
|
|
|
|
|
.TP
|
|
.B Scan Mode
|
|
|
|
.TP
|
|
.B \-\-mode
|
|
selects the basic mode of operation of the webcams valid choices.
|
|
|
|
The read resolution mode is 8 bits, output resolution is 24 bits.
|
|
Selects the resolution for a scan.
|
|
The camera can do only the resolutions listed.
|
|
.TP
|
|
.B \-\-Raw
|
|
In this mode raw data is displayed
|
|
.TP
|
|
.B \-\-Color
|
|
In this mode the bayer unshuffle is done but no color correction
|
|
.TP
|
|
.B \-\-Color_RGB
|
|
Bayer unshuffle, color correction
|
|
.TP
|
|
.B \-\-Color_RGB_TXT
|
|
Bayer unshuffle, color correction, textline with date and time is added
|
|
|
|
|
|
.TP
|
|
.B Enhancement options
|
|
|
|
.TP
|
|
.B \-\-white\-level\-r \-32..+32
|
|
Selects what red radiance level should be
|
|
considered "white", when scanning some sheets by changing the calibration
|
|
value loaded into the scanner. Scale \-32 .. 0 .. +32 in steps of 1.
|
|
|
|
.TP
|
|
.B \-\-white\-level\-g \-32..+32
|
|
Selects what green radiance level should be
|
|
considered "white", when scanning some sheets by changing the calibration i
|
|
value loaded into the scanner. Scale \-32 .. 0 .. +32 in steps of 1.
|
|
|
|
.TP
|
|
.B \-\-white\-level\-b \-32..+32
|
|
Selects what blue radiance level should be
|
|
considered "white", when scanning some sheets by changing the calibration
|
|
value loaded into the scanner. Scale \-32 .. 0 .. +32 in steps of 1.
|
|
|
|
.SH CONFIGURATION FILE
|
|
The configuration file
|
|
.I @CONFIGDIR@/stv680.conf
|
|
supports only one item: the device name to use (eg usb 0x.... 0x....).
|
|
|
|
.SH FILES
|
|
.TP
|
|
.I @LIBDIR@/libsane\-stv680.a
|
|
The static library implementing this backend.
|
|
.TP
|
|
.I @LIBDIR@/libsane\-stv680.so
|
|
The shared library implementing this backend (present on systems that
|
|
support dynamic loading).
|
|
|
|
.SH ENVIRONMENT
|
|
.TP
|
|
.B SANE_DEBUG_STV680
|
|
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 webcam can support.
|
|
|
|
.SH BUGS
|
|
.TP
|
|
Plenty. Parts of this backend are still under development.
|
|
1. Some untested cameras.
|
|
.br
|
|
2. Video streaming slow and stops sometimes (scanimage).
|
|
.br
|
|
3. Sometimes 1/3 of image is NOK (xcam).
|
|
|
|
|
|
.SH "SEE ALSO"
|
|
.BR sane(7),
|
|
.BR sane\-usb (5),
|
|
.BR scanimage (1),
|
|
.BR xcam (1)
|
|
|
|
.SH AUTHORS
|
|
Gerard Klaver
|
|
.I http://gkall.hobby.nl/stv680-aiptek.html
|
|
|
|
.SH CREDITS
|
|
.TP
|
|
Thanks to developers of the other stv680 programs:
|
|
STV680 kernel module
|
|
.br
|
|
pencam2 program
|
|
.br
|
|
.BR libghoto2 (3)
|
|
program (camlib stv0680)
|