346 lines
8.8 KiB
HTML
346 lines
8.8 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of sane-umax</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>sane-umax</H1>
|
|
Section: SANE Scanner Access Now Easy (5)<BR>Updated: 14 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-umax - SANE backend for UMAX scanners
|
|
<P>
|
|
<A NAME="lbAC"> </A>
|
|
<H2>ABOUT THIS FILE</H2>
|
|
|
|
<P>
|
|
This file only is a short description of the umax-backend for sane! For detailed information take a look at
|
|
sane-umax-doc.html (it is included in the sane source directory and in the xsane online help)!
|
|
<P>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<P>
|
|
The
|
|
<B>sane-umax</B>
|
|
|
|
library implements a SANE backend that provides access to several UMAX-SCSI-scanners and some Linotye Hell SCSI-scanners,
|
|
parallel- and USB-scanners are not (and probably will never be) supported!
|
|
<P>
|
|
<B>I suggest you hold one hand on the power-button of the scanner while you try the first scans!</B>
|
|
|
|
<P>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>CONFIGURATION</H2>
|
|
|
|
<P>
|
|
The configuration file for this backend resides in
|
|
<I>@CONFIGDIR@/umax.conf</I>.
|
|
|
|
<P>
|
|
Its contents is a list of device names that correspond to UMAX and UMAX compatible scanners. 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 scsi-maxqueue 4
|
|
option scsi-buffer-size-min 65536
|
|
option scsi-buffer-size-max 131072
|
|
option scan-lines 40
|
|
option preview-lines 10
|
|
option scsi-maxqueue 2
|
|
option execute-request-sense 0
|
|
option force-preview-bit-rgb 0
|
|
option slow-speed -1
|
|
option care-about-smearing -1
|
|
option calibration-full-ccd -1
|
|
option calibration-width-offset -1
|
|
option calibration-bytes-pixel -1
|
|
option exposure-time-rgb-bind -1
|
|
option invert-shading-data -1
|
|
option lamp-control-available 0
|
|
option gamma-lsb-padded 0
|
|
/dev/sge
|
|
#scsi Vendor Model Type Bus Channel ID LUN
|
|
# The following scanner supports lamp control
|
|
option lamp-control-available 1
|
|
scsi UMAX * Scanner * * * * *
|
|
# scanner on /dev/scanner does not support lamp control
|
|
option lamp-control-available 0
|
|
/dev/scanner
|
|
</PRE>
|
|
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="1">execute-request-sense:<DD>
|
|
values: 0 = disabled, 1 = enabled
|
|
<BR>
|
|
|
|
default = 0
|
|
<BR>
|
|
|
|
If set to 1 umax_do_request_sense is called in
|
|
umax_do_calibration. This can hang the system
|
|
(but has been enabled until this version)
|
|
<DT id="2">scsi-buffer-size-min, scsi-buffer-size-max:<DD>
|
|
values: 4096-1048576
|
|
<BR>
|
|
|
|
default min = 32768, max = 131072
|
|
<BR>
|
|
|
|
Especially the minimum value is very important.
|
|
If this value is set too small the backend is not
|
|
able to send gamma tables to the scanner or to
|
|
do a correct color calibration. This may result in
|
|
strange color effects. If the minimum value is set
|
|
too large then the backend is not able to allocate
|
|
the requested scsi buffer size and aborts with
|
|
out of memory error. The default is 32KB, for
|
|
some scanners it should be increased to 64KB.
|
|
<DT id="3">scan-lines, preview-lines:<DD>
|
|
values: 1-65535
|
|
<BR>
|
|
|
|
default: scan-lines = 40, preview-lines = 10
|
|
<BR>
|
|
|
|
define the maximum number of lines that are scanned
|
|
into one buffer
|
|
<DT id="4">force-preview-bit-rgb:<DD>
|
|
values:
|
|
0 = disabled,
|
|
1 = enabled
|
|
<BR>
|
|
|
|
default = 0
|
|
<BR>
|
|
|
|
set preview bit in rgb real scan
|
|
<DT id="5">slow-speed, care-about-smearing:<DD>
|
|
values:
|
|
-1 = auto,
|
|
0 = disabled,
|
|
1 = enabled
|
|
<BR>
|
|
|
|
default = -1
|
|
<BR>
|
|
|
|
dangerous options, needed for some scanners
|
|
do not changed these options until you really know
|
|
what you do, you may destroy your scanner when you
|
|
define wrong values for this options
|
|
<DT id="6">calibration-full-ccd:<DD>
|
|
values:
|
|
-1 = auto,
|
|
0 = disabled,
|
|
1 = enabled
|
|
<BR>
|
|
|
|
default = -1
|
|
<BR>
|
|
|
|
do calibration for each pixel of ccd instead of
|
|
selected image
|
|
<DT id="7">calibration-width-offset:<DD>
|
|
values: -99999 = auto, > -99999 set value
|
|
<BR>
|
|
|
|
add an offset width to the calculated with for
|
|
image/ccd
|
|
<DT id="8">calibration-bytes-pixel:<DD>
|
|
values:
|
|
-1 = disabled,
|
|
0 = not set,
|
|
1 = 1 byte/pixel,
|
|
2 = 2 bytes/pixel
|
|
<BR>
|
|
|
|
use # bytes per pixel for calibration
|
|
<DT id="9">exposure-time-rgb-bind:<DD>
|
|
values:
|
|
-1 = automatically set by driver - if known,
|
|
0 = disabled (own selection for red, green and blue),
|
|
1 = enabled (same values for red, green and blue)
|
|
<DT id="10">invert-shading-data:<DD>
|
|
values:
|
|
-1 = automatically set by driver - if known,
|
|
0 = disabled,
|
|
1 = enabled
|
|
<BR>
|
|
|
|
default = -1
|
|
<BR>
|
|
|
|
invert shading data before sending it back to the scanner
|
|
<DT id="11">lamp-control-available:<DD>
|
|
values:
|
|
0 = automatically set by driver - if known,
|
|
1 = available
|
|
<BR>
|
|
|
|
default = 0
|
|
<DT id="12">gamma-lsb-padded:<DD>
|
|
values:
|
|
-1 = automatically set by driver - if known,
|
|
0 = gamma data is msb padded,
|
|
1 = gamma data is lsb padded
|
|
<BR>
|
|
|
|
default = -1
|
|
<DT id="13">handle-bad-sense-error:<DD>
|
|
values:
|
|
0 = handle as device busy,
|
|
1 = handle as ok,
|
|
2 = handle as i/o error,
|
|
3 = ignore bad error code - continue sense handler
|
|
<BR>
|
|
|
|
default = 0
|
|
<DT id="14">scsi-maxqueue:<DD>
|
|
values:
|
|
1..# (maximum defined at compile time)
|
|
<BR>
|
|
|
|
default = 2
|
|
<BR>
|
|
|
|
most scsi drivers allow internal command queueing with a depth
|
|
of 2 commands. In most cases it does not mprove anything when you
|
|
increase this value. When your scsi driver does not support any
|
|
command queueing you can try to set this value to 1.
|
|
<P>
|
|
</DL>
|
|
<P>
|
|
|
|
The special device name must be a generic SCSI device or a symlink to such a device.
|
|
To find out to which device your scanner is assigned and how you have to set the
|
|
permissions of that device, have a look at sane-scsi.
|
|
<P>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>SCSI ADAPTER TIPS</H2>
|
|
|
|
<P>
|
|
The ISA-SCSI-adapters that are shipped with some Umax-scanners are not supported very
|
|
well by Linux (I suggest not to use it), the PCI-SCSI-adapters that come with some
|
|
Umax-scanners are not supported at all (as far as I know). On other platforms these
|
|
SCSI-adapters are not supported. So you typically need to purchase another SCSI-adapter
|
|
that is supported by your platform. See the relevant hardware FAQs and HOWTOs for your
|
|
platform for more information.
|
|
<P>
|
|
The UMAX-scanners do block the scsi-bus for a few seconds while scanning. It is not
|
|
necessary to connect the scanner to its own SCSI-adapter. But if you need short
|
|
response time for your SCSI-harddisk (e.g. if your computer is a file-server) or
|
|
other scsi devices, I suggest you use an own SCSI-adapter for your UMAX-scanner.
|
|
<P>
|
|
If you have any problems with your Umax scanner, check your scsi chain
|
|
(cable length, termination, ...).
|
|
<P>
|
|
See also: <A HREF="/cgi-bin/man/man2html?5+sane-scsi">sane-scsi</A>(5)
|
|
<P>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="15">The backend configuration file:<DD>
|
|
<I>@CONFIGDIR@/umax.conf</I>
|
|
|
|
<DT id="16">The static library implementing this backend:<DD>
|
|
<I>@LIBDIR@/libsane-umax.a</I>
|
|
|
|
<DT id="17">The shared library implementing this backend:<DD>
|
|
<I>@LIBDIR@/libsane-umax.so</I>
|
|
|
|
(present on systems that support dynamic loading)
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>ENVIRONMENT</H2>
|
|
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="18"><B>SANE_DEBUG_UMAX</B>
|
|
|
|
<DD>
|
|
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:
|
|
SANE_DEBUG_UMAX values
|
|
<P>
|
|
|
|
<PRE>
|
|
Number Remark
|
|
0 print important errors (printed each time)
|
|
1 print errors
|
|
2 print sense
|
|
3 print warnings
|
|
4 print scanner-inquiry
|
|
5 print information
|
|
6 print less important information
|
|
7 print called procedures
|
|
8 print reader_process messages
|
|
10 print called sane-init-routines
|
|
11 print called sane-procedures
|
|
12 print sane infos
|
|
13 print sane option-control messages
|
|
</PRE>
|
|
|
|
|
|
<P>
|
|
<DT id="19">Example:<DD>
|
|
export SANE_DEBUG_UMAX=8
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
<P>
|
|
X-resolutions greater than 600 dpi sometimes make problems
|
|
<P>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<A HREF="/cgi-bin/man/man2html?7+sane">sane</A>(7)
|
|
<P>
|
|
<A NAME="lbAK"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
<P>
|
|
Oliver Rauch
|
|
<P>
|
|
<A NAME="lbAL"> </A>
|
|
<H2>EMAIL-CONTACT</H2>
|
|
|
|
<A HREF="mailto:Oliver.Rauch@Rauch-Domain.DE">Oliver.Rauch@Rauch-Domain.DE</A>
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="20"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="21"><A HREF="#lbAC">ABOUT THIS FILE</A><DD>
|
|
<DT id="22"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="23"><A HREF="#lbAE">CONFIGURATION</A><DD>
|
|
<DT id="24"><A HREF="#lbAF">SCSI ADAPTER TIPS</A><DD>
|
|
<DT id="25"><A HREF="#lbAG">FILES</A><DD>
|
|
<DT id="26"><A HREF="#lbAH">ENVIRONMENT</A><DD>
|
|
<DT id="27"><A HREF="#lbAI">BUGS</A><DD>
|
|
<DT id="28"><A HREF="#lbAJ">SEE ALSO</A><DD>
|
|
<DT id="29"><A HREF="#lbAK">AUTHOR</A><DD>
|
|
<DT id="30"><A HREF="#lbAL">EMAIL-CONTACT</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:05 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|