246 lines
7.4 KiB
HTML
246 lines
7.4 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of sane-avision</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>sane-avision</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>
|
|
<P>
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
sane-avision - SANE backend for original Avision and Avision OEM scanners
|
|
(HP, Minolta, Mitsubishi, UMAX and possibly more) flatbed and film scanners.
|
|
<P>
|
|
<A NAME="lbAC"> </A>
|
|
<H2>ABOUT THIS FILE</H2>
|
|
|
|
<P>
|
|
This file is a short description for the avision-backend shipped with SANE.
|
|
<P>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
The
|
|
<B>sane-avision</B>
|
|
|
|
library implements a SANE (Scanner Access Now Easy) backend that
|
|
provides access to various Avision scanners and the Avision OEM
|
|
scanners labelled by HP, Minolta, Mitsubishi or Fujitsu.
|
|
<P>
|
|
It is fully big-endian aware and in every-day use on PowerPC and SPARC
|
|
systems.
|
|
<P>
|
|
<B>I suggest you hold one hand on the power-button of the scanner while</B>
|
|
|
|
you try the first scans - especially with film-scanners!
|
|
<P>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>CONFIGURATION</H2>
|
|
|
|
<P>
|
|
The configuration file for this backend resides in
|
|
<I>@CONFIGDIR@/avision.conf</I>.
|
|
|
|
<P>
|
|
Its contents is a list of device names that correspond to Avision and Avision
|
|
compatible scanners and backend-options. Empty lines and lines starting with
|
|
a hash mark (#) are ignored. A sample configuration file is shown below:
|
|
<P>
|
|
<PRE>
|
|
# this is a comment
|
|
option force-a4
|
|
option force-a3
|
|
option skip-adf
|
|
option disable-gamma-table
|
|
option disable-calibration
|
|
#scsi Vendor Model Type Bus Channel ID LUN
|
|
scsi AVISION
|
|
scsi HP
|
|
scsi /dev/scanner
|
|
usb 0x03f0 0x0701
|
|
</PRE>
|
|
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="1">force-a4:<DD>
|
|
Forces the backend to overwrite the scanable area
|
|
returned by the scanner to ISO A4. Scanner that are
|
|
known to return bogus data are marked in the backend
|
|
so if you need this option please report this to the
|
|
backend maintainer. USE WITH CARE!
|
|
<DT id="2">force-a3:<DD>
|
|
Forces the backend to overwrite the scanable area
|
|
returned by the scanner to ISO A3. Scanner that are
|
|
known to return bogus data are marked in the backend
|
|
so if you need this option please report this to the
|
|
backend maintainer. USE WITH CARE!
|
|
<DT id="3">skip-adf:<DD>
|
|
Forces the backend to ignore an inconsistent ADF
|
|
status returned by the scanner (ADF not present, but
|
|
ADF model number non-zero). Without this option, the
|
|
backend will make several attempts to reset the ADF
|
|
and retry the query in this situation, and will fail
|
|
with a "not supported" error if the ADF still doesn't
|
|
respond.
|
|
<DT id="4">disable-gamma-table:<DD>
|
|
Disables the usage of the scanner's gamma-table. You
|
|
might try this if your scans hang or only produces
|
|
random garbage.
|
|
<DT id="5">disable-calibration:<DD>
|
|
Disables the scanner's color calibration. You
|
|
might try this if your scans hang or only produces
|
|
random garbage.
|
|
<DT id="6">Note:<DD>
|
|
Any option above modifies the default code-flow
|
|
for your scanner. The options should only be used
|
|
when you encounter problems with the default be-
|
|
haviour of the backend. Please report the need of
|
|
options to the backend-author so the backend can
|
|
be fixed as soon as possible.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>DEVICE NAMES</H2>
|
|
|
|
This backend expects device names of the form:
|
|
<P>
|
|
|
|
<DL COMPACT><DT id="7"><DD>
|
|
<I>scsi scsi-spec</I>
|
|
|
|
<P>
|
|
<I>usb usb-spec</I>
|
|
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
Where
|
|
<I>scsi-spec</I>
|
|
|
|
is the path-name to a special device or a device ID for the device that
|
|
corresponds to a SCSI scanner. The special device name must be a generic
|
|
SCSI device or a symlink to such a device, for example on Linux "/dev/sga"
|
|
or "/dev/sg0". The device ID is the ID returned by the scanner, for example
|
|
"HP" or "AVISION". See <A HREF="/cgi-bin/man/man2html?5+sane-scsi">sane-scsi</A>(5) for details.
|
|
<DL COMPACT>
|
|
<DT id="8">Note:<DD>
|
|
Since the backend now includes native USB access,
|
|
it is no longer needed - even considered obsolete -
|
|
to access USB scanner via the SCSI emulation (named
|
|
hpusbscsi on Linux) for Avision USB devices such as
|
|
the HP 53xx, HP 74xx or Minolta film-scanners.
|
|
</DL>
|
|
<P>
|
|
|
|
<I>usb-spec</I>
|
|
|
|
is the USB device name, the vendor/product ID pair or the name used by
|
|
libusb corresponding to the USB scanner. For example "0x03f0 0x0701" or
|
|
"libusb:002:003". See <A HREF="/cgi-bin/man/man2html?5+sane-usb">sane-usb</A>(5) for details.
|
|
<P>
|
|
The program
|
|
<I>sane-find-scanner</I>
|
|
|
|
helps to find out the correct scsi or usb device name.
|
|
<P>
|
|
A list with supported devices is built into the avision backend so
|
|
normally specifying an ID should not be necessary.
|
|
<P>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="9"><I>@CONFIGDIR@/avision.conf</I>
|
|
|
|
<DD>
|
|
The backend configuration file (see also description of
|
|
<B>SANE_CONFIG_DIR</B>
|
|
|
|
below).
|
|
<DT id="10"><I>@LIBDIR@/libsane-avision.a</I>
|
|
|
|
<DD>
|
|
The static library implementing this backend.
|
|
<DT id="11"><I>@LIBDIR@/libsane-avision.so</I>
|
|
|
|
<DD>
|
|
The shared library implementing this backend (present on systems that
|
|
support dynamic loading).
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>ENVIRONMENT</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="12"><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="13"><B>SANE_DEBUG_AVISION</B>
|
|
|
|
<DD>
|
|
If the library was compiled with debug support enabled, this
|
|
environment variable controls the debug level for this backend.
|
|
Higher debug levels increase the verbosity of the output. The debug
|
|
level 7 is the author's preferred value to debug backend problems.
|
|
<P>
|
|
Example:
|
|
export SANE_DEBUG_AVISION=7
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<A HREF="/cgi-bin/man/man2html?7+sane">sane</A>(7), <A HREF="/cgi-bin/man/man2html?5+sane-scsi">sane-scsi</A>(5), <A HREF="/cgi-bin/man/man2html?5+sane-usb">sane-usb</A>(5)
|
|
<BR>
|
|
|
|
<A HREF="http://exactcode.com/site/open_source/saneavision/">http://exactcode.com/site/open_source/saneavision/</A>
|
|
<P>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>MAINTAINER</H2>
|
|
|
|
René Rebe
|
|
<A NAME="lbAK"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
René Rebe and Meino Christian Cramer
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="14"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="15"><A HREF="#lbAC">ABOUT THIS FILE</A><DD>
|
|
<DT id="16"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="17"><A HREF="#lbAE">CONFIGURATION</A><DD>
|
|
<DT id="18"><A HREF="#lbAF">DEVICE NAMES</A><DD>
|
|
<DT id="19"><A HREF="#lbAG">FILES</A><DD>
|
|
<DT id="20"><A HREF="#lbAH">ENVIRONMENT</A><DD>
|
|
<DT id="21"><A HREF="#lbAI">SEE ALSO</A><DD>
|
|
<DT id="22"><A HREF="#lbAJ">MAINTAINER</A><DD>
|
|
<DT id="23"><A HREF="#lbAK">AUTHOR</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:04 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|