From 44cf8ec67278bd1ab6c7f83a9993f7a5686a9541 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sat, 9 Mar 2024 01:06:44 +0100 Subject: Adding upstream version 0.23.93. Signed-off-by: Daniel Baumann --- doc/ref/zbarimg.xml | 242 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 242 insertions(+) create mode 100644 doc/ref/zbarimg.xml (limited to 'doc/ref/zbarimg.xml') diff --git a/doc/ref/zbarimg.xml b/doc/ref/zbarimg.xml new file mode 100644 index 0000000..572bea9 --- /dev/null +++ b/doc/ref/zbarimg.xml @@ -0,0 +1,242 @@ + + + + zbarimg + 1 + + + + zbarimg + + scan and decode bar codes from image file(s) + + + + + + zbarimg + + + + + + + + + + + + + + image + + + + + zbarimg + + + + + + + + + + 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, 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 "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 (`-'). + + + &refcommonoptions; + + + + + Ouput points of the polygon containing the code bar. + Using a format compatible with The <polygon> element + of the Scalable Vector Graphics (SVG) markup language + + + + + + + + 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 + + + + + + + + + + Enable/disable display of subsequent + image files, + until next or + is encountered. This option + may appear multiple times to enable display of specific + images. Image display is disabled by default + + + + + + + + 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 + . + + + + + + + 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 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 scan.tiff + + + + + Exit Status + + zbarimg 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 ) + + + + + 4 + + No barcode was detected in one or more of the images. No + other errors occurred. + + + + + + + See Also + + + + + + Bugs + + See + + + + -- cgit v1.2.3