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

HMI Controls for AVL.NET

Introduction

It is possible to use a subset of HMI Controls, available in Adaptive Vision Studio HMI Designer, in an AVL.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 Adaptive Vision Library installation directory. Additionally, when working with AVL.NET library, or AVL.NET primitive types, the modules AvlNet.dll and AvlNet.TS.dll will also be referenced by the application (as described in Getting Started with Adaptive Vision Library .NET).

Please note: In order for the 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 AVL.NET libraries with the application.

To begin working with the Visual Studio Windows Forms designer, controls from the HMI.Controls.dll module must be manually added to the 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 Adaptive Vision 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 Adaptive Vision Studio HMI designer will also be available in the Visual Studio Windows Forms designer. The ports available for connection with a vision application in the Adaptive Vision 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 .

Example

An example presenting how to use HMI controls in a Windows Forms application is located in the AVL examples folder as "05 AVL.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: AVL.NET Designers Next: Usage Examples