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

Barcode Detection

IP Command Grooper.IP

Detects and reads barcode data from images using a configurable set of barcode readers and preprocessing options.

Remarks

The Barcode Detection command is used to locate, decode, and extract barcode information from document images. It supports a wide range of barcode symbologies, including 1D, 2D, and postal barcodes, and can be configured to use multiple detection engines for optimal accuracy and performance.

How Barcode Detection Works

  1. The command optionally preprocesses the image (e.g., binarization, cropping to a region of interest).
  2. One or more barcode readers are applied to the image to detect and decode barcodes.
  3. Detected barcodes are returned as part of the command result and, when run in a batch or process context, are stored in the object's Layout Data for downstream use.

Supported Pixel Formats

All common pixel formats are supported, including Pixel8bppGrayscale, Pixel24bppBgr, and Pixel1bppIndexed. Images are automatically converted as needed for barcode detection.

Diagnostics

When run in diagnostic mode, Barcode Detection generates additional output to assist with configuration and troubleshooting:

  • Diagnostic images showing preprocessed input and detected barcode regions.
  • Log messages listing detected barcodes, their symbologies, values, and confidence scores.

These diagnostics help verify that the command is correctly configured and that barcodes are being detected as expected.

Layout Data

When Barcode Detection is executed it outputs all detected barcode information as Layout Data. Activities such as Image Processing and Recognize capture this Layout Data and store it with the corresponding Batch Page or Batch Folder for later use in data extraction. Each detected barcode is represented as a layout item, capturing its symbology, value, confidence score, orientation, and bounding rectangle within the image.

This Layout Data enables downstream processes and activities to access barcode information without reprocessing the image. For example, extracted barcodes can be used for indexing, validation, or routing documents based on barcode content.

Classification Features

For each barcode detected, Barcode Detection generates classification features that are added to the result's feature dictionary. Specifically, for every barcode, a feature is added for its symbology (e.g., ReadBarcodes.BarcodeType.QR) and for its value (e.g., ReadBarcodes.BarcodeValue.123456). These features can be used by downstream classification, separation, or routing logic to make decisions based on the presence, type, or value of barcodes found on the page.

Configuration and Usage

To use Barcode Detection, add it to an IP Profile or configure it as a property of a Grooper object. Enable one or more barcode readers to target the symbologies present in your documents. Optionally, configure preprocessing options such as binarization and region of interest to improve detection accuracy.

Review the 'Symbologies' property to confirm which barcode types are currently supported by your configuration. Use diagnostic output to fine-tune settings for your specific document types and image quality.

Properties

NameTypeDescription
Barcode Readers
Preprocessing
Command Info

See Also

Used By

Notification