sane-gphoto2(5) SANE Scanner Access Now Easy sane-gphoto2(5)NAMEsane-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 sup-
port other models are welcome.
Because of the limited testing of this backend, it is com-
mented out in /usr/freeware/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 characteris-
tics of the camera to be used. Resolutions (high resolu-
tion, 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 camers. In this case, the line would read "top-
folder=/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/freeware/etc/sane.d/gphoto2.conf
The backend configuration file (see also descrip-
tion of SANE_CONFIG_DIR below).
/usr/freeware/lib32/sane/libsane-gphoto2.a
The static library implementing this backend.
/usr/freeware/lib32/sane/libsane-gphoto2.so
The shared library implementing this backend (pre-
sent on systems that support dynamic loading).
ENVIRONMENT
SANE_CONFIG_DIR
This environment variable specifies the list of
directories 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 /usr/freeware/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 spec-
ified directories. For example, setting SANE_CON-
FIG_DIR to "/tmp/config:" would result in directo-
ries "tmp/config", ".", and "/usr/free-
ware/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 ALSOsane(7)AUTHOR
Peter S. Fales
The manpage was largeley 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.mostang.com/sane/mail.html for
details). You must be subscribed to the list, otherwise
your mail won't be sent to the subscribers.
sane-backends 1.0.12 04 September 2001 sane-gphoto2(5)