Application.h

#pragma once
 
 
#include <Foundation/Basics.h>
 
#include <Foundation/Application/Implementation/ApplicationEntryPoint.h>
#include <Foundation/Utilities/CommandLineUtils.h>
 
#include <Foundation/Profiling/Profiling.h>
 
class plApplication;
 
PL_FOUNDATION_DLL void plRun(plApplication* pApplicationInstance);
 
PL_FOUNDATION_DLL plResult plRun_Startup(plApplication* pApplicationInstance);
PL_FOUNDATION_DLL void plRun_MainLoop(plApplication* pApplicationInstance);
PL_FOUNDATION_DLL void plRun_Shutdown(plApplication* pApplicationInstance);
 
class PL_FOUNDATION_DLL plApplication
{
  PL_DISALLOW_COPY_AND_ASSIGN(plApplication);
 
public:
  enum class Execution
  {
    Continue, 
    Quit,     
  };
 
  plApplication(plStringView sAppName);
 
  virtual ~plApplication();
 
  void SetApplicationName(plStringView sAppName);
 
  const plString& GetApplicationName() const { return m_sAppName; }
 
  virtual plResult BeforeCoreSystemsStartup();
 
  virtual void AfterCoreSystemsStartup() {}
 
  virtual void BeforeHighLevelSystemsShutdown() {}
 
  virtual void AfterHighLevelSystemsShutdown() {}
 
  virtual void BeforeCoreSystemsShutdown() {}
 
  virtual void AfterCoreSystemsShutdown() {}
 
  virtual void BeforeEnterBackground() {}
 
  virtual void BeforeEnterForeground() {}
 
  virtual Execution Run() = 0;
 
  inline void SetReturnCode(plInt32 iReturnCode) { m_iReturnCode = iReturnCode; }
 
  inline plInt32 GetReturnCode() const { return m_iReturnCode; }
 
  virtual const char* TranslateReturnCode() const { return ""; }
 
  void SetCommandLineArguments(plUInt32 uiArgumentCount, const char** pArguments);
 
  static plApplication* GetApplicationInstance() { return s_pApplicationInstance; }
 
  plUInt32 GetArgumentCount() const { return m_uiArgumentCount; }
 
  const char* GetArgument(plUInt32 uiArgument) const;
 
  const char** GetArgumentsArray() const { return m_pArguments; }
 
  void EnableMemoryLeakReporting(bool bEnable) { m_bReportMemoryLeaks = bEnable; }
 
  bool IsMemoryLeakReportingEnabled() const { return m_bReportMemoryLeaks; }
 
  virtual void RequestQuit();
 
  PL_ALWAYS_INLINE bool WasQuitRequested() const { return m_bWasQuitRequested; }
 
protected:
  bool m_bWasQuitRequested = false;
 
private:
  plInt32 m_iReturnCode = 0;
 
  plUInt32 m_uiArgumentCount = 0;
 
  const char** m_pArguments = nullptr;
 
  bool m_bReportMemoryLeaks = true;
 
  plString m_sAppName;
 
  static plApplication* s_pApplicationInstance;
 
  friend PL_FOUNDATION_DLL_FRIEND void plRun(plApplication* pApplicationInstance);
  friend PL_FOUNDATION_DLL_FRIEND plResult plRun_Startup(plApplication* pApplicationInstance);
  friend PL_FOUNDATION_DLL_FRIEND void plRun_MainLoop(plApplication* pApplicationInstance);
  friend PL_FOUNDATION_DLL_FRIEND void plRun_Shutdown(plApplication* pApplicationInstance);
};