Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Widgets are used to control and visualize data points in a project.

Page Content

Table of Contents
excludePage Content

Adding a Widget

To add a widget to a diagram, open the Libraries menu with the “+” button located in the bottom-left corner of the diagram.Image Removed

...

Once added, the sidebar shows the data points for the selected widget.

Widgets

Commands

Command widgets can be connected to a parameter in order to control that parameter from the diagram. 

Name

Icon

Description

Numeric Control

Image Removed
image-20240308-191836.pngImage Added

Command a numerical parameter, either INTEGER or REAL.

Knob

Image Removed
image-20240311-021301.pngImage Added

Command a numerical parameter in a given range, either INTEGER or REAL.

Slider

Image Removed
image-20240311-021409.pngImage Added

Command a numerical parameter in a given range, either INTEGER or REAL.

Switch

Image Removed
image-20240311-021449.pngImage Added

Command a numerical parameter for a pre-determined set of two values. Best suited for BOOLEAN. The value sent is either “Value (Off)” or “Value (On)”.

Image Loop Control

Image Removed
image-20240311-021715.pngImage Added

Command a numerical parameter for a pre-

detemined

determined set of up to ten values. Best suited for INDEX or ENUM.  Each time the widget is clicked, the next image is shown and the next value is sent.

If the value received is not equal to any “Value N”, the fallback image is displayed.

The “Image 1” parameter is responsible for setting the aspect ratio.

Button

Image Removed
image-20240311-021815.pngImage Added

Command a numerical parameter for a pre-determined set of two values. Best suited for TRIGGER. The value sent is either “Value (idle)” or “Value (pressed)”.

Button can also trigger the run of a script.

When the “Behavior” is set to “Non-Latching”, the value for “Value (pressed)” is sent only while the left mouse button is pressed over the widget.

When the “Behavior” is set to “Latching”,  the value for “Value (pressed)” is sent as soon as a mouse click occurs on the widget, and until a subsequent mouse click.

When the “Behavior” is set to “scripting, a script from the Scripts list must be chosen.

Dropdown

image-20240311-022706.pngImage Added

Command a numerical parameter for a pre-determined set of values. Best suited for INDEX or ENUM

The pairs of text and value can be edited in the widget States table as shown below.

DropDown.gifImage Added

Displays

Display widgets can be connected to a parameter, an input or an output. It visualizes the value of said parameter, input or output on the diagram, without interacting with it.

Name

Icon

Description

Numeric Display

Image Removed
image-20240311-022041.pngImage Added

Display a numerical value.

Gauge

Image Removed
image-20240311-022153.pngImage Added

Display a numerical value in a given range. Visual lower and upper areas can be added.

Thermometer

Image Removed
image-20240311-022341.pngImage Added

Display a numerical value in a given range. 

LED

Image Removed
image-20240311-022432.pngImage Added

Display whether a numerical value is or isn’t equal to zero.

Image Loop Display

Image Removed
image-20240311-022513.pngImage Added

Display a numerical value within given range. Many ranges can be set per image. If no range match is found, the fallback image is displayed.

The “Image 1” parameter is responsible for setting the aspect ratio.

Graph

Image Removed
image-20240311-022557.pngImage Added

Display values of multiple signals over an acquisition time period. Acquisition can be configured to be triggered upon a selected signal. As Graph operates slightly differently than other widgets, refer to the Graph widget section.

Graphics

Graphic widgets are visual tools to add on a diagram.

Name

Icon

Description

Text

Image Removed
image-20240311-030301.pngImage Added

Add customizable text on the diagram.

Tab Group

image-20240311-030403.pngImage Added

Add a widget containing multiple Tabs to alternate between sets of widgets.

Tab can be added with the image-20240311-032645.pngImage Added button, moved with the context menu and renamed by double-clicking on the tab name.

ShapeImage Removed

Tab can also be deleted, and all widgets contained in the tab will be deleted with the deleted tab.

To add a widget in a Tab, simply drag and drop the widget on the active tab.

Tabs.gifImage Added

Note that Tab Group does not support copy-paste and the Python API.

Shape

image-20240311-030801.pngImage Added

Add a customizable shape on the diagram.

Image

Image Removed
image-20240311-030847.pngImage Added

Add an image on the diagram. The image can be rescaled and rotated. The aspect ratio is controlled by the “Fit” parameter.

The image can be “Sent to Back” or “Sent to Front” from the context menu (just like any other widget).

Data Points and Properties of Widgets

...

Title is the name displayed on the diagram. The visibility can be toggled with the Image Modified button.

Data is the data point for this widget. Based on the widget’s category, a connection can be created between the widget’s “Data” parameter and another parameter, input or output.Image Removed

...

For detailed documentation about connections, see Connecting Data Points.

Data type is the type used for the value of a command widget. If the connected data point is “Integer”, a rounding operation is made for the value to remain an integer. It can be modified to be “Real” instead.

Minimum Minimum and Maximum define the range of the ticks. Incoming values are not clipped to the widget range.

...