Grooper Help - Version 25.0
25.0.0017 2,127
  • Overview
  • Help Status

2D Reader

Barcode Reader Grooper.IP

Detects and decodes two-dimensional (2D) barcodes using advanced image analysis.

Remarks

The [2D Reader] class provides Grooper’s specialized engine for detecting and decoding two-dimensional (matrix) barcodes, such as Data Matrix, which are widely used in manufacturing, pharmaceuticals, forms processing, and other data-rich applications. The reader is optimized for high accuracy and robust performance, especially on low-quality or degraded images, and supports the most common 2D symbologies.

[2D Reader] is typically configured as part of a Barcode Detection command. Users select the 2D symbologies to target and fine-tune detection for their document types. This reader is ideal for applications involving product labeling, pharmaceutical packaging, or any workflow that relies on extracting information from 2D barcodes on forms, labels, or packaging.

How It Works

The [2D Reader] analyzes the input image by:

  1. Candidate Region Analysis:

    • The page is scanned for regions likely to contain 2D barcodes, using advanced image processing algorithms tailored for the unique structure of matrix symbologies.
    • Each region is filtered by minimum and maximum size constraints to focus detection on appropriately sized candidates and reduce false positives.
  2. Decoding:

    • For each candidate region, the reader applies decoding logic for the selected 2D symbologies.
    • Barcodes are validated for structural correctness and, where applicable, error correction or checksum validation.
    • Only barcodes matching the selected symbologies and passing validation are returned.
  3. Error Handling:

    • If a region cannot be decoded or does not match the expected symbology, it is logged as a candidate region for further review or tuning.
    • Exceptions during decoding are logged for diagnostics.

Usage and Configuration

  • Symbology Selection:
    Use the 'Barcode Symbologies' property to specify which 2D barcode types to detect (e.g., DataMatrix). Limiting to expected types improves speed and reduces false positives.

  • Region Size Settings:
    Adjust the 'Minimum Size' and 'Maximum Size' properties to match the expected size range of 2D barcodes in your documents. This helps filter out irrelevant regions and optimize detection accuracy.

  • Integration:
    Add the [2D Reader] to your Barcode Detection configuration when processing documents, labels, or packaging containing 2D barcodes.

Diagnostics

When diagnostic mode is enabled, [2D Reader] generates artifacts to assist with configuration and troubleshooting:

  • Log messages for each candidate region, including region bounds and decoding results.
  • Diagnostic images highlighting detected barcode regions and candidate images.
  • Output of candidate regions that did not yield a valid barcode (for tuning region settings).
  • Exception logs for any errors encountered during decoding.

These diagnostics help users verify configuration, understand detection failures, and optimize settings for their specific document types.

Example Scenarios

  • Pharmaceutical Packaging:
    Enable DataMatrix to extract lot numbers and expiration dates from medicine cartons.

  • Forms Processing:
    Enable DataMatrix to capture encoded form IDs or batch numbers from scanned documents.

  • Manufacturing:
    Enable DataMatrix to track serialized parts or products on production lines.

Review diagnostic output to fine-tune settings and ensure reliable barcode extraction across your document set.

Properties

NameTypeDescription

Used By

Notification