274 lines
7.4 KiB
HTML
274 lines
7.4 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of sane-agfafocus</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>sane-agfafocus</H1>
|
|
Section: SANE Scanner Access Now Easy (5)<BR>Updated: 10 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"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
sane-agfafocus - SANE backend for AGFA Focus flatbed scanners
|
|
<A NAME="lbAC"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
The
|
|
<B>sane-agfafocus</B>
|
|
|
|
library implements a SANE (Scanner Access Now Easy) backend that
|
|
provides access to AGFA Focus flatbed scanners. At present, the following
|
|
scanners are supported from this backend:
|
|
<P>
|
|
|
|
<DL COMPACT><DT id="1"><DD>
|
|
AGFA Focus GS Scanner (6 bit gray scale) (untested)
|
|
<BR>
|
|
|
|
AGFA Focus Lineart Scanner (lineart) (untested)
|
|
<BR>
|
|
|
|
AGFA Focus II (8 bit gray scale) (untested)
|
|
<BR>
|
|
|
|
AGFA Focus Color (24 bit color 3-pass)
|
|
<BR>
|
|
|
|
AGFA Focus Color Plus (24 bit color 3-pass)
|
|
<BR>
|
|
|
|
<P>
|
|
|
|
Siemens S9036 (8 bit gray scale) (untested)
|
|
<BR>
|
|
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
The driver supports line art, 6bpp and 8bpp gray, 18bpp and 24bpp
|
|
color scans.
|
|
<P>
|
|
|
|
If you own a scanner other than the ones listed above that works with
|
|
this backend, please let us know by sending the scanner's model name,
|
|
SCSI id, and firmware revision to
|
|
<I><A HREF="mailto:sane-devel@alioth-lists.debian.net">sane-devel@alioth-lists.debian.net</A></I>.
|
|
|
|
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>
|
|
|
|
All of these scanners are pre-SCSI-2, and do not even report properly
|
|
to SCSI Inquiry. This is typically evident in SCSI bus scans, where
|
|
the scanner will come up with only garbage as vendor and models strings.
|
|
<P>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DEVICE NAMES</H2>
|
|
|
|
This backend expects device names of the form:
|
|
<P>
|
|
|
|
<DL COMPACT><DT id="2"><DD>
|
|
<I>special</I>
|
|
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
Where
|
|
<I>special</I>
|
|
|
|
is either the path-name for the special device that corresponds to a
|
|
SCSI scanner. For SCSI scanners, 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. See <A HREF="/cgi-bin/man/man2html?5+sane-scsi">sane-scsi</A>(5) for details.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>CONFIGURATION</H2>
|
|
|
|
The contents of the
|
|
<I>agfafocus.conf</I>
|
|
|
|
file is a list of device names that correspond to AGFA Focus
|
|
scanners. Empty lines and lines starting with a hash mark (#) are
|
|
ignored. A sample configuration file is shown below:
|
|
<P>
|
|
|
|
<DL COMPACT><DT id="3"><DD>
|
|
/dev/scanner
|
|
<BR>
|
|
|
|
# this is a comment
|
|
<BR>
|
|
|
|
/dev/sge
|
|
</DL>
|
|
|
|
<P>
|
|
<P>
|
|
|
|
<A NAME="lbAF"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="4"><I>/etc/sane.d/agfafocus.conf</I>
|
|
|
|
<DD>
|
|
The backend configuration file (see also description of
|
|
<B>SANE_CONFIG_DIR</B>
|
|
|
|
below).
|
|
<DT id="5"><I>/usr/lib/libsane-agfafocus.a</I>
|
|
|
|
<DD>
|
|
The static library implementing this backend.
|
|
<DT id="6"><I>/usr/lib/libsane-agfafocus.so</I>
|
|
|
|
<DD>
|
|
The shared library implementing this backend (present on systems that
|
|
support dynamic loading).
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>ENVIRONMENT</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="7"><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 /etc/sane.d. 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
|
|
"/etc/sane.d" being searched (in this order).
|
|
<DT id="8"><B>SANE_DEBUG_AGFAFOCUS</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_AGFAFOCUS values:
|
|
<P>
|
|
<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>
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>MISSING FUNCTIONALITY</H2>
|
|
|
|
<P>
|
|
Uploading of dither matrices and tonecurves has been implemented, but
|
|
so far has not proven to be useful for anything. For this reason
|
|
these options have been disabled.
|
|
<P>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
The scanners that do not support disconnect have problems with SCSI
|
|
timeouts if the SCSI bus gets loaded, eg. if you do a kernel build at
|
|
the same time as scanning. To see if your scanner supports
|
|
disconnect, run "SANE_DEBUG_AGFAFOCUS=128 scanimage -L" in sh and look
|
|
for the "disconnect:" line)
|
|
<P>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>DEBUG</H2>
|
|
|
|
If you have problems with SANE not detecting your scanner, make sure the
|
|
Artec backend is disabled. Somehow, this backend causes at least my scanner
|
|
not to respond correctly to SCSI inquiry commands.
|
|
<P>
|
|
|
|
If you encounter a bug please set the environment variable
|
|
SANE_DEBUG_AGFAFOCUS to 128 and try to regenerate the problem. Then
|
|
send me a report with the log attached.
|
|
<P>
|
|
|
|
If you encounter a SCSI bus error or trimmed and/or displaced images please
|
|
also set the environment variable SANE_DEBUG_SANEI_SCSI to 128 before sending
|
|
me the report.
|
|
<P>
|
|
<A NAME="lbAK"> </A>
|
|
<H2>TODO</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="9"><B>More scanners?</B>
|
|
|
|
<DD>
|
|
<P>
|
|
The AGFA ACS and ARCUS scanners are similar to the FOCUS scanners.
|
|
The driver could probably be extended to support these scanners
|
|
without too many changes. I do not have access to such scanners, and
|
|
cannot add support for it. However, if you are in possession of such
|
|
a scanner, I could be helpful in adding support for these scanners.
|
|
<P>
|
|
The AGFA HORIZON scanners are SCSI-2 scanners, and it would probably
|
|
be easier to support these scanners in a SCSI-2 compliant backend.
|
|
</DL>
|
|
<A NAME="lbAL"> </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="lbAM"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
<P>
|
|
Ingo Schneider and Karl Anders Øygard.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="10"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="11"><A HREF="#lbAC">DESCRIPTION</A><DD>
|
|
<DT id="12"><A HREF="#lbAD">DEVICE NAMES</A><DD>
|
|
<DT id="13"><A HREF="#lbAE">CONFIGURATION</A><DD>
|
|
<DT id="14"><A HREF="#lbAF">FILES</A><DD>
|
|
<DT id="15"><A HREF="#lbAG">ENVIRONMENT</A><DD>
|
|
<DT id="16"><A HREF="#lbAH">MISSING FUNCTIONALITY</A><DD>
|
|
<DT id="17"><A HREF="#lbAI">BUGS</A><DD>
|
|
<DT id="18"><A HREF="#lbAJ">DEBUG</A><DD>
|
|
<DT id="19"><A HREF="#lbAK">TODO</A><DD>
|
|
<DT id="20"><A HREF="#lbAL">SEE ALSO</A><DD>
|
|
<DT id="21"><A HREF="#lbAM">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>
|