Debian Codegraph @

upstream/debian-unstable/man5/sane-qcam.5

raw
1 .TH sane\-qcam 5 "14 Jul 2008" "" "SANE Scanner Access Now Easy"
2 .IX sane\-qcam
3 .SH NAME
4 sane\-qcam \- SANE backend for Connectix QuickCam cameras
5 .SH DESCRIPTION
6 The
7 .B sane\-qcam
8 library implements a SANE (Scanner Access Now Easy) backend that
9 provides access Connectix QuickCam cameras.
10 .SH "DEVICE NAMES"
11 This backend expects device names of the form:
12 .PP
13 .RS
14 .I port
15 .RE
16 .PP
17 where
18 .I port
19 is the I/O port address at which the device resides. This address is
20 normally specified in hexadecimal using C syntax (e.g., 0x37b) and may
21 be prefixed with the letter "u" (e.g., u0x37b) to force the backend to
22 access the camera in uni-directional mode.
23 .SH CONFIGURATION
24 The contents of the
25 .I qcam.conf
26 file is a list port addresses that may be connected to a
27 Connectix QuickCam. Empty lines and everything starting from a hash
28 mark (#) up to the end of a line are ignored. A sample configuration
29 file is shown below:
30 .PP
31 .RS
32 0x37b # /dev/lp0
33 .br
34 0x378 # /dev/lp1
35 .br
36 u0x278 # /dev/lp2 forced in uni-directional mode
37 .br
38 0x3bc # /dev/lp0 (alternate address)
39 .RE
40 .PP
41 In general, it is safest to list only the port addresses that really
42 correspond to a QuickCam. For example, if one of the listed addresses
43 actually connect to a printer, then starting up this backend will
44 cause the printer to perform a device reset (which is generally
45 undesirable).
46 .SH FILES
47 .TP
48 .I /etc/sane.d/qcam.conf
49 The backend configuration file (see also description of
50 .B SANE_CONFIG_DIR
51 below).
52 .TP
53 .I /usr/lib/x86_64-linux-gnu/sane/libsane\-qcam.a
54 The static library implementing this backend.
55 .TP
56 .I /usr/lib/x86_64-linux-gnu/sane/libsane\-qcam.so
57 The shared library implementing this backend (present on systems that
58 support dynamic loading).
59 .SH ENVIRONMENT
60 .TP
61 .B SANE_CONFIG_DIR
62 This environment variable specifies the list of directories that may
63 contain the configuration file. On *NIX systems, the directories are
64 separated by a colon (`:'), under OS/2, they are separated by a
65 semi-colon (`;'). If this variable is not set, the configuration file
66 is searched in two default directories: first, the current working
67 directory (".") and then in
68 .IR /etc/sane.d .
69 If the value of the
70 environment variable ends with the directory separator character, then
71 the default directories are searched after the explicitly specified
72 directories. For example, setting
73 .B SANE_CONFIG_DIR
74 to "/tmp/config:" would result in directories
75 .IR tmp/config ,
76 .IR . ,
77 and
78 .I /etc/sane.d
79 being searched (in this order).
80 .TP
81 .B SANE_DEBUG_QCAM
82 If the library was compiled with debug support enabled, this
83 environment variable controls the debug level for this backend. E.g.,
84 a value of 128 requests all debug output to be printed. Smaller
85 levels reduce verbosity.
86
87 .SH AUTHOR
88 David Mosberger
89
90 .SH BUGS
91 Support is currently limited to the color version of the QuickCam.
92 The black-and-white camera is starting to work too, but I don't
93 believe it works in all cases yet. Reportedly, acquiring images of
94 certain sizes work fine, but others result in shifted images (sounds
95 like a problem due to byte-padding).
96 .PP
97 The program needs root-privileges since it needs to be able to access
98 the camera's I/O ports.
99
100 .SH SEE ALSO
101 .BR sane (7)