GenICam GenTL Driver
|
For known issues when using GoPxL with GenTL, see the GoPxL release notes. |
GenICam is an industry standard for controlling and acquiring data from an imaging device.
The included GenTL driver allows GenICam-compliant third-party software applications such as Halcon and Common Vision Blox to acquire and process 3D data and intensity generated from the sensor.
|
Currently, the GenTL driver can't perform an alignment if you haven't saved a job first. |
The following sensor scan modes are supported:
- Video
- Profile (with Uniform Spacing disabled). In this mode, the point cloud profiles are resampled and accumulated into a surface.
- Surface (with Uniform Spacing enabled)
For more information on scan modes and uniform spacing, see Scan Modes and Intensity.
|
|
To use these third-party software applications, you must configure a system variable so the software can access the GenTL driver. For instructions, see To configure system variables to use the driver in Windows 10, below. |
To get the utilities package containing the driver (14631-x.x.x.x_SOFTWARE_GoPxL_Utilities.zip), go to https://lmi3d.com/product-downloads/, choose your product using the drop-down menus, and download the zip package.
After downloading the package and unzipping the file to a location you will remember, you will find the driver in Integration\GenTL\x64 (you can move the GenTL folder to a more convenient location).
To configure system variables to use the driver in Windows 10
| 1. | Click the Start menu and launch Settings. |
| 2. | In the Settings application search field, type "environment". |
The Environment Variables dialog opens.
| 3. | In the Environment Variables dialog, under the System variables list, click New. |
| 4. | In the New System Variable dialog, enter the following information, depending on your system: |
| Variable name | Variable value |
|---|---|
| GENICAM_GENTL64_PATH | The full path to the GenTL\x64 folder. |
| 5. | Click OK in the dialogs until they are all closed. |
To work with the GenTL driver, you must enable the Gocator protocol and the desired outputs on the Gocator page. For more information on configuring the Gocator protocol, see Gocator Communication Protocol.
If you need intensity data, check Acquire Intensity in the Scan Mode panel on the Scan page and enable the intensity output on the Gocator page. For more information on enabling intensity, see Scan Modes and Intensity.
The GenTL driver packs the output, intensity, and stamps (e.g., time stamp, encoder index, etc.) into either a 16-bit RGB image or a 16-bit grey scale image. You can select the format in the Go2GenTL.xml setting file.
The width and height of the 16-bit RGB or grey scale image is calculated from the maximum number of columns and rows needed to accommodate the sensor's field of view and the maximum part length.