195 lines
5.4 KiB
HTML
195 lines
5.4 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of sane-gphoto2</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>sane-gphoto2</H1>
|
|
Section: SANE Scanner Access Now Easy (5)<BR>Updated: 11 Jul 2008<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="ixAAB"></A>
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
sane-gphoto2 - SANE backend for gphoto2 supported cameras
|
|
<A NAME="lbAC"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
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.
|
|
<P>
|
|
|
|
Because of the limited testing of this backend, it is commented out
|
|
in @CONFIGDIR@/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'.
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DEVICE NAMES</H2>
|
|
|
|
The current version of the backend only allows one camera to be
|
|
connected. The device name is always "0".
|
|
<A NAME="lbAE"> </A>
|
|
<H2>CONFIGURATION</H2>
|
|
|
|
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 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".
|
|
<P>
|
|
|
|
The dumpinquiry line causes some information about the camera to
|
|
be printed.
|
|
<P>
|
|
|
|
Empty lines and lines starting with a hash mark (#) are
|
|
ignored. A sample configuration file is shown below:
|
|
<P>
|
|
|
|
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 camera. In this case, the
|
|
line would read "topfolder=/DCIM"
|
|
<P>
|
|
|
|
Some cameras don't implement a file structure and store all pictures
|
|
in the "/" directory. This is indicated by setting "subdirs=0" with
|
|
"topfolder=/"
|
|
<P>
|
|
|
|
<DL COMPACT><DT id="1"><DD>
|
|
port=usb:
|
|
<BR>
|
|
|
|
camera=Kodak DC240
|
|
<BR>
|
|
|
|
# this is a comment
|
|
<BR>
|
|
|
|
high_resolution=1280x960
|
|
<BR>
|
|
|
|
low_resolution=640x480
|
|
<BR>
|
|
|
|
thumb_resolution=160x120
|
|
<BR>
|
|
|
|
dumpinquiry
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
<A NAME="lbAF"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="2"><I>@CONFIGDIR@/gphoto2.conf</I>
|
|
|
|
<DD>
|
|
The backend configuration file (see also description of
|
|
<B>SANE_CONFIG_DIR</B>
|
|
|
|
below).
|
|
<DT id="3"><I>@LIBDIR@/libsane-gphoto2.a</I>
|
|
|
|
<DD>
|
|
The static library implementing this backend.
|
|
<DT id="4"><I>@LIBDIR@/libsane-gphoto2.so</I>
|
|
|
|
<DD>
|
|
The shared library implementing this backend (present on systems that
|
|
support dynamic loading).
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>ENVIRONMENT</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="5"><B>SANE_CONFIG_DIR</B>
|
|
|
|
<DD>
|
|
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 @CONFIGDIR@. 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
|
|
<B>SANE_CONFIG_DIR</B>
|
|
|
|
to "/tmp/config:" would result in directories "tmp/config", ".", and
|
|
"@CONFIGDIR@" being searched (in this order).
|
|
<DT id="6"><B>SANE_DEBUG_GPHOTO2</B>
|
|
|
|
<DD>
|
|
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.
|
|
<DT id="7"><B>GP_DEBUG</B>
|
|
|
|
<DD>
|
|
Set to 1, 2, or 3, to enable various levels of debugging within the
|
|
gphoto2 libraries.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<A HREF="/cgi-bin/man/man2html?7+sane">sane</A>(7)
|
|
<P>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
Peter S. Fales
|
|
<P>
|
|
<P>
|
|
|
|
The manpage was largely copied from the dc210 manpage.
|
|
<P>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
Many, no doubt.
|
|
<P>
|
|
|
|
More general comments, suggestions, and inquiries about frontends
|
|
or SANE should go to the SANE Developers mailing list
|
|
(see <A HREF="http://www.sane-project.org/mailing-lists.html">http://www.sane-project.org/mailing-lists.html</A> for details).
|
|
You must be subscribed to the list, otherwise your mail won't be
|
|
sent to the subscribers.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="8"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="9"><A HREF="#lbAC">DESCRIPTION</A><DD>
|
|
<DT id="10"><A HREF="#lbAD">DEVICE NAMES</A><DD>
|
|
<DT id="11"><A HREF="#lbAE">CONFIGURATION</A><DD>
|
|
<DT id="12"><A HREF="#lbAF">FILES</A><DD>
|
|
<DT id="13"><A HREF="#lbAG">ENVIRONMENT</A><DD>
|
|
<DT id="14"><A HREF="#lbAH">SEE ALSO</A><DD>
|
|
<DT id="15"><A HREF="#lbAI">AUTHOR</A><DD>
|
|
<DT id="16"><A HREF="#lbAJ">BUGS</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:06:05 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|