1sane-gphoto2(5) SANE Scanner Access Now Easy sane-gphoto2(5)
2
6 sane-gphoto2 - SANE backend for gphoto2 supported cameras
7
9 The sane-gphoto2 library implements a SANE (Scanner Access Now Easy)
10 backend that provides access to the digital cameras supported by
11 gphoto2. This backend has only been tested with a handful of cameras
12 so far. Patches to support other models are welcome.
13 Because of the limited testing of this backend, it is commented out in
15 /etc/sane.d/dll.conf by default. Either the comment character must be
16 removed or the backend must be called explicitly. E.g. `scanimage -d
17 gphoto2' or `xscanimage gphoto2'.
18
20 The current version of the backend only allows one camera to be con‐
21 nected. The device name is always "0".
22
24 The contents of the gphoto2.conf specify the characteristics of the
25 camera to be used. Resolutions (high resolution, low resolution, and
26 thumbnail size) are required since they are needed by the sane fron‐
27 tends, but can't be obtained through the gphoto2 interface. Valid
28 ports and cameras can be obtained by "gphoto2 --list-cameras" and
29 "gphoto2 --list-ports".
30 The dumpinquiry line causes some information about the camera to be
32 printed.
33 Empty lines and lines starting with a hash mark (#) are ignored. A
35 sample configuration file is shown below:
36 The "topfolder" line specifies the "fixed" part of the file path. For
38 example, on the Kodak DC-240, files are stored in the directory
39 /DCIM/100DC240. The /DCIM portion is constant, but 100DC240 will
40 change and must be read from the camera. In this case, the line would
41 read "topfolder=/DCIM"
42 Some cameras don't implement a file structure and store all pictures in
44 the "/" directory. This is indicated by setting "subdirs=0" with "top‐
45 folder=/"
46 port=usb:
48 camera=Kodak DC240
49 # this is a comment
50 high_resolution=1280x960
51 low_resolution=640x480
52 thumb_resolution=160x120
53 dumpinquiry
54
56 /etc/sane.d/gphoto2.conf
57 The backend configuration file (see also description of
58 SANE_CONFIG_DIR below).
59 /usr/lib64/sane/libsane-gphoto2.a
61 The static library implementing this backend.
62 /usr/lib64/sane/libsane-gphoto2.so
64 The shared library implementing this backend (present on systems
65 that support dynamic loading).
66
69 SANE_CONFIG_DIR
70 This environment variable specifies the list of directories that
71 may contain the configuration file. Under UNIX, the directories
72 are separated by a colon (`:'), under OS/2, they are separated
73 by a semi-colon (`;'). If this variable is not set, the config‐
74 uration file is searched in two default directories: first, the
75 current working directory (".") and then in /etc/sane.d. If the
76 value of the environment variable ends with the directory sepa‐
77 rator character, then the default directories are searched after
78 the explicitly specified directories. For example, setting
79 SANE_CONFIG_DIR to "/tmp/config:" would result in directories
80 "tmp/config", ".", and "/etc/sane.d" being searched (in this
81 order).
82 SANE_DEBUG_GPHOTO2
84 If the library was compiled with debugging support enabled, this
85 environment variable controls the debug level for this backend.
86 A value of 128 requests maximally copious debug output; smaller
87 levels reduce verbosity.
88 GP_DEBUG
90 Set to 1, 2, or 3, to enable various levels of debugging within
91 the gphoto2 libraries.
92
95 sane(7)
96
99 Peter S. Fales
100 The manpage was largely copied from the dc210 manpage.
103
106 Many, no doubt.
107 More general comments, suggestions, and inquiries about frontends or
109 SANE should go to the SANE Developers mailing list (see
110 http://www.sane-project.org/mailing-lists.html for details). You must
111 be subscribed to the list, otherwise your mail won't be sent to the
112 subscribers.
113 11 Jul 2008 sane-gphoto2(5)