1D/2D Code Reader

Overview

1D/2D Code Reader detects and decodes barcodes and matrix codes from an input image frame.

Use this node when you need to extract machine-readable identifiers such as product codes, tracking IDs, or URLs from camera frames and image streams.

You can control which code families are scanned by using the Code Filter input. This helps improve performance and reduce false detections in scenes with mixed patterns.

Input

Input Image

image required

The image frame to analyze. This is a reference input field, so it should point to an image output from an upstream node.

Code Filter

array required

List of code types to detect.

Default value:

• QR

Supported 1D Linear Codes

Supported 2D Matrix Codes

Overlay Results

boolean required

Whether to draw detection overlays on the output frame.

Default value:

• true

Overlay Type

boolean

Shown only when Overlay Results is enabled.

When enabled, the overlay includes each detected code type label (for example QR, CODE_128).

Default value:

• true

Overlay Text

boolean

Shown only when Overlay Results is enabled.

When enabled, the overlay includes decoded text values for each detection.

Default value:

• true

Output

Overlay Image

image

Output frame from the node. If overlays are enabled, this frame includes drawn detection results.

Detected Count

integer

Number of detected codes in the current frame.

Detected Codes

array

Array of decoded result objects. Each object contains:

• points array: Polygon points of the detected code in image coordinates. Each point is [x, y].
• label string: Decoded text value.
• codeType string: Detected code family (for example QR, EAN_13, PDF417).

Notes

• If Code Filter contains unsupported values only, initialization fails because no valid code types can be configured.
• For best accuracy, provide clear frames with enough contrast and keep code regions large enough in the image.
• If no code is detected, Detected Count is 0 and Detected Codes is an empty array.