Scroll to navigation

ZBar::Symbol(3pm) User Contributed Perl Documentation ZBar::Symbol(3pm)


Barcode::ZBar::Symbol - bar code scan result object


    my @symbols = $image->get_symbols();
    foreach my $sym (@symbols) {
        print("decoded: " . $sym->get_type() .
              ":" . $sym->get_data().
              "(" . $sym->get_count() . ")");


Barcode::ZBar::Symbol objects are constant results returned for each bar code scanned from images or video. This object wraps the raw symbol data with additional information about the decode (symbology, confidence, location, etc)



The type of bar code "symbology" from which the data was decoded.
The decoded data string. Note that some symbologies can encode binary data.
Confidence metric. An unscaled integer value that indicates something (intentionally unspecified) about the reliability of this result relative to another. Larger values are better than smaller values, where "large" and "small" are application dependent. Expect this definition to become more specific as the metric is enhanced.
Current cache count of the symbol. This integer value provides inter-scan reliability and redundancy information if enabled at the Barcode::ZBar::ImageScanner.
General orientation of decoded symbol. This returns one of the Barcode::ZBar::Orient constants, which provide a coarse, axis-aligned indication of symbol orientation.
Components of a composite result. This yields an array of physical component symbols that were combined to form a composite result.
  • A negative value indicates that this result is still uncertain
  • A zero value indicates the first occurrence of this result with high confidence
  • A positive value indicates a duplicate scan


Bar code type "symbology" constants:


Barcode::ZBar, Barcode::ZBar::Image

zbarimg(1), zbarcam(1)


Jeff Brown, <>


Copyright 2008-2010 (c) Jeff Brown <>

The ZBar Bar Code Reader is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

2023-01-04 perl v5.36.0