ZBARIMG(1)                    ZBar Barcode Reader                   ZBARIMG(1)



NNAAMMEE
       zbarimg - scan and decode bar codes from image file(s)

SSYYNNOOPPSSIISS
       zzbbaarriimmgg [--qqvv] [----qquuiieett] [----vveerrbboossee[[==_n]]
               {--ddDD | ----ddiissppllaayy | ----nnooddiissppllaayy | ----xxmmll | ----nnooxxmmll |
               --SS[[_s_y_m_b_o_l_o_g_y.]_c_o_n_f_i_g[[==_v_a_l_u_e] | ----sseett [[_s_y_m_b_o_l_o_g_y.]_c_o_n_f_i_g[[==_v_a_l_u_e]
               | _i_m_a_g_e...}

       zzbbaarriimmgg {--hh | ----hheellpp | ----vveerrssiioonn}

DDEESSCCRRIIPPTTIIOONN
       For each specified _i_m_a_g_e file zzbbaarriimmgg 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, DataBar, DataBar Expanded, Code 128, Code 93,
       Code 39, Codabar, Interleaved 2 of 5 and QR Code symbologies. The
       specific type of each detected symbol is printed with the decoded data.

       Note that "_i_m_a_g_e" 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.

OOPPTTIIOONNSS
       This program follows the usual GNU command line syntax. Single letter
       options may be bundled, long options start with two dashes (`-').

       --hh, ----hheellpp
           Print a short help message describing command line options to
           standard output and exit

       ----vveerrssiioonn
           Print program version information to standard output and exit

       --vv, ----vveerrbboossee[[==_n]
           Increase debug output level. Multiple --vv options create more spew.
           Alternatively specify _n to set the debug level directly

       --SS[[_s_y_m_b_o_l_o_g_y.]_c_o_n_f_i_g[[==_v_a_l_u_e], ----sseett [[_s_y_m_b_o_l_o_g_y.]_c_o_n_f_i_g[[==_v_a_l_u_e]
           Set decoder configuration option _c_o_n_f_i_g for _s_y_m_b_o_l_o_g_y to _v_a_l_u_e.
           _v_a_l_u_e defaults to 1 if omitted.  _s_y_m_b_o_l_o_g_y is one of eeaann1133, eeaann88,
           uuppccaa, uuppccee, iissbbnn1133, iissbbnn1100, ii2255, ccooddaabbaarr, ccooddee3399, ccooddee9933, ccooddee112288,
           qqrrccooddee or the special value **. If _s_y_m_b_o_l_o_g_y is omitted or **, the
           _c_o_n_f_i_g will be set for all applicable symbologies. These are the
           currently recognized _c_o_n_f_i_gs. Prefix a config with "no-" to negate
           it. Not all configs are appropriate for every symbology.

           eennaabbllee
               Control decoding/reporting of a symbology. For symbologies
               which are just subsets of eeaann1133 (uuppccaa, uuppccee, iissbbnn1133, iissbbnn1100),
               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

           ddiissaabbllee
               Antonym for eennaabbllee

           eemmiitt--cchheecckk
               Control whether check digits are included in the decoded
               output. Enabled by default. This config does not apply for
               ccooddee112288, which never returns the check digit. It also not apply
               for cases where the check digit is disabled (see aadddd--cchheecckk).
               Check digits are currently not implemented for ii2255 or ccooddee3399

           aadddd--cchheecckk
               Enable decode and verification of a check digit for symbologies
               where it is optional: this will include ccooddee3399 and ii2255, neither
               of which implements the check digit yet

           aasscciiii
               Enable escape sequences that encode the full ASCII character
               set. This would apply to ccooddee3399, except that it's not
               implemented either...

           ppoossiittiioonn
               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.

           tteesstt--iinnvveerrtteedd
               Specially for QR code images, sometimes the image is inverted,
               e. g. lines are written in white instead of black. This option
               makes ZBar to invert the image and parse again, in case it
               fails using the normal order. Enabling it affects all decoders.

           mmiinn--lleennggtthh==_n, mmaaxx--lleennggtthh==_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: ii2255, ccooddaabbaarr, ccooddee3399, ccooddee112288 and ppddff441177.
               mmiinn--lleennggtthh defaults to 6 for ii2255 and 1 for ccooddee3399 (per Code 39
               autodiscrimination recommendation); all others default to 0

           xx--ddeennssiittyy==_n, yy--ddeennssiittyy==_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q, ----qquuiieett
           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d, ----ddiissppllaayy, --DD, ----nnooddiissppllaayy
           Enable/disable display of subsequent _i_m_a_g_e files, until next
           ----ddiissppllaayy or ----nnooddiissppllaayy is encountered. This option may appear
           multiple times to enable display of specific images. Image display
           is disabled by default

       ----xxmmll, ----nnooxxmmll
           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 hhttttpp::////zzbbaarr..ssoouurrcceeffoorrggee..nneett//22000088//bbaarrccooddee..xxssdd.

       ----rraaww
           Enable raw symbol data output. This format prints symbol data
           separated by newlines without the additional symbology type
           information that is printed by default

EEXXAAMMPPLLEESS
       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:

           zzbbaarriimmgg product.png | uuppccrrppcc..ppyy

       The uuppccrrppcc..ppyy 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:

           zzbbaarriimmgg ----ddiissppllaayy --SSii2255..ddiissaabbllee 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:

           zzbbaarriimmgg ----xxmmll --SSddiissaabbllee --SSccooddee3399..eennaabbllee scan.tiff


EEXXIITT SSTTAATTUUSS
       zzbbaarriimmgg returns an exit code to indicate the status of the program
       execution. Current exit codes are:

       0
           Barcodes successfully detected in all images. Warnings may have
           been generated, but no errors.

       1
           An error occurred while processing some image(s). This includes bad
           arguments, I/O errors and image handling errors from ImageMagick.

       2
           ImageMagick fatal error.

       3
           The user quit the program before all images were scanned. Only
           applies when running in interactive mode (with ----ddiissppllaayy)

       4
           No barcode was detected in one or more of the images. No other
           errors occurred.

SSEEEE AALLSSOO
       zbarcam(1)

       hhttttpp::////zzbbaarr..ssff..nneett//

BBUUGGSS
       See hhttttpp::////ssff..nneett//ttrraacckkeerr//??ggrroouupp__iidd==118899223366&&aattiidd==992288551155

AAUUTTHHOORR
       JJeeffff BBrroowwnn <spadix@users.sourceforge.net>
           Lead developer

CCOOPPYYRRIIGGHHTT
       Copyright (C) 2007-2010 Jeff Brown

       All Rights Reserved




zbar-0.23.90                      2017-04-11                        ZBARIMG(1)
