2003-09-23 15:30:05 +00:00
|
|
|
<HTML>
|
|
|
|
|
<HEAD>
|
|
|
|
|
<TITLE>sane-gphoto2.5</TITLE>
|
|
|
|
|
</HEAD>
|
|
|
|
|
<BODY BGCOLOR=#FFFFFF TEXT=#000000><H1 ALIGN=CENTER><IMG SRC="../sane.png" HEIGHT=117 WIDTH=346></H1>
|
|
|
|
|
<H1>sane-gphoto2.5</H1>
|
|
|
|
|
<HR>
|
|
|
|
|
<PRE>
|
|
|
|
|
<!-- Manpage converted by man2html 3.0.1 -->
|
|
|
|
|
<B><A HREF="sane-gphoto2.5.html">sane-gphoto2(5)</A></B> SANE Scanner Access Now Easy <B><A HREF="sane-gphoto2.5.html">sane-gphoto2(5)</A></B>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
<H2>NAME</H2><PRE>
|
|
|
|
|
sane-gphoto2 - SANE backend for gphoto2 supported cameras
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
<H2>DESCRIPTION</H2><PRE>
|
|
|
|
|
The <B>sane-gphoto2</B> 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
|
|
|
|
|
/usr/local/etc/sane.d/dll.conf by default. Either the comment charac-
|
|
|
|
|
ter must be removed or the backend must be called explicitly. E.g.
|
|
|
|
|
`scanimage -d gphoto2' or `xscanimage gphoto2'.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
<H2>DEVICE NAMES</H2><PRE>
|
|
|
|
|
The current version of the backend only allows one camera to be con-
|
|
|
|
|
nected. The device name is always "0".
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
<H2>CONFIGURATION</H2><PRE>
|
|
|
|
|
The contents of the <I>gphoto2.conf</I> 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 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
|
|
|
|
|
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 "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
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
<H2>FILES</H2><PRE>
|
|
|
|
|
<I>/usr/local/etc/sane.d/gphoto2.conf</I>
|
|
|
|
|
The backend configuration file (see also description of
|
|
|
|
|
<B>SANE_CONFIG_DIR</B> below).
|
|
|
|
|
|
|
|
|
|
<I>/usr/local/lib/sane/libsane-gphoto2.a</I>
|
|
|
|
|
The static library implementing this backend.
|
|
|
|
|
|
|
|
|
|
<I>/usr/local/lib/sane/libsane-gphoto2.so</I>
|
|
|
|
|
The shared library implementing this backend (present on systems
|
|
|
|
|
that support dynamic loading).
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
<H2>ENVIRONMENT</H2><PRE>
|
|
|
|
|
<B>SANE_CONFIG_DIR</B>
|
|
|
|
|
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 config-
|
|
|
|
|
uration 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 explicitly specified directo-
|
|
|
|
|
ries. For example, setting <B>SANE_CONFIG_DIR</B> to "/tmp/config:"
|
|
|
|
|
would result in directories "tmp/config", ".", and
|
|
|
|
|
"/usr/local/etc/sane.d" being searched (in this order).
|
|
|
|
|
|
|
|
|
|
<B>SANE_DEBUG_GPHOTO2</B>
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
<B>GP_DEBUG</B>
|
|
|
|
|
Set to 1, 2, or 3, to enable various levels of debugging within
|
|
|
|
|
the gphoto2 libraries.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
<H2>SEE ALSO</H2><PRE>
|
|
|
|
|
<B><A HREF="sane.7.html">sane(7)</A></B>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
<H2>AUTHOR</H2><PRE>
|
|
|
|
|
Peter S. Fales
|
|
|
|
|
|
|
|
|
|
The manpage was largeley copied from the dc210 manpage.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
<H2>BUGS</H2><PRE>
|
|
|
|
|
Many, no doubt.
|
|
|
|
|
|
|
|
|
|
More general comments, suggestions, and inquiries about frontends or
|
|
|
|
|
SANE should go to the SANE Developers mailing list (see
|
2003-09-24 16:17:33 +00:00
|
|
|
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.
|
2003-09-23 15:30:05 +00:00
|
|
|
|
|
|
|
|
sane-backends 1.0.12-cvs 04 September 2001 <B><A HREF="sane-gphoto2.5.html">sane-gphoto2(5)</A></B>
|
|
|
|
|
</PRE>
|
|
|
|
|
<HR>
|
|
|
|
|
<ADDRESS>
|
|
|
|
|
Man(1) output converted with
|
|
|
|
|
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
|
|
|
|
|
</ADDRESS>
|
|
|
|
|
</BODY>
|
|
|
|
|
</HTML>
|
