Shellminator V3.0.1
Simple Terminal
Loading...
Searching...
No Matches
ShellminatorScreenGrid Class Reference

#include <Shellminator-ScreenGrid.hpp>

Inheritance diagram for ShellminatorScreenGrid:
Collaboration diagram for ShellminatorScreenGrid:

Public Member Functions

 ShellminatorScreenGrid ()
 Empty constructor. More...
 
 ShellminatorScreenGrid (int numOfRows_p, int numOfColumns_p)
 
void init (Shellminator *parent_p, Stream *channel_p) override
 Init function. More...
 
void draw (bool noClear=false) override
 Draw function. More...
 
void update (int width_p, int height_p) override
 Update function. More...
 
void forceRedraw () override
 
void addWidget (ShellminatorScreen *widget, int row, int column, int rowSpan=1, int columnSpan=1)
 
- Public Member Functions inherited from ShellminatorScreen
virtual void draw (bool noClear=false)
 Draw function. More...
 
virtual void init (Shellminator *parent_p, Stream *channel_p)
 Init function. More...
 
virtual void setOrigin (int x, int y)
 Origin of the top left corner. More...
 
virtual void update (int width_p, int height_p)
 Update function. More...
 
virtual void forceRedraw ()
 
int left ()
 Return the coordinate of the left column next to the object. More...
 
int right ()
 Return the coordinate of the right column next to the object. More...
 
int up ()
 Return the coordinate of the upper row next to the object. More...
 
int down ()
 Return the coordinate of the lower row next to the object. More...
 
ShellminatorgetParent ()
 
void attachEndFunction (void(*end_func_p)(Shellminator *))
 
void removeEndFunction ()
 

Protected Attributes

bool redraw = true
 This flag shows that redraw is necessary. More...
 
int numOfRows = 0
 
int numOfColumns = 0
 
int cellWidth = 0
 
int cellHeight = 0
 
ShellminatorScreenhead = NULL
 
- Protected Attributes inherited from ShellminatorScreen
Shellminatorparent = NULL
 Pointer to the caller terminal object. More...
 
Stream * channel = NULL
 
int width = 1
 Actual width of the object. More...
 
int height = 1
 Actual height of the object. More...
 
int originX = 1
 X coordinate of the origin. More...
 
int originY = 1
 Y coordinate of the origin. More...
 
void(* end_func )(Shellminator *) = NULL
 

Additional Inherited Members

- Public Attributes inherited from ShellminatorScreen
int row = 1
 It is used by the grid layout. More...
 
int column = 1
 It is used by the grid layout. More...
 
int columnSpan = 1
 It is used by the grid layout. More...
 
int rowSpan = 1
 It is used by the grid layout. More...
 
ShellminatorScreennextElement = NULL
 It is used by the grid layout. More...
 
void(*)(Shellminator *) getEndFunction ()
 

Detailed Description

Definition at line 55 of file Shellminator-ScreenGrid.hpp.

Constructor & Destructor Documentation

◆ ShellminatorScreenGrid() [1/2]

ShellminatorScreenGrid::ShellminatorScreenGrid ( )

Empty constructor.

Definition at line 36 of file Shellminator-ScreenGrid.cpp.

◆ ShellminatorScreenGrid() [2/2]

ShellminatorScreenGrid::ShellminatorScreenGrid ( int  numOfRows_p,
int  numOfColumns_p 
)

Definition at line 46 of file Shellminator-ScreenGrid.cpp.

Member Function Documentation

◆ addWidget()

void ShellminatorScreenGrid::addWidget ( ShellminatorScreen widget,
int  row,
int  column,
int  rowSpan = 1,
int  columnSpan = 1 
)

Definition at line 196 of file Shellminator-ScreenGrid.cpp.

◆ draw()

void ShellminatorScreenGrid::draw ( bool  noClear = false)
overridevirtual

Draw function.

This function is called by the caller terminal if redraw is requested. If you need to draw your screen, the requestRedraw function must be called on the parent terminal object. The reason for this is to save some CPU time and do not waste it to draw something unnecessarily.

Reimplemented from ShellminatorScreen.

Definition at line 151 of file Shellminator-ScreenGrid.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ forceRedraw()

void ShellminatorScreenGrid::forceRedraw ( )
overridevirtual

Reimplemented from ShellminatorScreen.

Definition at line 241 of file Shellminator-ScreenGrid.cpp.

Here is the caller graph for this function:

◆ init()

void ShellminatorScreenGrid::init ( Shellminator parent_p,
Stream *  channel_p 
)
overridevirtual

Init function.

This function is called by the host terminal, when the plot object gets registered to it. You can put all the initialisation section here.

Parameters
parent_pPointer to the caller terminal object.
channel_pThis is a pointer to a Stream object, which can be used to print the output data.
Note
Please use the channel_p object instead of parent -> channel method. This object can be a regular channel or a buffer accelerated one. The logic behind the buffering and flushing is handled by the caller terminal.

Reimplemented from ShellminatorScreen.

Definition at line 56 of file Shellminator-ScreenGrid.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ update()

void ShellminatorScreenGrid::update ( int  width_p,
int  height_p 
)
overridevirtual

Update function.

The update function must be used to process events and not to draw the objects. It is called much frequently than, the draw function. All the event handling should be done in the update function, including key and mouse detection along with various events.

Parameters
width_pThe width of the screen area in characters.
height_pThe height of the screen area in characters.

Reimplemented from ShellminatorScreen.

Definition at line 72 of file Shellminator-ScreenGrid.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

Member Data Documentation

◆ cellHeight

int ShellminatorScreenGrid::cellHeight = 0
protected

Definition at line 111 of file Shellminator-ScreenGrid.hpp.

◆ cellWidth

int ShellminatorScreenGrid::cellWidth = 0
protected

Definition at line 110 of file Shellminator-ScreenGrid.hpp.

◆ head

ShellminatorScreen* ShellminatorScreenGrid::head = NULL
protected

Definition at line 113 of file Shellminator-ScreenGrid.hpp.

◆ numOfColumns

int ShellminatorScreenGrid::numOfColumns = 0
protected

Definition at line 108 of file Shellminator-ScreenGrid.hpp.

◆ numOfRows

int ShellminatorScreenGrid::numOfRows = 0
protected

Definition at line 107 of file Shellminator-ScreenGrid.hpp.

◆ redraw

bool ShellminatorScreenGrid::redraw = true
protected

This flag shows that redraw is necessary.

In this implementation redraw is only required when the screen is resized.

Definition at line 105 of file Shellminator-ScreenGrid.hpp.