Component: Bitmap (Graphical Manager Primitives): Difference between revisions

Latest revision as of 14:37, 13 July 2026

Author	Matrix TSL
Version	1.0
Category	Graphical Manager Primitives

Bitmap component

A bitmap primitive used with the Graphical Manager on the GLCD Layout Editor panel. Requires a bitmap drawer GLCD library to be connected to the GLCD and the Display Manager.

Detailed description

No detailed description exists yet for this component

Examples

A simple example shows how to use a ASC712 to measure current range of +/- 5A. The component type can be changed within its properties.

ACS712 example

Macro reference

GetID

	GetID
Returns the assigned object/widget ID.
- UINT	Return

ModifyBitmap

	ModifyBitmap
Allows the bitmap image to be swapped out
- STRING	Filename
Bitmap filename in 8.3 file format
- BOOL	Redraw
Allows the bitmap to be redrawn immediatley or later on.
- VOID	Return

ModifyColour

	ModifyColour
Changes the theme index of the selected Object or Widget.
- BYTE	Index
0=Transparent, 1=Text
- BYTE	R

- BYTE	G

- BYTE	B

- BOOL	Redraw

- VOID	Return

ModifyPosition

	ModifyPosition
Moves an existing object or Widget to absolute coordinates on the screen.
- INT	X

- INT	Y

- BOOL	Relative
0=Absolute Positioning, 1=Relative Positioning
- VOID	Return

ModifyScale

	ModifyScale
Changes the width and height of the selected Object or Widget.
- UINT	Width

- UINT	Height

- VOID	Return

SetTextFloat

	SetTextFloat
Draws a floating point value with optional units onto an object or Widget location.
- FLOAT	Number

- BYTE	NumDP
Number of decimal points to display
- STRING	Unit
Optional unit string to add after the numeric value. e.g. "g" or "s"
- VOID	Return

SetTextLabel

	SetTextLabel
Draws a string onto an object or Widget location.
- STRING	Text
Text string to set as the label
- VOID	Return

SetTextNumber

	SetTextNumber
Draws an integer numerical value with optional units onto an object or Widget location.
- INT	Number

- STRING	Unit
Unit string to add after the numeric value. e.g. "g" or "s"
- VOID	Return

Property reference

	Properties
	Bitmap File
	BitmapFile

	Refresh Bitmap
Reloads the bitmap image from file. Immediatley defaults back to no once complete.
	Appearance
	Scaling

	Use Transparancy
When set to yes allows a transparent colour to be assigned.
	Touch
	Touchable
Determines if the display creator defined area responds to touches Touch is detected by using the DisplayManager::CheckForTouch macro with the X,Y coordinates of a touch
	Text
	Text
Optional default text to add to the inside of the shape
	Font
GLCD font to use
	Horizontal Alignment
Horizontal alignment of the text label inside the shape
	Vertical Alignment
Vertical alignment of the text label inside the shape
	Text Colour
The colour of the text

Component Source Code

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

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

@@ Line 33: / Line 33: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''GetID'''
+| width="90%" class="mtx-class-macrohead" | '''GetID'''
 |-
 | colspan="2" | Returns the assigned object/widget ID.&nbsp;
@@ Line 47: / Line 47: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ModifyBitmap'''
+| width="90%" class="mtx-class-macrohead" | '''ModifyBitmap'''
 |-
 | colspan="2" | Allows the bitmap image to be swapped out&nbsp;
@@ Line 71: / Line 71: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ModifyColour'''
+| width="90%" class="mtx-class-macrohead" | '''ModifyColour'''
 |-
 | colspan="2" | Changes the theme index of the selected Object or Widget.&nbsp;
@@ Line 110: / Line 110: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ModifyPosition'''
+| width="90%" class="mtx-class-macrohead" | '''ModifyPosition'''
 |-
 | colspan="2" | Moves an existing object or Widget to absolute coordinates on the screen.&nbsp;
@@ Line 139: / Line 139: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''ModifyScale'''
+| width="90%" class="mtx-class-macrohead" | '''ModifyScale'''
 |-
 | colspan="2" | Changes the width and height of the selected Object or Widget.&nbsp;
@@ Line 163: / Line 163: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SetTextFloat'''
+| width="90%" class="mtx-class-macrohead" | '''SetTextFloat'''
 |-
 | colspan="2" | Draws a floating point value with optional units onto an object or Widget location.&nbsp;
@@ Line 192: / Line 192: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SetTextLabel'''
+| width="90%" class="mtx-class-macrohead" | '''SetTextLabel'''
 |-
 | colspan="2" | Draws a string onto an object or Widget location.&nbsp;
@@ Line 211: / Line 211: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''SetTextNumber'''
+| width="90%" class="mtx-class-macrohead" | '''SetTextNumber'''
 |-
 | colspan="2" | Draws an integer numerical value with optional units onto an object or Widget location.&nbsp;
@@ Line 236: / Line 236: @@
 |-
 | 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;" | Bitmap File
+| width="90%" class="mtx-class-propfolder" | Bitmap File
 |-
 |-
@@ Line 253: / Line 253: @@
 | colspan="2" | Reloads the bitmap image from file. Immediatley defaults back to no once complete.&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;" | Appearance
+| width="90%" class="mtx-class-propfolder" | Appearance
 |-
 |-
@@ Line 267: / Line 267: @@
 | colspan="2" | When set to yes allows a transparent colour to be assigned.&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;" | Touch
+| width="90%" class="mtx-class-propfolder" | Touch
 |-
 |-
@@ Line 276: / Line 276: @@
 | colspan="2" | Determines if the display creator defined area responds to touches Touch is detected by using the DisplayManager::CheckForTouch macro with the X,Y coordinates of a touch&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;" | Text
+| width="90%" class="mtx-class-propfolder" | Text
 |-
 |-

SteveT (talk | contribs)