# Images in the ViDi Editor

When you first launch the ViDi Editor, you will need to add images to the View Browser. After adding images, by default, the ViDi tool will utilize the Region of Interest provided by the spreadsheet function tied to the ViDi tool. Upon adding images within the ViDi Editor, the editor will automatically apply the external fixture and/or ROI data to the images. These images will be windowed and fixtured automatically based on the settings of the ViDi function's Region and Fixture parameter settings.

The fixture data and/or ROI can be generated by In-Sight Vision Tools (for example, a PatMaxRedLine pattern). This is helpful in applications where the part being inspected may appear in different locations from image to image.

When an external fixture or ROI is being used, this will be indicated in the ViDi Editor GUI through the following icons:

Icon | Description
--- | ---
| This icon is also displayed at the beginning of the ViDi tool's icon, and indicates that an ROI is being generated by an In-Sight function and provided as the tool's ROI.
| This icon is displayed at the beginning of the ViDi tool's icon, and indicates that external fixture data is being provided to orient the tool's ROI.
| The Input icon indicates that image data is being passed into the ViDi Editor. In this scenario, that image data is being provided with either an external fixture or an external ROI. The Update button is used to pass in the external fixture and/or ROI data to the ViDi tool(s). This should be utilized if you have changed the fixture or ROI in the spreadsheet, which has changed how it will be applied to the tools in the ViDi Editor.

When you first open a ViDi function in the ViDi Editor, the tool is automatically configured to use an External ROI.

From the drop-down you can select whether to use an External ROI, External Fixture or Internal (the ROI within the ViDi Editor; if you use this option, you must make sure that the Region of the ViDi function matches the dimensions and placement of the ROI in the ViDi Editor).

Note: Before you are able to graphically modify the ROI within the ViDi Editor, you must first press the Update Fixtures button, unless the drop-down has been set to Internal.

External ROI | External Fixture | Internal
--- | --- | ---
When set to External ROI, the ViDi tool relies on the Region of Interest data being passed in from the spreadsheet. Within the ViDi Editor, the ROI cannot be modified. | When set to External Fixture, the ViDi tool relies on fixture data being passed in from the spreadsheet to orient the ROI. Within the ViDi Editor, the ROI can be modified. If this option is used, ensure that the ROI in the ViDi Editor is the same as the Region parameter settings of the spreadsheet ViDi function. | When set to Internal, the ViDi tool utilizes its own ROI settings, independent of the fixture or ROI settings in the ViDi function in the spreadsheet. If this option is used, ensure that the orientation and ROI in the ViDi Editor is the same as the External Fixture and Region parameter settings of the spreadsheet ViDi function.

Note:

- Results from the following functions are supported as fixture data for the ViDi functions:

  - DetectBlobs
  - FindPatMaxRedLine
  - Fixture
  - Fixtures

- The Update Training Fixtures option runs the entire spreadsheet.

- For the ViDi function, even if you are using external fixtures, you can have parallel ViDi tool chains that contain a mixture of externally fixtured tools and internally fixtured tools. However, only ViDi tools with the External option enabled will use spreadsheet tool fixture data.

- In the event that an external fixture or ROI fails to properly align an image within the ViDi Editor, an error message, "No Views Extracted" will be displayed in the image.

  You can enter the filter syntax view_index = -1 in the Display filter to show all the views that are exhibiting this behavior.

  To correct the issue, note the names of the images that are experiencing this issue, then return to the Spreadsheet Editor and adjust the fixture data to account for the fixture failure.