AppManager.h

Go to the documentation of this file.

// Copyright (c) 2025 Dave R. Smith.
// Malena Framework — Licensed under PolyForm Noncommercial 1.0.0; commercial use requires a paid license. See LICENSE.
 
//
// Created by Dave R. Smith on 3/5/25.
//
 
#ifndef MALENA_APPMANAGER_H
#define MALENA_APPMANAGER_H
 
#pragma once
 
#include <Malena/Core/malena_export.h>
#include <Malena/Core/CoreManager.h>
#include <Malena/Engine/Window/WindowManager.h>
#include <SFML/Graphics.hpp>
#include <functional>
#include <optional>
#include <string>
#include <cstdint>
 
#include <Malena/Engine/App/Lifecycle.h>
 
namespace ml
{
    class MALENA_API AppManager : public Lifecycle, public CoreManager<Core>
    {
    public:
        enum Architecture
        {
            MVC, 
            EDA, 
            ECS  
        };
 
    private:
        sf::RenderWindow* window = nullptr;
 
        Architecture      _architecture;
        sf::Color         _clearColor   { sf::Color::Black };
        sf::Clock         _clock;
        bool              _paused       { false };
 
        // Stored for window recreation (setWindowStyle)
        sf::VideoMode     _videoMode;
        std::string       _title;
        std::uint32_t     _windowStyle;
        unsigned int      _framerateLimit { 60 };
 
        std::function<void()>                           _preRenderHook;
        std::function<void()>                           _postRenderHook;
        std::function<bool()>                           _closeHandler;
        std::function<bool(const sf::Event&)>           _eventHandler;
        std::function<void(unsigned int, unsigned int)> _resizeHandler;

        inline static bool        _isDrawing       = false;
        inline static float       _deltaTime       = 0.f;
        inline static AppManager* _instance        = nullptr;
        inline static Core*       _exclusiveOwner  = nullptr;
        inline static Core*       _activePopup     = nullptr;
        inline static std::vector<std::function<void()>> _deferredUnloads;
 
    public:
        AppManager(const sf::VideoMode& videoMode,
                   const std::string& title,
                   sf::RenderWindow& window = WindowManager::getWindow(),
                   Architecture architecture = MVC,
                   std::uint32_t windowStyle = sf::Style::Default);

        void run();
 
        virtual ~AppManager() = default;
 
        // ── Window appearance ─────────────────────────────────────────────────

        void setBackgroundColor(sf::Color color);

        void setTitle(const std::string& title);

        void setIcon(const sf::Image& icon);

        void setWindowPosition(int x, int y);

        void setWindowStyle(std::uint32_t style);
 
        // ── Timing ────────────────────────────────────────────────────────────

        void setFramerateLimit(unsigned int limit);

        void setVSync(bool enabled);

        static float getDeltaTime() { return _deltaTime; }
 
        // ── Pause / resume ────────────────────────────────────────────────────

        void pause();

        void resume();

        bool isPaused() const { return _paused; }
 
        // ── Lifecycle hooks ───────────────────────────────────────────────────

        void onPreRender(std::function<void()> hook);

        void onPostRender(std::function<void()> hook);

        void onClose(std::function<bool()> handler);

        void onEvent(std::function<bool(const sf::Event&)> handler);

        void onResize(std::function<void(unsigned int, unsigned int)> handler);
 
        // ── Architecture ──────────────────────────────────────────────────────

        Architecture getArchitecture() const { return _architecture; }
 
        // ── Exclusive interaction ─────────────────────────────────────────────

        static void setExclusiveOwner(Core* owner);

        static void clearExclusiveOwner();

        static Core* exclusiveOwner() { return _exclusiveOwner; }
 
        // ── Top popup layer ───────────────────────────────────────────────────

        static void setActivePopup(Core* popup) { _activePopup = popup; }

        static Core* activePopup() { return _activePopup; }

        static void clearActivePopup() { _activePopup = nullptr; }
 
        // ── Internal ──────────────────────────────────────────────────────────

        static bool isDrawing() { return _isDrawing; }
 
        static bool isUnderExclusiveOwner(Core* component);
 
        static void deferUnload(std::function<void()> op)
        {
            _deferredUnloads.push_back(std::move(op));
        }

        static AppManager& get() { return *_instance; }
 
    private:
        void fireInputEvents(const std::optional<sf::Event>& event);
        void fireUpdateEvents();
        void draw();
        void flushDeferredUnloads();
    };
 
} // namespace ml
 
#endif // MALENA_APPMANAGER_H