sane-qcam(5) SANE Scanner Access Now Easy sane-qcam(5)
NAME
sane-qcam - SANE backend for Connectix QuickCam cameras
DESCRIPTION
The sane-qcam library implements a SANE (Scanner Access Now Easy) back-
end that provides access Connectix QuickCam cameras.
DEVICE NAMES
This backend expects device names of the form:
port
Where port is the I/O port address at which the device resides. This
address is normally specified in hexadecimal using C syntax (e.g.,
0x37b) and may be prefixed with the letter "u" (e.g., u0x37b) to force
the backend to access the camera in uni-directional mode.
CONFIGURATION
The contents of the qcam.conf file is a list port addresses that may be
connected to a Connectix QuickCam. Empty lines and everything starting
from a hash mark (#) up to the end of a line are ignored. A sample
configuration file is shown below:
0x37b # /dev/lp0
0x378 # /dev/lp1
u0x278 # /dev/lp2 forced in uni-directional mode
0x3bc # /dev/lp0 (alternate address)
In general, it is safest to list only the port addresses that really
correspond to a QuickCam. For example, if one of the listed addresses
actually connect to a printer, then starting up this backend will cause
the printer to perform a device reset (which is generally undesirable).
FILES
@CONFIGDIR@/qcam.conf
The backend configuration file (see also description of
SANE_CONFIG_DIR below).
@LIBDIR@/libsane-qcam.a
The static library implementing this backend.
@LIBDIR@/libsane-qcam.so
The shared library implementing this backend (present on systems
that support dynamic loading).
ENVIRONMENT
SANE_CONFIG_DIR
This environment variable specifies the list of directories that
may contain the configuration file. Under UNIX, the directories
are separated by a colon (`:'), under OS/2, they are separated
by a semi-colon (`;'). If this variable is not set, the config-
uration file is searched in two default directories: first, the
current working directory (".") and then in @CONFIGDIR@. If the
value of the environment variable ends with the directory sepa-
rator character, then the default directories are searched after
the explicitly specified directories. For example, setting
SANE_CONFIG_DIR to "/tmp/config:" would result in directories
"tmp/config", ".", and "@CONFIGDIR@" being searched (in this or-
der).
SANE_DEBUG_QCAM
If the library was compiled with debug support enabled, this en-
vironment variable controls the debug level for this backend.
E.g., a value of 128 requests all debug output to be printed.
Smaller levels reduce verbosity.
AUTHOR
David Mosberger
BUGS
Support is currently limited to the color version of the QuickCam. The
black-and-white camera is starting to work too, but I don't believe it
works in all cases yet. Reportedly, acquiring images of certain sizes
work fine, but others result in shifted images (sounds like a problem
due to byte-padding).
The program needs root-privileges since it needs to be able to access
the camera's I/O ports.
SEE ALSO
sane(7)
@PACKAGEVERSION@ 14 Jul 2008 sane-qcam(5)