Plasma Engine  2.0
Loading...
Searching...
No Matches
Public Member Functions | Static Public Member Functions | Public Attributes | Protected Member Functions | Protected Attributes | Friends | List of all members
plEngineProcessDocumentContext Class Referenceabstract

A document context is the counter part to an editor document on the engine side. More...

#include <EngineProcessDocumentContext.h>

Inheritance diagram for plEngineProcessDocumentContext:
Inheritance graph
[legend]

Public Member Functions

 plEngineProcessDocumentContext (plBitflags< plEngineProcessDocumentContextFlags > flags)
 
virtual void Initialize (const plUuid &documentGuid, const plVariant &metaData, plEngineProcessCommunicationChannel *pIPC, plStringView sDocumentType)
 
void Deinitialize ()
 
plStringView GetDocumentType () const
 Returns the document type for which this context was created. Useful in case a context may be used for multiple document types.
 
void SendProcessMessage (plProcessMessage *pMsg=nullptr)
 
virtual void HandleMessage (const plEditorEngineDocumentMsg *pMsg)
 
plBoundingBoxSphere GetWorldBounds (plWorld *pWorld)
 
void ProcessEditorEngineSyncObjectMsg (const plEditorEngineSyncObjectMsg &msg)
 
const plUuid & GetDocumentGuid () const
 
virtual void Reset ()
 
void ClearExistingObjects ()
 
virtual plWorldRttiConverterContext & GetContext ()
 
virtual const plWorldRttiConverterContext & GetContext () const
 
plWorld * GetWorld () const
 
virtual plGameObjectHandle ResolveStringToGameObjectHandle (const void *pString, plComponentHandle hThis, plStringView sProperty) const
 Tries to resolve a 'reference' (given in pData) to an plGameObject.
 
- Public Member Functions inherited from plReflectedClass
virtual const plRTTI * GetDynamicRTTI () const
 
bool IsInstanceOf (const plRTTI *pType) const
 Returns whether the type of this instance is of the given type or derived from it.
 
template<typename T >
PL_ALWAYS_INLINE bool IsInstanceOf () const
 Returns whether the type of this instance is of the given type or derived from it.
 

Static Public Member Functions

static plEngineProcessDocumentContext * GetDocumentContext (plUuid guid)
 
static void AddDocumentContext (plUuid guid, const plVariant &metaData, plEngineProcessDocumentContext *pView, plEngineProcessCommunicationChannel *pIPC, plStringView sDocumentType)
 
static bool PendingOperationsInProgress ()
 
static void UpdateDocumentContexts ()
 
static void DestroyDocumentContext (plUuid guid)
 
- Static Public Member Functions inherited from plNoBase
static const plRTTI * GetStaticRTTI ()
 

Public Attributes

plIPCObjectMirrorEngine m_Mirror
 
plWorldRttiConverterContext m_Context
 

Protected Member Functions

virtual void OnInitialize ()
 
virtual void OnDeinitialize ()
 
virtual plEngineProcessViewContext * CreateViewContext ()=0
 Needs to be implemented to create a view context used for windows and thumbnails rendering.
 
virtual void DestroyViewContext (plEngineProcessViewContext *pContext)=0
 Needs to be implemented to destroy the view context created in CreateViewContext.
 
virtual bool PendingOperationInProgress () const
 Should return true if this context has any operation in progress like thumbnail rendering and thus needs to continue rendering even if no new messages from the editor come in.
 
virtual void UpdateDocumentContext ()
 A tick functions that allows each document context to do processing that continues over multiple frames and can't be handled in HandleMessage directly.
 
virtual plStatus ExportDocument (const plExportDocumentMsgToEngine *pMsg)
 Exports to current document resource to file. Make sure to write plAssetFileHeader at the start of it.
 
void UpdateSyncObjects ()
 
void CreateThumbnailViewContext (const plCreateThumbnailMsgToEngine *pMsg)
 Creates the thumbnail view context. It uses 'CreateViewContext' in combination with an off-screen render target.
 
void DestroyThumbnailViewContext ()
 Once a thumbnail is successfully rendered, the thumbnail view context is destroyed again.
 
virtual bool UpdateThumbnailViewContext (plEngineProcessViewContext *pThumbnailViewContext)
 Overwrite this function to apply the thumbnail render settings to the given context.
 
virtual void OnThumbnailViewContextRequested ()
 Called before a thumbnail context is created.
 
virtual void OnThumbnailViewContextCreated ()
 Called after a thumbnail context was created. Allows to insert code before the thumbnail is generated.
 
virtual void OnDestroyThumbnailViewContext ()
 Called before a thumbnail context is destroyed. Used for cleanup of what was done in OnThumbnailViewContextCreated()
 
void SetTagOnObject (const plUuid &object, const char *szTag, bool bSet, bool recursive)
 Sets or removes the given tag on the object and optionally all children.
 
void SetTagRecursive (plGameObject *pObject, const plTag &tag)
 Sets the given tag on the object and all children.
 
void ClearTagRecursive (plGameObject *pObject, const plTag &tag)
 Clears the given tag on the object and all children.
 
const plEngineProcessViewContext * GetViewContext (plUInt32 uiView) const
 

Protected Attributes

plWorld * m_pWorld = nullptr
 
plBitflags< plEngineProcessDocumentContextFlags > m_Flags
 
plUuid m_DocumentGuid
 
plVariant m_MetaData
 
