Default implementation of the IApplication interface. More...

#include <core_application.hpp>

Inherits rendering_engine::IApplication.

Public Member Functions
	CoreApplication ()
	Constructs a CoreApplication using settings from the config file. More...

	CoreApplication (char const *appName)
	Constructs a CoreApplication with full-screen window size. More...

	CoreApplication (unsigned int width, unsigned int height, char const *appName)
	Constructs a CoreApplication with explicit window size. More...

	CoreApplication (unsigned int width, unsigned int height, char const *appName, std::shared_ptr< IWindowSystem > windowSystem, std::shared_ptr< IRenderer > renderer)
	Constructs a CoreApplication with injected subsystems. More...

	CoreApplication (char const *appName, std::shared_ptr< IWindowSystem > windowSystem, std::shared_ptr< IRenderer > renderer)
	Constructs a CoreApplication with custom systems but default window size. More...

virtual	~CoreApplication ()

void	Initialize () override
	Initializes the application and its subsystems. More...

void	Run () override
	Runs the main application loop. More...

void	Update (float deltaTime) override
	Updates the application state. More...

void	Draw () override
	Executes the rendering logic for the current frame. More...

void	Shutdown () override
	Performs cleanup and shuts down the application. More...

ScreenSettings	GetScreenSettings () const override
	Retrieves the current screen or window settings. More...

FrameMetrics	GetFrameMetrics () const override
	Returns performance metrics of the last processed frame. More...

Public Member Functions inherited from rendering_engine::IApplication
virtual void	Initialize ()=0
	Initializes the application and its subsystems. More...

virtual void	Run ()=0
	Runs the main application loop. More...

virtual void	Update (float deltaTime)=0
	Updates the application state. More...

virtual void	Draw ()=0
	Executes the rendering logic for the current frame. More...

virtual void	Shutdown ()=0
	Performs cleanup and shuts down the application. More...

virtual	~IApplication ()=default
	Virtual destructor for safe polymorphic deletion. More...

virtual ScreenSettings	GetScreenSettings () const =0
	Retrieves the current screen or window settings. More...

virtual FrameMetrics	GetFrameMetrics () const =0
	Returns performance metrics of the last processed frame. More...

Protected Attributes
bool	bIsFullScreen

unsigned int	mWidth

unsigned int	mHeight

std::string	mAppName

AppConfig	mAppConfig

FrameMetrics	mFrameMetrics

std::shared_ptr< AppTime >	mAppTime

std::shared_ptr< IWindowSystem >	mWindowSystem

std::shared_ptr< IRenderer >	mRenderer

std::shared_ptr< SceneManager >	mSceneManager

Detailed Description

Default implementation of the IApplication interface.

Coordinates the main execution flow of a rendering-based application, including initialization, update, rendering, and shutdown. It acts as the central manager that connects the renderer, window system, and scene management subsystems.

See also: IApplication; IWindowSystem; IRenderer

Definition at line 34 of file core_application.hpp.

Constructor & Destructor Documentation

◆ CoreApplication() [1/5]

rendering_engine::CoreApplication::CoreApplication ( )

Constructs a CoreApplication using settings from the config file.

Loads AppConfig and applies its values to window setup.

Definition at line 15 of file core_application.cpp.

    :
    mAppTime(std::make_shared<AppTime>()),
    mWindowSystem{ nullptr },
    mRenderer{ nullptr }
{
    mAppConfig = Utility::ReadConfigFile();
 
    mAppName = mAppConfig.appName.c_str();
    bIsFullScreen = mAppConfig.isFullScreen;
    mWidth = static_cast<unsigned int>(mAppConfig.screenWidth);
    mHeight = static_cast<unsigned int>(mAppConfig.screenHeight);
}

◆ CoreApplication() [2/5]

rendering_engine::CoreApplication::CoreApplication ( char const * appName )

Constructs a CoreApplication with full-screen window size.

Parameters

appName Name of the application, used for window caption and logging.

Definition at line 28 of file core_application.cpp.

    :
    bIsFullScreen{true},
    mAppName(appName),
    mAppTime(std::make_shared<AppTime>()),
    mWindowSystem{nullptr},
    mRenderer{nullptr}
{
    mAppConfig = Utility::ReadConfigFile();
}

