Datamatrix Detector Overview

Data Matrix (also commonly known as DataMatrix) is a type of 2D barcode which is widely used in production environments to mark products. Reading Datamatrix barcodes with a camera can help in visual verification of legibility and content of the code or automate the overall process with the marked piece.

Using the Datamatrix detector in Vision, you can monitor pre-defined regions on your camera's stream to detect Datamatrix barcodes in real-time. You can then use the data matrix detection events to build logic within your app.

In this article, you will learn...

  • How to set up a Datamatrix Detector

  • Using the Datamatrix 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.

  • Note: This feature is available from Tulip version r210+ and Player 1.1.0+

Setting up the Datamatrix Detector

After completing your camera configuration setup, you should see the video stream. To set up the Datamatrix detector, select the region that you want to monitor for detecting data matrix 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 by clicking the Create Detector link. Name the detector and give a description (optional) and choose Datamatrix as the type of detector. Enable the Datamatrix detector for this region using the toggle.

Creating a data matrix detector

The region boundary will turn green if a data matrix is detected in the region, else it will stay as red. If a data matrix is detected in the region, an event will be triggered in the app that is using this Camera Configuration.

Using the Datamatrix 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 from the list of events.

Building a data matrix trigger

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 "Datamatrix DETECTOR" overlay to display OCR 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 similar color as specified in the settings, the region boundary will turn green, and the trigger action will take place.

Data matrix detector with trigger in a Tulip App

You have now successfully completed setting up the Datamatrix detector in the camera configuration, and are ready to build this functionality into production apps.

Further Reading

Did this answer your question?