804 lines
22 KiB
HTML
804 lines
22 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of sane-bh</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>sane-bh</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-bh - SANE backend for Bell+Howell Copiscan II series document
|
|
scanners
|
|
<A NAME="lbAC"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
The
|
|
<B>sane-bh</B>
|
|
|
|
library implements a SANE (Scanner Access Now Easy) backend that
|
|
provides access to Bell+Howell Copiscan II series document
|
|
scanners. The Copiscan II 6338 has been the primary scanner model
|
|
used during development and testing, but since the programming interface
|
|
for the entire series is consistent the backend should work for the
|
|
following scanner models.
|
|
<P>
|
|
|
|
<DL COMPACT><DT id="1"><DD>
|
|
COPISCAN II 6338 Duplex Scanner with ACE
|
|
<BR>
|
|
|
|
COPISCAN II 2135 Simplex Scanner
|
|
<BR>
|
|
|
|
COPISCAN II 2137(A) Simplex Scanner (with ACE)
|
|
<BR>
|
|
|
|
COPISCAN II 2138A Simplex Scanner with ACE
|
|
<BR>
|
|
|
|
COPISCAN II 3238 Simplex Scanner
|
|
<BR>
|
|
|
|
COPISCAN II 3338(A) Simplex Scanner (with ACE)
|
|
<BR>
|
|
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
If you have a Bell+Howell scanner and are able to test it with this
|
|
backend, please contact
|
|
<I><A HREF="mailto:sane-devel@alioth-lists.debian.net">sane-devel@alioth-lists.debian.net</A></I>
|
|
|
|
with the model number and testing results. 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. Additionally, the author is curious as to the likelihood of using
|
|
this backend with the newer 4000 and 8000 series scanners. If you have such a
|
|
beast, please let me know.
|
|
<P>
|
|
|
|
The Bell+Howell Copiscan II series document scanners are high
|
|
volume, high throughput scanners designed for document scanning
|
|
applications. As such, they are lineart/grayscale scanners supporting
|
|
a fixed number of fairly low resolutions (e.g. 200/240/300dpi).
|
|
However, they do have a number of interesting and useful features
|
|
suited to needs of document imaging applications.
|
|
This backend attempts to support as many of these features as possible.
|
|
<P>
|
|
|
|
The main technical reference used in writing this backend is the
|
|
<B>Bell and Howell Copiscan II Remote SCSI Controller (RSC) OEM</B>
|
|
|
|
<B>Technical Manual Version 1.5.</B>
|
|
|
|
The Linux SCSI programming HOWTO, the SANE API documentation, and
|
|
SANE source code were also extremely valuable resources.
|
|
<P>
|
|
<P>
|
|
|
|
The latest backend release, additional information and helpful hints
|
|
are available from the backend homepage:
|
|
<BR>
|
|
|
|
<DL COMPACT><DT id="2"><DD>
|
|
<B><A HREF="http://www.martoneconsulting.com/sane-bh.html">http://www.martoneconsulting.com/sane-bh.html</A></B>
|
|
|
|
</DL>
|
|
|
|
<A NAME="lbAD"> </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 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 takes a format such as
|
|
<I>/dev/sga</I>
|
|
|
|
or
|
|
<I>/dev/sg0</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>bh.conf</I>
|
|
|
|
file is a list of device names that correspond to Bell+Howell
|
|
scanners. See <A HREF="/cgi-bin/man/man2html?5+sane-scsi">sane-scsi</A>(5) on details of what constitutes a valid device name.
|
|
Additionally, options can be specified; these lines begin with the word "option".
|
|
Each option is described in detail below. Empty lines and lines starting
|
|
with a hash mark (#) are ignored.
|
|
<P>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
The following options can be specified in the
|
|
<I>bh.conf</I>
|
|
|
|
file.
|
|
<DL COMPACT>
|
|
<DT id="4"><B>disable-optional-frames</B>
|
|
|
|
<DD>
|
|
This option prevents the backend from sending any optional frames. This
|
|
option may be useful when dealing with frontends which do not support these
|
|
optional frames. When this option is in effect, the data is sent in a
|
|
SANE_FRAME_GRAY frame. The optional frames sent by this backend are:
|
|
SANE_FRAME_G31D, SANE_FRAME_G32D, SANE_FRAME_G42D and SANE_FRAME_TEXT.
|
|
These frames are generated based on the compression and barcode options.
|
|
These frames are never sent in preview mode.
|
|
<DT id="5"><B>fake-inquiry</B>
|
|
|
|
<DD>
|
|
This option is used for debugging purposes and its use is not encouraged.
|
|
Essentially, it allows the backend to initialize in the absence of
|
|
a scanner. This is useful for development and not much else.
|
|
This option must be specified earlier in the configuration file than
|
|
the devices which are to be "faked".
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="6"><I>@CONFIGDIR@/bh.conf</I>
|
|
|
|
<DD>
|
|
The backend configuration file (see also description of
|
|
<B>SANE_CONFIG_DIR</B>
|
|
|
|
below).
|
|
<DT id="7"><I>@LIBDIR@/libsane-bh.a</I>
|
|
|
|
<DD>
|
|
The static library implementing this backend.
|
|
<DT id="8"><I>@LIBDIR@/libsane-bh.so</I>
|
|
|
|
<DD>
|
|
The shared library implementing this backend (present on systems that
|
|
support dynamic loading).
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>ENVIRONMENT</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="9"><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="10"><B>SANE_DEBUG_BH</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 255 requests all debug output to be printed. Smaller
|
|
levels reduce verbosity.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>SUPPORTED FEATURES</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="11"><B>ADF support</B>
|
|
|
|
<DD>
|
|
With document scanners, automatic document feeder (ADF) support is a key
|
|
feature. The backend supports the ADF by default and returns
|
|
<B>SANE_STATUS_NO_DOCS</B>
|
|
|
|
when the out-of-paper condition is detected. The SANE frontend
|
|
<B>scanadf</B>
|
|
|
|
is a command line frontend that supports multi-page scans. It has been
|
|
used successfully with this backend. The SANE frontend
|
|
<B>xsane</B>
|
|
|
|
is an improved GUI frontend by Oliver Rauch. Support for multi-page
|
|
scans is included in xsane version 0.35 and above.
|
|
<P>
|
|
<DT id="12"><B>Duplex scanning</B>
|
|
|
|
<DD>
|
|
Some models, such as the COPISCAN II 6338, support duplex scanning. That
|
|
is, they scan both sides of the document during a single pass through the
|
|
scanner (the scanner has two cameras). This backend supports duplex
|
|
scanning (with the
|
|
<B>--duplex</B>
|
|
|
|
option). The front and back page images are delivered consecutively
|
|
as if they were separately scanned pages.
|
|
<P>
|
|
<DT id="13"><B>Hardware compression</B>
|
|
|
|
<DD>
|
|
The scanner is capable of compressing the data into several industry
|
|
standard formats (CCITT G3, CCITT G3-2D, CCITT G4). This results in
|
|
increased performance as less data is passed from the scanner to the
|
|
host over the SCSI bus. The backend supports these compression formats
|
|
via the
|
|
<B>--g31d, --g32d, --g42d</B>
|
|
|
|
options, respectively. Many SANE frontends are not equipped to deal with
|
|
these formats, however. The SANE frontend
|
|
<B>scanadf</B>
|
|
|
|
supports these optional frame formats. The compressed image data
|
|
is written directly to a file and can then be processed by a scan-script
|
|
using the
|
|
<B>--scan-script</B>
|
|
|
|
option. Examples of this are given on the scanadf homepage.
|
|
<P>
|
|
<DT id="14"><B>Automatic Border Detection</B>
|
|
|
|
<DD>
|
|
The scanner can automatically detect the paper size and adjust the
|
|
scanning window geometry appropriately. The backend supports this
|
|
useful feature with the
|
|
<B>--autoborder</B>
|
|
|
|
option. It is enabled by default.
|
|
<P>
|
|
<DT id="15"><B>Batch Mode Scanning</B>
|
|
|
|
<DD>
|
|
The batch scan mode allows for maximum throughput. The Set Window
|
|
parameters must remain constant during the entire batch.
|
|
<P>
|
|
<DT id="16"><B>Icon Generation</B>
|
|
|
|
<DD>
|
|
The Icon function generates a thumbnail of the full page image, that can be
|
|
transferred as if it were a separate page. This allows the host to
|
|
quickly display a thumbnail representation during the scanning operation.
|
|
Perhaps this would be a great way of implementing a preview scan, but
|
|
since a normal scan is so quick, it might not be worth the trouble.
|
|
<P>
|
|
<DT id="17"><B>Multiple Sections</B>
|
|
|
|
<DD>
|
|
Multiple sections (scanning sub-windows) can be defined for the front and
|
|
back pages. Each section can have different characteristics (e.g. geometry,
|
|
compression). The sections are returned as if they were separately
|
|
scanned images. Additionally sections can be used to greatly enhance the
|
|
accuracy and efficiency of the barcode/patchcode decoding process by
|
|
limiting the search area to a small subset of the page. Most Copiscan II
|
|
series scanners support up to 8 user-defined sections.
|
|
<P>
|
|
<DT id="18"><B>Support Barcode/Patchcode Decoding</B>
|
|
|
|
<DD>
|
|
The RSC unit can recognize Bar and Patch Codes of various types embedded
|
|
in the scanned image. The codes are decoded and the data is returned to
|
|
the frontend as a text frame. The text is encoded in xml and contains
|
|
a great deal of information about the decoded data such as the location
|
|
where it was found, its orientation, and the time it took to find.
|
|
Further information on the content of this text frame as well as some
|
|
barcode decoding examples can be found on the backend homepage.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>LIMITATIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="19"><B>Decoding a single barcode type per scan</B>
|
|
|
|
<DD>
|
|
The RSC unit can search for up to six different barcode types at a time.
|
|
While the code generally supports this as well, the
|
|
<B>--barcode-search-bar</B>
|
|
|
|
option only allows the user to specify a single barcode type.
|
|
Perhaps another option which allows a comma separated list of barcode
|
|
type codes could be added to address this.
|
|
<DT id="20"><B>Scanning a fixed number of pages in batch mode</B>
|
|
|
|
<DD>
|
|
The separation of front and back end functionality in SANE presents a
|
|
problem in supporting the 'cancel batch' functionality in the scanner.
|
|
In batch mode, the scanner is always a page ahead of the host. The host,
|
|
knowing ahead of time which page will be the last, can cancel batch mode
|
|
prior to initiating the last scan command. Currently, there is no mechanism
|
|
available for the frontend to pass this knowledge to the backend.
|
|
If batch mode is enabled and the --end-count terminates a scanadf session,
|
|
an extra page will be pulled through the scanner, but is neither read
|
|
nor delivered to the frontend. The issue can be avoided by specifying
|
|
--batch=no when scanning a fixed number of pages.
|
|
<DT id="21"><B>Revision 1.2 Patch detector</B>
|
|
|
|
<DD>
|
|
There is an enhanced patchcode detection algorithm available in the RSC
|
|
with revision 1.2 or higher that is faster and more reliable than the
|
|
standard Bar/Patch code decoder. This is not currently supported.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAK"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="22"><B>Scan Mode Options:</B>
|
|
|
|
<DD>
|
|
<DT id="23"><B>--preview[=(yes|no)] [no]</B>
|
|
|
|
<DD>
|
|
Request a preview-quality scan. When preview is set to yes image
|
|
compression is disabled and the image is delivered in a
|
|
SANE_FRAME_GRAY frame.
|
|
<DT id="24"><B>--mode lineart|halftone [lineart]</B>
|
|
|
|
<DD>
|
|
Selects the scan mode (e.g., lineart,monochrome, or color).
|
|
<DT id="25"><B>--resolution 200|240|300dpi [200]</B>
|
|
|
|
<DD>
|
|
Sets the resolution of the scanned image. Each scanner model supports
|
|
a list of standard resolutions; only these resolutions can be used.
|
|
<DT id="26"><B>--compression none|g31d|g32d|g42d [none]</B>
|
|
|
|
<DD>
|
|
Sets the compression mode of the scanner. Determines the type of data
|
|
returned from the scanner. Values are:
|
|
<DL COMPACT><DT id="27"><DD>
|
|
<BR>
|
|
|
|
<B>none</B>
|
|
|
|
- uncompressed data - delivered in a SANE_FRAME_GRAY frame
|
|
<BR>
|
|
|
|
<B>g31d</B>
|
|
|
|
- CCITT G3 1 dimension (MH) - delivered in a SANE_FRAME_G31D frame
|
|
<BR>
|
|
|
|
<B>g32d</B>
|
|
|
|
- CCITT G3 2 dimensions (MR, K=4) - delivered in a SANE_FRAME_G32D frame
|
|
<BR>
|
|
|
|
<B>g42d</B>
|
|
|
|
- CCITT G4 (MMR) - delivered in a SANE_FRAME_G42D frame
|
|
<BR>
|
|
|
|
NOTE: The use of g31d, g32d, and g42d compression values causes the backend
|
|
to generate optional frame formats which may not be supported by all SANE
|
|
frontends.
|
|
</DL>
|
|
|
|
<P>
|
|
<DT id="28"><B>Geometry Options:</B>
|
|
|
|
<DD>
|
|
<DT id="29"><B>--autoborder[=(yes|no)] [yes]</B>
|
|
|
|
<DD>
|
|
Enable/Disable automatic image border detection. When enabled, the RSC unit
|
|
automatically detects the image area and sets the window geometry to match.
|
|
<DT id="30"><B>--paper-size Custom|Letter|Legal|A3|A4|A5|A6|B4|B5 [Custom]</B>
|
|
|
|
<DD>
|
|
Specify the scan window geometry by specifying the paper size of the
|
|
documents to be scanned.
|
|
<DT id="31"><B>--tl-x 0..297.18mm [0]</B>
|
|
|
|
<DD>
|
|
Top-left x position of scan area.
|
|
<DT id="32"><B>--tl-y 0..431.8mm [0]</B>
|
|
|
|
<DD>
|
|
Top-left y position of scan area.
|
|
<DT id="33"><B>--br-x 0..297.18mm [297.18]</B>
|
|
|
|
<DD>
|
|
Bottom-right x position of scan area.
|
|
<DT id="34"><B>--br-y 0..431.8mm [431.8]</B>
|
|
|
|
<DD>
|
|
Bottom-right y position of scan area.
|
|
<DT id="35"><B>Feeder Options:</B>
|
|
|
|
<DD>
|
|
<DT id="36"><B>--source Automatic Document Feeder|Manual Feed Tray [Automatic Document Feeder]</B>
|
|
|
|
<DD>
|
|
Selects the scan source (such as a document feeder). This option is provided
|
|
to allow multiple image scans with xsane; it has no other purpose.
|
|
<DT id="37"><B>--batch[=(yes|no)] [no]</B>
|
|
|
|
<DD>
|
|
Enable/disable batch mode scanning. Batch mode allows scanning at maximum throughput
|
|
by buffering within the RSC unit. This option is recommended when performing multiple
|
|
pages scans until the feeder is emptied.
|
|
<DT id="38"><B>--duplex[=(yes|no)] [no]</B>
|
|
|
|
<DD>
|
|
Enable duplex (dual-sided) scanning. The scanner takes an image of each side
|
|
of the document during a single pass through the scanner. The front page is
|
|
delivered followed by the back page. Most options, such as compression,
|
|
affect both the front and back pages.
|
|
<DT id="39"><B>--timeout-adf 0..255 [0]</B>
|
|
|
|
<DD>
|
|
Sets the timeout in seconds for the automatic document feeder (ADF).
|
|
The value 0 specifies the hardware default value which varies based
|
|
on the scanner model.
|
|
<DT id="40"><B>--timeout-manual 0..255 [0]</B>
|
|
|
|
<DD>
|
|
Sets the timeout in seconds for semi-automatic feeder. The value 0 specifies
|
|
the hardware default value which varies based on the scanner model.
|
|
<DT id="41"><B>--check-adf[=(yes|no)] [no]</B>
|
|
|
|
<DD>
|
|
Check ADF Status prior to starting scan using the OBJECT POSITION command.
|
|
Note that this feature requires RSC firmware level 1.5 or higher and dip
|
|
switch 4 must be in the on position. NOTE: This option has not been tested
|
|
extensively and may produce undesirable results.
|
|
<DT id="42"><B>Enhancement:</B>
|
|
|
|
<DD>
|
|
<DT id="43"><B>--control-panel[=(yes|no)] [yes]</B>
|
|
|
|
<DD>
|
|
Enables the scanner's control panel for selecting image enhancement
|
|
parameters. When the option is set to no the following options are
|
|
used to control image enhancement. See the Bell+Howell scanner users'
|
|
guide for complete information on ACE functionality.
|
|
<DT id="44"><B>--ace-function -4..4 [3]</B>
|
|
|
|
<DD>
|
|
Specify the Automatic Contrast Enhancement (ACE) Function.
|
|
<DT id="45"><B>--ace-sensitivity 0..9 [5]</B>
|
|
|
|
<DD>
|
|
Specify the Automatic Contrast Enhancement (ACE) Sensitivity.
|
|
<DT id="46"><B>--brightness 0..255 [0]</B>
|
|
|
|
<DD>
|
|
Controls the brightness of the acquired image. Ignored for ACE
|
|
capable scanners.
|
|
<DT id="47"><B>--threshold 0..255 [0]</B>
|
|
|
|
<DD>
|
|
Select minimum-brightness to get a white point. Ignored for ACE
|
|
capable scanners.
|
|
<DT id="48"><B>--contrast 0..255 [inactive]</B>
|
|
|
|
<DD>
|
|
Controls the contrast of the acquired image. This option is not
|
|
currently used by the scanner (and perhaps never will be).
|
|
<DT id="49"><B>--negative[=(yes|no)] [no]</B>
|
|
|
|
<DD>
|
|
Swap black and white, yielding a reverse-video image.
|
|
<DT id="50"><B>Icon:</B>
|
|
|
|
<DD>
|
|
<DT id="51"><B>--icon-width 0..3600pel (in steps of 8) [0]</B>
|
|
|
|
<DD>
|
|
Width of icon (thumbnail) image in pixels.
|
|
<DT id="52"><B>--icon-length 0..3600pel (in steps of 8) [0]</B>
|
|
|
|
<DD>
|
|
Length of icon (thumbnail) image in pixels.
|
|
<DT id="53"><B>Barcode Options:</B>
|
|
|
|
<DD>
|
|
<DT id="54"><B>--barcode-search-bar <see list> [none]</B>
|
|
|
|
<DD>
|
|
Specifies the barcode type to search for. If this option is
|
|
not specified, or specified with a value of none, then the barcode decoding
|
|
feature is completely disabled. The valid barcode type are:
|
|
<DL COMPACT><DT id="55"><DD>
|
|
<BR>
|
|
|
|
<B>none</B>
|
|
|
|
<BR>
|
|
|
|
<B>ean-8</B>
|
|
|
|
<BR>
|
|
|
|
<B>ean-13</B>
|
|
|
|
<BR>
|
|
|
|
<B>reserved-ean-add</B>
|
|
|
|
<BR>
|
|
|
|
<B>code39</B>
|
|
|
|
<BR>
|
|
|
|
<B>code2-5-interleaved</B>
|
|
|
|
<BR>
|
|
|
|
<B>code2-5-3lines-matrix</B>
|
|
|
|
<BR>
|
|
|
|
<B>code2-5-3lines-datalogic</B>
|
|
|
|
<BR>
|
|
|
|
<B>code2-5-5lines-industrial</B>
|
|
|
|
<BR>
|
|
|
|
<B>patchcode</B>
|
|
|
|
<BR>
|
|
|
|
<B>codabar</B>
|
|
|
|
<BR>
|
|
|
|
<B>codabar-with-start-stop</B>
|
|
|
|
<BR>
|
|
|
|
<B>code39ascii</B>
|
|
|
|
<BR>
|
|
|
|
<B>code128</B>
|
|
|
|
<BR>
|
|
|
|
<B>code2-5-5lines-iata</B>
|
|
|
|
<BR>
|
|
|
|
</DL>
|
|
|
|
<DT id="56"><B>--barcode-search-count 1..7 [3]</B>
|
|
|
|
<DD>
|
|
Number of times that the RSC performs the decoding algorithm. Specify
|
|
the smallest number possible to increase performance. If you are having
|
|
trouble recognizing barcodes, it is suggested that you increase this option
|
|
to its maximum value (7).
|
|
<DT id="57"><B>--barcode-search-mode <see list> [horiz-vert]</B>
|
|
|
|
<DD>
|
|
Chooses the orientation of barcodes to be searched. The valid orientations
|
|
are:
|
|
<DL COMPACT><DT id="58"><DD>
|
|
<BR>
|
|
|
|
<B>horiz-vert</B>
|
|
|
|
<BR>
|
|
|
|
<B>horizontal</B>
|
|
|
|
<BR>
|
|
|
|
<B>vertical</B>
|
|
|
|
<BR>
|
|
|
|
<B>vert-horiz</B>
|
|
|
|
</DL>
|
|
|
|
<DT id="59"><B>--barcode-hmin 0..1660mm [5]</B>
|
|
|
|
<DD>
|
|
Sets the barcode minimum height in millimeters (larger values increase
|
|
recognition speed). Of course the actual barcodes in the document must be
|
|
of sufficient size.
|
|
<DT id="60"><B>--barcode-search-timeout 20..65535us [10000]</B>
|
|
|
|
<DD>
|
|
Sets the timeout for barcode searching in milliseconds. When the timeout
|
|
expires, the decoder will stop trying to decode barcodes.
|
|
<DT id="61"><B>--section <string> []</B>
|
|
|
|
<DD>
|
|
Specifies a series of image sections. A section can be used to gather
|
|
a subset image or to provide a small area for barcode decoding.
|
|
Each section is specified in the following format (units are in millimeters):
|
|
</DL>
|
|
<P>
|
|
|
|
<B><width>x<height>+<top-left-x>+<top-left-y>[:functioncode...]</B>
|
|
|
|
<P>
|
|
|
|
Multiple sections can be specified by separating them with commas.
|
|
<P>
|
|
|
|
For example
|
|
<B>76.2x25.4+50.8+0:frontbar</B>
|
|
|
|
identifies an area 3 inches wide and 1 inch high with a top left corner
|
|
at the top of the page two inches from the left hand edge of the page.
|
|
This section will be used for barcode decoding on the front page only.
|
|
<P>
|
|
|
|
For example
|
|
<B>50.8x25.4+25.4+0:frontbar:front:g42d</B>
|
|
|
|
identifies an area 2 inches wide and 1 inch high with a top left corner
|
|
at the top of the page one inch from the left hand edge of the page.
|
|
This section will be used for barcode decoding on the front page as well
|
|
as generating an image compressed in g42d format.
|
|
<P>
|
|
|
|
Ordinarily barcodes are searched in the entire image. However, when you
|
|
specify sections all barcode searching is done within the specific sections
|
|
identified. This can significantly speed up the decoding process.
|
|
<P>
|
|
The following functioncodes are available:
|
|
<DL COMPACT><DT id="62"><DD>
|
|
<BR>
|
|
|
|
<B>front</B>
|
|
|
|
- generate an image for the front page section
|
|
<BR>
|
|
|
|
<B>back</B>
|
|
|
|
- generate an image for the back page section
|
|
<BR>
|
|
|
|
<B>frontbar</B>
|
|
|
|
- perform barcode search in front page section
|
|
<BR>
|
|
|
|
<B>backbar</B>
|
|
|
|
- perform barcode search in back page section
|
|
<BR>
|
|
|
|
<B>frontpatch</B>
|
|
|
|
- perform patchcode search in front page section
|
|
<BR>
|
|
|
|
<B>backpatch</B>
|
|
|
|
- perform patchcode search in back page section
|
|
<BR>
|
|
|
|
<B>none</B>
|
|
|
|
- use no image compression
|
|
<BR>
|
|
|
|
<B>g31d</B>
|
|
|
|
- use Group 3 1 dimension image compression
|
|
<BR>
|
|
|
|
<B>g32d</B>
|
|
|
|
- use Group 3 2 dimensions image compression
|
|
<BR>
|
|
|
|
<B>g42d</B>
|
|
|
|
- use Group 4 2 dimensions image compression
|
|
<BR>
|
|
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
If you omit a compression functioncode, the full page compression setting
|
|
is used. If you specify multiple compression functioncodes, only the
|
|
last one is used.
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="63"><B>--barcode-relmax 0..255 [0]</B>
|
|
|
|
<DD>
|
|
Specifies the maximum relation from the widest to the smallest bar.
|
|
<DT id="64"><B>--barcode-barmin 0..255 [0]</B>
|
|
|
|
<DD>
|
|
Specifies the minimum number of bars in Bar/Patch code.
|
|
<DT id="65"><B>--barcode-barmax 0..255 [0]</B>
|
|
|
|
<DD>
|
|
Specifies the maximum number of bars in a Bar/Patch code.
|
|
<DT id="66"><B>--barcode-contrast 0..6 [3]</B>
|
|
|
|
<DD>
|
|
Specifies the image contrast used in decoding. Use higher values when
|
|
there are more white pixels in the code.
|
|
<DT id="67"><B>--barcode-patchmode 0..1 [0]</B>
|
|
|
|
<DD>
|
|
Controls Patch Code detection.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAL"> </A>
|
|
<H2>BUGS</H2>
|
|
|
|
This is a new backend; detailed bug reports are welcome -- and expected ;)
|
|
<P>
|
|
|
|
If you have found something that you think is a bug, please attempt to
|
|
recreate it with the SANE_DEBUG_BH environment variable set to
|
|
255, and send a report detailing the conditions surrounding the bug to
|
|
<I><A HREF="mailto:sane-devel@alioth-lists.debian.net">sane-devel@alioth-lists.debian.net</A></I>.
|
|
|
|
<P>
|
|
<A NAME="lbAM"> </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), <A HREF="/cgi-bin/man/man2html?1+scanimage">scanimage</A>(1), <A HREF="/cgi-bin/man/man2html?1+scanadf">scanadf</A>(1)
|
|
<P>
|
|
<A NAME="lbAN"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
The sane-bh backend was written by Tom Martone, based on the sane-ricoh
|
|
backend by Feico W. Dillema and the bnhscan program by Sean Reifschneider
|
|
of tummy.com ltd. Some 8000 enhancements added by Mark Temple.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="68"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="69"><A HREF="#lbAC">DESCRIPTION</A><DD>
|
|
<DT id="70"><A HREF="#lbAD">DEVICE NAMES</A><DD>
|
|
<DT id="71"><A HREF="#lbAE">CONFIGURATION</A><DD>
|
|
<DT id="72"><A HREF="#lbAF">OPTIONS</A><DD>
|
|
<DT id="73"><A HREF="#lbAG">FILES</A><DD>
|
|
<DT id="74"><A HREF="#lbAH">ENVIRONMENT</A><DD>
|
|
<DT id="75"><A HREF="#lbAI">SUPPORTED FEATURES</A><DD>
|
|
<DT id="76"><A HREF="#lbAJ">LIMITATIONS</A><DD>
|
|
<DT id="77"><A HREF="#lbAK">OPTIONS</A><DD>
|
|
<DT id="78"><A HREF="#lbAL">BUGS</A><DD>
|
|
<DT id="79"><A HREF="#lbAM">SEE ALSO</A><DD>
|
|
<DT id="80"><A HREF="#lbAN">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>
|