![]() |
XII Release 0.1.0
|
Public Types | |
using | SUPER = xiiGameApplication |
![]() | |
using | SUPER = xiiGameApplicationBase |
![]() | |
using | SUPER = xiiApplication |
![]() | |
enum class | Execution { Continue , Quit } |
Defines the possible return values for the xiiApplication::Run() function. More... | |
Public Member Functions | |
virtual xiiApplication::Execution | Run () override |
Main run function which is called periodically. This function must be overridden. | |
![]() | |
xiiGameApplication (xiiStringView sAppName, xiiStringView sProjectPath={}) | |
sProjectPath may be empty, if FindProjectDirectory() is overridden. | |
virtual xiiString | FindProjectDirectory () const override |
Implementation of xiiGameApplicationBase::FindProjectDirectory to define the 'project' special data directory. | |
void | ReinitializeInputConfig () |
Used at runtime (by the editor) to reload input maps. Forwards to Init_ConfigureInput() | |
xiiStringView | GetAppProjectPath () const |
Returns the project path that was given to the constructor (or modified by an overridden implementation). | |
![]() | |
xiiGameApplicationBase (xiiStringView sAppName) | |
void | TakeProfilingCapture () |
Does a profiling capture and writes it to disk at ':appdata'. | |
void | TakeScreenshot () |
Schedules a screenshot to be taken at the end of the frame. | |
void | CaptureFrame () |
Schedules a frame capture if the corresponding plugin is loaded. | |
void | SetContinuousFrameCapture (bool bEnable) |
Controls if frame captures are taken continuously (without being persisted) or only on-demand. | |
bool | GetContinousFrameCapture () const |
virtual xiiResult | GetAbsFrameCaptureOutputPath (xiiStringBuilder &ref_sOutputPath) |
Get the absolute base output path for frame captures. | |
void | ActivateGameState (xiiWorld *pWorld, xiiStringView sStartPosition, const xiiTransform &startPositionOffset) |
Creates and activates the game state for this application. | |
void | DeactivateGameState () |
Deactivates and destroys the active game state. | |
xiiGameStateBase * | GetActiveGameState () const |
Returns the currently active game state. Could be nullptr. | |
const xiiPlatformProfile & | GetPlatformProfile () const |
Returns the xiiPlatformProfile that has been loaded for this application. | |
void | RunOneFrame () |
xiiTime | GetFrameTime () const |
![]() | |
xiiApplication (xiiStringView sAppName) | |
Constructor. | |
virtual | ~xiiApplication () |
Virtual destructor. | |
void | SetApplicationName (xiiStringView sAppName) |
Changes the application name. | |
const xiiString & | GetApplicationName () const |
Returns the application name. | |
virtual void | AfterHighLevelSystemsShutdown () |
Called after xiiStartup::ShutdownHighLevelSystems() has been executed. | |
virtual void | AfterCoreSystemsShutdown () |
This function is called after xiiStartup::ShutdownCoreSystems() has been called. | |
virtual void | BeforeEnterBackground () |
This function is called when an application is moved to the background. | |
virtual void | BeforeEnterForeground () |
This function is called whenever an application is resumed from background mode. | |
void | SetReturnCode (xiiInt32 iReturnCode) |
Sets the value that the application will return to the OS. You can call this function at any point during execution to update the return value of the application. Default is zero. | |
xiiInt32 | GetReturnCode () const |
Returns the currently set value that the application will return to the OS. | |
virtual const char * | TranslateReturnCode () const |
If the return code is not zero, this function might be called to get a string to print the error code in human readable form. | |
void | SetCommandLineArguments (xiiUInt32 uiArgumentCount, const char **pArguments) |
Will set the command line arguments that were passed to the app by the OS. This is automatically called by XII_APPLICATION_ENTRY_POINT() and XII_CONSOLEAPP_ENTRY_POINT(). | |
xiiUInt32 | GetArgumentCount () const |
Returns the number of command line arguments that were passed to the application. | |
const char * | GetArgument (xiiUInt32 uiArgument) const |
Returns one of the command line arguments that was passed to the application. | |
const char ** | GetArgumentsArray () const |
Returns the complete array of command line arguments that were passed to the application. | |
void | EnableMemoryLeakReporting (bool bEnable) |
bool | IsMemoryLeakReportingEnabled () const |
virtual void | RequestQuit () |
Calling this function requests that the application quits after the current invocation of Run() finishes. | |
XII_ALWAYS_INLINE bool | WasQuitRequested () const |
Returns whether RequestQuit() was called. | |
Private Member Functions | |
virtual xiiResult | BeforeCoreSystemsStartup () override |
This function is called before any kind of engine initialization is done. | |
virtual void | AfterCoreSystemsStartup () override |
This function is called after basic engine initialization has been done. | |
Additional Inherited Members | |
![]() | |
static xiiGameApplication * | GetGameApplicationInstance () |
Returns the xiiGameApplication singleton. | |
static xiiStringView | GetActiveRenderer () |
Returns the active renderer of the current app. Either the default or overridden via -render command line flag. | |
static void | SetOverrideDefaultDeviceCreator (xiiDelegate< xiiSharedPtr< xiiGALDevice >(const xiiGALDeviceCreationDescription &)> creator) |
When the graphics device is created, by default the game application will pick a platform specific implementation. This function allows to override that by setting a custom function that creates a graphics device. | |
static xiiGameApplicationBase * | GetGameApplicationBaseInstance () |
Returns the xiiGameApplicationBase singleton. | |
![]() | |
static xiiApplication * | GetApplicationInstance () |
Returns the one instance of xiiApplication that is available. | |
xiiCopyOnBroadcastEvent< const xiiGameApplicationExecutionEvent & > | m_ExecutionEvents |
![]() | |
static xiiCVarBool | cvar_AppVSync |
static xiiCVarBool | cvar_AppShowFPS |
![]() | |
virtual void | Init_ConfigureAssetManagement () override |
virtual void | Init_LoadRequiredPlugins () override |
virtual void | Init_SetupGraphicsDevice () override |
virtual void | Deinit_ShutdownGraphicsDevice () override |
virtual bool | IsGameUpdateEnabled () const override |
virtual void | Run_AcquireImage () override |
This function can be used to acquire a new window from a swap-chain or do any other update operations on windows before the multi-threaded rendering and update phase starts. | |
virtual void | Run_WorldUpdateAndRender () override |
virtual void | Run_PresentImage () override |
This function can be used to present the final image to a window. It is run at the end of the rendering phase. It can also be used to inspect the swap-chain e.g. for screenshot purposes before presenting. | |
virtual void | Run_FinishFrame () override |
void | RenderFps () |
void | RenderConsole () |
void | UpdateWorldsAndExtractViews () |
![]() | |
virtual void | BeforeHighLevelSystemsShutdown () override |
This function is called after the application main loop has run for the last time, before engine deinitialization. | |
virtual void | BeforeCoreSystemsShutdown () override |
This function is called after the application main loop has run for the last time, before engine deinitialization. | |
virtual void | Deinit_UnloadPlugins () |
virtual void | Deinit_ShutdownLogging () |
virtual void | StoreScreenshot (xiiImage &&image, xiiStringView sContext={}) |
Called with the result from taking a screenshot. The default implementation writes the image to disk at ':appdata/Screenshots'. | |
void | ExecuteTakeScreenshot (xiiWindowOutputTargetBase *pOutputTarget, xiiStringView sContext={}) |
void | ExecuteFrameCapture (xiiWindowHandle targetWindowHandle, xiiStringView sContext={}) |
virtual xiiUniquePtr< xiiGameStateBase > | CreateGameState () |
Creates a game state for the application to use. | |
virtual void | ActivateGameStateAtStartup () |
Allows to override whether a game state is created and activated at application startup. | |
virtual xiiString | GetBaseDataDirectoryPath () const |
Returns the target of the 'base' data directory. | |
virtual xiiString | GetProjectDataDirectoryPath () const |
Returns the target of the 'project' data directory. | |
virtual void | ExecuteBaseInitFunctions () |
Executes all 'BaseInit_' functions. Typically done very early, before core system startup. | |
virtual void | BaseInit_ConfigureLogging () |
virtual void | ExecuteInitFunctions () |
Executes all 'Init_' functions. Typically done after core system startup. | |
virtual void | Init_PlatformProfile_SetPreferred () |
virtual void | Init_ConfigureTelemetry () |
virtual void | Init_FileSystem_SetSpecialDirs () |
virtual void | Init_FileSystem_ConfigureDataDirs () |
virtual void | Init_LoadWorldModuleConfig () |
virtual void | Init_PlatformProfile_LoadForRuntime () |
virtual void | Init_ConfigureCVars () |
virtual void | Run_InputUpdate () |
virtual void | Run_BeforeWorldUpdate () |
virtual void | Run_AfterWorldUpdate () |
virtual void | Run_UpdatePlugins () |
void | UpdateFrameTime () |
![]() | |
xiiString | m_sAppProjectPath |
Stores what is given to the constructor. | |
bool | m_bIgnoreErrors = false |
xiiSharedPtr< xiiDelegateTask< void > > | m_pUpdateTask |
bool | m_bShowConsole = false |
xiiUniquePtr< xiiQuakeConsole > | m_pConsole |
bool | m_bTakeScreenshot = false |
xiiConsoleFunction< void()> | m_ConFunc_TakeScreenshot |
expose TakeScreenshot() as a console function | |
bool | m_bContinuousFrameCapture = false |
bool | m_bCaptureFrame = false |
xiiConsoleFunction< void()> | m_ConFunc_CaptureFrame |
expose CaptureFrame() as a console function | |
xiiUniquePtr< xiiGameStateBase > | m_pGameState |
xiiPlatformProfile | m_PlatformProfile |
xiiEventSubscriptionID | m_LogToConsoleID = 0 |
xiiEventSubscriptionID | m_LogToVsID = 0 |
xiiEvent< const xiiGameApplicationStaticEvent & > | m_StaticEvents |
xiiTime | m_FrameTime |
![]() | |
bool | m_bWasQuitRequested = false |
![]() | |
static xiiGameApplication * | s_pGameApplicationInstance = nullptr |
static xiiDelegate< xiiSharedPtr< xiiGALDevice >(const xiiGALDeviceCreationDescription &)> | s_DefaultDeviceCreator |
static xiiGameApplicationBase * | s_pGameApplicationBaseInstance = nullptr |
|
overrideprivatevirtual |
This function is called after basic engine initialization has been done.
xiiApplication will automatically call xiiStartup::StartupCoreSystems() to initialize the application. This function can be overridden to do additional application specific initialization. To startup entire subsystems, you should however use the features provided by xiiStartup and xiiSubSystem.
Reimplemented from xiiGameApplicationBase.
|
overrideprivatevirtual |
This function is called before any kind of engine initialization is done.
Override this function to be able to configure subsystems, before they are initialized. After this function returns, xiiStartup::StartupCoreSystems() is automatically called. If you need to set up custom allocators, this is the place to do this.
Reimplemented from xiiGameApplicationBase.
|
inlineoverrideprivatevirtual |
Reimplemented from xiiGameApplication.
|
inlineoverrideprivatevirtual |
Reimplemented from xiiGameApplicationBase.
|
inlineoverrideprivatevirtual |
Reimplemented from xiiGameApplicationBase.
|
inlineoverrideprivatevirtual |
Reimplemented from xiiGameApplication.
|
overridevirtual |
Main run function which is called periodically. This function must be overridden.
Return Execution::Quit when the application should quit. You may set a return code via SetReturnCode() beforehand.
Reimplemented from xiiGameApplicationBase.
|
inlineoverrideprivatevirtual |
Reimplemented from xiiGameApplication.