summaryrefslogtreecommitdiff
path: root/doc/sane-gphoto2.man
blob: f7ee918815a9a6f51b233ad9ec9a4f14f0fc434a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
.TH sane\-gphoto2 5 "11 Jul 2008" "@PACKAGEVERSION@" "SANE Scanner Access Now Easy"
.IX sane\-gphoto2
.SH NAME
sane\-gphoto2 \- SANE backend for gphoto2 supported cameras
.SH DESCRIPTION
The
.B 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.
.PP
Because of the limited testing of this backend, it is commented out
in
.I @CONFIGDIR@/dll.conf
by default.  Either the comment
character must be removed or the backend must be called explicitly.
E.g.
.I "scanimage \-d gphoto2"
or
.IR "xscanimage gphoto2" .
.SH "DEVICE NAMES"
The current version of the backend only allows one camera to be
connected.  The device name is always "0".
.SH CONFIGURATION
The contents of the
.I 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 can be obtained
by
.I "gphoto2 \-\-list\-cameras"
and
.IR "gphoto2 \-\-list\-ports" .
.PP
The
.B dumpinquiry
line causes some information about the camera to be printed.
.PP
Empty lines and lines starting with a hash mark (#) are
ignored.  A sample configuration file is shown below:
.PP
The
.B topfolder
line specifies the "fixed" part of the file path.  For
example, on the Kodak DC-240, files are stored in the directory
.IR /DCIM/100DC240.
The
.I /DCIM
portion is constant, but 100DC240 will change and must be read from the camera.
In this case, the line would read "topfolder=/DCIM"
.PP
Some cameras don't implement a file structure and store all pictures
in the
.I "/"
directory.  This is indicated by setting "subdirs=0" with
"topfolder=/"
.PP
.RS
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
.RE
.PP
.SH FILES
.TP
.I @CONFIGDIR@/gphoto2.conf
The backend configuration file (see also description of
.B SANE_CONFIG_DIR
below).
.TP
.I @LIBDIR@/libsane\-gphoto2.a
The static library implementing this backend.
.TP
.I @LIBDIR@/libsane\-gphoto2.so
The shared library implementing this backend (present on systems that
support dynamic loading).

.SH ENVIRONMENT
.TP
.B SANE_CONFIG_DIR
This environment variable specifies the list of directories that may
contain the configuration file.  On *NIX systems, 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
.RI ( "." )
and then in
.IR @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
to "/tmp/config:" would result in directories
.IR "tmp/config" ,
.IR "." ,
and
.I "@CONFIGDIR@"
being searched (in this order).
.TP
.B 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.
.TP
.B GP_DEBUG
Set to 1, 2, or 3, to enable various levels of debugging within the
gphoto2 libraries.

.SH "SEE ALSO"
.BR sane (7),
.BR scanimage (1),
.BR xscanimage (1),
.BR libgphoto2 (3)

.SH AUTHOR
Peter S. Fales

.PP
The manpage was largely copied from the
.BR sane\-dc210 (5)
manpage.

.SH BUGS
Many, no doubt.
.PP
More general comments, suggestions, and inquiries about frontends
or SANE should go to the SANE Developers mailing list
(see
.I 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.