# Migrating to This Release

This topic contains information about changes that may affect existing ViDi projects when migrating projects from previous releases to the current release.

## Changes to the Viewing of Overlay Graphics

In the 3.4.0 and 4.1.0 releases, the keyboard shortcuts used to show and hide overlay graphics in the Image Display Area have been changed. The new keystrokes are the following:

- The Alt key plus the Right Arrow key or the Alt key plus the Left Arrow key

These are used to cycle through the available combinations of display graphics (labels, markings, labels and markings, or no overlay graphics).

In previous releases, the space bar could be used to show or hide all overlay graphics, but that is no longer supported.

## Changes to Tool Training Workflow

In the 3.4.0 release, there is a new method for specifying the images/views that will be used to train a tool. If you will be re-training a tool that was trained in a previous release, you will need to configure the tool to use the new training set paradigm, via the Select Training Set dialog. Please refer to the Training Set and Use the Select Training Set Dialog topics.

## Changes to the Feature Filter Syntax

In the 3.4.0 release, the syntax for the Feature Filter Processing tool parameter was modified. If you were using width and height in your expression, they must now be qualified with view, such as view.width and view.height.

For example, in version 3.2 and earlier, syntax used to limit the found features to those where the center of the feature lies within the ROI would have been the following:

x < width and x > 0 and y > 0 and y < height

In 3.4.0 and later, it must now be expressed as the following:

x < view.width and x > 0 and y > 0 and y < view.height

Note:

This syntax can also more easily be expressed by using the in operator. For example, the following syntax could be used to simplify the expression:

x in [0,view.width] and y in [0,view.height]

When you open previously created Designer projects that contain the ViDi Sub Task Designer plugin, they will continue to use the previous version of the ViDi plugin unless the plugin is updated in Designer. If you attempt to load a project that contains the older plugin version, you will be prompted to update the plugin to the latest version.

All newly created projects after ViDi 4.1.0 has been installed will use that version of the plugin, even if the previous version is still installed.

To manually update the Designer project's plugin version to version 4.1.0 of ViDi, you will need to perform the following steps:

1. Launch Designer.
2. From the Designer Launch Page, select the project containing the VisionPro ViDi components.
3. Open the Utilities and launch the Project Plugin Configurator utility.
4. The Select a project dialog will be launched, where you can select the project.
5. Check the check box of the 4.1.0 version, and un-check the previous version.
6. Press the OK button.