NAME
zbarimg - scan and decode bar codes from image file(s)
SYNOPSIS
zbarimg [-qv] [--quiet] [--verbose[=n]]
{-dD | --display | --nodisplay | --xml | --noxml |
-S[symbology.]config[=value] | --set [symbology.]config[=value]
| image...}
zbarimg {-h | --help | --version}
DESCRIPTION
For each specified image file zbarimg scans the image for bar codes and
prints any decoded data to stdout. Images may optionally be displayed
to the screen.
The underlying library currently supports EAN-13 (including UPC and
ISBN subsets), EAN-8, Code 128, Code 39, and Interleaved 2 of 5
symbologies. The specific type of each detected symbol is printed with
the decoded data.
Note that "image" in this context refers to any format supported by
ImageMagick, including many vector formats such as PDF and PostScript.
Keep in mind that vector formats are rasterized before scanning;
manually rasterize vector images before scanning to avoid
unintentionally corrupting embedded barcode bitmaps.
OPTIONS
This program follows the usual GNU command line syntax. Single letter
options may be bundled, long options start with two dashes (‘-´).
-h, --help
Print a short help message describing command line options to
standard output and exit
--version
Print program version information to standard output and exit
-v, --verbose[=n]
Increase debug output level. Multiple -v options create more spew.
Alternatively specify n to set the debug level directly
-S[symbology.]config[=value], --set [symbology.]config[=value]
Set decoder configuration option config for symbology to value.
value defaults to 1 if omitted. symbology is one of ean13, ean8,
upca, upce, isbn13, isbn10, i25, code39, code128 or the special
value *. If symbology is omitted or *, the config will be set for
all applicable symbologies. These are the currently recognized
configs. Prefix a config with "no-" to negate it. Not all configs
are appropriate for every symbology.
enable
Control decoding/reporting of a symbology. For symbologies
which are just subsets of ean13 (upca, upce, isbn13, isbn10),
this config controls whether the subsets are detected and
reported as such. These special cases are disabled by default,
all other symbologies default to enabled
disable
Antonym for enable
emit-check
Control whether check digits are included in the decoded
output. Enabled by default. This config does not apply for
code128, which never returns the check digit. It also not apply
for cases where the check digit is disabled (see add-check).
Check digits are currently not implemented for i25 or code39
add-check
Enable decode and verification of a check digit for symbologies
where it is optional: this will include code39 and i25, neither
of which implements the check digit yet
ascii
Enable escape sequences that encode the full ASCII character
set. This would apply to code39, except that it´s not
implemented either...
position
Enable collection of symbol position information. Enabled by
default. Currently, the position information is unusable, so
you can save a few cycles by disabling this.
min-length=n, max-length=n
Bound the number of decoded characters in a valid symbol. If a
decode result is outside the configured min/max range
(inclusive), it will not be reported. Set to 0 to disable the
corresponding check. This setting applies to variable-length
symbologies: i25, code39, code128 and pdf417. min-length
defaults to 6 for i25 and 1 for code39 (per Code 39
autodiscrimination recommendation); all others default to 0
x-density=n, y-density=n
Adjust the density of the scanner passes. Lower values scan
more of the image at the cost of decreased performance. Setting
to 0 disables scanning along that axis. Defaults are both 1.
-q, --quiet
Quiet operation; only output decoded symbol data. specifically this
disables the statistics line printed (to stderr) before exiting, as
well as the warning message printed (also to stderr) when no
barcodes are found in an image
-d, --display, -D, --nodisplay
Enable/disable display of subsequent image files, until next
--display or --nodisplay is encountered. This option may appear
multiple times to enable display of specific images. Image display
is disabled by default
--xml, --noxml
Enable/disable result output using an XML format. This format wraps
the raw data from the symbol with information about the scan (such
as page indices) in an easy to parse format. The latest schema is
available from http://zbar.sourceforge.net/2008/barcode.xsd.
--raw
Enable raw symbol data output. This format prints symbol data
separated by newlines without the additional symbology type
information that is printed by default
EXAMPLES
Scan a PNG image of a UPC bar code symbol and pass resulting data to a
script that searches for the code in a database and does something
useful with it:
zbarimg product.png | upcrpc.py
The upcrpc.py example script included in the examples/ subdirectory of
the distribution will make an XMLRPC call to a popular internet UPC
database and print the product description if found.
Scan a JPEG image containing several barcodes and display the image in
a window, also disabling recognition of Interleaved 2 of 5 codes to
prevent confusion with other symbologies or background noise:
zbarimg --display -Si25.disable label.jpg
Look in a scanned document only for Code 39, using XML output format so
the page numbers are available. To enable only Code 39, first all
symbologies are disabled, then Code 39 is re-enabled:
zbarimg --xml -Sdisable -Scode39.enable scan.tiff
SEE ALSO
zbarcam(1)
http://zbar.sf.net/
BUGS
See http://sf.net/tracker/?group_id=189236&atid=928515
AUTHOR
Jeff Brown <spadix@users.sourceforge.net>
Lead developer
COPYRIGHT
Copyright © 2007-2009 Jeff Brown
All Rights Reserved