ezEngine  Release 25.03
ezShaderCompilerApplication Class Reference
Inheritance diagram for ezShaderCompilerApplication:

Public Types

using SUPER = ezGameApplication
 
- Public Types inherited from ezGameApplication
using SUPER = ezGameApplicationBase
 
- Public Types inherited from ezGameApplicationBase
using SUPER = ezApplication
 

Public Member Functions

virtual void Run () override
 Main run function which is called periodically. This function must be overridden. More...
 
- Public Member Functions inherited from ezGameApplication
 ezGameApplication (const char *szAppName, const char *szProjectPath)
 szProjectPath may be nullptr, if FindProjectDirectory() is overridden.
 
virtual ezString FindProjectDirectory () const override
 Implementation of ezGameApplicationBase::FindProjectDirectory to define the 'project' special data directory. More...
 
void ReinitializeInputConfig ()
 Used at runtime (by the editor) to reload input maps. Forwards to Init_ConfigureInput()
 
ezStringView GetAppProjectPath () const
 Returns the project path that was given to the constructor (or modified by an overridden implementation).
 
- Public Member Functions inherited from ezGameApplicationBase
 ezGameApplicationBase (ezStringView 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. More...
 
void CaptureFrame ()
 Schedules a frame capture if the corresponding plugin is loaded. More...
 
void SetContinuousFrameCapture (bool bEnable)
 Controls if frame captures are taken continuously (without being persisted) or only on-demand. More...
 
bool GetContinousFrameCapture () const
 
virtual ezResult GetAbsFrameCaptureOutputPath (ezStringBuilder &ref_sOutputPath)
 Get the absolute base output path for frame captures.
 
void ActivateGameState (ezWorld *pWorld, ezStringView sStartPosition, const ezTransform &startPositionOffset)
 Creates and activates the game state for this application. More...
 
void DeactivateGameState ()
 Deactivates and destroys the active game state. More...
 
ezGameStateBaseGetActiveGameState () const
 Returns the currently active game state. Could be nullptr.
 
const ezPlatformProfileGetPlatformProfile () const
 Returns the ezPlatformProfile that has been loaded for this application.
 
void RunOneFrame ()
 
ezTime GetFrameTime () const
 
- Public Member Functions inherited from ezApplication
 ezApplication (ezStringView sAppName)
 Constructor.
 
virtual ~ezApplication ()
 Virtual destructor.
 
void SetApplicationName (ezStringView sAppName)
 Changes the application name.
 
const ezStringGetApplicationName () const
 Returns the application name.
 
virtual void AfterHighLevelSystemsShutdown ()
 Called after ezStartup::ShutdownHighLevelSystems() has been executed.
 
virtual void AfterCoreSystemsShutdown ()
 This function is called after ezStartup::ShutdownCoreSystems() has been called. More...
 
virtual void BeforeEnterBackground ()
 This function is called when an application is moved to the background. More...
 
virtual void BeforeEnterForeground ()
 This function is called whenever an application is resumed from background mode. More...
 
void SetReturnCode (ezInt32 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.
 
ezInt32 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 (ezUInt32 uiArgumentCount, const char **pArguments)
 Will set the command line arguments that were passed to the app by the OS. This is automatically called by EZ_APPLICATION_ENTRY_POINT().
 
ezUInt32 GetArgumentCount () const
 Returns the number of command line arguments that were passed to the application. More...
 
const char * GetArgument (ezUInt32 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 RequestApplicationQuit ()
 Calling this function requests that the application quits after the current invocation of Run() finishes. More...
 
EZ_ALWAYS_INLINE bool ShouldApplicationQuit () const
 Returns whether RequestQuit() was called.
 

Private Member Functions

virtual ezResult BeforeCoreSystemsStartup () override
 This function is called before any kind of engine initialization is done. More...
 
virtual void AfterCoreSystemsStartup () override
 This function is called after basic engine initialization has been done. More...
 

Additional Inherited Members

- Static Public Member Functions inherited from ezGameApplication
static ezGameApplicationGetGameApplicationInstance ()
 Returns the ezGameApplication singleton.
 
static ezStringView GetActiveRenderer ()
 Returns the active renderer of the current app. Either the default or overridden via -render command line flag.
 
static void SetOverrideDefaultDeviceCreator (ezDelegate< ezGALDevice *(const ezGALDeviceCreationDescription &)> 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 Public Member Functions inherited from ezGameApplicationBase
static ezGameApplicationBaseGetGameApplicationBaseInstance ()
 Returns the ezGameApplicationBase singleton.
 
- Static Public Member Functions inherited from ezApplication
static ezApplicationGetApplicationInstance ()
 Returns the one instance of ezApplication that is available.
 
- Public Attributes inherited from ezGameApplicationBase
ezCopyOnBroadcastEvent< const ezGameApplicationExecutionEvent & > m_ExecutionEvents
 
- Static Public Attributes inherited from ezGameApplication
static ezCVarBool cvar_AppVSync
 
static ezCVarBool cvar_AppShowFPS
 
- Protected Member Functions inherited from ezGameApplication
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 ()
 
- Protected Member Functions inherited from ezGameApplicationBase
virtual void BeforeHighLevelSystemsShutdown () override
 This function is called after the application main loop has run for the last time, before engine deinitialization. More...
 
virtual void BeforeCoreSystemsShutdown () override
 This function is called after the application main loop has run for the last time, before engine deinitialization. More...
 
virtual void Deinit_UnloadPlugins ()
 
virtual void Deinit_ShutdownLogging ()
 
virtual void StoreScreenshot (ezImage &&image, ezStringView sContext={})
 Called with the result from taking a screenshot. The default implementation writes the image to disk at ':appdata/Screenshots'.
 
void ExecuteTakeScreenshot (ezWindowOutputTargetBase *pOutputTarget, ezStringView sContext={})
 
void ExecuteFrameCapture (ezWindowHandle targetWindowHandle, ezStringView sContext={})
 
virtual ezUniquePtr< ezGameStateBaseCreateGameState ()
 Creates a game state for the application to use. More...
 
virtual void ActivateGameStateAtStartup ()
 Allows to override whether a game state is created and activated at application startup. More...
 
virtual ezString GetBaseDataDirectoryPath () const
 Returns the target of the 'base' data directory. More...
 
virtual ezString GetProjectDataDirectoryPath () const
 Returns the target of the 'project' data directory. More...
 
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 ()
 
- Protected Attributes inherited from ezGameApplication
ezString m_sAppProjectPath
 Stores what is given to the constructor.
 
ezSharedPtr< ezDelegateTask< void > > m_pUpdateTask
 
bool m_bShowConsole = false
 
ezUniquePtr< ezQuakeConsolem_pConsole
 
- Protected Attributes inherited from ezGameApplicationBase
bool m_bTakeScreenshot = false
 
ezConsoleFunction< void()> m_ConFunc_TakeScreenshot
 expose TakeScreenshot() as a console function
 
bool m_bContinuousFrameCapture = false
 
bool m_bCaptureFrame = false
 
ezConsoleFunction< void()> m_ConFunc_CaptureFrame
 expose CaptureFrame() as a console function
 
ezUniquePtr< ezGameStateBasem_pGameState
 
ezPlatformProfile m_PlatformProfile
 
ezEventSubscriptionID m_LogToConsoleID = 0
 
ezEventSubscriptionID m_LogToVsID = 0
 
ezEvent< const ezGameApplicationStaticEvent & > m_StaticEvents
 
ezTime m_FrameTime
 
- Protected Attributes inherited from ezApplication
bool m_bWasQuitRequested = false
 
- Static Protected Attributes inherited from ezGameApplication
static ezGameApplications_pGameApplicationInstance = nullptr
 
static ezDelegate< ezGALDevice *(const ezGALDeviceCreationDescription &)> s_DefaultDeviceCreator
 
- Static Protected Attributes inherited from ezGameApplicationBase
static ezGameApplicationBases_pGameApplicationBaseInstance = nullptr
 

Member Function Documentation

◆ AfterCoreSystemsStartup()

void ezShaderCompilerApplication::AfterCoreSystemsStartup ( )
overrideprivatevirtual

This function is called after basic engine initialization has been done.

ezApplication will automatically call ezStartup::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 ezStartup and ezSubSystem.

Reimplemented from ezGameApplicationBase.

◆ BeforeCoreSystemsStartup()

ezResult ezShaderCompilerApplication::BeforeCoreSystemsStartup ( )
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, ezStartup::StartupCoreSystems() is automatically called. If you need to set up custom allocators, this is the place to do this.

Reimplemented from ezGameApplicationBase.

◆ Run()

void ezShaderCompilerApplication::Run ( )
overridevirtual

Main run function which is called periodically. This function must be overridden.

Call RequestApplicationQuit() at any point to prevent Run() from being called again.

Reimplemented from ezGameApplicationBase.


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