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

1D Reader

Barcode Reader Grooper.IP

Grooper’s 1D barcode reader for detecting and decoding linear barcodes using advanced image analysis.

Remarks

The [1D Reader] class provides Grooper’s specialized engine for detecting and decoding one-dimensional (linear) barcodes. It is optimized for high accuracy and robust performance, especially on low-quality or degraded images, and supports a wide range of 1D symbologies such as Code 128, Code 39, and Codabar.

[1D Reader] is typically configured as part of a Barcode Detection command. Users select the symbologies to target, adjust detection parameters, and fine-tune performance for their document types. This reader is ideal for applications where linear barcodes are prevalent, such as shipping labels, inventory forms, and pharmaceutical packaging.

How It Works

The [1D Reader] analyzes the input image in two main phases:

  1. Candidate Region Analysis:

    • The page is scanned for regions likely to contain barcodes, based on sets of parallel lines.
    • Each 'Candidate Region' is evaluated for barcode presence using the configured symbologies and decoding algorithms.
    • Properties such as 'Maximum Barcode Height' and 'Quiet Zone' control the size and filtering of these regions.
  2. Full-Page Scanning (Optional):

    • If enabled, the entire page is scanned for barcodes, not just detected regions.
    • The 'Scan Interval' property controls the granularity of this scan (e.g., every line, every 10th line).
    • Full-page scanning increases detection coverage but may impact performance.

For each region or scan line, the reader applies decoding logic for the selected symbologies. Barcodes are validated against the 'Minimum Confidence' threshold, and only those meeting or exceeding this value are returned. The reader also supports symbology-specific options, such as 'Code 39 Settings', to further refine detection.

Usage and Configuration

  • Symbology Selection:
    Use the 'Barcode Symbologies' property to specify which 1D barcode types to detect. Limiting to expected types improves speed and reduces false positives.

  • Performance vs. Accuracy:

    • Lower 'Scan Interval' values and enabling 'Full Page' scanning increase accuracy but may slow processing.
    • Higher 'Minimum Confidence' values reduce false positives but may miss degraded barcodes.
  • Region and Quiet Zone Settings:

    • Adjust 'Maximum Barcode Height' to control the size of candidate regions.
    • Set 'Quiet Zone' to require a minimum area of whitespace around barcodes, reducing false detections.
  • Code 39 Options:
    Configure 'Code 39 Settings' to handle start/stop characters and ASCII encoding as needed for your documents.

Diagnostics

When diagnostic mode is enabled, [1D 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 scan lines.
  • Output of candidate regions that did not yield a valid barcode (for tuning region settings).

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

Example Scenarios

  • Shipping Labels:
    Enable 'Code 128' and 'Code 39' symbologies, set 'Full Page' to true, and use a low 'Scan Interval' for maximum coverage.

  • Pharmaceutical Packaging:
    Enable 'Pharmacode' and adjust 'Quiet Zone' to accommodate tightly packed barcodes.

  • Mixed-Orientation Documents:
    Enable multiple 'Read Directions' to detect barcodes regardless of placement or rotation.

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

Properties

NameTypeDescription

See Also

Used By

Notification