Aether
SDL2 based UI Framework for NX
Public Member Functions | List of all members
Aether::Screen Class Reference

A class that represents a screen layout Stores all screen elements for a specific screen. More...

#include <Screen.hpp>

Inheritance diagram for Aether::Screen:
Aether::Container Aether::Element Aether::Overlay Aether::DateTime Aether::MessageBox Aether::PopupList

Public Member Functions

 Screen ()
 Constructs a new (empty) Screen object.
 
virtual void onLoad ()
 Invoked once when the screen is requested to be 'shown'. This method should set up all child elements.
 
virtual void onUnload ()
 Invoked once when the screen has been replaced by another screen. This method should tidy up all child elements.
 
void onButtonPress (Button btn, std::function< void()> func)
 Assigns a function to invoke when a button is pressed. More...
 
void onButtonRelease (Button btn, std::function< void()> func)
 Assigns a function to invoke when a button is released. More...
 
bool handleEvent (InputEvent *event)
 Attempts to handle the event if it is a button press/release. More...
 
- Public Member Functions inherited from Aether::Container
 Container (int x=0, int y=0, int w=100, int h=100)
 Construct a new Container object. More...
 
void setActive ()
 Re-highlight/focus the focused element.
 
void setInactive ()
 Removes focus from the focused element.
 
void addElement (Element *e)
 Adds new element a child. More...
 
bool removeElement (Element *e)
 Attempt to delete given child element. More...
 
void removeAllElements ()
 Deletes all children elements.
 
bool returnElement (Element *e)
 Attempt to remove the given child element. More...
 
void returnAllElements ()
 Removes (but does not delete) all children elements.
 
- Public Member Functions inherited from Aether::Element
 Element (int x=0, int y=0, int w=100, int h=100)
 Construct a new Element object. More...
 
int x ()
 Returns x-coordinate of element. More...
 
int y ()
 Returns y-coordinate of element. More...
 
int w ()
 Returns width of element. More...
 
int h ()
 Returns height of element. More...
 
virtual void setX (int x)
 Set x-coordinate of element. More...
 
virtual void setY (int y)
 Set y-coordinate of element. More...
 
virtual void setW (int w)
 Set width of element. More...
 
virtual void setH (int h)
 Set height of element. More...
 
virtual void setXY (int x, int y)
 Set co-ordinates of element. More...
 
virtual void setWH (int w, int h)
 Set size of element. More...
 
virtual void setXYWH (int x, int y, int w, int h)
 Setter size and co-ordinates of element. More...
 
Elementparent ()
 Returns the parent element of this element. More...
 
void setParent (Element *p)
 Set the parent element of this element. More...
 
bool isVisible ()
 Check if current element is visible on-screen. More...
 
bool hidden ()
 Check if current element is hidden. More...
 
void setHidden (bool b)
 Set whether element is hidden or not. More...
 
bool selected ()
 Check if current element is selected. More...
 
virtual void setSelected (bool b)
 Set whether element is selected or not. More...
 
bool selectable ()
 Check if current element is selectable. More...
 
void setSelectable (bool b)
 Set whether element is selectable or not. More...
 
bool touchable ()
 Check if current element is touch responsive. More...
 
void setTouchable (bool b)
 Set whether element is touch responsive or not. More...
 
bool highlighted ()
 Check if current element is highlighted. More...
 
void setHighlighted (bool b)
 Set whether element is highlighted or not. More...
 
bool hasHighlighted ()
 Check if current element has highlighted children element. More...
 
void setHasHighlighted (bool b)
 Set whether element has highlighted children element or not. More...
 
bool hasSelectable ()
 Check if current element has selectable children element. More...
 
void setHasSelectable (bool b)
 Set whether element has selectable children element or not. More...
 
bool hasSelected ()
 Check if current element has selected children element. More...
 
void setHasSelected (bool b)
 Set whether element has selected children element or not. More...
 
void setFocused (Element *e)
 Sets current element as unfocused and instead focuses a sub-element. More...
 
void setFocussed (Element *e)
 Sets current element as unfocused and instead focuses a sub-element. More...
 
Elementfocused ()
 Returns the currently focused element. More...
 
Elementfocussed ()
 Returns the currently focused element. More...
 
std::function< void()> onPressFunc ()
 Returns function invoked when the element is pressed. More...
 
void onPress (std::function< void()> f)
 Sets the function to invoked when the element is pressed. More...
 
virtual void update (unsigned int dt)
 Update is passed time since last frame (for animations) More...
 
virtual void render ()
 Render child elements + highlights.
 
virtual DrawablerenderHighlightBG ()
 Renders the highlight background. More...
 
virtual DrawablerenderHighlight ()
 Renders the highlight border. More...
 
virtual DrawablerenderSelection ()
 Renders the selection overlay. More...
 
virtual ~Element ()
 Destroy the Element object.
 

Additional Inherited Members

- Protected Member Functions inherited from Aether::Container
void addElementAt (Element *e, size_t i)
 
- Protected Member Functions inherited from Aether::Element
void renderHighlightTextures ()
 Renders cached highlight textures.
 
void renderSelectionTexture ()
 Renders cached selection texture.
 
void addElementAt (Element *e, size_t i)
 Add element at given index in vector. More...
 
- Protected Attributes inherited from Aether::Element
Elementparent_
 Pointer to parent element, if there is one.
 
std::vector< Element * > children
 Vector of child elements (used to call their methods)
 
Elementfocused_
 Children element which is highlighted/focused (to regain focus on activation)
 
- Static Protected Attributes inherited from Aether::Element
static Colour hiBGColour
 Background colour if element is highlighted.
 
static Colour hiBorderColour
 Border colour if element is highlighted.
 
static Colour selColour
 Selected colour if element is highlighted.
 
static unsigned int hiSize
 Size of highlight border.
 
static DrawablehiBGTex
 Highlight background texture.
 
static DrawablehiBorderTex
 Highlight border texture.
 
static DrawableselTex
 Selection texture.
 
static Rendererrenderer
 
static bool isTouch
 Indicator on whether the touch is "active" (i.e. hide highlighting) or not.
 

Detailed Description

A class that represents a screen layout Stores all screen elements for a specific screen.

Member Function Documentation

◆ handleEvent()

bool Aether::Screen::handleEvent ( InputEvent event)
virtual

Attempts to handle the event if it is a button press/release.

Parameters
eventevent to handle
Returns
Whether the event was handled by the screen.

Reimplemented from Aether::Container.

◆ onButtonPress()

void Aether::Screen::onButtonPress ( Button  btn,
std::function< void()>  func 
)

Assigns a function to invoke when a button is pressed.

Note
Setting a handler will block the button press event from travelling down to children.
Parameters
btnButton to assign function to
funcFunction to invoke when button pressed

◆ onButtonRelease()

void Aether::Screen::onButtonRelease ( Button  btn,
std::function< void()>  func 
)

Assigns a function to invoke when a button is released.

Note
Setting a handler will block the button release event from travelling down to children.
Parameters
btnButton to assign function to
funcFunction to invoke when button released

The documentation for this class was generated from the following file: