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/lib*/sane/libsane-qcam.a
44              The static library implementing this backend.
45
46       /usr/lib*/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.  Under UNIX, the directories
54              are  separated  by a colon (`:'), under OS/2, they are separated
55              by a semi-colon (`;').  If this variable is not set, the config‐
56              uration  file is searched in two default directories: first, the
57              current working directory (".") and then in /etc/sane.d.  If the
58              value  of the environment variable ends with the directory sepa‐
59              rator character, then the default directories are searched after
60              the  explicitly  specified  directories.   For  example, setting
61              SANE_CONFIG_DIR to "/tmp/config:" would  result  in  directories
62              "tmp/config",  ".",  and  "/etc/sane.d"  being searched (in this
63              order).
64
65       SANE_DEBUG_QCAM
66              If the library was compiled with  debug  support  enabled,  this
67              environment  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

AUTHOR

72       David Mosberger
73

BUGS

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