This section walks through the setup steps of a tool:

Installed Tools

image-20260303-075452.png

The installed Viz AI tools are listed in the top-left section of the AI Terminal.

Create and Terminate a Tool

Click on a tool to open its configurations.

  • Click the image-20260303-075841.png button to go back to the list of installed tools.

  • Create a new configuration with the image-20260303-074449.png button.

  • Launch with an existing configuration using the power on/off image-20260303-074547.png switch.

  • The image-20260303-080257.png button reveals more options to rename, duplicate, or delete a configuration.

image-20260303-075733.png

Once started, a new instance pops up below. The instance starts with a console window. Close the newly created window or toggle off the power on/off image-20260303-074547.png switch to terminate the tool.

Tool Configuration

Select a tool instance and a view similar to the image bellow is shown:

image-20260303-080900.png

The tool configuration view contains the following:

  • If an error or warning is present, this is indicated with a corresponding icon in the instances list on the left.

  • Find the configuration and control options in the right panel. The control options remain editable while the tool is running.

  • Find the input and output configuration in the center panel. The input and output configuration is further documented in the I/O Modules chapter.

  • Run and stop the tool with the play and pause buttons on the top of the right panel.

During the configuration, warnings and errors indicate if a parameter is not specified as expected:

image-20241017-124459.png

Run and Pause a Tool

If no configuration errors are present, the tool is launched with the play button on the top of the right panel.

image-20241017-125006.png

After initialization, which is indicated by spinning wheels, icons indicate the running state for each of the elements. On hover, a tooltip text gives more information about what is causing the error or warning. To change configuration, first pause the tool with the pause button on the top of the right panel and resume the tool after the configuration is changed.

image-20241017-125055.png

If everything runs as expected, all icons turn into green check marks.

image-20241017-125405.png

Note: The configuration is automatically stored per tool and configuration and is restored when starting a new instance.

Note: While running, only control parameters and actions are enabled. To change configuration, first pause the instance.

Errors and Warnings

Note: Errors and warnings of the input and output adapters are listed in the I/O Modules chapter.

Severity

Text

Potential Fixes

Error

Tool has failed processing. Revisit the tool's configuration parameters.

  • Try another configuration.

  • Likely, the tool can not deal with the format of one of the inputs. For example, the tool expects two images of the same dimension. Check the tool's documentation for further information.

Error

Tool failed to setup. Revisit the tool's configuration parameters.

  • Try another configuration.

  • There is likely an issue with the tool. Check that the tool is compatible with this version of the AI Terminal and check the tool's documentation for further information.

Warning

One or multiple frames were dropped. Consider to choose a different performance mode.

  • If the tool offers different performance modes, choose one with higher performance versus quality.

  • Distribute the load of your applications onto different graphics devices. The graphics device chosen for the Viz AI tool can be changed in the configuration panel.

  • If not every frame needs to be processed, choose a different performance mode for the configured Synchronization adapter (for example, every second).