summaryrefslogtreecommitdiffstats
path: root/upstream/opensuse-leap-15-6/man5/sane-qcam.5
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/opensuse-leap-15-6/man5/sane-qcam.5')
-rw-r--r--upstream/opensuse-leap-15-6/man5/sane-qcam.5101
1 files changed, 101 insertions, 0 deletions
diff --git a/upstream/opensuse-leap-15-6/man5/sane-qcam.5 b/upstream/opensuse-leap-15-6/man5/sane-qcam.5
new file mode 100644
index 00000000..6c3ee171
--- /dev/null
+++ b/upstream/opensuse-leap-15-6/man5/sane-qcam.5
@@ -0,0 +1,101 @@
+.TH sane\-qcam 5 "14 Jul 2008" "" "SANE Scanner Access Now Easy"
+.IX sane\-qcam
+.SH NAME
+sane\-qcam \- SANE backend for Connectix QuickCam cameras
+.SH DESCRIPTION
+The
+.B sane\-qcam
+library implements a SANE (Scanner Access Now Easy) backend that
+provides access Connectix QuickCam cameras.
+.SH "DEVICE NAMES"
+This backend expects device names of the form:
+.PP
+.RS
+.I port
+.RE
+.PP
+where
+.I port
+is the I/O port address at which the device resides. This address is
+normally specified in hexadecimal using C syntax (e.g., 0x37b) and may
+be prefixed with the letter "u" (e.g., u0x37b) to force the backend to
+access the camera in uni-directional mode.
+.SH CONFIGURATION
+The contents of the
+.I qcam.conf
+file is a list port addresses that may be connected to a
+Connectix QuickCam. Empty lines and everything starting from a hash
+mark (#) up to the end of a line are ignored. A sample configuration
+file is shown below:
+.PP
+.RS
+0x37b # /dev/lp0
+.br
+0x378 # /dev/lp1
+.br
+u0x278 # /dev/lp2 forced in uni-directional mode
+.br
+0x3bc # /dev/lp0 (alternate address)
+.RE
+.PP
+In general, it is safest to list only the port addresses that really
+correspond to a QuickCam. For example, if one of the listed addresses
+actually connect to a printer, then starting up this backend will
+cause the printer to perform a device reset (which is generally
+undesirable).
+.SH FILES
+.TP
+.I /etc/sane.d/qcam.conf
+The backend configuration file (see also description of
+.B SANE_CONFIG_DIR
+below).
+.TP
+.I /usr/lib64/sane/libsane\-qcam.a
+The static library implementing this backend.
+.TP
+.I /usr/lib64/sane/libsane\-qcam.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. 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
+.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_QCAM
+If the library was compiled with debug support enabled, this
+environment variable controls the debug level for this backend. E.g.,
+a value of 128 requests all debug output to be printed. Smaller
+levels reduce verbosity.
+
+.SH AUTHOR
+David Mosberger
+
+.SH BUGS
+Support is currently limited to the color version of the QuickCam.
+The black-and-white camera is starting to work too, but I don't
+believe it works in all cases yet. Reportedly, acquiring images of
+certain sizes work fine, but others result in shifted images (sounds
+like a problem due to byte-padding).
+.PP
+The program needs root-privileges since it needs to be able to access
+the camera's I/O ports.
+
+.SH SEE ALSO
+.BR sane (7)