The Distance Line Ellipse edit control provides a graphical user interface to the DistanceLineEllipse method, which returns the shortest distance between Line to Ellipse. The edit control allows you to configure the line and the ellipse, dictate which graphics appear as the tool executes, and view tool results. The following figure shows the Distance Line Ellipse edit control:

The edit control offers the following features:

• A row of control buttons at the top left
• A set of function tabs to define the line and the ellipse, choose what graphics the tool will use, and view results
• An image display window for displaying tool images and graphics

You can experiment with the edit control by using QuickBuild to create a CogDistanceLineEllipse tool. A new CogDistanceLineEllipse tool appears as shown in the following figure:

The line and ellipse parameters can either be specified directly from within the edit control or accepted as the result of other shape-generating vision tools. For example, the following figure shows how a Distance Line Ellipse tool accepts the Line and Ellipse generated as output from a Create Line and Create Ellipse tools:

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

The following table describes the function of each button:

Table 1. Control buttons

Button	Description	Function
	Run	Measures the distance between the line and ellipse
	Electric mode	Toggles electric mode, where the Distance Line Ellipse tool executes automatically when particular configuration parameters change. In electric mode, a lightning bolt appears next to every electric property
	Local image display	Opens or closes the local image display window. A Distance Line Ellipse tool supports the following image buffers: The Current.InputImage buffer contains the current image and the input line and input ellipse The LastRun.InputImage buffer contains the results of the tool after it measures the distance between the line and the ellipse
	Floating image display	Opens one or more floating image windows, which support the same image buffers as the local image display window
	Open	Opens a VisionPro persistence (.vpp) file that contains a set of saved properties for this vision tool type. VisionPro reports an error if you try to open a .vpp file for another object type.
	Save	Saves 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	Saves the current properties of the vision tool to a new VisionPro persistence (.vpp) file
	Reset	Resets the vision tool to its default state.
	Show ToolTips	Enables or disables the display of tooltips for individual items in the edit control
	Help	Opens this VisionPro online help file

Use the Settings tab to define Line and Ellipse, or use the tab to confirm that the existing shapes correspond to the correct input parameters generated by another tool. The following figure shows the Settings tab:

The Settings tab offers the following features to define the Line parameter:

The Settings tab offers the following features to define the Ellipse parameter:

Use the Graphics tab to control which graphics the Distance Line Ellipse tool generates and displays. The following figure shows the Graphics tab:

The Graphics tab offers the following features:

Use the Results tab to view the relationship between Line and Ellipse as determined by the Distance Line Ellipse tool. The following figure shows the Results tab:

The Results tab offers the following features: