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 becalled 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 canbe 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 filepath. 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 thecamera. 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
dumpinquirysane-backends 1.0.1L9ast 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 ofSANE_CONFIG_DIR 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). ENVIRONMENTSANE_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 thedirectory separator character, then the default direc-
tories are searched after the explicitly specifieddirectories. 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 debuglevel 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) AUTHOR Peter S. Fales The manpage was largely copied from the dc210 manpage.sane-backends 1.0.1L9ast 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 mailinglist (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.ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:_________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|____________________|____________________________________|_
| Availability | image/scanner/xsane/sane-backends|
|____________________|____________________________________|_
| Interface Stability| Uncommitted ||____________________|___________________________________|
NOTES Source for SANE is available on http://opensolaris.org.sane-backends 1.0.1L9ast change: 04 September 2001 3