About the CIRCULAR GAUGE

The CIRCULAR GAUGE visually presents the position of a numerical value within a defined minimum and maximum range using a dial and needle, rather than displaying the value as digits alone. This approach helps the operator quickly recognize the value's position within the normal operating range.


An examination of the control's source structure in EOS SCADA shows that the gauge consists of more than just a needle. The Base Arc, Needle, Scale Lines, Scale Numbers, Region Collection, and Label Collection are treated as independently configurable components.

Core concept: The CIRCULAR GAUGE makes an analog process variable readable at a glance by combining a value, scale, needle, and colored visual regions. It is therefore a useful visual tool, especially on SCADA/HMI screens where operators need to assess process conditions quickly.

Basic Control Architecture

Base Arc

Defines the main geometry of the gauge dial. It is configured using color, start angle, sweep angle, radius, and width.

Needle

The moving element that displays the current value on the dial. Its appearance is configured using color, type, width, and radius.

Scale

Intermediate, minor, and major scale lines, together with scale numbers, make it possible to read the value represented on the dial.

Regions

The CIRCULAR_REGION_COLLECTION structure can be used to highlight specific value ranges with different colors.

Labels

Text such as the process name, physical quantity, unit, or description can be displayed using LABEL_COLLECTION.

Background

A background image can provide the visual foundation for a custom gauge design.

General Properties

The following table lists the general properties and default values directly defined in the supplied source code. The English descriptions are based on the corresponding EOS SCADA terminology.

Property English Equivalent Default Description
UCType Control Type DAIRESEL_GOSTERGE Defines the EOS SCADA user control type.
UpdateInterval Update Interval 1000 ms Specifies the interval at which the control's data/display is updated.
DecimalPoint Decimal Places 0 Specifies the number of decimal places used to display numerical values.
UCBackColor Control Background Color Transparent Defines the control's background color.
UCForeColor Control Foreground Color White Defines the control's general foreground/text color.
UCFont Control Font Microsoft Sans Serif, 8.25 pt, Bold Defines the control's default font.
BorderStyle Border Style None Defines how the control's border is displayed.

Border Style

The GNCerceveTuru options defined in the source code are:

  • None — No border
  • Fixedsingle — Single fixed border
  • Fixed3d — Fixed 3D border

Base Arc and Dial Geometry

The Base Arc defines the main dial geometry on which the scale and needle operate. Different dial shapes can be created by adjusting the start angle, sweep angle, radius, and width together.

Property English Equivalent Default Usage
BaseArcColor Base Arc Color Gray Defines the color of the dial's base arc.
BaseArcStart Base Arc Start Angle 270° Defines the starting angle of the base arc.
BaseArcSweep Base Arc Sweep 90° Defines the angular sweep of the base arc.
BaseArcRadius Base Arc Radius 80 Defines the radius of the base arc.
BaseArcWidth Base Arc Width 2 Defines the thickness of the base arc line.
Center Center Point(15, 100) Defines the center position of the gauge geometry.

Geometric flexibility: The base arc's start and sweep values play a key role in determining which portion of the gauge geometry is used. This allows the same user control to be adapted to different screen layouts, such as full-circle, semicircular, or quarter-circle gauges.

Needle Settings

The needle is the visual representation of the analog value on the dial. In the supplied source code, two needle colors, the needle type, width, and radius can be configured.

Property English Equivalent Default Description
MinValue Minimum Value 0 Defines the lower limit of the gauge scale.
MaxValue Maximum Value 100 Defines the upper limit of the gauge scale.
NeedleColor1 Needle Color 1 Gray The first needle color, selected using the DGRenkTuru enum.
NeedleColor2 Needle Color 2 DimGray Defines the needle's second color component.
NeedleType Needle Type Advance Defines the needle shape using the DGIgneTuru enum.
NeedleWidth Needle Width 2 Defines the needle's thickness.
NeedleRadius Needle Radius 80 Defines how far the needle extends from the center.

Example image: In the supplied image, the needle points to a value near the lower part of the scale. The major numbers on the dial appear in the 45–55 range, while the more closely spaced minor ticks help indicate intermediate values.

Scale Lines and Scale Numbers

The scale is fundamental to the readability of a circular gauge. The control provides three levels of scale lines with different densities: intermediate, minor, and major. In addition, the radius, starting position, interval, and rotation angle of the scale numbers can be configured.

Scale Lines

