70 lines
2.1 KiB
C++
70 lines
2.1 KiB
C++
// Copyright Epic Games, Inc. All Rights Reserved.
|
|
|
|
#pragma once
|
|
|
|
#include "Modules/ModuleManager.h"
|
|
|
|
namespace UE::Trace
|
|
{
|
|
class FStoreClient;
|
|
}
|
|
|
|
/**
|
|
* The public interface to this module
|
|
*/
|
|
class IStateTreeModule : public IModuleInterface
|
|
{
|
|
|
|
public:
|
|
|
|
/**
|
|
* Singleton-like access to this module's interface. This is just for convenience!
|
|
* Beware of calling this during the shutdown phase, though. Your module might have been unloaded already.
|
|
*
|
|
* @return Returns singleton instance, loading the module on demand if needed
|
|
*/
|
|
static IStateTreeModule& Get()
|
|
{
|
|
return FModuleManager::LoadModuleChecked<IStateTreeModule>("StateTreeModule");
|
|
}
|
|
|
|
/**
|
|
* Checks to see if this module is loaded and ready. It is only valid to call Get() if IsAvailable() returns true.
|
|
*
|
|
* @return True if the module is loaded and ready to use
|
|
*/
|
|
static bool IsAvailable()
|
|
{
|
|
return FModuleManager::Get().IsModuleLoaded("StateTreeModule");
|
|
}
|
|
|
|
/**
|
|
* Creates new tracing connection if necessary and enables StateTree debugging related channels (frame + statetree).
|
|
* If traces are already active we keep track of all channels previously activated to restore them on stop.
|
|
* @param OutTraceId In case a connection is already active this indicates its id, 0 otherwise.
|
|
* @return True if a new trace connection was created, false otherwise (already active or not created)
|
|
* @note Even if it returns false this can still have enabled StateTree related channels, OutTraceId will indicate
|
|
* which trace to use and StopTraces should be called to restore to previous setup.
|
|
*/
|
|
virtual bool StartTraces(int32& OutTraceId) = 0;
|
|
|
|
/**
|
|
* Stops the trace service if it was not already connected when StartTraces was called.
|
|
* Restores previously enabled channels if necessary.
|
|
*/
|
|
virtual void StopTraces() = 0;
|
|
|
|
/**
|
|
* Indicates if the statetree specific traces are active (explicitly started by StartTraces).
|
|
* @return True is StartTraces was called, false otherwise.
|
|
*/
|
|
virtual bool IsTracing() const = 0;
|
|
|
|
#if WITH_STATETREE_TRACE_DEBUGGER
|
|
/**
|
|
* Gets the store client.
|
|
*/
|
|
virtual UE::Trace::FStoreClient* GetStoreClient() = 0;
|
|
#endif // WITH_STATETREE_TRACE_DEBUGGER
|
|
};
|