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)
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 con-
nected. The device name is always "0".
CONFIGURATION
The contents of the gphoto2.conf specify the characteristics of the cam-
era to be used. Resolutions (high resolution, low resolution, and
thumbnail size) are required since they are needed by the sane fron-
tends, 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 sam-
ple configuration file is shown below:
The topfolder line specifies the "fixed" part of the file path. For ex-
ample, 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 "top-
folder=/"
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_CON-
FIG_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 direc-
tories are separated by a colon (`:'), under OS/2, they are sepa-
rated 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 sub-
scribers.
11 Jul 2008 sane-gphoto2(5)
Generated by dwww version 1.16 on Sat Oct 3 06:26:55 CEST 2026.