===== Indicator =====

com.ergotech.vib.graphics.Indicator

==== Image Examples ====

| {{:mistudio:graphics:more_layout:status_motion:pasted:20260701-090814.png?40|Indicator in the graphics palette}} | {{:mistudio:graphics:more_layout:status_motion:pasted:20260701-090849.png?40|Indicator graphic example}} |
| //Indicator in the graphics palette.// | //Indicator graphic example.// |

==== Overview ====

The Indicator graphic is a More Layout status display graphic used to show a value in a two-part display.

The lower part of the Indicator displays the input value. Numeric input is displayed as an integer, and non-numeric input is displayed as text.

The upper part of the Indicator displays two lines of static text.

Indicator is useful when an application needs to show a value with a labeled status area above it.

==== Common Uses ====

  * Displaying a status value
  * Showing numeric values as integers
  * Showing text values
  * Adding a labeled status display to an application screen
  * Displaying two static label lines above a changing value
  * Creating process or equipment status displays

==== Input Behavior ====

Indicator accepts input through **valueInput**.

The input can come from a data source, Constant, or another logic component.

Numeric input is converted to an integer for display in the lower section.

Text input is displayed as text in the lower section.

==== Output Behavior ====

Indicator has no default output ports.

Indicator is used as a display graphic.

==== Indicator-Specific Behavior ====

Indicator uses an upper text section and a lower value display section.

Indicator-specific settings include:

  * **Name** Sets the name of the Indicator graphic.
  * **Bottom Font** Controls the font used in the lower display section.
  * **Color** Sets the fill color of the lower display section.
  * **Font** Controls the font used for the upper text section.
  * **Text Color** Sets the text color used in the lower display section.
  * **Line 1 Text** Sets the first static text line in the upper section.
  * **Line 2 Text** Sets the second static text line in the upper section.
  * **Color Top** Sets the background color of the upper section.
  * **Color Top Text** Sets the text color used in the upper section.
  * **Use Color** Controls whether incoming server colors are used for the active display.
  * **Arc Height** Sets the corner arc height.
  * **Arc Width** Sets the corner arc width.
  * **Bad Qual. Indicator** Controls the indicator used when bad quality data is received.
  * **Bezel** Sets the bezel style.
  * **Bezel Color** Sets the outside bezel color.
  * **Bezel Inside Color** Sets the inside bezel color.
  * **Bezel Thickness** Sets the thickness of the bezel.
  * **Cursor** Sets the cursor shown when the pointer is over the Indicator.
  * **Rotation** Sets the Indicator rotation.
  * **Split Percent** Controls how much of the display is used for the upper two-line text section.
  * **Click Action** Defines a click action.
  * **Click Count** Sets the number of clicks used for the click action.
  * **Visible** Controls whether the Indicator is shown.
  * **Warning Qual. Indicator** Controls the indicator used when warning or transitional quality data is received.

==== Logic Ports ====

In the Logic Editor, Indicator includes this default port:

  * **valueInput**

The **valueInput** port updates the displayed value in the lower section of the Indicator.

==== Display Sections ====

The Indicator display is split into two sections.

The upper section displays **Line 1 Text** and **Line 2 Text**.

The lower section displays the incoming value from **valueInput**.

The **Split Percent** property controls how much of the graphic is used for the upper text section.

==== Notes ====

Use Indicator when a display needs two static label lines and one changing value area.

Use [[mistudio:design_editor:more_layout:buttons_inputs:indicatorbutton|IndicatorButton]] when the graphic also needs button-style user interaction.

Use [[mistudio:design_editor:basic_layout:indicators:annunciator|Annunciator]] for a simpler data-driven text or number display.

For general graphic behavior, see [[mistudio:design_editor:active_graphic|Active Graphic]].

==== Related Pages ====

  * [[mistudio:design_editor:start|MIStudio Design Editor]]
  * [[mistudio:design_editor:more_layout:start|More Layout]]
  * [[mistudio:design_editor:more_layout:status_motion:start|Status, Motion, and Process Graphics]]
  * [[mistudio:design_editor:more_layout:buttons_inputs:indicatorbutton|IndicatorButton]]
  * [[mistudio:design_editor:basic_layout:indicators:annunciator|Annunciator]]
  * [[mistudio:design_editor:active_graphic|Active Graphic]]