|On this page…|
If you are having trouble using the Image Acquisition Toolbox™ software with a GenICam™ GenTL camera driver using the toolbox's gentl adaptor, follow these troubleshooting steps:
With previous versions of the Image Acquisition Toolbox, the files for all of the adaptors were included in your installation. Starting with version R2014a, each adaptor is available separately through the Support Package Installer. In order to use the Image Acquisition Toolbox, you must install the adaptor that your camera uses, in this case, the GenICam Interface support package. See Image Acquisition Support Packages for Hardware Adaptors for information about installing the adaptors.
Verify that the adaptor loads. You can use the imaqhwinfo command to list installed adaptors. The gentl adaptor should be included on the list.
If it does not load, make sure that GenICam is configured correctly using the imaqsupport function.
For information on installing GenICam, see Software Configuration.
Make sure your camera's driver is installed.
Make sure your environment variables are set. For example, depending on the GenTL producers you have installed, on a 32-bit Windows® system, it could be something like:
GENICAM_GENTL32_PATH=C:\Program Files\LeutronVision\Simplon\bin\cti;C:\Program Files\MATRIX VISION\mvIMPACT acquire\bin;C:\XIMEA\GenTL Producer\x86
Each directory that you list in the environment variables must contain a DLL file that has a .cti extension and that exports the standard C functions that are expected for a GenTL producer. The Image Acquisition Toolbox gentl adaptor scans these directories for all the CTI files and then checks whether they export the correct minimum set of functions.
Test the connectivity of your device separate from using the Image Acquisition Toolbox. Use the vendor program included with your device to see if you can detect and acquire images from the camera.
If you are using the GenICam GenTL adaptor with a GigE Vision camera, it may be the case that the producers for GigE Vision cameras do not send a ForceIP command and so sometimes after plugging in a new camera, it will not be found. Using the toolbox's gige adaptor first can resolve this.
You can also look at producers in other vendor software.
For example, Leutron Vision uses a program called Simplon Explorer. Using this program you can see what producers are installed and what cameras are connected. You can double-click on a camera within the Simplon Explorer to control it.
Note that with Matrix Vision, if a device is configured for DirectShow, it will not be available to GenTL.
Run the imaqsupport function for further troubleshooting information.