◆ CoreApplication() [3/5]

rendering_engine::CoreApplication::CoreApplication	(	unsigned int	width,
		unsigned int	height,
		char const *	appName
	)

Constructs a CoreApplication with explicit window size.

Parameters

width	Window width in pixels.
height	Window height in pixels.
appName	Name of the application.

Definition at line 39 of file core_application.cpp.

    :
    bIsFullScreen{false},
    mWidth{width},
    mHeight{height},
    mAppName(appName),
    mAppTime(std::make_shared<AppTime>()),
    mWindowSystem{ nullptr },
    mRenderer{ nullptr }
{
    mAppConfig = Utility::ReadConfigFile();
}

◆ CoreApplication() [4/5]

rendering_engine::CoreApplication::CoreApplication	(	unsigned int	width,
		unsigned int	height,
		char const *	appName,
		std::shared_ptr< IWindowSystem >	windowSystem,
		std::shared_ptr< IRenderer >	renderer
	)

Constructs a CoreApplication with injected subsystems.

Parameters

width	Window width in pixels.
height	Window height in pixels.
appName	Name of the application.
windowSystem	Shared pointer to a custom window system implementation.
renderer	Shared pointer to a custom renderer implementation.

Definition at line 52 of file core_application.cpp.

    :
    bIsFullScreen{ false },
    mWidth{ width },
    mHeight{ height },
    mAppName(appName),
    mAppTime(std::make_shared<AppTime>()),
    mWindowSystem{ windowSystem },
    mRenderer{ renderer }
{
    mAppConfig = Utility::ReadConfigFile();
}

◆ CoreApplication() [5/5]

rendering_engine::CoreApplication::CoreApplication	(	char const *	appName,
		std::shared_ptr< IWindowSystem >	windowSystem,
		std::shared_ptr< IRenderer >	renderer
	)

Constructs a CoreApplication with custom systems but default window size.

Parameters

appName	Name of the application.
windowSystem	Shared pointer to a custom window system implementation.
renderer	Shared pointer to a custom renderer implementation.

Definition at line 69 of file core_application.cpp.

    :
    bIsFullScreen{ true },
    mWidth{ 0 },
    mHeight{ 0 },
    mAppName(appName),
    mAppTime(std::make_shared<AppTime>()),
    mWindowSystem{ windowSystem },
    mRenderer{ renderer }
{
    mAppConfig = Utility::ReadConfigFile();
}

◆ ~CoreApplication()

rendering_engine::CoreApplication::~CoreApplication ( )

virtual

Definition at line 84 of file core_application.cpp.

84{};

Member Function Documentation

◆ Draw()

void rendering_engine::CoreApplication::Draw ( )

overridevirtual

Executes the rendering logic for the current frame.

Implements rendering_engine::IApplication.

Definition at line 217 of file core_application.cpp.

{
    if (mRenderer->BeginFrame())
    {
        mRenderer->BeginRenderPass();
        mSceneManager->Draw();
        mRenderer->EndRenderPass();
        mRenderer->EndFrame();
    }
}

◆ GetFrameMetrics()

FrameMetrics rendering_engine::CoreApplication::GetFrameMetrics ( ) const

overridevirtual

Returns performance metrics of the last processed frame.

Returns: FrameMetrics structure containing timing and FPS data.

Implements rendering_engine::IApplication.

Definition at line 253 of file core_application.cpp.

{
    return mFrameMetrics;
}

◆ GetScreenSettings()

ScreenSettings rendering_engine::CoreApplication::GetScreenSettings ( ) const

overridevirtual

Retrieves the current screen or window settings.

Returns: A structure describing screen configuration parameters.

Implements rendering_engine::IApplication.

Definition at line 242 of file core_application.cpp.

{
    ScreenSettings ss;
    ss.name = mAppName;
    ss.isFullScreen = bIsFullScreen;
    ss.height = mHeight;
    ss.width = mWidth;
    
    return ss;
}

◆ Initialize()

void rendering_engine::CoreApplication::Initialize ( )

overridevirtual

Initializes the application and its subsystems.

Implements rendering_engine::IApplication.

Definition at line 86 of file core_application.cpp.

{
    Logger::Get().Initialize(mAppName);
 
    LOG_INFO("Initializing CoreApplication...");
    LOG_INFO(std::string("Application name: ") + mAppName);
 
    auto startTime = std::chrono::steady_clock::now();
 
    if (!mWindowSystem)
    {
        LOG_DEBUG("Creating StandaloneDesktopWindow...");
        mWindowSystem = std::make_shared<StandaloneDesktopWindow>(*this);
    }
    if (!mRenderer)
    {
        LOG_DEBUG("Creating VulkanRenderer...");
        mRenderer = std::make_shared<VulkanRenderer>(*mWindowSystem.get());
    }
 
    LOG_INFO("Creating application window...");
    mWindowSystem->CreateAppWindow(mWidth, mHeight, mAppName);
    if (bIsFullScreen)
    {
        mWidth = mWindowSystem->GetFullScreenResolution().width;
        mHeight = mWindowSystem->GetFullScreenResolution().height;
 
        LOG_INFO("Fullscreen mode enabled. Resolution set to: "
            + std::to_string(mWidth) + "x" + std::to_string(mHeight));
    }
    LOG_INFO("Initializing renderer...");
    mRenderer->InitializeRenderer();
 
    LOG_INFO("Initializing SceneManager...");
    mSceneManager = std::make_shared<SceneManager>(mRenderer.get(), this);
    mSceneManager->Initialize();
 
    auto endTime = std::chrono::steady_clock::now();
    auto duration = std::chrono::duration_cast<std::chrono::milliseconds>(endTime - startTime).count();
 
    LOG_INFO("CoreApplication initialized in " + std::to_string(duration) + " ms.");
}

◆ Run()

void rendering_engine::CoreApplication::Run ( )

overridevirtual

Runs the main application loop.

Implements rendering_engine::IApplication.

Definition at line 129 of file core_application.cpp.

{
    LOG_INFO("Entering main loop.");
 
    AppClock appClock;
    appClock.Reset();
    
    const float targetFrameTimeMs =
        (mAppConfig.targetFPS > 0) ? (1000.0f / static_cast<float>(mAppConfig.targetFPS)) : 0.0f;
    
    while (!mWindowSystem->ShouldClose())
    {
        const auto frameStart = std::chrono::steady_clock::now();
 
        appClock.UpdateAppTime(*mAppTime);
        mWindowSystem->PollEvents();
 
        const auto updateStart = std::chrono::steady_clock::now();
        Update(mAppTime->ElapsedAppTimeSeconds());
        const auto updateEnd = std::chrono::steady_clock::now();
 
        const auto drawStart = std::chrono::steady_clock::now();
        Draw();
        const auto drawEnd = std::chrono::steady_clock::now();
 
        const auto frameEnd = std::chrono::steady_clock::now();
 
        mFrameMetrics.updateTimeMs =
            std::chrono::duration<float, std::milli>(updateEnd - updateStart).count();
        mFrameMetrics.drawTimeMs =
            std::chrono::duration<float, std::milli>(drawEnd - drawStart).count();
        mFrameMetrics.frameDurationMs =
            std::chrono::duration<float, std::milli>(frameEnd - frameStart).count();
 
 
        // Frame pacing (sleep)
        if (mAppConfig.targetFPS > 0)
        {
            const auto afterMetrics = std::chrono::steady_clock::now();
 
            const float actualFrameTimeMs =
                std::chrono::duration<float, std::milli>(afterMetrics - frameStart).count();
 
            if (actualFrameTimeMs < targetFrameTimeMs)
            {
                const auto sleepDuration =
                    std::chrono::duration<float, std::milli>(
                        targetFrameTimeMs - actualFrameTimeMs);
 
                std::this_thread::sleep_for(sleepDuration);
            }
        }
 
        const auto frameEndTotal = std::chrono::steady_clock::now();
        const auto frameLengthTotal = std::chrono::duration<float, std::milli>(frameEndTotal - frameStart).count();
        
        if (mFrameMetrics.frameDurationMs > 0.0f)
        {
            mFrameMetrics.fpsRaw = 1000.0f / frameLengthTotal;
 
            const float alpha = 0.1f;
 
            if (mFrameMetrics.fpsSmoothed == 0.0f)
            {
                mFrameMetrics.fpsSmoothed = mFrameMetrics.fpsRaw;
            }
            else
            {
                mFrameMetrics.fpsSmoothed =
                alpha * mFrameMetrics.fpsRaw +
                (1.0f - alpha) * mFrameMetrics.fpsSmoothed;
            }
        }
    }
 
    LOG_INFO("Main loop exited.");
 
    Shutdown();
}

◆ Shutdown()

void rendering_engine::CoreApplication::Shutdown ( )

overridevirtual

Performs cleanup and shuts down the application.

Implements rendering_engine::IApplication.

Definition at line 228 of file core_application.cpp.

{
    LOG_INFO("Shutting down CoreApplication...");
    mRenderer->WaitIdle();
    LOG_DEBUG("Shutting down SceneManager...");
    mSceneManager->Shutdown();
    LOG_DEBUG("Shutting down Renderer...");
    mRenderer->ShutdownRenderer();
    LOG_DEBUG("Shutting down WindowSystem...");
    mWindowSystem->Shutdown();
    LOG_INFO("CoreApplication shutdown complete.");
    Logger::Get().Shutdown();
}

◆ Update()

void rendering_engine::CoreApplication::Update ( float deltaTime )

overridevirtual

Updates the application state.

Parameters

deltaTime Time elapsed since the previous frame, in milliseconds.

Implements rendering_engine::IApplication.

Definition at line 209 of file core_application.cpp.

{
    if (mSceneManager)
    {
        mSceneManager->Update(deltaTime);
    }
}

Member Data Documentation

◆ bIsFullScreen

bool rendering_engine::CoreApplication::bIsFullScreen

protected

Definition at line 97 of file core_application.hpp.

◆ mAppConfig

AppConfig rendering_engine::CoreApplication::mAppConfig

protected

Definition at line 101 of file core_application.hpp.

◆ mAppName

std::string rendering_engine::CoreApplication::mAppName

protected

Definition at line 100 of file core_application.hpp.

◆ mAppTime

std::shared_ptr<AppTime> rendering_engine::CoreApplication::mAppTime

protected

Definition at line 105 of file core_application.hpp.

◆ mFrameMetrics

FrameMetrics rendering_engine::CoreApplication::mFrameMetrics

protected

Definition at line 103 of file core_application.hpp.

◆ mHeight

unsigned int rendering_engine::CoreApplication::mHeight

protected

Definition at line 99 of file core_application.hpp.

◆ mRenderer

std::shared_ptr<IRenderer> rendering_engine::CoreApplication::mRenderer

protected

Definition at line 107 of file core_application.hpp.

◆ mSceneManager

std::shared_ptr<SceneManager> rendering_engine::CoreApplication::mSceneManager

protected

Definition at line 109 of file core_application.hpp.

◆ mWidth

unsigned int rendering_engine::CoreApplication::mWidth

protected

Definition at line 98 of file core_application.hpp.

◆ mWindowSystem

std::shared_ptr<IWindowSystem> rendering_engine::CoreApplication::mWindowSystem

protected

Definition at line 106 of file core_application.hpp.

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

Public Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ CoreApplication() [1/5]

◆ CoreApplication() [2/5]

◆ CoreApplication() [3/5]

◆ CoreApplication() [4/5]

◆ CoreApplication() [5/5]

◆ ~CoreApplication()

Member Function Documentation

◆ Draw()

◆ GetFrameMetrics()

◆ GetScreenSettings()

◆ Initialize()

◆ Run()

◆ Shutdown()

◆ Update()

Member Data Documentation

◆ bIsFullScreen

◆ mAppConfig

◆ mAppName

◆ mAppTime

◆ mFrameMetrics

◆ mHeight

◆ mRenderer

◆ mSceneManager

◆ mWidth

◆ mWindowSystem