ml::ApplicationBase Class Reference

Internal base class for all Malena applications. More...

#include <Application.h>

Inheritance diagram for ml::ApplicationBase:

Public Types
enum	Architecture { MVC , EDA , ECS }
	Architectural style hint passed at construction. More...

Public Member Functions
	ApplicationBase (const sf::VideoMode &videoMode, const std::string &title)
	Construct from an SFML video mode, using *this as the controller.
	ApplicationBase (const sf::VideoMode &videoMode, const std::string &title, UIController &appLogic, sf::RenderWindow &window=WindowManager::getWindow())
	Construct with a separate UIController and explicit video mode.
	ApplicationBase (unsigned int screenWidth, unsigned int screenHeight, unsigned int bitDepth, const std::string &title)
	Construct from pixel dimensions and bit depth.
void	addComponent (Core &component)
	Register a Core object with the application's component manager.
void	initialization () override=0
	Create and register all components and resources.
void	onUpdate (std::function< void()> f)
	Register a callback invoked every frame during the update tick.
void	registerEvents () override=0
	Attach event callbacks to components and framework objects.
void	run () override
	Enter the main loop and run until the window is closed.

Static Public Member Functions
static void	clearEvents ()
	Clear all event subscriptions across the entire application.
static void	reset ()
	Full application reset — clears events, messages, and components.

Detailed Description

Internal base class for all Malena applications.

Do not inherit directly. Use ml::Application or ml::ApplicationWith.

See also

Application, ApplicationWith

Definition at line 31 of file Application.h.

Member Enumeration Documentation

Architecture

enum ml::AppManager::Architecture

inherited

Architectural style hint passed at construction.

Informs the framework which structural pattern the application follows. Defaults to MVC.

Enumerator
MVC	Model-View-Controller.
EDA	Event-Driven Architecture.
ECS	Entity-Component-System.

Definition at line 76 of file AppManager.h.

Constructor & Destructor Documentation

ApplicationBase() [1/3]

ml::ApplicationBase::ApplicationBase	(	const sf::VideoMode &	videoMode,
		const std::string &	title,
		UIController &	appLogic,
		sf::RenderWindow &	window = WindowManager::getWindow() )

Construct with a separate UIController and explicit video mode.

ApplicationBase() [2/3]

ml::ApplicationBase::ApplicationBase	(	unsigned int	screenWidth,
		unsigned int	screenHeight,
		unsigned int	bitDepth,
		const std::string &	title )

Construct from pixel dimensions and bit depth.

ApplicationBase() [3/3]

ml::ApplicationBase::ApplicationBase	(	const sf::VideoMode &	videoMode,
		const std::string &	title )

Construct from an SFML video mode, using *this as the controller.

Member Function Documentation

addComponent()

void ml::ApplicationBase::addComponent

(

Core &

component

)

Register a Core object with the application's component manager.

clearEvents()

void ml::ApplicationBase::clearEvents ( )

static

Clear all event subscriptions across the entire application.

initialization()

void ml::UIController::initialization ( )

overridepure virtualinherited

Create and register all components and resources.

Implement this method to construct the objects your application needs and register them with the appropriate managers (e.g., via addComponent). This method runs before registerEvents(), so every object you plan to subscribe to will already exist by the time callbacks are attached.

Implements ml::Controller.

Implemented in ml::Application, and ml::ApplicationWith< Manifest >.

onUpdate()

void ml::UIController::onUpdate ( std::function< void()> f )

inherited

Register a callback invoked every frame during the update tick.

Equivalent to calling onUpdate on a component, but scoped to the controller itself. Use this for frame-level logic that is not tied to a specific component — for example, polling game state, advancing a timer, or orchestrating scene transitions.

Parameters

f	Callback with no arguments, invoked once per frame.

registerEvents()

void ml::UIController::registerEvents ( )

overridepure virtualinherited

Attach event callbacks to components and framework objects.

Implement this method to wire up onClick, onHover, onUpdate, onMessage, and any other subscriptions. Called immediately after initialization() by AppManager before the main loop begins.

Implements ml::Controller.

Implemented in ml::Application, and ml::ApplicationWith< Manifest >.

reset()

void ml::ApplicationBase::reset ( )

static

Full application reset — clears events, messages, and components.

Tears down all framework state in the correct order:

1. All event subscriptions
2. All message subscriptions
3. All registered components

After reset(), call initialization() and registerEvents() to rebuild the scene.

Note

Does NOT close the window or restart the main loop.

run()

void ml::AppManager::run ( )

overridevirtualinherited

Enter the main loop and run until the window is closed.

Each iteration of the loop:

1. Polls all pending SFML events and passes each to fireInputEvents().
2. Calls fireUpdateEvents() for the per-frame update tick.
3. Clears the window, calls draw() on all registered components, and displays the frame.

Returns when the SFML window is closed or window.close() is called.

Implements ml::Manager.

---

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

• Engine/App/Application.h