2003-09-23 15:30:05 +00:00
|
|
|
|
<HTML>
|
|
|
|
|
|
<HEAD>
|
|
|
|
|
|
<TITLE>sane-avision.5</TITLE>
|
|
|
|
|
|
</HEAD>
|
2003-09-24 17:24:12 +00:00
|
|
|
|
<BODY BGCOLOR=#FFFFFF TEXT=#000000><H1 ALIGN=CENTER><IMG SRC="/images/sane.png" HEIGHT=117 WIDTH=346></H1>
|
2003-09-23 15:30:05 +00:00
|
|
|
|
<H1>sane-avision.5</H1>
|
|
|
|
|
|
<HR>
|
|
|
|
|
|
<PRE>
|
|
|
|
|
|
<!-- Manpage converted by man2html 3.0.1 -->
|
|
|
|
|
|
<B><A HREF="sane-avision.5.html">sane-avision(5)</A></B> SANE Scanner Access Now Easy <B><A HREF="sane-avision.5.html">sane-avision(5)</A></B>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
|
<H2>NAME</H2><PRE>
|
|
|
|
|
|
sane-avision - SANE backend for original Avision and Avision OEM scan-
|
2004-11-07 19:26:31 +00:00
|
|
|
|
ners (HP, Minolta, Mitsubishi, UMAX and possibly more) flatbed and film
|
|
|
|
|
|
scanners.
|
2003-09-23 15:30:05 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
|
<H2>ABOUT THIS FILE</H2><PRE>
|
2003-11-23 12:03:17 +00:00
|
|
|
|
This file is a short descripton for the avision-backend shipped with
|
|
|
|
|
|
SANE.
|
2003-09-23 15:30:05 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
|
<H2>DESCRIPTION</H2><PRE>
|
2003-11-23 12:03:17 +00:00
|
|
|
|
The <B>sane-avision</B> library implements a SANE (Scanner Access Now Easy)
|
|
|
|
|
|
backend that provides access to various Avision scanners and the Avi-
|
2003-09-23 15:30:05 +00:00
|
|
|
|
sion OEM scanners labelled by HP, Minolta, Mitsubishi or Fujitsu.
|
|
|
|
|
|
|
2004-11-07 19:26:31 +00:00
|
|
|
|
It is fully big-endian aware and in every-day use on PowerPC and SPARC
|
|
|
|
|
|
systems.
|
|
|
|
|
|
|
|
|
|
|
|
<B>I</B> <B>suggest</B> <B>you</B> <B>hold</B> <B>one</B> <B>hand</B> <B>on</B> <B>the</B> <B>power-button</B> <B>of</B> <B>the</B> <B>scanner</B> <B>while</B>
|
|
|
|
|
|
you try the first scans - especially with film-scanners!
|
2003-11-23 12:03:17 +00:00
|
|
|
|
|
2003-09-23 15:30:05 +00:00
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
|
<H2>CONFIGURATION</H2><PRE>
|
|
|
|
|
|
The configuration file for this backend resides in
|
2005-08-07 11:14:41 +00:00
|
|
|
|
<I>/usr/local/etc/sane.d/avision.conf</I>.
|
2003-09-23 15:30:05 +00:00
|
|
|
|
|
2004-11-07 19:26:31 +00:00
|
|
|
|
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
|
2003-09-23 15:30:05 +00:00
|
|
|
|
is shown below:
|
|
|
|
|
|
|
|
|
|
|
|
# this is a comment
|
|
|
|
|
|
|
|
|
|
|
|
option force-a4
|
2004-11-07 19:26:31 +00:00
|
|
|
|
option force-a3
|
2003-09-23 15:30:05 +00:00
|
|
|
|
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
|
|
|
|
|
|
|
2005-08-07 11:14:41 +00:00
|
|
|
|
force-a4:
|
|
|
|
|
|
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!
|
|
|
|
|
|
|
|
|
|
|
|
force-a3:
|
|
|
|
|
|
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!
|
|
|
|
|
|
|
|
|
|
|
|
disable-gamma-table:
|
|
|
|
|
|
Disables the usage of the scanner's gamma-table. You might try
|
|
|
|
|
|
this if your scans hang or only produces random garbage.
|
|
|
|
|
|
|
|
|
|
|
|
disable-calibration:
|
|
|
|
|
|
Disables the scanner's color calibration. You might try this if
|
|
|
|
|
|
your scans hang or only produces random garbage.
|
|
|
|
|
|
|
|
|
|
|
|
Note: Any option above modifies the default code-flow for your scan-
|
|
|
|
|
|
ner. 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.
|
2003-09-23 15:30:05 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
|
<H2>DEVICE NAMES</H2><PRE>
|
|
|
|
|
|
This backend expects device names of the form:
|
|
|
|
|
|
|
2003-11-23 12:03:17 +00:00
|
|
|
|
<I>scsi</I> <I>scsi-spec</I>
|
2003-09-23 15:30:05 +00:00
|
|
|
|
|
2005-08-07 11:14:41 +00:00
|
|
|
|
<I>usb</I> <I>usb-spec</I>
|
2003-11-23 12:03:17 +00:00
|
|
|
|
|
|
|
|
|
|
Where <I>scsi-spec</I> is the path-name to a special device or a device ID for
|
2004-11-07 19:26:31 +00:00
|
|
|
|
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 exam-
|
2003-11-23 12:03:17 +00:00
|
|
|
|
ple on Linux "/dev/sga" or "/dev/sg0". The device ID is the ID returned
|
2004-11-07 19:26:31 +00:00
|
|
|
|
by the scanner, for example "HP" or "AVISION". See <B><A HREF="sane-scsi.5.html">sane-scsi(5)</A></B> for
|
2003-11-23 12:03:17 +00:00
|
|
|
|
details.
|
2003-09-23 15:30:05 +00:00
|
|
|
|
|
2005-08-07 11:14:41 +00:00
|
|
|
|
Note: 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-scan-
|
|
|
|
|
|
ners.
|
2003-09-23 15:30:05 +00:00
|
|
|
|
|
2003-11-23 12:03:17 +00:00
|
|
|
|
<I>usb-spec</I> is the USB device name, the vendor/product ID pair or the name
|
2004-11-07 19:26:31 +00:00
|
|
|
|
used by libusb corresponding to the USB scanner. For example "0x03f0
|
2003-11-23 12:03:17 +00:00
|
|
|
|
0x0701" or "libusb:002:003". See <B><A HREF="sane-usb.5.html">sane-usb(5)</A></B> for details.
|
|
|
|
|
|
|
|
|
|
|
|
The program <I>sane-find-scanner</I> helps to find out the correct scsi or usb
|
|
|
|
|
|
device name.
|
|
|
|
|
|
|
|
|
|
|
|
A list with supported devices is built into the avision backend so nor-
|
|
|
|
|
|
mally specifying an ID should not be necessary.
|
2003-09-23 15:30:05 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
|
<H2>FILES</H2><PRE>
|
|
|
|
|
|
<I>/usr/local/etc/sane.d/avision.conf</I>
|
2004-11-07 19:26:31 +00:00
|
|
|
|
The backend configuration file (see also description of
|
2003-09-23 15:30:05 +00:00
|
|
|
|
<B>SANE_CONFIG_DIR</B> below).
|
|
|
|
|
|
|
|
|
|
|
|
<I>/usr/local/lib/sane/libsane-avision.a</I>
|
|
|
|
|
|
The static library implementing this backend.
|
|
|
|
|
|
|
|
|
|
|
|
<I>/usr/local/lib/sane/libsane-avision.so</I>
|
|
|
|
|
|
The shared library implementing this backend (present on systems
|
|
|
|
|
|
that support dynamic loading).
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
|
<H2>ENVIRONMENT</H2><PRE>
|
|
|
|
|
|
<B>SANE_CONFIG_DIR</B>
|
|
|
|
|
|
This environment variable specifies the list of directories that
|
|
|
|
|
|
may contain the configuration file. Under UNIX, the directories
|
2004-11-07 19:26:31 +00:00
|
|
|
|
are separated by a colon (`:'), under OS/2, they are separated
|
2003-09-23 15:30:05 +00:00
|
|
|
|
by a semi-colon (`;'). If this variable is not set, the config-
|
2004-11-07 19:26:31 +00:00
|
|
|
|
uration file is searched in two default directories: first, the
|
|
|
|
|
|
current working directory (".") and then in
|
2003-09-23 15:30:05 +00:00
|
|
|
|
/usr/local/etc/sane.d. If the value of the environment variable
|
2004-11-07 19:26:31 +00:00
|
|
|
|
ends with the directory separator character, then the default
|
2005-12-18 15:23:45 +00:00
|
|
|
|
directories are searched after the explicitly specified
|
|
|
|
|
|
directories. For example, setting <B>SANE_CONFIG_DIR</B> to "/tmp/con-
|
|
|
|
|
|
fig:" would result in directories "tmp/config", ".", and
|
2003-09-23 15:30:05 +00:00
|
|
|
|
"/usr/local/etc/sane.d" being searched (in this order).
|
|
|
|
|
|
|
|
|
|
|
|
<B>SANE_DEBUG_AVISION</B>
|
2004-11-07 19:26:31 +00:00
|
|
|
|
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 prefered value to debug backend
|
2003-09-23 15:30:05 +00:00
|
|
|
|
problems.
|
|
|
|
|
|
|
|
|
|
|
|
Example: export SANE_DEBUG_AVISION=7
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
|
<H2>SEE ALSO</H2><PRE>
|
2003-11-23 12:03:17 +00:00
|
|
|
|
<B><A HREF="sane.7.html">sane(7)</A></B>, <B><A HREF="sane-scsi.5.html">sane-scsi(5)</A></B>, <B><A HREF="sane-usb.5.html">sane-usb(5)</A></B>
|
2004-11-07 19:26:31 +00:00
|
|
|
|
http://www.exactcode.de/oss/avision/
|
2003-09-23 15:30:05 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
|
<H2>AUTHOR</H2><PRE>
|
2003-10-15 08:58:04 +00:00
|
|
|
|
Ren<65> Rebe and Meino Christian Cramer
|
2003-09-23 15:30:05 +00:00
|
|
|
|
|
2005-12-18 15:23:45 +00:00
|
|
|
|
sane-backends 1.0.17 04 Mar 2003 <B><A HREF="sane-avision.5.html">sane-avision(5)</A></B>
|
2003-09-23 15:30:05 +00:00
|
|
|
|
</PRE>
|
|
|
|
|
|
<HR>
|
|
|
|
|
|
<ADDRESS>
|
|
|
|
|
|
Man(1) output converted with
|
|
|
|
|
|
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
|
|
|
|
|
|
</ADDRESS>
|
|
|
|
|
|
</BODY>
|
|
|
|
|
|
</HTML>
|
