GenTL Producer

GenTL is a generic and standardized API for controlling machine vision cameras. It is supported by various manufacturers of machine vision software.

The Ensenso SDK contains a GenTL producer ensenso.cti, which implements the GenTL standard.

Feature Reference

In GenTL, cameras are controlled using GenICam, which is a description of a device’s features and how to use them. This documentation assumes some basic knowledge of how features work in GenICam.

The Ensenso GenTL producer uses feature names as defined by the SFNC standard where possible. This reference provides some details on how functionality of Ensenso cameras is mapped to these features as well as a description of custom features which are not defined in the SFNC.

Note that the list of GenICam features described here is not exhaustive. We do not list trivial features such as DeviceSerialNumber, which work as expected by the SFNC. GenTL consumers usually provide a way to discover all provided features.

• Components and Sources

• Image Acquisition

• Stereo Matching

• Processing Control

Loading Parameters

The GenTL producer automatically loads parameters which are saved in device memory upon opening a device. This allows to configure the camera interactively in Ensenso Engage and transferring the resulting setup to the GenTL producer.

It can also be used to adjust additional parameters which are available in the NxLib, but not exposed through GenICam.

See the guide on parameter files for more information on how parameters are saved and loaded in the NxLib.

Applications

The GenTL interface is standardized and the producer should work in any application which supports GenTL. There are some differences in how the various applications handle GenTL producers, though, especially with processing data from 3D cameras. The following pages contain some hints on how to use the Ensenso GenTL producer in different applications:

• Aurora Vision

• Halcon

• NeuroCheck