NAME

       sane-gphoto2 - SANE backend for gphoto2 supported cameras

DESCRIPTION

       The sane-gphoto2 library implements a SANE (Scanner Access Now Easy) backend that provides
       access to the digital cameras supported by gphoto2.  This backend  has  only  been  tested
       with a handful of cameras so far.  Patches to support other models are welcome.

       Because   of   the   limited   testing   of   this   backend,   it  is  commented  out  in
       /etc/sane.d/dll.conf by default.  Either the comment character  must  be  removed  or  the
       backend must be called explicitly.  E.g. `scanimage -d gphoto2' or `xscanimage gphoto2'.

DEVICE NAMES

       The  current  version  of  the backend only allows one camera to be connected.  The device
       name is always "0".

CONFIGURATION

       The contents of the gphoto2.conf specify the characteristics of the  camera  to  be  used.
       Resolutions  (high resolution, low resolution, and thumbnail size) are required since they
       are needed by the sane frontends, but can't be obtained  through  the  gphoto2  interface.
       Valid  ports  and  cameras  can  be  obtained  by  "gphoto2  --list-cameras"  and "gphoto2
       --list-ports".

       The dumpinquiry line causes some information about the camera to be printed.

       Empty lines and lines starting with a hash mark (#) are ignored.  A  sample  configuration
       file is shown below:

       The  "topfolder"  line  specifies  the "fixed" part of the file path.  For example, on the
       Kodak DC-240, files are stored in the directory  /DCIM/100DC240.   The  /DCIM  portion  is
       constant,  but  100DC240  will change and must be read from the camera.  In this case, the
       line would read "topfolder=/DCIM"

       Some cameras don't implement a file structure and store all pictures in the "/" directory.
       This is indicated by setting "subdirs=0" with "topfolder=/"

              port=usb:
              camera=Kodak DC240
              # this is a comment
              high_resolution=1280x960
              low_resolution=640x480
              thumb_resolution=160x120
              dumpinquiry

FILES

       /etc/sane.d/gphoto2.conf
              The backend configuration file (see also description of SANE_CONFIG_DIR below).

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

       /usr/lib/arch_triplet/sane/libsane-gphoto2.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  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 separator 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 "/etc/sane.d" being searched (in this order).

       SANE_DEBUG_GPHOTO2
              If the library was  compiled  with  debugging  support  enabled,  this  environment
              variable  controls  the  debug  level  for  this  backend.  A value of 128 requests
              maximally copious debug output; smaller levels reduce verbosity.

       GP_DEBUG
              Set to 1, 2, or 3, to  enable  various  levels  of  debugging  within  the  gphoto2
              libraries.

SEE ALSO

       sane(7)

AUTHOR

       Peter S. Fales

       The manpage was largely copied from the dc210 manpage.

BUGS

       Many, no doubt.

       More general comments, suggestions, and inquiries about frontends or SANE should go to the
       SANE  Developers  mailing  list  (see  http://www.sane-project.org/mailing-lists.html  for
       details).   You  must  be subscribed to the list, otherwise your mail won't be sent to the
       subscribers.

                                           11 Jul 2008                            sane-gphoto2(5)