Property English Equivalent Default Usage
ScaleLinesInterColor Intermediate Scale Line Color Black Defines the color of intermediate scale lines.
ScaleLinesInterWidth Intermediate Scale Line Width 1 Defines the width of intermediate scale lines.
ScaleLinesInterInnerRadius Intermediate Scale Line Inner Radius 73 Defines the inner radius of intermediate scale lines.
ScaleLinesInterOuterRadius Intermediate Scale Line Outer Radius 80 Defines the outer radius of intermediate scale lines.
ScaleLinesMinorColor Minor Scale Line Color Gray Defines the color of minor scale lines.
ScaleLinesMinorTicks Minor Scale Ticks 9 Defines the number of minor ticks between major intervals.
ScaleLinesMinorWidth Minor Scale Line Width 1 Defines the width of minor scale lines.
ScaleLinesMinorInnerRadius Minor Scale Line Inner Radius 75 Defines the inner radius of minor scale lines.
ScaleLinesMinorOuterRadius Minor Scale Line Outer Radius 80 Defines the outer radius of minor scale lines.
ScaleLinesMajorColor Major Scale Line Color Black Defines the color of major scale lines.
ScaleLinesMajorStepValue Major Scale Line Step Value 25 Defines the value interval between major scale lines.
ScaleLinesMajorWidth Major Scale Line Width 2 Defines the width of major scale lines.
ScaleLinesMajorInnerRadius Major Scale Line Inner Radius 70 Defines the inner radius of major scale lines.
ScaleLinesMajorOuterRadius Major Scale Line Outer Radius 80 Defines the outer radius of major scale lines.

Scale Numbers

Property English Equivalent Default Usage
ScaleNumbersColor Scale Number Color Black Defines the color of the scale numbers.
ScaleNumbersRadius Scale Number Radius 95 Defines the distance of the numbers from the center.
ScaleNumbersStartScaleLine Scale Number Starting Scale Line 1 Defines the scale line at which numbering begins.
ScaleNumbersStepScaleLines Scale Number Scale Line Step 1 Defines the scale-line interval between numbers.
ScaleNumbersRotation Scale Number Rotation 0° Defines the rotation angle of the scale numbers.

Circular Regions

RegionCollection is a collection used to highlight specific value ranges on a circular scale with colors. It provides a foundation for visually distinguishing normal, warning, critical, or other operating regions.

Property English Equivalent Default Description
RegionCollection Region Collection CIRCULAR_REGION_COLLECTION[] A collection of circular region definitions.
RegionColor Region Color LimeGreen Defines the visual color of a region.
RegionMin Region Minimum 0 Defines the starting value of a region.
RegionMax Region Maximum 20 Defines the ending value of a region.
InnerWidth Inner Width 75 Defines the inner boundary/radius of the colored region.
OuterWidth Outer Width 80 Defines the outer boundary/radius of the colored region.

For example, on a pressure gauge, one range can be marked as the normal operating region and a higher range as a warning region using different colors. This example illustrates only the visual design approach; the supplied source code does not define a specific operating-region standard.

Label Collection

LabelCollection is used to place fixed descriptions or process information on the gauge. Multiple labels can be defined to display a title, unit, or explanatory text on a single gauge.

Property English Equivalent Default Usage
LabelCollection Label Collection LABEL_COLLECTION[] A collection of labels to be displayed on the gauge.
LabelColor Label Color Black Defines the color of the label text.
LabelPosition Label Position Point(0, 0) Defines the label's position within the control.
LabelText Label Text "" Defines the fixed text to be displayed.
LabelFont Label Font Arial Narrow, 10 pt, Regular Defines the font and size of the label text.

Applications on SCADA Screens

Circular gauges are used particularly on HMI/SCADA screens where it is important to quickly recognize the position of an analog value within a minimum–maximum range. Siemens WinCC documentation describes the Gauge object as a way to present numerical values in an analog instrument format. One example is determining at a glance whether boiler pressure is within the normal range.

Rockwell Automation documentation describes a gauge object as a traditional measuring instrument or dial containing a needle and a value range. It also explains that thresholds can be used to highlight different value ranges with colors, and that the gauge represents the process value through the needle's position at runtime.

Pressure

Monitoring pressure values for boilers, pumps, compressors, process lines, and similar equipment on an analog dial.

Temperature

Quickly assessing temperatures in boilers, furnaces, turbine auxiliary systems, motors, and process equipment.

Flow Rate

Displaying the flow rate of water, steam, gas, or other process fluids together with a defined range.

