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  or  through  GUI  elements  in
37       xcam. For both programs use the -B option needed for size buffer.
38
39       Some frontends examples:
40       xcam
41              xcam -B
42
43       scanimage:  for  writing  in batch mode to a file or to a new file each
44       time.
45              scanimage -B -d stv680:libusb:001:002  --batch=out.ppm  --batch-
46              count 5 --mode "Color RGB"
47              scanimage -B -d stv680:libusb:001:002 --batch=out%d.ppm --batch-
48              count 5 --mode "Color RGB"
49
50       If you have any success with a camera not listed here, or if  you  have
51       any strange behavior, please report to the backend maintainer or to the
52       SANE mailing list.
53
54       Valid command line options and their syntax can be listed by using
55              scanimage --help -d stv680
56
57
58
59       Scan Mode
60
61
62       --mode selects the  basic  mode  of  operation  of  the  webcams  valid
63              choices.
64
65              The  read  resolution  mode  is  8 bits, output resolution is 24
66              bits.  Selects the resolution for a scan.   The  camera  can  do
67              only the resolutions listed.
68
69       --Raw  In this mode raw data is displayed
70
71       --Color
72              In this mode the bayer unshuffle is done but no color correction
73
74       --Color_RGB
75              Bayer unshuffle, color correction
76
77       --Color_RGB_TXT
78              Bayer  unshuffle,  color correction, textline with date and time
79              is added
80
81
82
83       Enhancement options
84
85
86       --white-level-r
87              Selects what red radiance level should  be  considered  "white",
88              when  scanning  some  sheets  by  changing the calibration value
89              loaded into the scanner. Scale -32 .. 0 .. +32 in steps of 1.
90
91
92       --white-level-g
93              Selects what green radiance level should be considered  "white",
94              when  scanning  some  sheets by changing the calibration i value
95              loaded into the scanner. Scale -32 .. 0 .. +32 in steps of 1.
96
97
98       --white-level-b
99              Selects what blue radiance level should be  considered  "white",
100              when  scanning  some  sheets  by  changing the calibration value
101              loaded into the scanner. Scale -32 .. 0 .. +32 in steps of 1.
102
103

CONFIGURATION FILE

105       The configuration file /etc/sane.d/stv680.conf supports only one infor‐
106       mation: the device name to use (eg usb 0x.... 0x....).
107
108
109

FILES

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

ENVIRONMENT

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

LIMITATIONS

129       The  windows TWAIN driver has many more options than this SANE backend.
130       However they are only software adjustments. This  backend  only  imple‐
131       ments what the webcam can support.
132
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

149       Gerard Klaver http://gkall.hobby.nl/stv680-aiptek.html
150
151
152
153

CREDITS

155       Thanks to developers of the other stv680 programs:
156              STV680 kernel module
157              pencam2 program
158              libghoto2 program (camlib stv0680)
159
160
161
162
163sane-backends 1.0.18             09 June 2006                   sane-stv680(5)