SANE Scanner Access Now Easy                      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 `xscanim-
     age 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  con-
     stant,  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
          highresolution=1280x960
          lowresolution=640x480
          thumbresolution=160x120
          dumpinquiry



sane-backends 1.0.Last change: 04 September 2001                1






SANE Scanner Access Now Easy                      sane-gphoto2(5)



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

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

     /usr/lib/sane/libsane-gphoto2.so
          The shared library implementing this  backend  (present
          on systems that support dynamic loading).


ENVIRONMENT
     SANECONFIGDIR
          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
          directory separator character, then the default  direc-
          tories  are  searched  after  the  explicitly specified
          directories.  For example, setting  SANECONFIGDIR  to
          "/tmp/config:"     would    result    in    directories
          "tmp/config", ".", and "/etc/sane.d" being searched (in
          this order).

     SANEDEBUGPHOTO2
          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.

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


SEE ALSO
     sane(7)


AUTHOR
     Peter S. Fales


     The manpage was largely copied from the dc210 manpage.




sane-backends 1.0.Last change: 04 September 2001                2






SANE Scanner Access Now Easy                      sane-gphoto2(5)



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.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     
       ATRIBUTE TYPE     ATRIBUTE VALUE 
    
     Availability         SUNWsane-backend
    
     Interface Stability  Uncommitted     
    

NOTES
     Source for SANE is available on http:/opensolaris.org.































sane-backends 1.0.Last change: 04 September 2001                3