Jump to content

Component: Display Manager (Graphical Library)

From Flowcode Help
Revision as of 11:12, 13 January 2023 by BenR (talk | contribs)
Author MatrixTSL
Version 1.0
Category Graphical Library


Display Manager component

A component designed to simplify the process of drawing primitives and text onto a graphical display. Keeps track of coordinates so you don't have to. Also works great as a base layer for gLCD based games as it will check for collisions and perform movement.

Component Source Code

Please click here for the component source code: FC_Comp_Source_DisplayManager.fcfx

Detailed description

The component can create the follow objects.


Type_line - A simple straight line.

Type_Rectangle - A simple rectangular box.

Type_RectangeFilled - A filled rectangular box.

Type_Ellipse - A simple ellipse or circle.

Type_EllipseFilled - A filled ellipse or circle.

Type_TextBox - A text area allowing a line of text to be displayed.


The type can be entered by using the public constants. Begin with the Display Manager handle name followed by :: and the list of the public variables will be displayed.

For example... DisplayManager1::Type_TextBox

Examples

An example showing the creation of some text areas inside formatted shapes.

Display Manager Example

Downloadable macro reference

MoveObject
Moves an existing object to absolute coordinates on the screen. 
- UINT ObjectID
 
- UINT X
 
- UINT Y
 
- VOID Return


ShiftObject
Shifts an existing object coordinates on the screen relative to the previous coordinates. 
- UINT ObjectID
 
- INT X
 
- INT Y
 
- VOID Return


DrawObject
Draws a single object onto the display without clearing the display. Doesn't draw a textfield component, this is done using the SetObjectText macro. 
- UINT ObjectID
 
- VOID Return


ScaleObject
Changes the width and height of the selected Object 
- UINT ObjectID
 
- UINT Width
 
- UINT Height
 
- VOID Return


RedrawAll
Clears the display and redraws all the content from the display manager objects. Doesn't draw textfield components, this is done using the SetObjectText macro. 
- VOID Return


SetObjectText
Assigns text to a single line text object and draws directly to the display. Blanks the selected area first to ensure nothing from previous text is left behind. 
- UINT ObjectID
 
- STRING Text
 
- BYTE Font
 
- VOID Return


CreateObject
Define an object on the graphical LCD. Returns the Object ID. 
- UINT ObjectType
 
- UINT X
 
- UINT Y
 
- UINT Width
 
- UINT Height
 
- UINT Return



Property reference

Properties
GLCD Component
Selects the GLCD component to display all the objects 
Max Objects
The total number of objects allowed on the screen. Sets the size of the RAM buffers used to track the various screen elements.