diff options
Diffstat (limited to 'upstream/debian-bookworm/man5/sane-gphoto2.5')
| -rw-r--r-- | upstream/debian-bookworm/man5/sane-gphoto2.5 | 147 |
1 files changed, 147 insertions, 0 deletions
diff --git a/upstream/debian-bookworm/man5/sane-gphoto2.5 b/upstream/debian-bookworm/man5/sane-gphoto2.5 new file mode 100644 index 00000000..7fd16d69 --- /dev/null +++ b/upstream/debian-bookworm/man5/sane-gphoto2.5 @@ -0,0 +1,147 @@ +.TH sane\-gphoto2 5 "11 Jul 2008" "" "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 /etc/sane.d/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 +.I "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 /etc/sane.d/gphoto2.conf +The backend configuration file (see also description of +.B SANE_CONFIG_DIR +below). +.TP +.I /usr/lib/x86_64-linux-gnu/sane/libsane\-gphoto2.a +The static library implementing this backend. +.TP +.I /usr/lib/x86_64-linux-gnu/sane/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 /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 +directories. For example, setting +.B SANE_CONFIG_DIR +to "/tmp/config:" would result in directories +.IR "tmp/config" , +.IR "." , +and +.I "/etc/sane.d" +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. |