CircularGauge

CircularGauge (Circular Gauge)

The CircularGauge is a high-quality, customizable indicator object used to visualize numeric data on an analog dial (needle).
It presents values with defined “Minimum” and “Maximum” limits—such as speed, pressure, temperature, or flow rate—in an industrial format that operators can perceive at a glance.
The object’s built-in “Wizard” menu offers hundreds of ready-made design templates.
Info: This object shares the same technical infrastructure as the LinearGauge and NumericIndicator.

Quick Design: Gauge Wizard

The most practical way to configure this object is to use the Wizard located in the Advanced panel. Instead of configuring settings from scratch, you start with ready-made templates.

  1. Open Wizard: Select the object and go to the Advanced panel. Click the button next to the Wizard row under the top Custom category.
  2. Gallery: In the window that opens, navigate to the Gallery tab from the menu on the left.
  3. Select Type: Open the “Gauge Type Groups” box and select Circular.
  4. Select Template: The templates in the gallery will transform into horizontal or vertical bars. Select a style you like from the menu on the right, pick the specific gauge, and click Finish.
  5. Result: Your gauge will transform into the selected professional design (colors, frame, needle type, etc.) within seconds

Properties Panel – Key Properties

Once the design is handled via the Wizard, you use this panel to make the gauge “live” by establishing data connections.

Value

  • Default (Tag):
    • This is the main connection controlling the movement of the needle.
    • Bind a Tag here. As the tag’s value changes, the needle animates towards that value.

Events

  • Mouse Down / Mouse Up
    • Can be used to trigger an action (e.g., opening a detail page or resetting a counter) when the operator clicks on the gauge.

Advanced Panel – Key Properties

While the Wizard handles the general design, the Advanced panel is used to configure specific limits (Min/Max) and colored regions (Ranges).

Note: This object has a nested structure. Settings are grouped under the Gauge Container.

1. Scale and Limit Settings 

This is where you define whether the gauge displays 0-100 or 0-10 Bar.

  • Path: Gauge Container -> CircularGauges -> Click the (Collection) button.
  • Scales: Enter the Scales collection in the window that opens.
    • Minimum: The start value of the scale (e.g., 0).
    • Maximum: The end value of the scale (e.g., 100).
    • Interval: The step increment for the main tick marks (e.g., increments of 10).

2. Colored Regions (Ranges) 

To create a “Safe Zone” (Green) or “Danger Zone” (Red) on the gauge:

  • Path: Gauge Container -> CircularGauges -> Scales -> Ranges.
  • Setting: Add a new Range.
    • StartValue: 80
    • EndValue: 100
    • FillColor: Red
  • Result: The section of the gauge between 80 and 100 is painted with a red strip.

3. Needle and Header Settings

  • Pointers
    • Use the Pointers collection to change the needle’s color, thickness, or type.
  • Labels
    • Use the Labels collection to add unit text (like “BAR”, “RPM”, or “°C”) to the center of the gauge.

4. Visual Quality

  • AntiAliasing
    • Located under Appearance in the main screen of the Advanced panel. Setting this value to All ensures the gauge edges appear smooth and modern, rather than jagged.

Common Usage Example

Example: Boiler Pressure Gauge and Danger Zone

To display a steam boiler’s pressure between 0 and 10 Bar and have the needle enter a red “Danger Zone” when it exceeds 8 Bar.

  1. Add a CircularGauge to the screen.
  2. Open the Advanced -> Wizard menu and select a gauge style from the Circular Gauges group.
  3. Go to the Advanced panel and follow the path: Gauge Container -> CircularGauges -> Scales.
    • Set Minimum: 0
    • Set Maximum: 10
  4. Enter the Ranges section within the same collection and click Add to create a new zone.
    • StartValue: 8
    • EndValue: 10
    • FillColor: Red
    • Result: The slice between 8 and 10 on the gauge will be colored red.
  5. Select the object and return to the Properties panel.
  6. Bind the Boiler_Pressure_PT101 tag to the Value -> Default (Tag) property.

Result: In Runtime, when the pressure exceeds 8 Bar, the operator is visually warned as the needle enters the red zone.

Leave a Reply