kopia lustrzana https://gitlab.com/sane-project/website
256 wiersze
9.6 KiB
HTML
256 wiersze
9.6 KiB
HTML
<HTML>
|
||
<HEAD>
|
||
<TITLE>sane-umax.5</TITLE>
|
||
</HEAD>
|
||
<BODY BGCOLOR=#FFFFFF TEXT=#000000><H1 ALIGN=CENTER><IMG SRC="../images/sane.png" HEIGHT=117 WIDTH=346></H1>
|
||
<H1>sane-umax.5</H1>
|
||
<HR>
|
||
<PRE>
|
||
<!-- Manpage converted by man2html 3.0.1 -->
|
||
<B><A HREF="sane-umax.5.html">sane-umax(5)</A></B> SANE Scanner Access Now Easy <B><A HREF="sane-umax.5.html">sane-umax(5)</A></B>
|
||
|
||
|
||
</PRE>
|
||
<H2>NAME</H2><PRE>
|
||
sane-umax - SANE backend for UMAX scanners
|
||
|
||
|
||
</PRE>
|
||
<H2>ABOUT THIS FILE</H2><PRE>
|
||
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)!
|
||
|
||
|
||
</PRE>
|
||
<H2>DESCRIPTION</H2><PRE>
|
||
The <B>sane-umax</B> library implements a SANE backend that provides access to
|
||
several UMAX-SCSI-scanners and some Linotye Hell SCSI-scanners, paral‐
|
||
lel- and USB-scanners are not (and probably will never be) supported!
|
||
|
||
<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>
|
||
<B>you</B> <B>try</B> <B>the</B> <B>first</B> <B>scans!</B>
|
||
|
||
|
||
</PRE>
|
||
<H2>CONFIGURATION</H2><PRE>
|
||
The configuration file for this backend resides in
|
||
<I>/usr/local/etc/sane.d/umax.conf</I>.
|
||
|
||
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:
|
||
|
||
# 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
|
||
|
||
execute-request-sense:
|
||
values: 0 = disabled, 1 = enabled
|
||
default = 0
|
||
If set to 1 umax_do_request_sense is called in umax_do_calibra‐
|
||
tion. This can hang the system (but has been enabled until this
|
||
version)
|
||
|
||
scsi-buffer-size-min, scsi-buffer-size-max:
|
||
values: 4096-1048576
|
||
default min = 32768, max = 131072
|
||
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.
|
||
|
||
scan-lines, preview-lines:
|
||
values: 1-65535
|
||
default: scan-lines = 40, preview-lines = 10
|
||
define the maximum number of lines that are scanned into one
|
||
buffer
|
||
|
||
force-preview-bit-rgb:
|
||
values: 0 = disabled, 1 = enabled
|
||
default = 0
|
||
set preview bit in rgb real scan
|
||
|
||
slow-speed, care-about-smearing:
|
||
values: -1 = auto, 0 = disabled, 1 = enabled
|
||
default = -1
|
||
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
|
||
|
||
calibration-full-ccd:
|
||
values: -1 = auto, 0 = disabled, 1 = enabled
|
||
default = -1
|
||
do calibration for each pixel of ccd instead of selected image
|
||
|
||
calibration-width-offset:
|
||
values: -99999 = auto, > -99999 set value
|
||
add an offset width to the calculated with for image/ccd
|
||
|
||
calibration-bytes-pixel:
|
||
values: -1 = disabled, 0 = not set, 1 = 1 byte/pixel, 2 = 2
|
||
bytes/pixel
|
||
use # bytes per pixel for calibration
|
||
|
||
exposure-time-rgb-bind:
|
||
values: -1 = automatically set by driver - if known, 0 = dis‐
|
||
abled (own selection for red, green and blue), 1 = enabled (same
|
||
values for red, green and blue)
|
||
|
||
invert-shading-data:
|
||
values: -1 = automatically set by driver - if known, 0 = dis‐
|
||
abled, 1 = enabled
|
||
default = -1
|
||
invert shading data before sending it back to the scanner
|
||
|
||
lamp-control-available:
|
||
values: 0 = automatically set by driver - if known, 1 = avail‐
|
||
able
|
||
default = 0
|
||
|
||
gamma-lsb-padded:
|
||
values: -1 = automatically set by driver - if known, 0 = gamma
|
||
data is msb padded, 1 = gamma data is lsb padded
|
||
default = -1
|
||
|
||
handle-bad-sense-error:
|
||
values: 0 = handle as device busy, 1 = handle as ok, 2 = handle
|
||
as i/o error, 3 = ignore bad error code - continue sense handler
|
||
default = 0
|
||
|
||
scsi-maxqueue:
|
||
values: 1..# (maximum defined at compile time)
|
||
default = 2
|
||
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.
|
||
|
||
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.
|
||
|
||
|
||
</PRE>
|
||
<H2>SCSI ADAPTER TIPS</H2><PRE>
|
||
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 sup‐
|
||
ported. 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.
|
||
|
||
The UMAX-scanners do block the scsi-bus for a few seconds while scan‐
|
||
ning. 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 sug‐
|
||
gest you use an own SCSI-adapter for your UMAX-scanner.
|
||
|
||
If you have any problems with your Umax scanner, check your scsi chain
|
||
(cable length, termination, ...).
|
||
|
||
See also: <B><A HREF="sane-scsi.5.html">sane-scsi(5)</A></B>
|
||
|
||
|
||
</PRE>
|
||
<H2>FILES</H2><PRE>
|
||
The backend configuration file:
|
||
<I>/usr/local/etc/sane.d/umax.conf</I>
|
||
|
||
The static library implementing this backend:
|
||
<I>/usr/local/lib/sane/libsane-umax.a</I>
|
||
|
||
The shared library implementing this backend:
|
||
<I>/usr/local/lib/sane/libsane-umax.so</I> (present on systems that
|
||
support dynamic loading)
|
||
|
||
|
||
</PRE>
|
||
<H2>ENVIRONMENT</H2><PRE>
|
||
<B>SANE_DEBUG_UMAX</B>
|
||
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
|
||
|
||
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
|
||
|
||
Example:
|
||
export SANE_DEBUG_UMAX=8
|
||
|
||
|
||
</PRE>
|
||
<H2>BUGS</H2><PRE>
|
||
X-resolutions greater than 600 dpi sometimes make problems
|
||
|
||
|
||
</PRE>
|
||
<H2>SEE ALSO</H2><PRE>
|
||
<B><A HREF="sane.7.html">sane(7)</A></B>
|
||
|
||
|
||
</PRE>
|
||
<H2>AUTHOR</H2><PRE>
|
||
Oliver Rauch
|
||
|
||
|
||
</PRE>
|
||
<H2>EMAIL-CONTACT</H2><PRE>
|
||
Oliver.Rauch@Rauch-Domain.DE
|
||
|
||
14 Jul 2008 <B><A HREF="sane-umax.5.html">sane-umax(5)</A></B>
|
||
</PRE>
|
||
<HR>
|
||
<ADDRESS>
|
||
Man(1) output converted with
|
||
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
|
||
</ADDRESS>
|
||
</BODY>
|
||
</HTML>
|