Difference between revisions of "Component: Display Manager (Graphical Library)"

From Flowcode Help
Jump to navigationJump to search
 
(9 intermediate revisions by 2 users not shown)
Line 21: Line 21:
 
==Detailed description==
 
==Detailed description==
  
 +
The component can create the follow objects.
  
 +
*'''Type_Line''' - 2 - A simple straight line.
 +
*'''Type_Rectangle''' - 1 - A simple rectangular box.
 +
*'''Type_RectangeFilled''' - 5 - A filled rectangular box.
 +
*'''Type_Ellipse''' - 3 - A simple ellipse or circle.
 +
*'''Type_EllipseFilled''' - 4 - A filled ellipse or circle.
 +
*'''Type_TextBox''' - 0 - A text area allowing a line of text to be displayed.
  
  
 +
The type can be entered by using the component's 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'''
 
 
 
 
 
 
''No detailed description exists yet for this component''
 
  
 
==Examples==
 
==Examples==
  
 +
An example showing the creation of some text areas inside formatted shapes.
  
 
+
{{Fcfile|DisplayManagerExample.fcfx|Display Manager Example}}
 
 
 
 
 
 
 
 
 
 
 
 
 
 
''<span style="color:red;">No additional examples</span>''
 
 
 
  
 
==Downloadable macro reference==
 
==Downloadable macro reference==
Line 154: Line 150:
 
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''RedrawAll'''
 
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''RedrawAll'''
 
|-
 
|-
| colspan="2" | 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.&nbsp;
+
| colspan="2" | Redraws all the content from the display manager objects. Doesn't draw textfield components, this is done using the SetObjectText macro.&nbsp;
 
|-
 
|-
 
|-
 
|-
Line 201: Line 197:
 
| width="90%" | ObjectType
 
| width="90%" | ObjectType
 
|-
 
|-
| colspan="2" | &nbsp;
+
| colspan="2" | 0=TextBox, 1=Rect, 2=Line, 3=Ellipse, 4=FilledEllipse, 5=FilledRect
 
|-
 
|-
 
| width="10%" align="center" | [[File:Fc9-u16-icon.png]] - UINT
 
| width="10%" align="center" | [[File:Fc9-u16-icon.png]] - UINT
 
| width="90%" | X
 
| width="90%" | X
 
|-
 
|-
| colspan="2" | &nbsp;
+
| colspan="2" | X Pixel Coordinate
 
|-
 
|-
 
| width="10%" align="center" | [[File:Fc9-u16-icon.png]] - UINT
 
| width="10%" align="center" | [[File:Fc9-u16-icon.png]] - UINT
 
| width="90%" | Y
 
| width="90%" | Y
 
|-
 
|-
| colspan="2" | &nbsp;
+
| colspan="2" | Y Pixel Coordinate
 
|-
 
|-
 
| width="10%" align="center" | [[File:Fc9-u16-icon.png]] - UINT
 
| width="10%" align="center" | [[File:Fc9-u16-icon.png]] - UINT
 
| width="90%" | Width
 
| width="90%" | Width
 
|-
 
|-
| colspan="2" | &nbsp;
+
| colspan="2" | Pixel Width or X Radius
 
|-
 
|-
 
| width="10%" align="center" | [[File:Fc9-u16-icon.png]] - UINT
 
| width="10%" align="center" | [[File:Fc9-u16-icon.png]] - UINT
 
| width="90%" | Height
 
| width="90%" | Height
 
|-
 
|-
| colspan="2" | &nbsp;
+
| colspan="2" | Pixel Height or Y Radius
 
|-
 
|-
 
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u16-icon.png]] - UINT
 
| width="10%" align="center" style="border-top: 2px solid #000;" | [[File:Fc9-u16-icon.png]] - UINT
 
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 
| width="90%" style="border-top: 2px solid #000;" | ''Return''
 
|}
 
|}
 
 
 
  
 
==Property reference==
 
==Property reference==
Line 247: Line 240:
 
|-
 
|-
 
| colspan="2" | The total number of objects allowed on the screen. Sets the size of the RAM buffers used to track the various screen elements.&nbsp;
 
| colspan="2" | The total number of objects allowed on the screen. Sets the size of the RAM buffers used to track the various screen elements.&nbsp;
|-
 
| width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-conn-icon.png]]
 
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Connections'''
 
|-
 
|-
 
| width="10%" align="center" style="background-color:#D8C9D8;" | [[File:Fc9-conn-icon.png]]
 
| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Simulations'''
 
|-
 
 
|}
 
|}

Latest revision as of 11:38, 13 January 2023

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 Pack

FREE

Detailed description

The component can create the follow objects.

  • Type_Line - 2 - A simple straight line.
  • Type_Rectangle - 1 - A simple rectangular box.
  • Type_RectangeFilled - 5 - A filled rectangular box.
  • Type_Ellipse - 3 - A simple ellipse or circle.
  • Type_EllipseFilled - 4 - A filled ellipse or circle.
  • Type_TextBox - 0 - A text area allowing a line of text to be displayed.


The type can be entered by using the component's 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.

FC6 Icon.png Display Manager Example

Downloadable macro reference

Fc9-comp-macro.png MoveObject
Moves an existing object to absolute coordinates on the screen. 
Fc9-u16-icon.png - UINT ObjectID
 
Fc9-u16-icon.png - UINT X
 
Fc9-u16-icon.png - UINT Y
 
Fc9-void-icon.png - VOID Return


Fc9-comp-macro.png ShiftObject
Shifts an existing object coordinates on the screen relative to the previous coordinates. 
Fc9-u16-icon.png - UINT ObjectID
 
Fc9-s16-icon.png - INT X
 
Fc9-s16-icon.png - INT Y
 
Fc9-void-icon.png - VOID Return


Fc9-comp-macro.png 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. 
Fc9-u16-icon.png - UINT ObjectID
 
Fc9-void-icon.png - VOID Return


Fc9-comp-macro.png ScaleObject
Changes the width and height of the selected Object 
Fc9-u16-icon.png - UINT ObjectID
 
Fc9-u16-icon.png - UINT Width
 
Fc9-u16-icon.png - UINT Height
 
Fc9-void-icon.png - VOID Return


Fc9-comp-macro.png RedrawAll
Redraws all the content from the display manager objects. Doesn't draw textfield components, this is done using the SetObjectText macro. 
Fc9-void-icon.png - VOID Return


Fc9-comp-macro.png 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. 
Fc9-u16-icon.png - UINT ObjectID
 
Fc9-string-icon.png - STRING Text
 
Fc9-u8-icon.png - BYTE Font
 
Fc9-void-icon.png - VOID Return


Fc9-comp-macro.png CreateObject
Define an object on the graphical LCD. Returns the Object ID. 
Fc9-u16-icon.png - UINT ObjectType
0=TextBox, 1=Rect, 2=Line, 3=Ellipse, 4=FilledEllipse, 5=FilledRect
Fc9-u16-icon.png - UINT X
X Pixel Coordinate
Fc9-u16-icon.png - UINT Y
Y Pixel Coordinate
Fc9-u16-icon.png - UINT Width
Pixel Width or X Radius
Fc9-u16-icon.png - UINT Height
Pixel Height or Y Radius
Fc9-u16-icon.png - UINT Return

Property reference

Fc9-prop-icon.png Properties
Fc9-type-17-icon.png GLCD Component
Selects the GLCD component to display all the objects 
Fc9-type-21-icon.png 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.