The DLRuntime tool edit control provides a graphical user interface to the [T_Cognex_VisionPro_DLRuntime_CogDLRuntimeTool] tool API, which you use to integrate a saved VisionPro Deep Learning (VPDL) runtime workspace into your QuickBuild application. See the topic Integrating a VPDL Runtime Workspace for more information.

The edit control offers the following features:

• A row of control buttons at the top provide access to the most common operations.
• A set of function tabs allow you specify the VPDL workspace you want to import and view results from the tools contained in the workspace.
• An image display window displays the images you acquire and the results of processing the image with the various VPDL tools configured in the runtime workspace.

To include the edit control in your custom vision application, you must first add it to your Visual Studio .NET development environment. See the topic Adding Edit Controls to Visual Studio for more information.

See the following sections for more information:

• Control Buttons
• DL Workspace
• Graphics
• Result

The following table describes the function of each button:

Button	Description	Function
	Run	Run the tools contained in the VPDL runtime workspace on the image stored in the Current.InputImage record.
	Electric mode	Toggle electric mode, where the DLRuntime tool executes automatically when particular configuration parameters change. In electric mode, a lightning bolt appears next to every electric property.
	Local image display	Open or close the local image display window. A DLRuntime tool supports the following image buffers: The Current.InputImage buffer contains the current image the tool will analyze. The LastRun.InputImage buffer contains the last image processed by the DLRuntime tool. Other LastRun image buffers to display tool results from the VPDL tools in the runtime workspace and any additional image processing you perform on the image.
	Floating image display	Open one or more floating image windows, which support the same image buffers as the local image display window.
	Open	Open a VisionPro persistence (.vpp) file that contains a set of saved properties for this vision tool object type. VisionPro reports an error if you try to open a .vpp file for another object type.
	Save	Save the current properties of the vision tool to a VisionPro persistence (.vpp) file. The edit control allows you to choose between saving the vision tool with or without its image buffers and tool results.
	Save As	Save the current properties of the vision tool to a new VisionPro persistence (.vpp) file.
	Reset	Reset the vision tool to its default state. The tool gives you a choice between resetting to the default-constructed state, which is appropriate when you are using it in a Visual Studio.NET application, or its template-initialized state, which is appropriate for QuickBuild applications.
	Show Floating Results	Open a separate results window with the same contents as seen in the Results tab.
	Show ToolTips	Enable or disable the display of tooltips for individual items in the edit control.
	Help	Open this VisionPro online help file.

This section contains the following subsections.

• Simple Mode
• Advanced Mode
• Stream

Use the DL Worksapce tab to select the VisionPro Deep Learning (VPDL) runtime workspace you want to integrate into QuickBuild. The tab supports a simple mode and an advanced mode, toggled with the following element:

The tab offers the following parameters in simple mode:

The tab offers the following parameters in advanced mode:

Use Selected Stream Name to select the stream you want to process:

Refer to your VisionPro Deep Learning technical documentation for details on streams.

This section contains the following subsections.

• Results
• Diagnostics

Use the Graphics tab to enable or disable various graphics over the LastRun records associated with any VPDL tool in the runtime workspace:

Enable Show Red Score Maps to show the ScoreMap image for any Red tool.

Enable or disable any of the following diagnostic graphics:

Use the Result tab to view the results from any VisionPro Deep Learning tool in the runtime workspace:

Use Tool to choose which VPDL tool result to display. Refer to your VisionPro Deep Learning documentation for details on the results for any tool.