Table of Contents
SevenSegment
com.ergotech.vib.graphics.SevenSegment
Image Examples
 |  |
| SevenSegment in the graphics palette. | SevenSegment graphic example. |
Overview
The SevenSegment graphic is a Basic Layout indicator used to display decimal numbers as seven-segment digits.
SevenSegment is useful when an application needs a digital-style numeric display.
The display uses lit and unlit segments. The lit segments show the current value, and the unlit segments can be shown with a separate color when the display is not transparent.
Common Uses
- Displaying numeric values
- Creating digital-style readouts
- Showing values with a fixed number of digits
- Showing values with decimal places
- Displaying process values in a compact numeric format
Input Behavior
SevenSegment accepts a numeric value object.
The input value is displayed using the configured number of digits and decimal places.
If the input value cannot fit within the configured display size, SevenSegment shows an overflow indicator using dash characters.
If the input value cannot be converted to a number, the overflow indicator is also shown.
Output Behavior
SevenSegment is primarily used as a display graphic.
It does not function as a user input control.
SevenSegment-Specific Behavior
SevenSegment displays numbers using lit and unlit segment colors.
SevenSegment-specific settings may include:
- Number of Digits Sets the total number of numeric digits in the display.
- Number of Decimal Digits Sets the number of digits used for the decimal portion of the number.
- Color for Lit Segments Sets the color used for segments that are turned on.
- Color for Unlit Segments Sets the color used for segments that are turned off.
- Segment Width Sets the thickness of the display segments.
- Margin Sets the space between the SevenSegment display and the outside border.
- Use Color Controls whether the color from the input data object is used for the lit segments.
- Bezel Sets the display bezel style.
Overflow Behavior
SevenSegment has a fixed display capacity based on Number of Digits and Number of Decimal Digits.
If the number is too large to display, an overflow indicator is shown.
Negative numbers require space for the minus sign. If a SevenSegment display needs to show both positive and negative values, allow enough digits for the minus sign.
Logic Ports
In the Logic Editor, SevenSegment may include:
- valueInput
The valueInput port is used to update the displayed SevenSegment value.
Notes
Use SevenSegment when a digital-style numeric display is needed.
For values that need a gauge-style display, see Radial or Meters.
For other indicator graphics, see Indicators.
For shared Active Graphic behavior, see Active Graphic.