plEngineProcessCommunicationChannel * m_pIPC = nullptr
 
plHybridArray< plEngineProcessViewContext *, 4 > m_ViewContexts
 
plMap< plUuid, plEditorEngineSyncObject * > m_SyncObjects
 

Friends

class plEditorEngineSyncObject
 

Detailed Description

A document context is the counter part to an editor document on the engine side.

For every document in the editor that requires engine output (rendering, picking, etc.), there is a plEngineProcessDocumentContext created in the engine process.

Member Function Documentation

◆ CreateViewContext()

virtual plEngineProcessViewContext * plEngineProcessDocumentContext::CreateViewContext ( )
protectedpure virtual

Needs to be implemented to create a view context used for windows and thumbnails rendering.

Implemented in plAnimatedMeshContext, plAnimationClipContext, plDecalContext, plJoltCollisionMeshContext, plKrautTreeContext, plLayerContext, plMaterialContext, plMeshContext, plParticleContext, plRenderPipelineContext, plRmlUiDocumentContext, plSceneContext, plSkeletonContext, plStateMachineContext, plTextureContext, and plTextureCubeContext.

◆ DestroyViewContext()

virtual void plEngineProcessDocumentContext::DestroyViewContext ( plEngineProcessViewContext * pContext)
protectedpure virtual

Needs to be implemented to destroy the view context created in CreateViewContext.

Implemented in plAnimatedMeshContext, plAnimationClipContext, plDecalContext, plJoltCollisionMeshContext, plKrautTreeContext, plLayerContext, plMaterialContext, plMeshContext, plParticleContext, plRenderPipelineContext, plRmlUiDocumentContext, plSceneContext, plSkeletonContext, plStateMachineContext, plTextureContext, and plTextureCubeContext.

◆ ExportDocument()

plStatus plEngineProcessDocumentContext::ExportDocument ( const plExportDocumentMsgToEngine * pMsg)
protectedvirtual

Exports to current document resource to file. Make sure to write plAssetFileHeader at the start of it.

Reimplemented in plLayerContext, plRenderPipelineContext, plSceneContext, and plStateMachineContext.

◆ OnDestroyThumbnailViewContext()

void plEngineProcessDocumentContext::OnDestroyThumbnailViewContext ( )
protectedvirtual

Called before a thumbnail context is destroyed. Used for cleanup of what was done in OnThumbnailViewContextCreated()

Reimplemented in plSceneContext.

◆ OnThumbnailViewContextCreated()

void plEngineProcessDocumentContext::OnThumbnailViewContextCreated ( )
protectedvirtual

Called after a thumbnail context was created. Allows to insert code before the thumbnail is generated.

Reimplemented in plSceneContext.

◆ OnThumbnailViewContextRequested()

virtual void plEngineProcessDocumentContext::OnThumbnailViewContextRequested ( )
inlineprotectedvirtual

Called before a thumbnail context is created.

Reimplemented in plParticleContext.

◆ ResolveStringToGameObjectHandle()

plGameObjectHandle plEngineProcessDocumentContext::ResolveStringToGameObjectHandle ( const void * pData,
plComponentHandle hThis,
plStringView sComponentProperty ) const
virtual

Tries to resolve a 'reference' (given in pData) to an plGameObject.

Tries to resolve a 'reference' (given in pData) to an plGameObject. hThis is the 'owner' of the reference and szComponentProperty is the name of the reference property in that component.

There are two different use cases:

1) hThis is invalid and szComponentProperty is null:

This is used by plPrefabReferenceComponent::SerializeComponent() to check whether a string represents a game object reference. It may be any arbitrary string and thus must not assert. In this case a reference is always a stringyfied GUID. Since this is only used for scene export, only the lookup shall be done and nothing else.

2) hThis and szComponentProperty represent a valid component+property combination:

This is called at edit time whenever a reference property is queried, which also happens whenever a reference is modified. In this case we need to maintain two maps: one that know which object references which other objects one that knows by which other objects an object is referenced These are needed to fix up references during undo/redo when objects get deleted and recreated. Ie. when an object that has references or is referenced gets deleted and then undo restores it, the references should appear as well.

Reimplemented in plSceneContext.

◆ UpdateDocumentContext()

void plEngineProcessDocumentContext::UpdateDocumentContext ( )
protectedvirtual

A tick functions that allows each document context to do processing that continues over multiple frames and can't be handled in HandleMessage directly.

Make sure to call the base implementation when overwriting as this handles the thumbnail rendering that takes multiple frames to complete.

Reimplemented in plLayerContext, and plSceneContext.

◆ UpdateThumbnailViewContext()

bool plEngineProcessDocumentContext::UpdateThumbnailViewContext ( plEngineProcessViewContext * pThumbnailViewContext)
protectedvirtual

Overwrite this function to apply the thumbnail render settings to the given context.

Return false if you need more frames to be rendered to setup everything correctly. If true is returned for 'ThumbnailConvergenceFramesTarget' frames in a row the thumbnail image is taken. This is to allow e.g. camera updates after more resources have been streamed in. The frame counter will start over to count to 'ThumbnailConvergenceFramesTarget' when a new resource is being loaded to make sure we do not make an image of half-streamed in data.

Reimplemented in plAnimatedMeshContext, plAnimationClipContext, plJoltCollisionMeshContext, plKrautTreeContext, plMaterialContext, plMeshContext, plParticleContext, plRmlUiDocumentContext, plSceneContext, and plSkeletonContext.

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