Description

LumiScan Barcode Reader finds barcodes in a camera image and reports, for each one, what it says and where it is.

It reads linear (1D) barcodes — the striped codes read across rather than as a grid. The reader is configured for ZXing’s whole linear family rather than one symbology, so Code 128, Code 39, EAN-13 and UPC-A are all read by the same call, among others; the code does not have to be identified in advance. Every code found in the image is reported: there is no limit of one per run, and no reference picture or training step of any kind.

The application needs no template and no configuration. You give it the address of an image and call execute; it reads every barcode in that image. Its sibling applications read the other symbologies — LumiScan DMC Reader, LumiScan QR Code Reader and LumiScan Aztec Code Reader — and work the same way.

Where it runs

The application runs on ctrlX OS (ctrlX CORE or ctrlX IPC) with the ctrlX Data Layer, and on a PC (Windows 11 or Ubuntu 24.04) with LumiScan Keryx, the Data Layer of HD Vision Systems for PCs. Its nodes, their addresses and their behaviour are the same on both; where something differs, this manual says so. See Data Layer Reference.

What is the same for every LumiScan app - how addresses are built, the handshake, execute and stream call patterns, status codes, settings and tools - is described in the LumiScan Keryx manual. This manual covers only what is specific to LumiScan Barcode Reader; its own nodes are listed in the Data Layer Reference.

Where the images come from

The application does not talk to a camera itself. It reads an image node published by another application on the Data Layer, given as an address in input/image-address, for example:

hdvisionsystems/lumiscan-cam-driver/camera1/output/image

The node must publish data, width, height and pixel-type, which is what LumiScan Cam Driver provides. See Requirements.

No modules

Unlike the LumiScan applications that search for a configured thing, this reader has no modules. There is one reader per installation, at one Data Layer address. On ctrlX OS, one licence seat covers it.

There is nothing per-instance to configure because there is nothing to configure at all: the only input that changes between runs is which image to read.

Seeing the results

The results are numbers on the Data Layer. To see them drawn on the picture they were found in, open LumiScan Cockpit: it lists this application as a single view named bar-code and draws a rectangle around each code, labelled with the decoded text and the score.