sane-qcam - SANE backend for Connectix QuickCam cameras


DESCRIPTION

       The  sane-qcam  library  implements a SANE (Scanner Access
       Now Easy) backend 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  hexadeci­
       mal  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  configura­
       tion 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

       /etc/sane.d/qcam.conf
              The  backend  configuration file (see also descrip­
              tion of SANE_CONFIG_DIR below).

       /usr/lib/sane/libsane-qcam.a
              The static library implementing this backend.

       /usr/lib/sane/libsane-qcam.so
              The shared library implementing this backend  (pre­
              sent 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

              semi-colon (`;').  If this variable is not set, the
              configuration  file  is  searched  in  two  default
              directories:  first,  the current working directory
              (".") and then in /etc/sane.d.  If the value of the
              environment  variable ends with the directory sepa­
              rator character, then the default  directories  are
              searched  after  the  explicitly specified directo­
              ries.   For  example,  setting  SANE_CONFIG_DIR  to
              "/tmp/config:"    would   result   in   directories
              "tmp/config", ".", and "/etc/sane.d" being searched
              (in this order).

       SANE_DEBUG_QCAM
              If  the  library  was  compiled  with debug support
              enabled, this  environment  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-priviledges since it  needs  to  be
       able to access the camera's I/O ports.


SEE ALSO

       sane(7)


Man(1) output converted with man2html