Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
sane-gphoto2(5) 	  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) back-
     end 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
     /usr/local/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 exam-
     ple, 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
     /usr/local/etc/sane.d/gphoto2.conf
	    The  backend  configuration  file (see also description of SANE_CON-
	    FIG_DIR below).

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

     /usr/local/lib/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 /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 ex-
	    plicitly specified	directories.   For  example,  setting  SANE_CON-
	    FIG_DIR to "/tmp/config:" would result in directories tmp/config, .,
	    and /usr/local/etc/sane.d being searched (in this order).

     SANE_DEBUG_GPHOTO2
	    If the library was compiled with debugging support enabled, this en-
	    vironment  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  sub-
     scribers.

				   11 Jul 2008			 sane-gphoto2(5)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=sane-gphoto2&sektion=5&manpath=FreeBSD+Ports+15.1.quarterly>

home | help