About BASIC INDICATOR

LABEL_GRADIENT can be used to enhance information presentation on SCADA screens with meaningful text and visual status indications rather than limiting it to numerical values. As an alternative to conventional text user controls, it provides richer typography and visual effects.


When a data source is connected, the data value is evaluated against predefined thresholds, and the corresponding LED Data State is activated. This allows the same control to display operating status, fault, ready, disabled, warning, or other project-specific states using different text and colors.

The Control's Key Strength

Single control → static text or connected data → threshold-based LED states → state-specific text and visual appearance.

PUMP 01
RUNNING
PRESSURE NORMAL


Operating Principle

LABEL_GRADIENT supports two basic modes of use. In the first mode, the control is configured to display a static text string directly. In the second mode, the control is connected to a data source and selects the appropriate appearance from the defined LED Data States according to the data value.

Static Text

The control can display a heading, description, equipment name, direction, or informational text without being linked to a process value.

Data-Driven Display

Different states can be selected according to the connected data value. Each state can have its own text and visual properties.

LED Data States

The LEDDataStates collection can be used to define different states based on threshold values.

Dynamic Visual Response

By changing the background, text color, and blinking behavior according to the current state, the control can provide more prominent visual feedback to the operator.

Important Considerations for State Design

When defining LED Data States, it is important to ensure that threshold values do not overlap and that every process state is clearly covered. For critical alarms and operating conditions, use meaningful status text rather than relying on color alone.

Potential Applications in SCADA

BASIC INDICATOR can be used in many SCADA screen designs because the same text control can display different visual states.

Equipment Status

Display the status of a motor, pump, fan, valve, or other equipment as text, such as RUNNING / STOPPED / READY / FAULT.

Operating Warnings

Highlight conditions that require the operator's attention using different text and visual properties.

Process Status

Instead of displaying a process value directly as a number, describe the range in which the value falls using meaningful text.

Information Label

Display a static description, equipment name, section name, or operator instruction without a data connection.

Status Confirmation

Indicate with a short message that an operating condition has been met or that the expected operating state has been reached.

Fault / Error

Create visual emphasis during a fault by using different text, colors, and blinking behavior.

Text Effects

The LabelType property determines the basic visual presentation of the text. This allows the same text content to be displayed according to different screen design styles.

SIMPLESimplePlain text appearance
GRADIENTGradientText with color transitions
SHADOWShadowText with a shadow effect

This structure can be used to distinguish different levels of information on the same screen. Selecting an effect does not change the process information itself; it only configures the visual presentation of the text.

LED Data States

LED_STATE_COLLECTION is one of the core structures that enables the control to produce different appearances according to the connected data value. Threshold and display information can be defined separately for each state.

Property English Description Explanation
LevelThreshold Level Threshold The threshold value that determines when the data value enters the corresponding state.
LevelText Level Text The text displayed for the corresponding data state.
LevelBackColor Level Background Color The background color used for the corresponding state.
LevelForeColor Level Foreground Color The text color used for the corresponding state.
BlinkActive Blinking Enabled Determines whether blinking behavior is enabled for the corresponding state.

State Transitions

For example, the same control can display different text for different ranges of a data value, such as READY, RUNNING, WARNING, or FAULT. The conditions under which these messages are displayed are configured through LED Data States.

General Properties

Property English Description Default Explanation
UCType Control Type LABEL_GRADIENT Specifies the type of the user control.
UpdateInterval Update Interval 1000 ms Defines the update interval of the control.
DecimalPoint Decimal Places 0 Specifies the decimal display setting when numerical data is used.
UCBackColor Control Background Color Transparent Defines the overall background color of the control.
UCForeColor Control Foreground Color Black Defines the overall text color of the control.
UCFont Control Font Arial Narrow 8.25 Bold Defines the overall font used by the control.
BlinkInterval Blink Interval 500 ms Defines the time interval used when blinking is enabled.
AutoSize Auto Size false Determines whether the control size is adjusted automatically to fit the text.

