202 lines
6.3 KiB
HTML
202 lines
6.3 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of sane-hs2p</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>sane-hs2p</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"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
sane-hs2p - SANE backend for Ricoh SCSI flatbed/ADF scanners
|
|
<A NAME="lbAC"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
The
|
|
<B>sane-hs2p</B>
|
|
|
|
library implements a SANE (Scanner Access Now Easy) backend that provides
|
|
access to the Ricoh IS450 family of scanners. Should also work with the IS420,
|
|
IS410, and IS430 scanners, but these are untested.
|
|
Please contact the maintainer or the sane-devel mailing list if you own such a scanner.
|
|
<P>
|
|
|
|
This backend is alpha-quality. It may have bugs and some scanners haven't been
|
|
tested at all. Be careful and pull the plug if the scanner causes unusual
|
|
noise.
|
|
<P>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DEVICE NAMES</H2>
|
|
|
|
This backend expects device names of the form:
|
|
<P>
|
|
|
|
<DL COMPACT><DT id="1"><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. The program
|
|
<I>sane-find-scanner</I>
|
|
|
|
helps to find out the correct device. Under Linux, such a device name could be
|
|
<I>/dev/sg0</I>
|
|
|
|
or
|
|
<I>/dev/sga</I>,
|
|
|
|
for example. See
|
|
<B><A HREF="/cgi-bin/man/man2html?5+sane-scsi">sane-scsi</A></B>(5)
|
|
|
|
for details.
|
|
<P>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>CONFIGURATION</H2>
|
|
|
|
The contents of the
|
|
<I>hs2p.conf</I>
|
|
|
|
file is a list of device names that correspond to SCSI
|
|
scanners. Empty lines and lines starting with a hash mark (#) are
|
|
ignored. See
|
|
<B><A HREF="/cgi-bin/man/man2html?5+sane-scsi">sane-scsi</A></B>(5)
|
|
|
|
on details of what constitutes a valid device name.
|
|
<P>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="2"><I>@CONFIGDIR@/hs2p.conf</I>
|
|
|
|
<DD>
|
|
The backend configuration file (see also description of
|
|
<B>SANE_CONFIG_DIR</B>
|
|
|
|
below).
|
|
<DT id="3"><I>@LIBDIR@/libsane-hs2p.a</I>
|
|
|
|
<DD>
|
|
The static library implementing this backend.
|
|
<DT id="4"><I>@LIBDIR@/libsane-hs2p.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="5"><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 @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 "/tmp/config:" would result in directories "tmp/config", ".", and
|
|
"@CONFIGDIR@" being searched (in this order).
|
|
<DT id="6"><B>SANE_DEBUG_HS2P</B>
|
|
|
|
<DD>
|
|
If the library was compiled with debug support enabled, this
|
|
environment variable controls the debug level for this backend.
|
|
A value of 255 prints all debug output. Smaller values reduce verbosity.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>CURRENT STATUS</H2>
|
|
|
|
The hs2p backend is now in version 1.00. All major scanning-related features
|
|
are supported, except for those features requiring the optional IPU. Scanning
|
|
from the flatbed or ADF (either simplex or duplex) is supported. Lineart,
|
|
halftone, 4-bit gray, and 8-bit gray are supported. Pre-set gamma tables and
|
|
halftone patterns are supported, as well as brightness, threshold, contrast.
|
|
Also supported is scan wait mode, binary and gray filtering, negative scanning,
|
|
and absolute or relative white setting. Printing with the optional endorser
|
|
also is supported.
|
|
<P>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>PLANNED FUNCTIONALITY</H2>
|
|
|
|
This scanner can scan from the ADF in continuous simplex mode.
|
|
Surprisingly, many scanners scan an entire document from the ADF
|
|
into memory before ejecting the sheet. Thus if the document is too
|
|
long, the scanner cannot hold the entire image data in memory.
|
|
But if the scanner would send its image data when its memory got full,
|
|
and then read the next buffer's worth of data, continuous scanning
|
|
could be achieved.
|
|
<P>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>MISSING FUNCTIONALITY</H2>
|
|
|
|
The SCSI commands for uploading (2AH) or downloading (28H)
|
|
custom halftone patterns (02H) and gamma vectors (03H) should work,
|
|
but require implementing the SANE Option-Value code to allow the
|
|
user to create the tables to be uploaded to the scanner. No support
|
|
for Maintenance Data (80H) is planned as this functionality is more
|
|
suited to a stand-alone utility to be used by a technician when
|
|
replacing the lamp or ADF unit. Nor is support for reading or changing
|
|
IPU (93H) parameters and adjustments planned, since my IS450 lacks
|
|
such a unit. The 31-byte Auto Photo/Letter struct and 21-byte Dynamic
|
|
threshold struct are documented in the hs2p-scsi.h file should someone
|
|
wish to use their IPU for image data processing.
|
|
<P>
|
|
<A NAME="lbAK"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?7+sane">sane</A></B>(7),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+sane-find-scanner">sane-find-scanner</A></B>(1),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+sane-scsi">sane-scsi</A></B>(5),
|
|
|
|
<P>
|
|
<A NAME="lbAL"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
jeremy <<A HREF="mailto:jeremy@acjlaw.net">jeremy@acjlaw.net</A>>
|
|
<BR>
|
|
|
|
Maintained by Jeremy Johnson <<A HREF="mailto:jeremy@acjlaw.net">jeremy@acjlaw.net</A>>
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="7"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="8"><A HREF="#lbAC">DESCRIPTION</A><DD>
|
|
<DT id="9"><A HREF="#lbAD">DEVICE NAMES</A><DD>
|
|
<DT id="10"><A HREF="#lbAE">CONFIGURATION</A><DD>
|
|
<DT id="11"><A HREF="#lbAF">FILES</A><DD>
|
|
<DT id="12"><A HREF="#lbAG">ENVIRONMENT</A><DD>
|
|
<DT id="13"><A HREF="#lbAH">CURRENT STATUS</A><DD>
|
|
<DT id="14"><A HREF="#lbAI">PLANNED FUNCTIONALITY</A><DD>
|
|
<DT id="15"><A HREF="#lbAJ">MISSING FUNCTIONALITY</A><DD>
|
|
<DT id="16"><A HREF="#lbAK">SEE ALSO</A><DD>
|
|
<DT id="17"><A HREF="#lbAL">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:05 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|