You are here: Start » FIL.NET » HMI Controls for FIL.NET

HMI Controls for FIL.NET


It is possible to use a subset of HMI Controls, available in FabImage Studio HMI Designer, in an FIL.NET based Windows Forms .NET application. Controls from the VideoBox family (for presenting video preview or 2D geometry results), and the View3DBox control (for presenting 3D data results) are particularly useful. All available HMI controls are fully compatible Windows Forms controls, and can be used in projects which GUI is based on Windows Forms and .NET Framework 4 (or later compatible).

To be able to use the controls in an application, a reference to all the following modules needs to be added to the application project:

  • HMI.dll
  • HMI.Controls.dll
  • VideoBoxBase.dll

All the above libraries can be found in the appropriate platform binaries subdirectory of FabImage Library installation directory. Additionally, when working with FIL.NET library, or FIL.NET primitive types, the modules FilNet.dll and FilNet.TS.dll will also be referenced by the application (as described in Getting Started with FabImage Library .NET).

Please note: In order for the Microsoft Visual Studio's Windows Forms designer to work with the controls, 32 bit version of the libraries must be used and the application must be build for 32 bit (x86) platform. For final deployment, the application can, however, be build for 32 or 64 bit platforms, and care must be taken to include the proper platform version of the controls and FIL.NET libraries with the application.

To begin working with the Microsoft Visual Studio Windows Forms designer, controls from the HMI.Controls.dll module must be manually added to the Microsoft Visual Studio toolbox (right click on a chosen category in the toolbox » Choose Items... » Browse » select HMI.Controls.dll from the 32 bit binaries of FabImage Library).

Once the controls are available in the toolbox, they can be used as any other Windows Forms controls. The properties available for editing in the FabImage Studio HMI designer will also be available in the Microsoft Visual Studio Windows Forms designer. The ports available for connection with a vision application in the FabImage Studio HMI designer are available as properties of the control object accessible from the application code (e.g. an equivalent of the inValue port of Knob control is to write a value to the Value property of HMI.Control.Knob class). For more information, check the control classes listed below .


An example presenting how to use HMI controls in a Windows Forms application is located in the FIL examples folder as "05 FIL.Net\10 video box control". This example show how set up the application project and how to use ZoomingVideoBox control for displaying a single image.

Available Control Classes

All HMI control classes are located in the HMI.Controls namespace. The following class types are available as controls in user applications:

Previous: FIL.NET Designers Next: FIL.NET Performance Tips