2.16.2.1.13 Gauge element

The Gauge display element shows a numeric parameter value as a horizontal bar in an entry field like frame. The gauge element is capable to adjust the scale factor for the gauge automatically from the parameter's range definition. Alternatively the scale parameters may set explicitly.

The attributes listed below may be configured to customize a display element of this type:

• Message ID: The message ID addresses the parameter the element shall display or edit. The message ID consists of the MNC name, device name followed by a colon and the name of the parameter.ANT.11.XMIT-1.tx.on for example addresses the variable tx.on at a device named XMIT-1 at MNC.
• Label: The label text is drawn above the element.
• Font: Font contains two options:
  • Font: The font attribute applies to the text shown in the parameter field itself. The label text is shown with the standard ("plain") font size for all font selections except the smallest one. In the latter case the label is drawn using this small font size, too.
  • Color: The color attribute of a parameter element sets the color of the label shown above the entry field. The text in the parameter field itself always is shown in the default text color of the selected look & feel. Colors may be specified by using a hexadecimal RGB notation. You may click to the color example field in order to open a color chooser dialog and select the color from there.
• Specify range: Check this checkbox to define the range which is displayed by the gauge element.
  • min value: The minimum value of the displayed range.
  • max value: The maximum value of the displayed range.
• Specify thresholds: Check this checkbox to define the threshold values which are used for RGR and GYR color schemes.
  • min thresholds: The minimum value of the threshold range.
  • max thresholds: The maximum value of the threshold range.
• Graph color: The gauge element knows three color schemes, allowing to change the bar color dynamically with the monitored value. Please note, unless you specify min/max thresholds for the monitored value, only the fixed color mode is available.
  • Fixed: The bar is displayed with the color defined with in the above color filed.
  • R-G-R (red, green, red): The bar is displayed green while the value is between the minimum and maximum thresholds. If the value is outside the limits, the bar is displayed red.
  • R-Y-G (red, yellow, green): The bar is displayed red while the value is below the minimum threshold value. It changes to yellow if the value is between the minimum and maximum thresholds. If the value exceeds the maximum threshold, the bar color changes to green.
  • G-Y-R (green, yellow, red): The bar is displayed green while the value is below the minimum threshold value. It changes to yellow if the value is between the minimum and maximum thresholds. If the value exceeds the maximum threshold, the bar color changes to red.
• show ticks: check this to make the element show scale ticks vor the min/max and threshold values below the gauge.
• show ticks with labels: With this mark checked, below the gauge element labeled ticks are shown for the min/max and threshold values. (requires "show ticks"). Bar graph elements with this option enabled should be configured with a width that is sufficient to show the scale labels without overlap.