ZBARCAM(1) | ZBar Barcode Reader | ZBARCAM(1) |
NAME¶
zbarcam - scan and decode bar codes from a video deviceSYNOPSIS¶
zbarcam [-qv] [--quiet]
[--nodisplay] [ --xml] [--verbose[=n]]
[--prescale= WxH]
[-S[symbology.]config[=value]]
[
--set [symbology.]config[=value]]
[ device]
zbarcam {-h | --help |
--version}
DESCRIPTION¶
zbarcam scans a video4linux video source (eg, a webcam) for bar codes and prints any decoded data to the standard output. The video stream is also displayed to the screen. device is the path to the video4linux (version 1 or 2) character device special file (major number 81 and minor number 0 thru 63). It defaults to /dev/video0 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.OPTIONS¶
This program follows the usual GNU command line syntax. Single letter options may be bundled, long options start with two dashes (`-´). -h, --helpPrint 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
-q, --quiet
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.
Quiet operation; disable the audible beep otherwise
emitted when a symbol is decoded
--nodisplay
Disable output video window. Video input will be scanned
until the program is interrupted or otherwise signaled
--xml
Stream results using an XML output format. This format
wraps the raw data from the symbol with information about the scan in an easy
to parse format. The latest schema is available from
http://zbar.sourceforge.net/2008/barcode.xsd
--raw
Use raw symbol data output format. This format prints
symbol data separated by newlines without the additional symbology type
information that is printed by default
--prescale=WxH
Request video input scaling from the camera driver.
Possibly useful for reducing huge frames to achieve a higher frame rate. Note
that the driver may adjust or completely ignore the scaling request
EXAMPLES¶
Scan for barcodes using the second video device and pipe the resulting data through a script that searches for each code in a database and does something useful with them:zbarcam /dev/video1 | upcrpc.py
zbarcam --xml -Si25.disable
zbarcam --nodisplay -Sdisable -Scode39.enable
SEE ALSO¶
zbarimg(1) http://zbar.sf.net/BUGS¶
See http://sf.net/tracker/?group_id=189236&atid=928515AUTHOR¶
Jeff Brown <spadix@users.sourceforge.net>Lead developer
COPYRIGHT¶
Copyright © 2007-2009 Jeff Brown2009-10-23 | zbar-0.10 |