Opto Engineering® - 20 years
Home Resources Tech notes
How to integrate ITALA® cameras with Machine Vision Software

The principal purpose of this technical document is to provide an exhaustive guide, offering valuable insights into the integration of the ITALA® camera with the most common Machine Vision software applications.

Each section contained herein is dedicated to a distinct software platform. Within each section, we undertake a comprehensive exploration of the connection process, accompanied by a presentation of detailed step-by-step instructions, complemented by illustrative screenshots.

Our goal is to provide users with a thorough understanding of the procedures involved, ensuring a smooth and proficient implementation of the ITALA® camera across diverse Machine Vision software environments.

Opto Engineering - FabImage®

Connect the camera, to do that follow the guidelines that you find in the Getting Started. Once the camera is properly connected, open FabImage Studio.

With FabImage® you have the possibility to use either GigEVision or GenICam protocols, Itala cameras are compatible with both of them. We will see first how to set up the connection using GigEVision and then how to do it with the GenICam protocol.

GigE Vision

In the Toolbox section, which is usually on the left, double-click on GigEVision, you can find it under the tab Image Acquisition.

Toolbox GigEVision
Toolbox GigEVision

A new window will open that allows you to choose among different filter variants. Here you can choose to grab an image either in synchronous mode or with a timeout. The main difference between the two modes is that with Synchronous the program will wait for an image for an indefinite period of time, stopping the execution of the program. Using WithTimeout you can set a time in milliseconds that will be the maximum time that the program will wait for the image to come, if no image comes it will return a Nil.

For this example, we will go with Synchronous, so double-click on that. This will add the filter to the program editor.

GigEVision filter variant
GigEVision filter variant

Now click on the recently added filter to show the properties, these will be shown in the Properties tab, which is usually on the bottom left of the program as a default setting. You will notice that the program is asking for an input, which is the address of the camera since the inAddress variable has an orange-lined background. Click on the icon with the three dots to assign an address to the filter.

FabImage workflow
FabImage workflow

This will open up the GigE Vision Device Manager which will display some useful information such as a list of the cameras connected to the PC, their IP Address, the MAC address, and the Serial Number. Select the camera that you want to connect and click on Select.

GigEVision device manager
GigEVision device manager

Now drag the output of the filter, the outFrame, to the data preview. Run the program to see the live image being captured.

If you want to control the parameters of the cameras there are two ways. One will be using the integrated tool inside FabImage, the other is using the filters. If you need to quickly set your parameters the first method is the easiest to do however, if your parameters need to change dynamically during the execution of the project, you have to do it with the filters.

To access the tool go to Tools > Manage GigE Vision Devices…, in the window that will appear select the camera that you want to manage by double clicking on its name. This will open the GenICam tree of the camera, by navigating to the wanted parameter you will see a tab with some information and an editor.

Once you are done editing the parameters of the camera, simply click on Close to close the window.

Device control
Device control

The other way to change the parameters is by using FabImage’s filters. In the FabImage toolbox go down to the Program I/O tab, open it, and select the GigEVision I/O.

GigEVision I/O Filter
GigEVision I/O Filter

This will open a window with all the possible options of the GigEVision filter, you can either Set a Parameter, Get the value of a parameter, or Execute commands. In this case, you also need to choose the type of parameter that you are going to modify. If we keep the exposure time as an example we can select Real. To do that just double-click on it, this will add the filter to the program editor.

GigEVision I/O Filter Variant
GigEVision I/O Filter Variant

Now click on the filter once to select it, in this way, you will be able to see the properties of the filter. Here you need to specify the Address of the camera, following the same procedure used for the GrabImage filter.

GigEVision setting parameter
GigEVision setting parameter

You will need to specify the name of the parameter in the inParameterName variable. To do that click on the icon with the three dots, this will open the GenICam tree of the camera. Navigate to the parameter that you want to access and double-click on it. Now you just need to put the value of the parameter that you want to set in the inValue field.

Device control
Device control

