Barcode Reader

Provides a configurable base for barcode reading in Grooper.

Remarks

The Barcode Reader class serves as the foundation for all barcode reading functionality in Grooper. It enables detection and decoding of barcode data from images using a variety of supported symbologies and decoding engines.

Barcode Reader objects are typically configured as part of a Barcode Detection command or embedded within other Grooper objects that require barcode extraction. Users select and configure barcode readers to target the symbologies present in their documents, optimizing for accuracy and performance.

Usage and Configuration

• Add a Barcode Reader to your Barcode Detection configuration to enable barcode extraction.
• Select the desired symbologies using the 'Barcode Symbologies' property.
• Adjust reader-specific options to improve detection for your document types.
• Multiple readers can be combined to support a wide range of barcode formats.

Use a specific reader type (such as Standard Reader, [1D Reader], or [2D Reader]) to target particular barcode families or optimize for certain use cases.

How It Works

When executed, the Barcode Reader processes the input image, searching for barcodes that match the configured symbologies. It applies decoding algorithms to extract barcode values, symbology types, and positional information. The results are returned as Layout Data for downstream use in extraction, validation, or document routing.

Diagnostics

When diagnostic mode is enabled, Barcode Reader may generate the following artifacts to assist with configuration and troubleshooting:

• Log messages detailing detected barcodes, symbologies, and values.
• Diagnostic images highlighting detected barcode regions (when supported by the reader).

These diagnostics help verify configuration and ensure that barcodes are being detected as expected.

Properties

Name	Type		Description
Read Directions	ReadDirection	►	Specifies the orientation(s) in which the barcode reader searches for barcodes on the document. ConverterPg Flags Converter DefaultAll A combination of the following flags: Name Value Description None 0 Represents no directions. Not recommended in general use. East 1 Easterly scan (horizontally, left to right). South 2 Southerly scan (vertically, top to bottom). West 4 Westerly scan (horizontally, right to left). North 8 Northerly scan (vertically, bottom to top). All 15 Represents all supported directions. The 'Read Directions' property determines which directions the Barcode Reader will scan when searching for barcodes within an image. By default, the reader scans in all supported directions, but you can limit or expand the search to target specific orientations as needed. Usage and Configuration Select one or more directions to match the expected orientation(s) of barcodes in your documents. Common directions include South (top-to-bottom), North (bottom-to-top), East (left-to-right), and West (right-to-left). Multiple directions can be enabled to detect barcodes with inconsistent or mixed orientations. Impact and Considerations Enabling all directions increases the likelihood of detecting barcodes regardless of their placement, but may increase processing time. Some barcode types may yield different values if read upside down or in a non-standard orientation. For example, a Patch T barcode read upside down may be interpreted as a Patch 3. Restricting directions can improve performance and reduce false positives if you know the expected orientation. Example For documents scanned in a consistent orientation, select only the primary direction (e.g., South). For mixed or uncertain orientations, enable multiple directions to ensure all barcodes are detected.

Derived Types

There are 4 implementations of Barcode Reader.

1D Reader	Grooper’s 1D barcode reader for detecting and decoding linear barcodes using advanced image analysis.
2D Reader	Detects and decodes two-dimensional (2D) barcodes using advanced image analysis.
Postcode Reader	Detects and decodes postal barcodes using advanced image analysis.
Standard Reader	Detects and reads barcode data using the Atalasoft barcode engine for broad symbology support.