You are here: Start » User Interface » Deploying Programs with the Runtime Application

Deploying Programs with the Runtime Application

Introduction

Adaptive Vision Executor is a lightweight application that can run programs created with Adaptive Vision Studio. The GUI controls that appear in this application are the ones that have been created with the HMI Designer. The end user can manipulate the controls to adjust parameters and can see the results, but he is not able change the project.

Adaptive Vision Executor application is installed with the Adaptive Vision Studio Runtime package. It can be used on computers without the full development license. Only a runtime license is required. What is more, programs executed in Adaptive Vision Executor usually run significantly faster, because there is no overhead of the advanced program control and visualization features of the graphical environment of Adaptive Vision Studio.

The screen of Adaptive Vision Executor.

Usage

Open a project from a file and use standard buttons to control the program execution. A file can also be started using the Windows Explorer context menu command Run, which is default for computers with Adaptive Vision Studio Runtime and no Adaptive Vision Studio installed.

Please note, that Adaptive Vision Executor can only run projects created in exactly the same version of Adaptive Vision Studio. This limitation is introduced on purpose – little changes between versions of Studio may affect program compatibility. After any upgrade your application should first be loaded and re-saved with Adaptive Vision Studio as it then runs some backward compatibility checks and adjustments that are not available in Executor.

Console mode

It is possible to run Adaptive Vision Executor in the console mode. To do so, the --console argument is needed to be passed. Note, that this mode makes the --program argument required so the application will know which program to run at startup.

Adaptive Vision Executor is able to open a named pipe where it's log will be write into. This is possible with --log-pipe argument which accepts a pipe name to be opened. One may then connect to the pipe and process Adaptive Vision Executor log live. This can be easily done e.g. in C#:


	var logPipe = new NamedPipeClientStream(".", "myProjectPipe", PipeDirection.In);
	logPipe.Connect();

	byte[] buffer = new byte[1024];
	int count = 0;
	while (logPipe.IsConnected && (count = logPipe.Read(buffer, 0, 1024)) > 0)
	{
		Console.WriteLine(Encoding.UTF8.GetString(buffer, 0, count));
	}

Available Adaptive Vision Executor arguments are as follows:

--program
Path to the program to be loaded
--log-level
Sets the logged information level
--console
Runs the application in the console mode
--auto-close
Automatically closes the application when program is finished. Meaningful only in console mode.
--language
Specifies the language code to use as the user interface language.
--attach
Attaches application process to the calling process console.
--log-pipe
Creates a named pipe which will be populated with log entries during application lifetime. Meaningful only in console mode.
--help
Displays help

Runtime Executables

Adaptive Vision Executor can open .avproj files, the same as Adaptive Vision Studio, however it is better to use .avexe files here. Firstly one can have a single binary executable file for the runtime environment. Secondly this file is encrypted so that nobody is able to look at project details. To create one, open a project in Adaptive Vision Studio and use File » Export to Runtime Executable.... This will produce an .avexe file that can be executed directly from the Windows Explorer.

If Adaptive Vision project contains any User Filter libraries, it is crucial to put their *.dll files into the appropriate directory when running in Adaptive Vision Executor. This is when exporting to .avexe file might also be a handy option. While defining the .avexe contents, it is possible to select all the User Filters libraries that the exported project depends on. Selected libraries are deployed then to the same directory as generated .avexe file and the .avexe itself is set to use all User Filter libraries from its directory.

Defining the Runtime Executable.

In case there are any other dependencies, e.g. exposed by used User Filter libraries, one can add them into the Adaptive Vision project as an attachment in Project Explorer and also deploy with .avexe file during export.

Trick: Configuration File as a Module Not Exported to AVEXE

It is often convenient to have an configuration file separated from the executable so that various parameters can be adjusted for a particular installation (but not made available to the end user). This can be easily implemented with a simple programming idiom:

  1. Use global parameters in your project for values that might require adjusting.
  2. Place the global parameters in a separate module (through the Project Explorer window).
  3. Exclude the module when exporting the .avexe file.
  4. In the runtime environment copy the .avexe file and the module (as a separate file) with global parameters.
  5. Open the config module in the Notepad to edit it when needed.

Other Runtime Options

Please note that Adaptive Vision Executor is only one of several options for creating end-user's applications. Other available options are:

  • .NET Macrofilter Interface Generator – generates a native .NET assembly (a DLL file) and makes it possible to invoke macrofilters created in Adaptive Vision Studio as simple class methods from a .NET project. Internally the execution engine of Adaptive Vision Studio is used, so modifying the related macrofilters does not require to re-compile the .NET solution. The HMI can be implemented with WinForms, WPF or similar technologies.
  • C++ Code Generator – generates native C++ code (a CPP file) that is based on Adaptive Vision Library C++. This code can be integrated with bigger C++ projects and the HMI can be implemented with Qt, MFC or similar libraries. Each time you modify the program in Studio, the C++ code has to be re-generated and re-compiled.

Startup Applications

It is possible to run any process before starting a program in Adaptive Vision Executor. Go to Settings in Adaptive Vision Executor and the Startup section. To define a new startup program select the Add button on the right. In a New startup program dialog box you need to specify the application path (obligatory) and arguments (optional). It is similar to typing the application name and command-line arguments in the Run dialog box of the Windows Start menu. The added program will appear in the list. All added programs will start each time you run Adaptive Vision Executor.

Defining Startup Applications

If Deep Learning Service is installed you can choose to run it on start by selecting 'Start Deep Learning service on startup'.

Previous: Seeing More in the Diagnostic Mode Next: Remote Access to the Runtime Application