Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The TRangeCircularGauge control implements a circular gauge to specify colors according to the range of the primary variable. It defines the title, adds center text, links to a specific data value, and sets range start and end values. It customizes the gauge arc's start and sweep angles and sets the pointer type. The control configures the legend display, shape, and position. Users can define range segments, their start and end values, color, width, and rounding radius, and assign legend labels, allowing real-time data visualization and differentiation of gauge segments.

On this page:

Table of Contents
maxLevel3
stylenone


Requirements

This component is Portable. It runs both on Windows and on Web Pages hosted in any platform.


Configuration

The TRangeCircularGauge control implements a circular gauge with settings to specify colors according the range of the main variable.

Range Circular Gauge Settings

Field

Description

Header

Defines the title of the gauge. For example example, the header can be set to "SPEED," indicating the type of data displayed.

Center Text

Allows the user to add text in the center of the gauge. This field is currently empty.

Linked Value

Links a specific data value or source to the gauge. In this example, it is set to "Tag.Speed," ensuring the gauge reflects real-time speed data.

Range Start

Defines the starting value of the gauge range. Set to 0, this establishes the minimum value the gauge can represent.

Range End

Specifies the ending value of the gauge range. Set to 100, this establishes the maximum value the gauge can represent.

Start Angle

Determines the starting angle of the gauge arc. Set to 135 degrees, this customization allows the gauge to start at a specified point on the circle.

Sweep Angle

Defines the extent of the gauge arc in degrees. Set to 270 degrees, this determines how much of the circle the gauge will cover.

Pointer TypeSets

Defines the type of pointer used in the gauge

. Options include "Range Pointer" and potentially others, with the current selection being "Range Pointer."

(e.g., RangePointer). Customizes the pointer style.

  • NeedlePointer: This pointer type represents the data value with a needle-like indicator. It is commonly used to provide a precise and clear indication of the current value on the gauge.

  • RangePointer: This pointer type highlights a range on the gauge. It is useful for visualizing a span of values rather than a single point, allowing users to see the current range of interest.

  • SymbolPointer: This pointer type uses a symbol to indicate the data value. It can be customized with different symbols to suit various applications and visual preferences.

Legend

Enables the legend display.

Legend Shape

Defines the legend shape from: Triangle, Circle, Diamond, Rectangle.

Position

Defines the legend position from: Auto, Bottom, Left, Right, Top.

  • Auto: Automatically positions the legend based on the available space and layout.

  • Bottom: Positions the legend at the bottom of the gauge.

  • Left: Positions the legend to the left of the gauge.

  • Right: Positions the legend to the right of the gauge.

  • Top: Positions the legend at the top of the gauge.

Range

Indicates the specific range segment. Users can enable or disable each range by marking the checkbox next to the range entry.

Range Start and End

Defines the starting and ending values for each range segment. This setting determines the minimum and maximum values for each color segment of the gauge.

Color

Specifies the color for each range segment. This setting allows users to visually differentiate between various segments of the gauge.

Start and End Width

Defines the width of the start and end points of each range segment. This setting determines the thickness of the segment boundaries on the gauge.

Rounded

Determines if the ends of each range segment are rounded. Users can specify the rounding radius.

Legend

Allows users to assign a legend label to each range segment. This setting helps in identifying the purpose of each color segment on the gauge.



Runtime Execution 

In Runtime, the control has embedded controls to allow the Operator to modify the view. Typically the configuration settings of <> is attached to a Tag exposed in the  Display User Interface, allowing the operator to select <.>.


In this section:

Page Tree
root@parent
spacesV10