


sane-qcam(5)                                         sane-qcam(5)


NNAAMMEE
       sane-qcam - SANE backend for Connectix QuickCam cameras

DDEESSCCRRIIPPTTIIOONN
       The  ssaannee--qqccaamm  library  implements a SANE (Scanner Access
       Now Easy) backend that provides access Connectix  QuickCam
       cameras.

DDEEVVIICCEE NNAAMMEESS
       This backend expects device names of the form:

              _p_o_r_t

       Where  _p_o_r_t  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.

CCOONNFFIIGGUURRAATTIIOONN
       The  contents  of  the  _q_c_a_m_._c_o_n_f  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).

FFIILLEESS
       _/_u_s_r_/_l_o_c_a_l_/_e_t_c_/_s_a_n_e_._d_/_q_c_a_m_._c_o_n_f
              The  backend  configuration file (see also descrip-
              tion of SSAANNEE__CCOONNFFIIGG__DDIIRR below).

       _/_u_s_r_/_l_o_c_a_l_/_l_i_b_/_l_i_b_s_a_n_e_-_q_c_a_m_._a
              The static library implementing this backend.

       _/_u_s_r_/_l_o_c_a_l_/_l_i_b_/_l_i_b_s_a_n_e_-_q_c_a_m_._s_o
              The shared library implementing this backend  (pre-
              sent on systems that support dynamic loading).

EENNVVIIRROONNMMEENNTT
       SSAANNEE__CCOONNFFIIGG__DDIIRR
              This  environment  variable  specifies  the list of
              directories  that  may  contain  the  configuration
              file.  Under UNIX, the directories are separated by



                         25 October 1997                        1





sane-qcam(5)                                         sane-qcam(5)


              a colon (`:'), under OS/2, they are separated by  a
              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  /usr/local/etc/sane.d.   If  the
              value  of  the  environment  variable ends with the
              directory separator  character,  then  the  default
              directories are searched after the explicitly spec-
              ified directories.  For example, setting  SSAANNEE__CCOONN--
              FFIIGG__DDIIRR  to "/tmp/config:" would result in directo-
              ries "tmp/config", ".", and "/usr/local/etc/sane.d"
              being searched (in this order).

       SSAANNEE__DDEEBBUUGG__QQCCAAMM
              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.

AAUUTTHHOORR
       David Mosberger

BBUUGGSS
       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.
























                         25 October 1997                        2