When you are setting a parameter of the camera always put the filters before the acquisition of the image, if you want to see the changes straight away, otherwise in the first iteration of the project you will start the acquisition with the values already set in the camera.

GenICam

On the left, you will find a section called Toolbox, here double click on GenICam, and you can find it under the tab Image Acquisition.

Toolbox GenICam
Toolbox GenICam

A new window will open that allows you to choose among different filter variants. Here you can choose to grab an image either in synchronous mode or with a timeout. The main difference between the two modes is that with Synchronous the program will wait for an image for an indefinite period of time, stopping the execution of the program. Using WithTimeout you can set a time in milliseconds that will be the maximum time that the program will wait for the image to come, if no image comes it will return a Nil.

For this example, we will go with Synchronous, so double-click on that. This will add the filter to the program editor.

GenICam filter variant
GenICam filter variant

Now click on the recently added filter in order to show the properties on the tab on the bottom left of the program. You will notice that the program is asking for an input, which is the address of the camera since the inAddress variable has an orange-lined background. Click on the icon with the three dots to assign an address to the filter.

FabImage workflow
FabImage workflow

This will open up the General Device Manager which will display all the GenTL infrastructures. Locate the one called Opto Engineering GenTL 1.5 Producer, open it, and select the Network Card Interface that you want to use, open that and you will see the name of the camera connected. Click on that and then click Select.

General Device Manager
General Device Manager

Now drag the output of the filter, the outFrame to the data preview. Run the program to see the live image being captured.

If you want to control the parameters of the cameras there are two ways. One will be using the integrated tool inside FabImage, the other is by means of the filters. If you need to quickly set your parameters the first method is the easiest to do. However, if your parameters need to change dynamically during the execution of the project, you have to do it with the filters.

To access the tool go to Tools > Manage GenICam Devices…, in the window that will appear, locate the GenTL infrastructure named Opto Engineering GenTL x.x Producer, open it, and open also the correct Network Card Interface that you want to use. Double-click on the name of the camera. This will open the GenICam tree of the camera, by navigating to the wanted parameter you will see a tab with some information and an editor.

Once you are done editing the parameters of the camera, simply click on the Close button in order to close the window.

Device control
Device control

The other way to change the parameters is by using FabImage’s filters. In the FabImage toolbox go down to the Program I/O tab, open it, and select the GenICam I/O.

GenICam I/O Filter
GenICam I/O Filter

This will open a window with all the possible options of the GenICam filter, you can either Set a Parameter, Get the value of a parameter, or Execute commands. In this case, you also need to choose the type of parameter that you are going to modify. If we keep the exposure time as an example we can select Real. To do that just double-click on it, this will add the filter to the program editor.

GenICam I/O Filter Variant
GenICam I/O Filter Variant

Now click on the filter once to select it, in this way, you will be able to see the properties of the filter. Here you need to specify the Address of the camera, following the same procedure used for the GrabImage filter.

GenICam setting parameters
GenICam setting parameters

You will need to specify the name of the parameter in the inParameterName variable. To do that click on the icon with the three dots, this will open the GenICam tree of the camera. Navigate to the parameter that you want to access and double-click on it. Now you just need to put the value of the parameter that you want to set in the inValue field.

Device control
Device control

When you are setting a parameter of the camera, always put the filters before the acquisition of the image if you want to see the changes straight away, otherwise in the first iteration of the project you will start the acquisition with the values already set in the camera.

Cognex - VisionPro

Connect the camera, to do that follow the guidelines that you find in the Getting Started. Please notice that this software is not a product of Opto Engineering, but it has been developed and is maintained by Cognex.

Once the camera is properly connected, open Cognex GigE Vision Configurator to ensure that the performance driver is correctly installed and set.

Cognex GigE Vision Configuration Tool
Cognex GigE Vision Configuration Tool

Now open VisionPro QuickBuild, this will be used to integrate the camera and create the project with VisionPro. In order to import the camera double click on Image Source.

QuickBuild
QuickBuild

