sane-qcam(5)

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

NAME

6       sane-qcam - SANE backend for Connectix QuickCam cameras
7

DESCRIPTION

9       The sane-qcam library implements a SANE (Scanner Access Now Easy) back‐
10       end that provides access Connectix QuickCam cameras.
11

DEVICE NAMES

13       This backend expects device names of the form:
14
15              port
16
17       where port is the I/O port address at which the device  resides.   This
18       address  is  normally  specified  in  hexadecimal using C syntax (e.g.,
19       0x37b) and may be prefixed with the letter "u" (e.g., u0x37b) to  force
20       the backend to access the camera in uni-directional mode.
21

CONFIGURATION

23       The contents of the qcam.conf file is a list port addresses that may be
24       connected to a Connectix QuickCam.  Empty lines and everything starting
25       from  a  hash  mark  (#) up to the end of a line are ignored.  A sample
26       configuration file is shown below:
27
28              0x37b  # /dev/lp0
29              0x378  # /dev/lp1
30              u0x278 # /dev/lp2 forced in uni-directional mode
31              0x3bc  # /dev/lp0 (alternate address)
32
33       In general, it is safest to list only the port  addresses  that  really
34       correspond  to a QuickCam.  For example, if one of the listed addresses
35       actually connect to a printer, then starting up this backend will cause
36       the printer to perform a device reset (which is generally undesirable).
37

FILES

39       /etc/sane.d/qcam.conf
40              The   backend   configuration  file  (see  also  description  of
41              SANE_CONFIG_DIR below).
42
43       /usr/lib64/sane/libsane-qcam.a
44              The static library implementing this backend.
45
46       /usr/lib64/sane/libsane-qcam.so
47              The shared library implementing this backend (present on systems
48              that support dynamic loading).
49

ENVIRONMENT

51       SANE_CONFIG_DIR
52              This environment variable specifies the list of directories that
53              may contain the configuration file.  On *NIX systems, the direc‐
54              tories are separated by a colon (`:'), under OS/2, they are sep‐
55              arated by a semi-colon (`;').  If this variable is not set,  the
56              configuration  file  is  searched  in  two  default directories:
57              first,  the  current  working  directory  (".")  and   then   in
58              /etc/sane.d.  If the value of the environment variable ends with
59              the directory separator character, then the default  directories
60              are  searched  after  the explicitly specified directories.  For
61              example, setting SANE_CONFIG_DIR to "/tmp/config:" would  result
62              in directories tmp/config, ., and /etc/sane.d being searched (in
63              this order).
64
65       SANE_DEBUG_QCAM
66              If the library was compiled with debug support enabled, this en‐
67              vironment  variable  controls  the debug level for this backend.
68              E.g., a value of 128 requests all debug output  to  be  printed.
69              Smaller levels reduce verbosity.
70
71

AUTHOR

73       David Mosberger
74
75

BUGS

77       Support is currently limited to the color version of the QuickCam.  The
78       black-and-white camera is starting to work too, but I don't believe  it
79       works  in all cases yet.  Reportedly, acquiring images of certain sizes
80       work fine, but others result in shifted images (sounds like  a  problem
81       due to byte-padding).
82
83       The  program  needs root-privileges since it needs to be able to access
84       the camera's I/O ports.
85
86