man-pages/man5/sane-microtek.5.html
2021-03-31 01:06:50 +01:00

314 lines
7.4 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of sane-microtek</TITLE>
</HEAD><BODY>
<H1>sane-microtek</H1>
Section: SANE Scanner Access Now Easy (5)<BR>Updated: 13 Jul 2008<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="ixAAB"></A>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
sane-microtek - SANE backend for Microtek scanners
<A NAME="lbAC">&nbsp;</A>
<H2>DESCRIPTION</H2>
The
<B>sane-microtek</B>
library implements a SANE (Scanner Access Now Easy) backend that
provides access to the &quot;second generation&quot; Microtek scanners. At present,
the following hardware is known to work with this backend:
<P>
<DL COMPACT><DT id="1"><DD>
Microtek ScanMaker E2, E3, E6
<BR>
Microtek ScanMaker II, IIG, IIHR, IISP, III
<BR>
Microtek ScanMaker 35t, 35t+, 45t
<BR>
Microtek ScanMaker 600GS, 600ZS (see bug notes)
<BR>
Agfa StudioScan
<BR>
Agfa StudioScan II, StudioScan IIsi
<BR>
Agfa Arcus II (but not the &quot;Arcus&quot;)
<BR>
Agfa DuoScan (preliminary)
<BR>
Vobis &quot;Highscreen Realscan&quot;
<BR>
Microtek Color PageWiz (preliminary)
<BR>
<P>
Transparent Media Adapter
<BR>
Document AutoFeeder
<BR>
</DL>
<P>
The driver supports line art, halftone, 8bpp gray, and 24bpp color scans
at normal and &quot;expanded&quot; resolutions (i.e. 1200x1200 on an E6), fast scans
for color previews, and downloadable gamma tables.
<P>
The supported scanners are all SCSI scanners. However, some parallel
port models may work (under Linux), if they use a parport-&gt;scsi chip,
and if you can find a scsi-&gt;parport driver. This is known to be the
case for the Color PageWiz.
<P>
The driver does
<B>not</B>
support the newest Microtek scanners, such as the V330 and V660, which use
a new and very different SCSI-II command set. For those, try the alternate
<B>microtek2</B>
backend. Most non-SCSI scanners would use the new command set. Most
scanners newer than the Scanmaker E6 would use the new command set.
<P>
If you own a Microtek scanner other than the ones listed above, tell us
what happens --- see the
<B>BUGS</B>
section at the end of this document.
<P>
Although this manual page is generally updated with each release,
up-to-date information on new releases and extraneous helpful hints
are available from the backend homepage:
<BR>
<DL COMPACT><DT id="2"><DD>
<B><A HREF="http://www.mir.com/mtek/">http://www.mir.com/mtek/</A></B>
</DL>
<P>
<A NAME="lbAD">&nbsp;</A>
<H2>DEVICE NAMES</H2>
This backend expects device names of the form:
<P>
<DL COMPACT><DT id="3"><DD>
<I>special</I>
</DL>
<P>
Where
<I>special</I>
is the UNIX path-name for the special device that corresponds to the
scanner. The special device name must be a generic SCSI device or a
symlink to such a device. Under Linux, such a device name could be
<I>/dev/sga</I>
or
<I>/dev/sge</I>,
for example.
<P>
<P>
<A NAME="lbAE">&nbsp;</A>
<H2>CONFIGURATION</H2>
The contents of the
<I>microtek.conf</I>
file is a list of device names that correspond to Microtek
scanners. Empty lines and lines starting with a hash mark (#) are
ignored. A sample configuration file is shown below:
<P>
<DL COMPACT><DT id="4"><DD>
/dev/scanner
<BR>
# this is a comment
<BR>
/dev/sge
</DL>
<P>
The configuration file may also contain the special tokens
<I>norealcal</I>
or
<I>noprecal.</I>
<I>norealcal</I>
will disable the use of magic, undocumented scanner calibration commands
which are known to work on the E6, but may not work with other models.
<I>noprecal</I>
will disable logic which tries to avoid scanner precalibration. This logic
would only have been activated if the magic calibration code was turned off.
<P>
<P>
<A NAME="lbAF">&nbsp;</A>
<H2>FILES</H2>
<DL COMPACT>
<DT id="5"><I>@CONFIGDIR@/microtek.conf</I>
<DD>
The backend configuration file (see also description of
<B>SANE_CONFIG_DIR</B>
below).
<DT id="6"><I>@LIBDIR@/libsane-microtek.a</I>
<DD>
The static library implementing this backend.
<DT id="7"><I>@LIBDIR@/libsane-microtek.so</I>
<DD>
The shared library implementing this backend (present on systems that
support dynamic loading).
<P>
</DL>
<A NAME="lbAG">&nbsp;</A>
<H2>ENVIRONMENT</H2>
<DL COMPACT>
<DT id="8"><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 (&quot;.&quot;) 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 &quot;/tmp/config:&quot; would result in directories &quot;tmp/config&quot;, &quot;.&quot;, and
&quot;@CONFIGDIR@&quot; being searched (in this order).
<DT id="9"><B>SANE_DEBUG_MICROTEK</B>
<DD>
If the library was compiled with debugging support enabled, this
environment variable controls the debug level for this backend.
A value of 128 requests maximally copious debug output; smaller
levels reduce verbosity.
<P>
</DL>
<A NAME="lbAH">&nbsp;</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)
<P>
<A NAME="lbAI">&nbsp;</A>
<H2>AUTHOR</H2>
Matt Marjanovic
<P>
<A NAME="lbAJ">&nbsp;</A>
<H2>BUGS</H2>
Known bugs/limitations are:
<P>
<DL COMPACT><DT id="10"><DD>
Brightness and contrast broken.
<BR>
The 600GS is grayscale only, and will lock up if you select color.
(Unfortunately, the 600GS and 600ZS are indistinguishable by software.)
<BR>
</DL>
<P>
i.e. don't complain about these --- but if brightness and/or contrast
<B>do</B>
work for you, please tell me.
<P>
If your scanner locks up, try setting the
<I>norealcal</I>
or
<I>noprecal</I>
option in the configuration file (first one, then both), and see if it helps.
(If it does, report it.)
<P>
Send lengthy bug reports and new scanner information to
<B><A HREF="mailto:mtek-bugs@mir.com">mtek-bugs@mir.com</A></B>.
All bug reports and new scanner inquiries should include an error log file.
You can generate copious
stderr output by setting the SANE_DEBUG_MICROTEK environment variable
described above. For example:
<P>
<DL COMPACT><DT id="11"><DD>
setenv SANE_DEBUG_MICROTEK 128
</DL>
<P>
More general comments, suggestions, and inquiries about frontends
or SANE should go to
<B><A HREF="mailto:sane-devel@alioth-lists.debian.net">sane-devel@alioth-lists.debian.net</A></B>,
the SANE Developers mailing list. Have a look at
<A HREF="http://www.sane-project.org/mailing-lists.html">http://www.sane-project.org/mailing-lists.html</A> concerning subscription to sane-devel.
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="12"><A HREF="#lbAB">NAME</A><DD>
<DT id="13"><A HREF="#lbAC">DESCRIPTION</A><DD>
<DT id="14"><A HREF="#lbAD">DEVICE NAMES</A><DD>
<DT id="15"><A HREF="#lbAE">CONFIGURATION</A><DD>
<DT id="16"><A HREF="#lbAF">FILES</A><DD>
<DT id="17"><A HREF="#lbAG">ENVIRONMENT</A><DD>
<DT id="18"><A HREF="#lbAH">SEE ALSO</A><DD>
<DT id="19"><A HREF="#lbAI">AUTHOR</A><DD>
<DT id="20"><A HREF="#lbAJ">BUGS</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>