sane-gphoto2(5)           (11 Jul 2008)           sane-gphoto2(5)

     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 cam-
          eras 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 com-
          mented 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 cam-
          era 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

     Page 1                       Plan 9             (printed 5/24/22)

     sane-gphoto2(5)           (11 Jul 2008)           sane-gphoto2(5)

               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 direc-
               tories 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 direc-
               tory separator 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_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 maxi-
               mally copious debug output; smaller levels reduce ver-
               bosity.

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

     SEE ALSO
          sane(7) scanimage(1) xscanimage(1)

     AUTHOR
          Peter S. Fales

     Page 2                       Plan 9             (printed 5/24/22)

     sane-gphoto2(5)           (11 Jul 2008)           sane-gphoto2(5)

          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.

     Page 3                       Plan 9             (printed 5/24/22)