“Use unicode strings”

: The visualization codes character strings as Unicode.

“Use CurrentVisu variable”

: the application knows and uses the global variable ‎VisuElems.CurrentVisu‎ of the type ‎STRING‎. It contains the name of the currently active visualization at the runtime of the application. The application can read from the variable in order to obtain the name of the currently active visualization. The application can cause a visualization change by a write access.

Requirement: the application contains a visualization that calls further visualizations.

“Selected style”

Opens a selection list with styles that are installed in the visualization styles repository.

“Display all versions (for experts only)”

: The selection list contains only the latest version of each selected style and all other styles. If a newer version of the selected style is installed it is also displayed.

: The selection list contains all versions of all installed styles.

Button

Opens a selection list with commands for the use of the “Visualization Styles Editor”.

“Open Style Editor”

The “Visualization Styles Editor” opens.

“Create and edit derived style”

The “Visualization Styles Editor” opens with the dialog “Create a new visualization style”. The dialog contains the settings for the first configuration step.

Requirement: a style is selected in “Selected style”.

“Copy and edit the selected style”

The “Visualization Style Editor” opens with the dialog “Open existing style as a copy”. The dialog contains the settings for the first configuration step.

Requirement: a style is selected in “Selected style”.

“Preview”

The elements displayed represent the style specified in “Selected style”.

“Selected language”

Language used by the display variants at the start of a visualization.

“Numpad”

Dialog that calls the visualization if a user activates the input field for a number at runtime. The dialog represents a numeric keypad. Default: “VisuDialogs.Numpad”

“Keypad”

Dialog that calls the visualization if a user activates the input field for a text at runtime. The dialog represents a keyboard. Preset: “VisuDialogs.Keypad”

“Use text input with limits”

Requirement: CODESYS TargetVisu or CODESYS WebVisu are configured as display variants and the “standard text input” is “keyboard”. The visualization then supports input via keyboard at runtime. The input thus generally takes place via an input field.

: Instead of the input field you can call a dialog that displays the value range for inputs with a limited value range.

Default:“VisuDialogs.TextinputWithLimits”. This dialog displays the value range and doesn't accept any value outside these limits.

You can configure your visualization with a user management. To do this, configure an input to an element that causes a user management dialog to appear. The ‎VisuUserManagement‎ library contains ready-to-use dialog visualizations for this purpose. The library is located in the installation directory, for example in ‎C:\Program Files (x86)\3S CODESYS\CODESYS\Projects\Visu\Dialogs\VisuUserMgmtDialogs.library‎.

You can also use other visualizations as user management dialogs. To do that you have to change the defaults here.

“Login dialog”

User management dialog that enables logging in; typically a request to enter a username and a password. It appears upon an input event on an element that executes as a consequential action “User management”, action “Login”.

Preset: ‎VisuUserManagement.VUM_Login‎

“Change password dialog”

User management dialog that enables a password to be changed; typically a request to enter the current password and a new one. It appears upon an input event on an element that executes as a consequential action “User management”, action “Change user password”.

Preset: ‎VisuUserManagement.ChangePassword‎

“Change configuration dialog”

User management dialog that enables a configuration change of the user management, i.e. typically a display of the current user configuration and a possibility to change it. It appears upon an input event on an element that executes as a consequential action “User management”, action “Open user configuration”.

Preset: ‎VisuUserManagement.VUM_UserManagement‎

“Activate multitouch handling”

: At runtime the visualization expects user inputs via gestures and touch events.

“Activate semi-transparent drawing”

: The visualization draws the elements in a semi-transparent color.

To do this you can additionally specify a graduation value for the transparency when defining a color. The transparency is defined in the “Transparency” property.

The leading byte is evaluated in color variables.

Preset: Activated. Requirement: you create a new visualization and the display variants can paint semi-transparently.

“Activate standard keyboard handling”

“Size of memory for visualization”

Memory size in bytes allocated by the visualization at runtime. Preset: “400000”

“Size of the paintbuffer (per client)”

Memory size in bytes allocated by the visualization per display variant and used for painting actions. Preset: “50000”

“Transfer visualization files to the PLC”

: When downloading the application from the visualization directories to the controller, CODESYS copies image files and text list files that the visualization references. A CODESYS TargetVisu needs the files on the PLC and similarly the dialogs that support a numerical input or a keyboard input.

Use local visualization files

: The visualization uses image files and text list files from local directories

Note: In order to achieve that the visualization can access the files stored locally, it is necessary thatthat the file paths are relative. The paths are given in dialog box “Project  Project settings” in tab “Visualization”.

Note: It is also necessary that the link type of a image is “Link to file”. The link type is specified in the image pool.

“Maximum number of visualization clients”

Limits the number of visualization clients that are executed at the same time.

If you configure the elements so that they vary depending on the display variant, then you have to limit the number of display variants. A visualization is given an ID at runtime that identifies the display variant and then processes data accordingly. CODESYS can the query the ID using the system variable ‎CURRENTCLIENTID‎ and thus obtains the information as to which of the running variants is concerned.

Example: ‎arr[CURRENTCLIENTID].dwColor‎

Requirement: ‎VisuGlobalClientManager‎ library is integrated in the project.

Tip: You can find in the CODESYS store. example "Global Client Manager"

“Transfer both svg images and converted images”

This option is visible only if both a WebVisu and a TargetVisu exist. It concerns images in svg format only.

The option is available if the device description for the controller of the TargetVisu does not support the svg (full) format.

: The images are transmitted in the png or bmp formats (for TargetVisu) and additionally in svg format (for WebVisu).