11. SUPPLIED SOFTWARE
driver that provides access to an imaging device through the GenTL interface.
A GenTL consumer, on the other hand, is any software that uses one or more
GenTL producers through this interface. The supplied software module rep-
resents a GenTL producer and can be used with any application software that
acts as a consumer. This allows for the ready integration of SceneScan into
existing machine vision software suites like e.g. HALCON.
Depending on the version that you downloaded, the producer is provided
either as a binary or as source code. If you choose the source code release,
the producer will be built along with the other software components. The
produced / downloaded binary is named nerian-gentl.cti. In order to be
found by a consumer, this le has to be placed in a directory that is in the
GenTL search path. The search path is specied through the following two
environment variables:
GENICAM_GENTL32_PATH: Search path for 32-bit GenTL producers.
GENICAM_GENTL64_PATH: Search path for 64-bit GenTL producers.
The binary Windows installer automatically congures these environment
variables. When building the source code release, please congure the envi-
ronment variables manually.
11.2.2 Virtual Devices
Once the search path has been set, the producer is ready to be used by a
consumer. For each SceneScan the producer provides ve virtual devices, which
each deliver one part of the obtained data. These virtual devices are named
as follows:
/left Provides the left camera image that is transmitted by SceneScan. In
the default conguration, this is the image after rectication has been
applied. The image is encoded with 8 or 12 bits per pixel (Mono8 or
Mono12).
/right Provides the image of the right camera. The right camera image is
only transmitted if SceneScan is congured in pass through or rectify
mode (see Section 9.3). The image is encoded with 8 or 12 bits per pixel
(Mono8 or Mono12).
/disparity Provides the disparity map that is transmitted by SceneScan.
This data is not available if SceneScan is congured in pass through
or rectify mode. The disparity map is transmitted with a non-packed 12
bits per pixel encoding (Mono12).
/pointcloud Provides a transformation of the disparity map into a 3D point
cloud (see Section 8.2). Each point is represented by three 32-bit oating
point numbers that encode an x-, y- and z-coordinate (Coord3D_ABC32f).
47