Histogram
This element can be used to add a histogram to a visualization page for displaying the values of an array. The minimum and maximum display values can be specified here. For certain value ranges special colors can be defined. An example of the configuration can be found in the section "Configuration of a histogram".
Properties editor
The properties of a visualization element - except alignment and order - can all be configured in the properties editor. By default, this editor opens next to the visualization editor, or it can be opened explicitly via the "Properties" command (which can be found in the View menu as standard).
A property can be modified by editing the field "Value". To this end, an input field, a selection list, a dialog or checkbox that can be activated is provided in this field, depending on the element type. The value field opens
- after a double-click,
- after a single click in a selected field,
- via the space bar, if the field was already selected.
If a variable is assigned,
- simply enter its name.
- Use the
button to open the input assistant for selecting a variable. The Variables category lists all variables that have already been defined in the project.
Working in the list of properties can be made easier with the aid of default, sorting and filter functions.
Element properties
All element properties and their descriptions are listed below.
Element name | The element name can be changed. Standard name is "GenElemInst_x". "x" stands for a sequential number. |
Element type | The element type is entered here. For three element groups it is possible to switch between the corresponding elements by changing the element type: |
Auxiliary setting
Data array | Variable of type array, whose data is to be visualized. |
Subrange of array
Use subrange | If this option is enabled, only the subrange of the assigned data array is used |
Start index | Indexes the first data set of the assigned data array. |
End index | Indexes the last data set of the assigned data array. |
Display type | Here you can select the display type of the data in the histogram:
|
Line width | Thickness of the curve representing the data in the histogram. This setting is only available if the display type "Curve" was selected. |
Show horizontal lines | If this option is enabled, horizontal lines are drawn at the main scales. |
Relative bar width | Relative width of the bar or the line in pixels |
Position
Here you can define the position (X/Y coordinates) and size (width and height) of the element in pixels. The origin is in the top left corner of the window. The positive x-axis is on the right, the positive y-axis runs downwards. If the values edited, the displayed element is simultaneously modified in the visualization editor.
X | Horizontal position in pixels – X=0 is the left edge of the window. |
Y | Vertical position in pixels – Y=0 is the upper edge of the window. |
Width | Width of the element in pixels |
Height | Height of the element in pixels |
Scale
|
Scale start |
Lower scale limit value |
|
Scale end |
Upper scale limit value |
|
Main scale |
Distance between two lines of the coarse scale |
|
Sub scale |
Distance between two lines on the fine scale. The value can be set to 0 if a further subdivision of the coarse scale is not desired. |
|
Scale color |
The color can be set via the selection list or via the |
|
Base line |
Numeric value by which the base line of the histogram is to be moved upwards. |
Labelling
|
Unit |
The entered text is used as element label. It is shown below the center of the scale and can be used to specify the unit of the scale, for example. |
|
Font |
Here you can set the font for the unit and the scale:
Click the |
|
Scale format (C-syntax) |
Use the C syntax to specify the formatting of the scale label. For example, entering the string "%3.2f s" in this field results in scale labels with 3 digits, 2 of which are decimal places, followed by the letter "s". |
|
Max. text width of labels |
Value specifying the maximum width of the scale label. This value is generally set correctly automatically. Only use this setting option if the automatic adjustment does not lead to the required result. |
|
Text height of labels |
Value specifying the height of the scale label. This value is generally set correctly automatically. Only use this setting option if the automatic adjustment does not lead to the required result. |
|
Font color |
The color for the label can be set via the selection list or via the |
button from the standard color selection dialog.Colors
A color is defined based on a hexadecimal number consisting of red / green / blue (RGB) components. For each of these three colors, 256 (0-255) values are available, which can be entered here statically. The color can be selected from a selection list or via the color selection dialog, which can be opened via the button . In addition, the level of transparency can be set for each color (0: fully transparent, 255: fully opaque).
|
Graph color |
Color for the graph |
|
Alarm color
|
Here you can specify the threshold value for the alarm.
The alarm is set if the current value of the array element meets the alarm condition. If "Less" is set, the alarm is triggered if the value is lower than the threshold value. If "More" is set, the alarm is triggered, if the value is greater than the threshold value.
Here you can select a color for displaying the individual bar in the event of an alarm. |
|
Use color areas |
If this option is enabled, the color areas are displayed as defined under color areas. |
|
Color areas
|
Click on the [<n>]: The number indexes the area. Clicking "Delete" deletes the corresponding color area and its settings. |
button to generate a new color area. For each color area an area is created that covers the corresponding settings.Area [<n>]
|
Begin of area |
Start of the color range. It must lie within the defined scale. |
|
End of area |
End of the color range. It must lie within the defined scale. |
|
Color |
Color of the bar area |
 | Transparency is not supported under Windows CE. |
Access rights
This setting relates to the access rights for the individual element. Click to open the Access rights dialog. The setting is only available if a user management was added to the PLC project. The following status messages are available:
Not set. All rights. | The default message is set, if the element is shown as available for all groups. |
Rights are issued: Limited rights. | The message is set, if the element is shown with limited behavior for at least one group. |