Linear Gauge Controls allow the visualization of data ranges in a linear format. The customization includes setting gauge orientation, position, linked data, range start and end, scale direction, interval, size, stroke, labels visibility, size, stroke, ticks size, thickness, stroke, pointer type, thickness, stroke, and range segments.
On this page:
Requirements
This component is Portable. It runs both on Windows and on Web Pages hosted in any platform.
Configuration
- Go to Displays / Draw.
- On the Components Panel, select Gauges, then LinearGauge.
- Click or drag-and-drop it on the Drawing area to use it.
- Double-click the object to open the configuration window.
Linear Gauge configurations encompass settings for General, Scale, Labels, Ticks, Pointer, and Range. General settings include gauge orientation, positions, linked value, range start, and end values. Scale settings involve scale direction, interval, bar size, stroke, border color, and thickness. Label settings cover visibility, size, stroke, prefix, and postfix options. Tick settings define major and minor tick sizes, thickness, stroke, and the number of minor ticks per interval. Pointer settings determine the type, stroke, thickness, height, and width of the pointer. Range settings specify segments, start and end values, color, and boundary width.
General
Linear Gauge General settings control the basic appearance and functionality of the gauge. These settings include orientation (horizontal or vertical), position relative to other elements (above or below),specific data value or source link (e.g., "Tag.Level"), and defining the starting and ending values of the gauge range (e.g., 0 to 100).
Linear Gauge General Settings | |
|---|---|
Field | Description |
Gauge Orientation | Sets the orientation of the gauge. Options include "Horizontal" and "Vertical," allowing the gauge to be displayed either horizontally or vertically. |
Gauge Positions | Sets the position of the gauge relative to other elements. Options include "Above" and "Below," determining whether the gauge appears above or below other components. |
Linked Value | Links a specific data value or source to the gauge. E.g.: "Tag.Level," indicates the gauge will display real-time data from this source. |
Range Start | Defines the minimum value the gauge can represent. Default is 0. |
Range End | Specifies the maximum value the gauge can represent. Default is 100. |
Scale
Linear Gauge Scale settings also manage the scale's direction, interval, size, stroke, border color, and thickness. Users can set the scale direction to forward or backward, define intervals between scale markings, adjust the scale bar size and stroke width, and customize the border's color and thickness to enhance visual clarity.
Linear Gauge Scale Settings | |
|---|---|
Field | Description |
Scale Direction | Sets the direction of the scale. Options include "Forward," indicating a normal ascending scale, and potentially "Backward," which would indicate a descending scale. |
Scale Interval | Defines the interval between scale markings, that is, the spacing of the major divisions on the scale. Default is 100. |
Scale Bar Size | Specifies the size of the scale bar, determining the thickness or height of the scale bar. Default is 15. |
Scale Bar Stroke | Adjusts the stroke (outline) width of the scale bar. This option influences the visual clarity and emphasis of the scale bar. |
Scale Bar BorderBrush | Defines the color of the scale bar border. The default setting is a shade of gray, which determines the visual appearance of the scale bar's border. |
Scale Bar Border Thickness | Specifies the thickness of the scale bar border. By default, it is set to "1,1,1,1", which indicates uniform thickness on all sides and affects the visual weight and prominence of the scale bar's border. |
Labels
Linear Gauge Labels Settings handle the visibility, size, stroke, prefix, and postfix of labels. Users can choose to show or hide labels, define their size, adjust the stroke color for emphasis, and add prefixes or postfixes to label values, allowing for clear and customized data representation.
Linear Gauge Labels Settings | |
|---|---|
Field | Description |
Labels Visibility | Sets the visibility of the labels. Options include "Visible" to show the labels, or "Hidden" to hide them. |
Label Size | Defines the font size of the text labels on the gauge. Default is 15. |
Label Stroke | Adjusts the stroke (outline) color of the labels. The default setting is a shade of gray, which affects the visibility and emphasis of the label text. |
Label Postfix | Adds a postfix to the label text. This field is blank by default, allowing the user to add a suffix to each label value if needed. |
Label Prefix | Adds a prefix to the label text. This field is blank by default, allowing the user to add a prefix to each label value if needed. |
Ticks
Linear Gauge Ticks settings specify the dimensions and appearance of major and minor tick marks. These settings include the size, thickness, and stroke color of both major and minor ticks, and the number of minor ticks per interval, enabling precise and detailed scale gradations for better data readability.
Linear Gauge Ticks Settings | |
|---|---|
Field | Description |
Major Tick Size | Defines the size of the major ticks, that is, it determines the length of the major tick marks on the gauge. Default is 15. |
Major Tick Thickness | Specifies the thickness of the major ticks, that is, it determines the width of the major tick marks. Default is 2. |
Major Tick Stroke | Adjusts the stroke (outline) color of the major ticks. The default setting is a shade of gray, affecting the visibility and emphasis of the major tick marks. |
Minor Tick Size | Defines the size of the minor ticks, that is, it determines the length of the minor tick marks on the gauge. Default is 7. |
Minor Tick Thickness | Specifies the thickness of the minor ticks. In other words, it determines the width of the minor tick marks. Default is 1. |
Minor Tick Stroke | Adjusts the stroke (outline) color of the minor ticks. The default setting is a shade of gray, affecting the visibility and emphasis of the minor tick marks. |
Minor Ticks Per Interval | Defines the number of minor ticks per interval. It specifies how many minor tick marks will appear between each pair of major tick marks, allowing for finer granularity. Default is 5. |
Pointer
Linear Gauge Pointer Settings determine the type and appearance of the gauge pointer. Users can choose between a bar pointer or symbol pointer, and adjust the stroke color and thickness for the bar pointer, or define the height, width, and stroke color for the symbol pointer, ensuring the pointer is clearly visible and fits the gauge design.
Linear Gauge Pointer Settings | |
|---|---|
Field | Description |
Pointer Type | Sets the type of pointer used in the gauge. Options include "Bar Pointer" and "Symbol Pointer." The current selection is "Bar Pointer," indicating a bar-shaped pointer. |
Bar Pointer Stroke | Adjusts the stroke (outline) color of the bar pointer. This option is available only if "Bar Pointer" is selected as the pointer type. |
Bar Pointer Thickness | Specifies the thickness of the bar pointer. This option is available only if "Bar Pointer" is selected as the pointer type. |
Symbol Pointer Height | Defines the height of the symbol pointer. This option is unlocked and available if "Symbol Pointer" is selected as the pointer type. |
Symbol Pointer Width | Defines the width of the symbol pointer. This option is unlocked and available if "Symbol Pointer" is selected as the pointer type. |
Symbol Pointer Stroke | Adjusts the stroke (outline) color of the symbol pointer. This option is unlocked and available if "Symbol Pointer" is selected as the pointer type. |
Range
Linear Gauge Range Settings configure specific segments of the gauge. Users can enable or disable each range segment, set the starting and ending values for each segment, assign different colors to segments, and define the start and end width of each segment's boundaries, allowing for distinct and visually segmented data representation.
Linear Gauge Range Settings | |
|---|---|
Field | Description |
Range | Indicates the specific range segment. The user 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 the user 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. |
Runtime Execution
The LinearGauge Control provides a visual representation of data ranges in a linear manner. Users can customize the gauge by setting its orientation, position, and the data it is linked to. The control allows for detailed adjustments including the start and end of the range, scale direction, interval, and size. Additionally, users can modify the appearance of labels, ticks, pointers, and range segments in terms of size, thickness, and stroke. This level of customization ensures that the LinearGauge Control can be tailored to fit the specific needs of any application that requires linear data display.
In this section: