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/x86_64-linux-gnu/sane/libsane-gphoto2.a
              The static library implementing this backend.

       /usr/lib/x86_64-linux-gnu/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.   On  *NIX  systems,  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), scanimage(1), xscanimage(1), libgphoto2(3)

AUTHOR

       Peter S. Fales

       The manpage was largely copied from the sane-dc210(5) 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)