sane-stv680(5)

1sane-stv680(5)           SANE Scanner Access Now Easy           sane-stv680(5)
2
3
4

NAME

6       sane-stv680 - SANE backend for STV680 camera's
7

DESCRIPTION

9       The  sane-stv680  library  implements  a SANE (Scanner Access Now Easy)
10       backend that provides access  to  some  STV680  cameras.  This  backend
11       should  be  considered  beta-quality  software! STV680 cameras are sold
12       under various brands like Aiptek.  This backend may or may not  support
13       yours.
14
15       The cameras that should work with this backend are:
16
17       Vendor Model              USB vendor id  USB product id  status
18       ------------------------  -------------  --------------  --------
19       AIPTEK stv680                0x0553         0x0202       basic
20       Konica e-mini                0x04c8         0x0722       untested
21       DigitalDream l'espion XS     0x1183         0x0001       untested
22       Creative WebCam Go mini      0x041e         0x4007       untested
23
24       For all these cameras, see the backend home page (under AUTHOR) for the
25       exact status of each camera.
26
27       For startup of this backend check that if  present  the  stv680  kernel
28       module is removed or disabled.
29       Also    before    using,    enable   the   backend   by   editing   the
30       /etc/sane.d/dll.conf file, change #stv680 to stv680.
31
32       For problems with the untested cameras, you should contact  the  author
33       for that.
34
35       The options the backend supports can either be selected through command
36       line options to programs like scanimage(1) or through GUI  elements  in
37       xcam(1).  For both programs use the -B option needed for size buffer.
38
39       Some frontends examples:
40
41       xcam(1)
42              xcam -B
43
44       scanimage(1): for writing in batch mode to a file or to a new file each
45       time:
46
47              scanimage -B -d stv680:libusb:001:002  --batch=out.ppm  --batch-
48              count 5 --mode "Color RGB"
49              scanimage -B -d stv680:libusb:001:002 --batch=out%d.ppm --batch-
50              count 5 --mode "Color RGB"
51
52       If you have any success with a  camera  not  listed  here,  or  if  you
53       observe  any  strange behavior, please report to the backend maintainer
54       or to the SANE mailing list.
55
56       Valid command line options and their syntax can be listed by using:
57
58              scanimage --help -d stv680
59
60
61
62       Scan Mode
63
64
65       --mode selects the  basic  mode  of  operation  of  the  webcams  valid
66              choices.
67
68              The  read  resolution  mode  is  8 bits, output resolution is 24
69              bits.  Selects the resolution for a scan.   The  camera  can  do
70              only the resolutions listed.
71
72       --Raw  In this mode raw data is displayed
73
74       --Color
75              In this mode the bayer unshuffle is done but no color correction
76
77       --Color_RGB
78              Bayer unshuffle, color correction
79
80       --Color_RGB_TXT
81              Bayer  unshuffle,  color correction, textline with date and time
82              is added
83
84
85
86       Enhancement options
87
88
89       --white-level-r -32..+32
90              Selects what red radiance level should  be  considered  "white",
91              when  scanning  some  sheets  by  changing the calibration value
92              loaded into the scanner. Scale -32 .. 0 .. +32 in steps of 1.
93
94
95       --white-level-g -32..+32
96              Selects what green radiance level should be considered  "white",
97              when  scanning  some  sheets by changing the calibration i value
98              loaded into the scanner. Scale -32 .. 0 .. +32 in steps of 1.
99
100
101       --white-level-b -32..+32
102              Selects what blue radiance level should be  considered  "white",
103              when  scanning  some  sheets  by  changing the calibration value
104              loaded into the scanner. Scale -32 .. 0 .. +32 in steps of 1.
105
106

CONFIGURATION FILE

108       The configuration file /etc/sane.d/stv680.conf supports only one  item:
109       the device name to use (eg usb 0x.... 0x....).
110
111

FILES

113       /usr/lib64/sane/libsane-stv680.a
114              The static library implementing this backend.
115
116       /usr/lib64/sane/libsane-stv680.so
117              The shared library implementing this backend (present on systems
118              that support dynamic loading).
119
120

ENVIRONMENT

122       SANE_DEBUG_STV680
123              If the library was compiled with  debug  support  enabled,  this
124              environment  variable controls the debug level for this backend.
125              E.g., a value of 128 requests all debug output  to  be  printed.
126              Smaller levels reduce verbosity.
127
128

LIMITATIONS

130       The  windows TWAIN driver has many more options than this SANE backend.
131       However they are only software adjustments. This  backend  only  imple‐
132       ments what the webcam can support.
133
134

BUGS

136       Plenty. Parts of this backend are still under development.
137              1. Some untested cameras.
138              2. Video streaming slow and stops sometimes (scanimage).
139              3. Sometimes 1/3 of image is NOK (xcam).
140
141
142

AUTHORS

148       Gerard Klaver http://gkall.hobby.nl/stv680-aiptek.html
149
150

CREDITS

152       Thanks to developers of the other stv680 programs:
153              STV680 kernel module
154              pencam2 program
155              libghoto2(3) program (camlib stv0680)
156
157
158
159                                  11 Jul 2008                   sane-stv680(5)