Two windows will open up, use the Image Source window, here you will set the source used to acquire the image. You can either select a camera or acquire an image, we will select a camera. Double-click on the Camera button.

Image source window
Image source window

This will show the camera settings, from this window you can select the camera to use. Click on the combo box to see the list of available cameras. Select the entry related to the Itala Camera which starts with GigE Vision, in this way, you ensure to use GigE Vision communication interface.

ITALA camera selection
ITALA camera selection

Click on the descending arrow in the video format box to select the desired pixel format for the image acquisition.

Pixel format selection
Pixel format selection

To start the acquisition of the camera click on Initialize Acquisition.

Acquisition start
Acquisition start

Click on the camera icon on the top left of the window to see a live preview of the image acquired.

You will notice that also other tabs appeared in the window, you can use these to control the parameters of the camera.

Camera parameters
Camera parameters

MVTec - Halcon

Connect the camera, to do that follow the guidelines that you find in the Getting Started. Also, make sure to have downloaded the latest version of GigEVision interface for Halcon.

Once the camera is properly connected, open Halcon HDevelop. Please notice that Halcon is not an Opto Engineering Product but it has been developed and is maintained by MVTec.

Go to Assistant and click on Open New Image Acquisition, this will open an image acquisition assistant window which will guide you through the connection with the camera.

Open the assistant
Open the assistant

The assistant allows you to select the camera to connect, control the camera parameters, and capture the images.

In the Source tab, you need to select the correct acquisition interface. Select the option Image Acquisition Interface and from the dropdown menu select GigEVision2 as the interface that you are going to use.

Image acquisition assistant
Image acquisition assistant

Then go to the Connection tab, here you can choose the camera to connect with Halcon. From the drop-down menu close to the device parameter you can select the camera. Notice that if you do have only one camera connected this will be shown. Once you have selected the camera click on Connect. This will start the connection with the camera, you can use the buttons Snap or Live to either acquire a single image or to start the acquisition of a stream of images.

Camera selection
Camera selection

Once the camera is connected you will be able to access the tabs EasyParams and Parameters which allow for the control of the camera parameters. You can use the tab Parameters to access and modify the GenICam tree of the camera. Note that if you are not connected to the camera, you will not be able to access these two tabs.

Once you set up the camera you can generate the code to use in HDevelop for the image acquisition. To do that go to the Code Generation tab, select the Control Flow and the Acquisition mode, and then click Insert Code. You will then find the generated code in the Program Window of HDevelop.

Code generation
Code generation

National Instruments - LabView

Connect the camera, to do that follow the guidelines that you find in the Getting Started. Once the camera is properly connected, open NI MAX. Please notice that this software has been developed and is maintained by National Instruments.

LabView main window
LabView main window

You should see a window that displays some information about the PC that you are using. In order to see the camera you need to use the menu on the left. Go to My System > Devices and Interfaces > Network Devices. Here you should see a list of all the cameras connected to the PC. Opto Engineering cameras will be seen as Opto Engineering NAME OF THE CAMERA “cam_number”.

Camera selection
Camera selection

Click once on the name of the camera to access its parameters. The central window of the software will change and it will show some general information about the device such as the name, the IP address, the model name, and the serial number.

On the top, you will see two buttons to snap an image or to start the grabbing of a stream of images. At the bottom, you can change the information displayed in the central window and you will be able to access the camera parameters. In particular:

  • Acquisition Attributes: allows to show the image, allows to change the pixel format, and to select a Region of Interest.
  • Camera Attributes: displays the GenICam tree with all the camera parameters and allows you to change them.
  • Bayer Color: can be used to perform White Balance operation.
  • Ethernet Attributes: contains the attributes related to ethernet connection.
Camera information
Camera information

You can switch to Camera Attributes and navigate to Exposure Time to select a proper value. You will find it under Acquisition Control.

Camera parameters
Camera parameters

Once you set your camera parameters you can click on Grab to start the acquisition of the camera. You will see the image displayed in the center of the window.

Acquiring an image
Acquiring an image