If you are having trouble using the Image
Acquisition Toolbox™ software
with a GenICam™ GenTL camera driver using the toolbox's
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 MATLAB® Add-Ons. 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
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
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 64-bit Windows® system, it could be something like:
GENICAM_GENTL64_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
and that exports the standard C functions that are expected for a
GenTL producer. The Image
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
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.
imaqsupport function for
further troubleshooting information.