Indicator and Text Settings

Property English Description Default Explanation
LabelType Label Type Shadow Determines whether the text uses the Simple, Gradient, or Shadow appearance.
TextAlign Text Alignment Middlecenter Determines the position of the text within the control area.
LabelText Label Text TEXT Defines the primary text displayed by the control.
BorderStyle Border Style None Defines the border style around the control.
BorderStyle3D 3D Border Style Flat Defines the appearance of the 3D border.

Gradient Settings

When gradient properties are enabled, a directional color transition between two colors can be created in the text area. This can be used to emphasize headings and status messages visually.

Property English Description Default Explanation
DrawGradient Draw Gradient false Determines whether the gradient appearance is drawn.
GradientAngle Gradient Angle 0 Defines the angle of the gradient direction.
GradientMode Gradient Mode Forwarddiagonal Defines whether the color transition is horizontal, vertical, or diagonal.
GradientColor1 Gradient Color 1 Black Specifies the first gradient color.
GradientColor2 Gradient Color 2 White Specifies the second gradient color.

Shadow Settings

Property English Description Default Explanation
DrawShadow Draw Shadow false Determines whether a shadow effect is drawn for the text.
ShadowColor Shadow Color Black Defines the color of the shadow effect.
ShadowXOffset Shadow X Offset 1 Defines the horizontal offset of the shadow.
ShadowYOffset Shadow Y Offset 1 Defines the vertical offset of the shadow.

Enumeration Values

LGGostergeTuru — Label Type

Value Description
Simple Simple
Gradient Gradient
Shadow Shadow

GNKenarSekli — 3D Border Style

Value Description
Raisedouter Raised Outer
Raisedinner Raised Inner
Raised Raised
Sunkenouter Sunken Outer
Sunkeninner Sunken Inner
Sunken Sunken
Etched Etched
Bump Bump
Adjust Adjust
Flat Flat

GNRenkFarkiTuru — Gradient Mode

Value Description
Horizontal Horizontal
Vertical Vertical
Forwarddiagonal Forward Diagonal
Backwarddiagonal Backward Diagonal

GNKonum — Text Position

Value Description
Topleft Top Left
Topcenter Top Center
Topright Top Right
Middleleft Middle Left
Middlecenter Middle Center
Middleright Middle Right
Bottomleft Bottom Left
Bottomcenter Bottom Center
Bottomright Bottom Right

Recommended Approach to SCADA Screen Design

Keep Text Short

Status messages should be clear and concise enough for operators to read at a glance.

Use Colors Meaningfully

Use color changes to reinforce status information rather than for decoration alone.

Limit Blinking

Blinking should be reserved for conditions requiring particular attention, while unnecessary visual movement on the screen should be minimized.

Standardize States

Using consistent text and visual conventions for similar states throughout a project makes interpretation easier for operators.

Accessibility and Readability

Explicitly identifying states with text, rather than relying only on color differences, is safer. For example, displaying the text FAULT alongside a red background makes the status clearer than using a red background alone.

Example State Design

The following example illustrates how a single control can display different text according to the data value. The value ranges are provided for illustration only; actual thresholds should be determined according to process requirements.

Example State Displayed Text Visual Approach Blinking
Standby READY Simple, unobtrusive appearance Off
Operating RUNNING Distinctive status color Off
Warning WARNING High-contrast appearance Project-dependent
Fault FAULT Distinctive color and text Enable if required

Conclusion

BASIC INDICATOR (LABEL_GRADIENT) is a user control that makes text-based information presentation more flexible on SCADA screens. It offers an alternative to conventional text indicators through effects such as Simple, Gradient, and Shadow, while LED Data States allow different conditions of a connected data value to be represented using different text and visual properties.

Another important advantage of this control is that a data connection is not mandatory. Therefore, the same user control can serve as both a dynamic process status indicator and a static informational text display.

Key Idea

LABEL_GRADIENT = Text display + visual effects + data states + state-specific text.