Level

Displaying analog level values for tanks, reservoirs, and similar equipment in dial format.

Power and Load

Presenting active power, load percentage, or similar analog electrical quantities together with their minimum–maximum ranges.

Speed / RPM

Monitoring rotational speed or RPM in motors, pumps, fans, and rotating machinery using an analog gauge.

Designs from Full Circle to Quarter Circle

One of the main strengths of the CIRCULAR GAUGE is that the same control architecture can be adapted to different screen geometries. The following design approaches can be implemented by adjusting the base arc and scale geometry:

Design Visual Approach Typical Application
Full Circle 360° circular display Motor speed, pressure, temperature, power, and general analog measurements.
Semicircle Upper or lower half-dial Compact groups of analog gauges on wide SCADA screens.
Quarter Circle Compact dial spanning approximately 90° Corner gauges and analog measurements in limited spaces on mimic screens.
Custom-Angle Dial A specified start angle and sweep angle Custom process mimics and equipment graphics.

This approach is consistent with the general gauge design principles used in industrial HMI software. Rockwell FactoryTalk Optix documentation defines the Circular Gauge object as a way to display an analog variable between minimum and maximum values. It also supports warning regions to display specific value ranges in different colors.

IMPORTANT: Control Size

The size cannot be changed with the mouse

The size of the CIRCULAR GAUGE user control cannot be increased using the mouse. Therefore, the exact dimensions required for the target screen must be determined before the control is placed on the SCADA screen.

Because the control uses circular geometry, changes to its width and height may directly affect the geometric relationships between the scale, numbers, needle, and labels.

Needle Color Types — DGRenkTuru

The color selection for the NeedleColor1 property is handled through the DGRenkTuru enum in the source code. This enum defines seven color options:

Enum Value English Equivalent Usage
Blue Blue Selects blue for Needle Color 1.
Gray Gray Selects gray for Needle Color 1.
Green Green Selects green for Needle Color 1.
Magenta Magenta Selects magenta for Needle Color 1.
Red Red Selects red for Needle Color 1.
Violet Violet Selects violet for Needle Color 1.
Yellow Yellow Selects yellow for Needle Color 1.

Needle Types — DGIgneTuru

The NeedleType property provides two needle types through the DGIgneTuru enum in the source code:

Enum Value English Equivalent Description
Advance Advanced The advanced needle type selected by default in the source code.
Simple Simple The needle type defined for a simpler needle appearance.

Recommended Practice

  1. Determine the resolution of the SCADA screen on which the control will be used.
  2. Set the target width and height of the gauge during the design phase.
  3. Adjust the center, radius, scale lines, and number radii to match these dimensions.
  4. Check the needle length and width in proportion to the dial.
  5. Verify that labels and colored regions remain within the gauge boundaries.
  6. Test the Runtime appearance at the final size, then fix the control in the screen design.

Recommended Configuration Sequence

  1. General settings: Control Type, Update Interval, Decimal Places, color, and font.
  2. Value range: Minimum Value and Maximum Value.
  3. Dial geometry: Base Arc Start Angle, Base Arc Sweep, radius, width, and center.
  4. Needle: Needle Type, Needle Color 1/2, width, and radius.
  5. Scale: Intermediate, minor, and major scale lines, including their radii and widths.
  6. Numbering: Scale Number Color, radius, starting scale line, interval, and rotation.
  7. Colored regions: Region Color, Region Minimum/Maximum, and inner/outer width.
  8. Labels: Label Text, Label Position, Label Color, and Label Font.
  9. Final visual check: Size, readability, and Runtime appearance.

Conclusion

The CIRCULAR GAUGE is a powerful EOS SCADA user control that presents analog process values in the familiar format of a measuring instrument, allowing operators to interpret them quickly.

The control's main strength lies not only in the movement of its needle, but also in the independent configuration of elements such as dial geometry, scale lines, numbers, needle, colored regions, labels, and background. This allows a single user control to be reused for different process variables and SCADA screen designs.

For analog values such as pressure, temperature, flow rate, level, power, load, and rotational speed, a circular gauge provides an effective visual solution whenever operators need to see not only the numerical magnitude of a value but also its position within the scale.

EOS SCADA design principle: Determine the target screen dimensions before placing the CIRCULAR GAUGE on the screen. Then configure the dial, scale, needle, and label geometry to fit those fixed dimensions. Since the control cannot be resized with the mouse, its final Runtime appearance must be verified during the design phase.