Component: Numeric Label (Indicators): Difference between revisions

Latest revision as of 14:37, 13 July 2026

Author	Matrix TSL
Version	1.0
Category	Indicators

Numeric Label component

Allows a numeric label to be displayed on the user panel. Used for displaying the value of a variable during simulation runtime. Provides up to 5 customisable ranges to automatically alter the colour of the label based on the value.

Component Source Code

Please click here to download the component source project: FC_Comp_Source_NumericLabel.fcfx

Please click here to view the component source code (Beta): FC_Comp_Source_NumericLabel.fcfx

Detailed description

No detailed description exists yet for this component

Examples

No additional examples

Macro reference

DisplayAsInt

	DisplayAsInt
Displays an integer value on the label. Capable of displaying positive and negative values.
- LONG	Value
Integer value to display
- VOID	Return

DisplayAsReal

	DisplayAsReal
Displays a floating point value on the label with a confiiguarable number of decimal points
- FLOAT	Value
Real floating point value to display
- BYTE	Precision
Number of decimal point values to show e.g. 2 = 0.00
- VOID	Return

SetForegroundColour

	SetForegroundColour
Allows the user to manually specify the default colour of the foreground text.
- LONG	Colour
RGB colour in the hexadecimal form 0xBBGGRR, -1 for Transparent
- VOID	Return

SetUnits

	SetUnits
Allows the user to manually specify the units string that is appended to the end of the label.
- STRING	Units
RGB colour in the hexadecimal form 0xBBGGRR, -1 for Transparent
- VOID	Return

Property reference

	Properties
	Title
	Show Title
Decides if the title is shown on the panel.
	Title Text
Specifies the title displayed on the panel.
	Title Scale
Specifies the size of the title on the panel, default 1.2
	Title Colour
Specifies the colour of the title text
	Title Offset
Distance above component center to draw the title
	Label Properties
	Label Scale
Specifies the scale of the label text, default 1.0
	Show Units
Specifies if the unit text is appended to the end of the numeric value
	Unit Text
Optionally adds a unit label to the end of the displays string
	Colour Ranges
Allows ranges to be specified to automatically format the foreground and background colours based on the numeric value
	Defaults
	Numeric Colour
The label Text colour

@@ Line 48: / Line 48: @@
 ''<span style="color:red;">No additional examples</span>''
@@ Line 53: / Line 61: @@
 ==Macro reference==
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+===DisplayAsInt===
+{| class="mtx-class-macrotable wikitable"
+|-
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
+| width="90%" class="mtx-class-macrohead" | '''DisplayAsInt'''
+|-
+| colspan="2" | Displays an integer value on the label. Capable of displaying positive and negative values.&nbsp;
+|-
+|-
+| width="10%" align="center" | [[File:Fc9-s32-icon.png]] - LONG
+| width="90%" | Value
+|-
+| colspan="2" | Integer value to display&nbsp;
+|-
+| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
+| width="90%" style="border-top: 2px solid #000;" | ''Return''
+|}
+===DisplayAsReal===
+{| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''DisplayAsReal'''
+| width="90%" class="mtx-class-macrohead" | '''DisplayAsReal'''
 |-
 | colspan="2" | Displays a floating point value on the label with a confiiguarable number of decimal points&nbsp;
@@ Line 76: / Line 104: @@
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+===SetForegroundColour===
+{| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SetForegroundColour'''
+| width="90%" class="mtx-class-macrohead" | '''SetForegroundColour'''
 |-
 | colspan="2" | Allows the user to manually specify the default colour of the foreground text.&nbsp;
@@ Line 94: / Line 123: @@
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+===SetUnits===
-|-
+{| class="mtx-class-macrotable wikitable"
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''DisplayAsInt'''
-|-
-| colspan="2" | Displays an integer value on the label. Capable of displaying positive and negative values.&nbsp;
-|-
-|-
-| width="10%" align="center" | [[File:Fc9-s32-icon.png]] - LONG
-| width="90%" | Value
-|-
-| colspan="2" | Integer value to display&nbsp;
-|-
-| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-void-icon.png]] - VOID
-| width="90%" style="border-top: 2px solid #000;" | ''Return''
-|}
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" align="center" | [[File:Fc9-comp-macro.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SetUnits'''
+| width="90%" class="mtx-class-macrohead" | '''SetUnits'''
 |-
 | colspan="2" | Allows the user to manually specify the units string that is appended to the end of the label.&nbsp;
@@ Line 128: / Line 140: @@
 | width="90%" style="border-top: 2px solid #000;" | ''Return''
 |}
 ==Property reference==
-{| class="wikitable" style="width:60%; background-color:#FFFFFF;"
+{| class="mtx-class-macrotable wikitable"
 |-
-| width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-prop-icon.png]]
+| width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-prop-icon.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Properties'''
+| width="90%" class="mtx-class-macrohead" | '''Properties'''
 |-
 |-
-| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
+| width="10%" align="center" class="mtx-class-propfolder" | [[File:Fc9-conn-icon.png]]
-| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Title
+| width="90%" class="mtx-class-propfolder" | Title
 |-
 |-
@@ Line 169: / Line 179: @@
 | colspan="2" | Distance above component center to draw the title&nbsp;
 |-
-| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
+| width="10%" align="center" class="mtx-class-propfolder" | [[File:Fc9-conn-icon.png]]
-| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Label Properties
+| width="90%" class="mtx-class-propfolder" | Label Properties
 |-
 |-
@@ Line 193: / Line 203: @@
 | colspan="2" | Allows ranges to be specified to automatically format the foreground and background colours based on the numeric value&nbsp;
 |-
-| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
+| width="10%" align="center" class="mtx-class-propfolder" | [[File:Fc9-conn-icon.png]]
-| width="90%" style="background-color:#EAE1EA; color:#4B008D;" | Defaults
+| width="90%" class="mtx-class-propfolder" | Defaults
 |-
 |-

SteveT (talk | contribs)