Dialog: Options: Visualization

Symbol:

Function: Configures the visualization editor and the integrated visualization

Call: Tools → Options menu, Visualization category

Tab: General

Note

These settings are not applied used for the following display variants: CODESYS TargetVisu, CODESYS WebVisu, or CODESYS HMI.

Presentation Options (Visualization Editor in the Programming System)
Fixed	The visualization retains its original size.
Isotropic	The visualization retains its proportions.
Anisotropic	The visualization resizes to the window in the development system.
Use scaling options for dialogs	: The dialogs (also for keypad and numpad) are scaled as the visualization (drawn with the same scaling factor). This is an advantage when a dialog was created to match the visualization because then they are scaled together.
Antialiased drawing	: The visualization is drawn with antialiasing methods, both while editing and as an integrated visualization at runtime. Tip If a horizontal or vertical line is drawn blurry on a specific visualization platform, then this can be corrected by an offset of 0.5 px in the direction of the line thickness (see element Absolute movement property, Use REAL values option). Requirement: The platform in use supports REAL coordinates.
Device Image	If a “device image” (DeviceImage) is defined in the device description of the controller or in the Advanced Settings of the Visualization Manager, then it can be displayed in the visualization editor. Show offline: : The device image is visible in offline mode. Show in visualizations with parameter interface: : The device image is displayed. Visualizations with a parameter interface are often used only as a partial image. Then it is not useful to display the device image there. Show online: : The device image is visible in online mode.
Editing Options
Link to toggle/tap variable where appropriate	: The <toggle/tap variable> placeholder is activated in the visualization element properties. When you drag an element that has the Color variables and Toggle color properties into the visualization editor, then this property is configured with the <toggle/tap variable> placeholder. The following elements are affected: Button, Frame, Image, Line, Pie, Polygon, Rectangle, Text Field, Scroll Bar.

Tab: Grid/Snapline

Table 122. Settings when positioning with snaplines is enabled

Assisted positioning	The Snaplines option is selected (default). In the editor, when inserting and moving elements, lines are shown which indicate where positions exist that match the positions of adjacent elements. In addition, lines are shown which subdivide the visualization editor into a grid. This allows you to align elements with adjacent elements or arrange them in a fixed column and row layout.
Snapping sensitivity	Distance in pixels from which snapping to the snapline takes effect `5`: Default
Element distance	Minimum distance to adjacent elements `10`: Default `0`: Maintaining a distance to adjacent elements is disabled.
Border distance	Minimum distance from the border which is observed from the snapline `5`: Default `0`: Maintaining a distance to the border is disabled.

"Grid" lines

Hidden grid to support positioning in a fixed row and column layout

The lines of the adjacent column or adjacent row are shown only when the element is moved with the mouse.

Columns

Number of columns (all the same width)

2: The snapline which is shown marks the horizontal center of the visualization editor (default).

0: Showing is disabled.

Rows

Number of rows (all the same width)

2: The snapline which is shown marks the vertical center of the visualization editor (default).

0: Showing is disabled.

Snap only on matching edges

: The alignment is limited. Alignment is done only between edges with the same position, such as left edge with left edge.

Table 123. Settings when positioning without assistance is enabled

Assisted positioning

The No assistance option is selected.

In the editor, you can freely position a visualization element.

Table 124. Settings when positioning with a grid is enabled

Assisted positioning	The Grid option is selected. A grid of points is displayed in the editor. You can move an element along the grid.
Enabled	: When you move the element and release the mouse button at the desired position, the element is automatically set to a grid point. You can position elements only on the grid.
Enabled	: The grid is visible. However, elements can occupy all positions. You can position the element freely.
Size	Horizontal and vertical distance to the grid points (in pixels) `10`: Default

For more information, see: Assisted Positioning

Tab: File Options

Text file for textual "List components"

File name and location of a .csv file type. It contains a table with texts in Text List format.

The file entries are provided when the "List components" feature is used as input assistance.

Note: You create this file as an export file of the global text list by means of the Import/Export Text Lists command.

Visualization Directories

Text list files

Locations for Text Lists.

Note: This setting is valid in the project as long as no other location is configured in the Project Settings, Visualization category, Text list files field.

Note: The location can also be defined by an environment variable.

Image files

Directory with image files that are available in the project. Multiple directories are separated by a semicolon.

CODESYS uses the directory for image pools with image files that are not integrated in the project, but referenced by a link. Absolute paths are used for global images throughout the entire project. Relative paths (example: .\images) are used for project-specific images.

This option allows for image pools to be opened successfully when the project and the respective image directory are moved to another directory on the computer.

Note: This setting is valid in the project as long as no other location is configured in the Project Settings, Visualization category, "Image files" field.

Note: The location can also be defined by an environment variable.

Tab: Global Settings

Table 125. Device Setting for Libraries and Global Visualizations

Device Setting for Libraries and Global Visualizations	The following settings are used when the visualization is in the POUs view or when you are developing a library in a library project that is currently open.
No limitation by device settings	: All visualization element properties exist for creating the visualization.
Use settings of the following device	: Only the visualization element properties that are released by the device setting below are available for creating the visualization.
Currently selected device	Device whose device settings are used.
Name	Example: CODESYS Control Win
Version	Example: 3.5.11.0
Select Device	Opens the Select Device dialog. All installed devices are listed there. You can filter by device or vendor. Select a device and click OK to close the dialog.
Derive device automatically	"Visualizations try to derive the device from current project". : If a device exists in the project, then its device settings are applied. As a result, only the visualization element properties are available that the device can also implement. For example, a gradient or rotating element (Interior rotation property) cannot be programmed for every device.

Editing Settings for Library Visualizations	The setting affects visualizations in library projects and internal visualizations there. Tip This option is intended for library developers to also display the properties in a visualization that are relevant for the overlay feature and can therefore be edited. This is necessary here because library projects by definition do not require a device description or a Visualization Manager.
Display overlay properties	: The properties relevant to the overlay feature (for example, the Animation duration property) are displayed.

Update Frame Parameters Settings

For more information, see:

Use Dialog for Update

: To update the frame parameters, the Updating the Frame Parameters dialog opens. A comparison list is displayed there where changed parameters are highlighted.

: The frame parameters are changed directly. Transfer arguments for removed interface variables are deleted and recently inserted interface variables remain unassigned.