Datamatrix and Barcode Detectors Overview
Reading barcodes with a camera can help in visual verification of legibility and content of the code, as well as automating the overall process with the marked piece. We have available two barcode detectors:
General purpose Barcode Detector, which can read a host of 1D and 2D barcodes, like: Code 128, Code 39 and QR code.
Data Matrix Detector, which reads 2D DataMatrix barcodes widely used in production environments to mark products.
We offer a specialized Datamatrix Detector due to the speed and accuracy of the special purpose datamatrix detection algorithms.
Note: Barcode detectors are only available from Tulip version r212+ and Player version 1.2.2+.
Using the barcode detectors in Vision, you can monitor pre-defined regions on your camera's stream to detect barcodes in real-time. You can then use the detection events to build logic within your app.
In this article, you will learn...
How to set up a Datamatrix or Barcode Detector
Using the detector event in-app triggers
Please review Getting Started with Vision to get an understanding of Vision's functionalities and requirements, as well as for instructions on how to set up your camera.
This feature works with both Color and Depth cameras.
Setting up the Datamatrix or Barcode Detector
After completing your camera configuration setup, you should see the video stream. To set up the Datamatrix or Barcode detector, select the region that you want to monitor for detecting barcodes. You may have to create a new region, by clicking and dragging on the picture to define your region:
Next, create a Datamatrix detector or Barcode detector by clicking the Create Detector link. Name the detector and give a description (optional) and choosing the desired type of detector. Enable the detector for this region using the toggle.
To create a Barcode detector, remember you must select "Barcode Detector" when creating the detector. The Barcode and Datamatrix detectors are separate.
The region boundary will turn green if a barcode is detected in the region, else it will stay as red. If a barcode is detected in the region, an event will be triggered in the app that is using this Camera Configuration.
Using the Datamatrix or Barcode Detector in an App
Switch over to your app editor, and create a new Device Output Trigger.
All Camera Configurations will appear under the sub-list of Specific device. Please select your Camera Configuration from the dropdown.
Note, that the Specific device section allows you to use multiple cameras in the same app. Any station that runs this app must have the specific Camera Configuration that you selected for the camera. Otherwise, a warning will be shown when the app runs.
Now you will see a dropdown of various events to run the trigger off of:
For this example, select Datamatrix Detected or Barcode Detected from the list of events.
If you have a video preview widget in your step, note the "Show Overlay" option allows you to disable showing the regions on top of the video. Enable the "DATAMATIRX DETECTOR" or "BARCODE DETECTOR" overlay to display the code detection information.
Run the app at the station to which you assigned your Camera Configuration.
When opening the step with the Vision Camera Widget in your Player, you will see the video stream of the camera. When you move an object inside the region which has a barcode the region boundary will turn green, and the trigger action will take place.
You have now successfully completed setting up the Datamatrix and Barcode detectors in the camera configuration, and are ready to build this functionality into production apps.