Recognize Barcodes Node

Recognizes Barcodes detected by an AI model in the video stream

Overview

The Recognize Barcodes node decodes barcodes detected by an AI model, and adds metadata to the frame metadata.

Suggested use : AI Model Node (with Barcode model) -> Track Objects Node -> Recognize Barcodes Node

Inputs & Outputs

  • Inputs : 1, Media Format : Raw Video
  • Outputs : 1, Media Format: Raw Video
  • Output Metadata : Barcode Information

Properties

Property

Value

barcode_types

Comma separated list of barcode types to recognize. Empty will search for all types.

Options:
codabar,code128,code39,code93,composite,databar,databar_exp,ean13,ean2,ean5,ean8,i25,isbn10,isbn13,pdf417,qrcode,upca,upce

preprocess

Enables preprocessing to enhance image quality, which might improve detection rates.

Options:
none : Disabled
upscale : Upscale detected barcode upscale.sharpen : Upscale + Apply image sharpening. Helps if barcodes are blurry.
upscale.sharpen.rotate : Upscale + Sharpen + Autorotate.

display_info

Boolean. If true, detected Barcode info will be drawn on video

Ex. true / false

process_detected_barcodes_only

Enable to only process barcodes detected by a prior model inference node. Turning off scans entire image for barcodes, and increases processing time but may be useful if the model doesn't detect barcodes well.

Ex. true / false

Metadata

Metadata Property

Description

nodes.<node_id>

Describes Barcode information for any decoded barcodes.
Format : as defined in the table below.

<node_id> for Recognize Barcode Nodes is of the form annotate_barcodeX (ex. annotate_barcode1)

Example

"nodes": {
    "annotate_barcode1": {
        "type": "annotate_barcode",
        "barcodes" : [
          { 
            "type": "EAN13",
            "data": "124314072131",
            "coords": [104,205,100,300],
            "id": 1203112309710239
          },
          { 
            "type": "CODE128",
            "data": "203927812",
            "coords": [410,445,120,340],
            "id": 102397932481
          }          
        ],
        "barcode_count": 2,
        "barcode_count_delta": 1
    }
}

Format

Key

Type

Description

barcodes

Array

True if motion is currently detected, else False

barcodes[].type

Enum

Type of recognized barcode.
One of the supported barcode_types values.

barcodes[].data

String

Contents of the Barcode

barcodes[].coords

Array

Where in the image the barcode is detected.

Format: [x,y,width,height]

barcodes[].id

Long Integer

Unique tracking ID for the detected barcode if a tracker is used and process_detected_barcodes_only is set to True.

Else -1.

barcode_count

Integer

Number of barcodes recognized.

barcode_count_delta

Integer

Number of new barcodes recognized in this frame.


Did this page help you?