TrueReality  v0.1.1912
trManager::DirectorBase Class Referenceabstract

A director base. More...

#include <DirectorBase.h>

Inheritance diagram for trManager::DirectorBase:
Collaboration diagram for trManager::DirectorBase:

Public Types

using BaseClass = trManager::ActorBase
 
- Public Types inherited from trManager::ActorBase
using BaseClass = trManager::EntityBase
 
- Public Types inherited from trManager::EntityBase
using BaseClass = trBase::Base
 
- Public Types inherited from trBase::Base
using BaseClass = trBase::SmrtClass
 
- Public Types inherited from trBase::SmrtClass
using BaseClass = osg::Referenced
 

Public Member Functions

 DirectorBase (const std::string &name=CLASS_TYPE)
 Holds the class type name for efficient comparisons. More...
 
virtual const std::string & GetType () const override=0
 Returns the class type. More...
 
virtual void OnTick (const trManager::MessageBase &msg)
 Function that will receive Tick Messages from the System Manager. More...
 
virtual void OnMessage (const trManager::MessageBase &msg)
 Function that is used by the Systems Manager to deliver all messages to the Director. More...
 
virtual void BuildInvokables () override
 Builds the default invokables for this class. More...
 
virtual trManager::DirectorPriorityGetDirectorPriority () const
 Returns the Directors message priority. More...
 
virtual void SetDirectorPriority (trUtil::EnumerationPointer< trManager::DirectorPriority > priority)
 Sets the Directors message priority. More...
 
- Public Member Functions inherited from trManager::ActorBase
 ActorBase (const std::string &name=CLASS_TYPE)
 Holds the class type name for efficient comparisons. More...
 
virtual void RegisterForMessage (const std::string &messageType, const std::string &invokableName)
 Registers an actor for messages. More...
 
virtual void UnRegisterFromMessage (const std::string &messageType)
 Unregister an actor that is listening for a given message. More...
 
virtual void RegisterForMessagesAboutEntity (const trBase::UniqueId &aboutEntityId, const std::string &invokableName)
 Registers for messages about a specific actor. More...
 
virtual void UnregisterFromMessagesAboutEntity (const trBase::UniqueId &aboutEntityId)
 Unregisters from messages about a specific actor. More...
 
virtual void OnTickRemote (const trManager::MessageBase &msg)
 Convenience function that will receive a Network Tick Message from the System Manager This does not happen automatically, each class needs to register for the message. More...
 
virtual bool SendMessage (const trManager::MessageBase &message)
 Send a message to an Actor, Actor Module, or a Director. More...
 
virtual bool SendNetworkMessage (const trManager::MessageBase &message)
 Send a Network message to an Actor, Actor Module, or a Director. More...
 
virtual bool AddActorModule (trManager::EntityBase &actorModule)
 Adds an Actor Module to the current Actor. More...
 
virtual bool RemoveActorModule (trManager::EntityBase &actorModule)
 Removes the given Actor Module from the current Actor. More...
 
virtual bool RemoveActorModule (const trBase::UniqueId &id)
 Removes the given Actor Module from the current Actor. More...
 
virtual bool RemoveAllActorModules ()
 
virtual trManager::EntityBaseFindActorModule (const trBase::UniqueId &id)
 Finds and returns the Actor Module cast down to Entity. More...
 
virtual void OnAddedToSysMan () override
 Called by the System Manager when EntityBase Registration is complete. More...
 
virtual void OnRemovedFromSysMan () override
 Called by the System Manager after removing and Unregistering the EntityBase. More...
 
- Public Member Functions inherited from trManager::EntityBase
 EntityBase (const std::string &name=CLASS_TYPE)
 Invokable for Tick Remote messages. More...
 
const EntityTypeGetEntityType ()
 Returns the Entity Type, which is usually a Director, Actor, or an Actor module. More...
 
virtual void SetSystemManager (trManager::SystemManager *sysMan)
 This method is used by the System Manager to pass the Entity an instance if itself when it is registered. More...
 
virtual const bool & IsRegistered ()
 Returns True if the Instance is registered with a System Manager. More...
 
virtual void SetRegistration (bool isRegistered)
 Is set to True by the System Manager when the class instance is registered with it. More...
 
virtual void AddInvokable (trManager::Invokable &newInvokable)
 Adds an invokable that can receive a message. More...
 
virtual void RemoveInvokable (trManager::Invokable *invokable)
 Removes the invokable that is passed in. More...
 
virtual void RemoveInvokable (const std::string &invokableName)
 Removes the invokable described by invokableName. More...
 
trManager::InvokableGetInvokable (const std::string &name)
 Gets a registered invokable. More...
 
void GetInvokables (std::vector< trManager::Invokable *> &toFill)
 Gets the list of invokables. More...
 
void GetInvokables (std::vector< const trManager::Invokable *> &toFill) const
 Gets the invokables. More...
 
virtual bool AddChild (trManager::EntityBase &child)
 Adds a child to this Entity. More...
 
virtual bool RemoveChild (trManager::EntityBase &child)
 Removes the child from this Entity. More...
 
virtual bool RemoveAllChildren ()
 Removes all of the entities children . More...
 
virtual std::vector< trBase::SmrtPtr< trManager::EntityBase > > * GetChildren ()
 
virtual const std::vector< trBase::SmrtPtr< trManager::EntityBase > > * GetChildren () const
 
virtual const trManager::EntityBaseFindChild (const trBase::UniqueId &childId)
 Finds a child of this Entity in the children list. More...
 
virtual int GetNumOfChildren ()
 Gets the children of this Entity has. More...
 
virtual void SetParent (trManager::EntityBase &parent)
 Sets the hierarchal parent of this Entity. More...
 
virtual void ForgetParent ()
 Forgets the hierarchal parent of this Entiry. More...
 
trManager::EntityBaseGetParent ()
 Gets the parent of this hierarchal Entity. More...
 
const trManager::EntityBaseGetParent () const
 Gets the parent of this hierarchal Entity. More...
 
virtual void OnParentRemoved (trManager::EntityBase &parent)
 Convenience function that will be called by the system when the Entities parent is removed. More...
 
virtual void OnParentSet (trManager::EntityBase &parent)
 Convenience function that will be called by the system when a new parent is added or set to the Entity. More...
 
virtual void Emancipate ()
 Removes the hierarchal parent of this Entity, and removes this Entity from the parent. More...
 
virtual bool RemoveFromHierarchy ()
 Removes from this entity from the hierarchy tree attaching its children to its parent. More...
 
- Public Member Functions inherited from trBase::Base
 Base (const std::string &name=CLASS_TYPE)
 Holds the class type name for efficient comparisons. More...
 
virtual void SetName (const std::string &name)
 Sets this instances name. More...
 
virtual const std::string & GetName ()
 Returns this instances name. More...
 
virtual const std::string & GetName () const
 Returns this instances name. More...
 
virtual void SetUUID (const trBase::UniqueId &id)
 Overwrites the default internal UUID with the passed in one. More...
 
virtual const trBase::UniqueIdGetUUID (void)
 Returns the instances Universally Unique ID. More...
 
- Public Member Functions inherited from trBase::SmrtClass
 SmrtClass ()
 Adds an easy and swappable access to the base class. More...
 
 SmrtClass (bool threadSafeRefUnref)
 Constructor. More...
 
 SmrtClass (const SmrtClass &inst)
 Copy constructor. More...
 
virtual bool GetThreadSafeRefUnref ()
 Get whether a mutex is used to ensure Ref() and UnRef() are thread safe. More...
 
OpenThreads::Mutex * GetRefMutex () const
 Get the mutex used to ensure thread safety of Ref()/UnRef(). More...
 
int Ref () const
 Increment the reference count by one, indicating that this object has another pointer which is referencing it. More...
 
int Unref () const
 Decrement the reference count by one, indicating that a pointer to this object is no longer referencing it. More...
 
int UnRefNoDelete () const
 Decrement the reference count by one, indicating that a pointer to this object is no longer referencing it. More...
 
int ReferenceCount () const
 Return the number of pointers currently referencing this object. More...
 

Static Public Member Functions

static bool CompareComponentPriority (const trBase::SmrtPtr< trManager::EntityBase > &first, const trBase::SmrtPtr< trManager::EntityBase > &second)
 Local function used to compare priorities of Directors. More...
 
- Static Public Member Functions inherited from trBase::SmrtClass
static OpenThreads::Mutex * GetGlobalReferencedMutex ()
 Get the optional global Referenced mutex, this can be shared between all trBase::SmrtClass. More...
 

Static Public Attributes

static const trUtil::RefStr CLASS_TYPE = trUtil::RefStr("trManager::DirectorBase")
 Adds an easy and swappable access to the base class. More...
 
- Static Public Attributes inherited from trManager::ActorBase
static const trUtil::RefStr CLASS_TYPE
 Adds an easy and swappable access to the base class. More...
 
- Static Public Attributes inherited from trManager::EntityBase
static const trUtil::RefStr CLASS_TYPE
 Adds an easy and swappable access to the base class. More...
 
static const trUtil::RefStr ON_MESSAGE_INVOKABLE
 Holds the class type name for efficient comparisons. More...
 
static const trUtil::RefStr ON_TICK_INVOKABLE
 Invokable for general messages. More...
 
static const trUtil::RefStr ON_TICK_REMOTE_INVOKABLE
 Invokable for Tick messages. More...
 
- Static Public Attributes inherited from trBase::Base
static const trUtil::RefStr CLASS_TYPE = trUtil::RefStr("trBase::Base")
 Adds an easy and swappable access to the base class. More...
 

Protected Member Functions

 ~DirectorBase ()
 dtor. More...
 
- Protected Member Functions inherited from trManager::ActorBase
 ~ActorBase ()
 dtor. More...
 
virtual void ActorModuleTick (const trManager::MessageBase &tickMsg)
 Sends the passed in message Tick Message to all attached Actor Modules. More...
 
- Protected Member Functions inherited from trManager::EntityBase
 ~EntityBase ()
 
- Protected Member Functions inherited from trBase::Base
 ~Base ()
 Base destructor. More...
 
- Protected Member Functions inherited from trBase::SmrtClass
 ~SmrtClass ()
 

Private Attributes

trUtil::EnumerationPointer< trManager::DirectorPrioritymDirectorPriority
 

Additional Inherited Members

- Protected Attributes inherited from trManager::EntityBase
trBase::ObsrvrPtr< trManager::SystemManagermSysMan
 
trUtil::EnumerationPointer< const trManager::EntityTypemEntityType
 
trUtil::HashMap< std::string, trBase::SmrtPtr< trManager::Invokable > > mInvokables
 

Detailed Description

A director base.

Serves as the base class for all directors in the Entity System. A director should be used as a general manager for an overarching subsystem in the software.

Definition at line 39 of file DirectorBase.h.

Member Typedef Documentation

◆ BaseClass

Constructor & Destructor Documentation

◆ DirectorBase()

trManager::DirectorBase::DirectorBase ( const std::string &  name = CLASS_TYPE)

Holds the class type name for efficient comparisons.

ctor.

Parameters
name(Optional) The name.

Definition at line 34 of file DirectorBase.cpp.

References BuildInvokables(), trManager::EntityType::DIRECTOR, mDirectorPriority, trManager::EntityBase::mEntityType, and trManager::DirectorPriority::NORMAL.

Here is the call graph for this function:

◆ ~DirectorBase()

trManager::DirectorBase::~DirectorBase ( )
protected

dtor.

Definition at line 42 of file DirectorBase.cpp.

Member Function Documentation

◆ BuildInvokables()

void trManager::DirectorBase::BuildInvokables ( )
overridevirtual

Builds the default invokables for this class.

Reimplemented from trManager::ActorBase.

Definition at line 82 of file DirectorBase.cpp.

References trManager::EntityBase::AddInvokable(), trUtil::MakeFunctor(), trManager::EntityBase::ON_MESSAGE_INVOKABLE, and OnMessage().

Referenced by DirectorBase().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ CompareComponentPriority()

bool trManager::DirectorBase::CompareComponentPriority ( const trBase::SmrtPtr< trManager::EntityBase > &  first,
const trBase::SmrtPtr< trManager::EntityBase > &  second 
)
static

Local function used to compare priorities of Directors.

Parameters
firstThe first.
secondThe second.
Returns
True if it succeeds, false if it fails.

Definition at line 47 of file DirectorBase.cpp.

References trManager::EntityType::DIRECTOR, trBase::SmrtPtr< T >::Get(), GetDirectorPriority(), trManager::EntityBase::GetEntityType(), trUtil::EnumerationNumeric::GetID(), LOG_E, and trBase::SmrtPtr< T >::Valid().

Referenced by trManager::SystemManager::RegisterDirector().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GetDirectorPriority()

trManager::DirectorPriority & trManager::DirectorBase::GetDirectorPriority ( ) const
virtual

Returns the Directors message priority.

Returns
The director priority.

Definition at line 88 of file DirectorBase.cpp.

References mDirectorPriority.

Referenced by CompareComponentPriority().

Here is the caller graph for this function:

◆ GetType()

const std::string & trManager::DirectorBase::GetType ( ) const
overridepure virtual

Returns the class type.

Returns
The type.

Implements trManager::ActorBase.

Implemented in trCore::SystemDirector.

◆ OnMessage()

void trManager::DirectorBase::OnMessage ( const trManager::MessageBase msg)
virtual

Function that is used by the Systems Manager to deliver all messages to the Director.

Parameters
msgThe message.

Reimplemented in trCore::SystemDirector.

Definition at line 76 of file DirectorBase.cpp.

Referenced by BuildInvokables().

Here is the caller graph for this function:

◆ OnTick()

void trManager::DirectorBase::OnTick ( const trManager::MessageBase msg)
virtual

Function that will receive Tick Messages from the System Manager.

Parameters
msgThe message.

Implements trManager::ActorBase.

Definition at line 70 of file DirectorBase.cpp.

◆ SetDirectorPriority()

void trManager::DirectorBase::SetDirectorPriority ( trUtil::EnumerationPointer< trManager::DirectorPriority priority)
virtual

Sets the Directors message priority.

This should only be used by the System Manager.

Parameters
priorityThe priority.

Definition at line 94 of file DirectorBase.cpp.

References mDirectorPriority.

Member Data Documentation

◆ CLASS_TYPE

const trUtil::RefStr trManager::DirectorBase::CLASS_TYPE = trUtil::RefStr("trManager::DirectorBase")
static

Adds an easy and swappable access to the base class.

Definition at line 44 of file DirectorBase.h.

◆ mDirectorPriority

trUtil::EnumerationPointer<trManager::DirectorPriority> trManager::DirectorBase::mDirectorPriority
private

Definition at line 130 of file DirectorBase.h.

Referenced by DirectorBase(), GetDirectorPriority(), and SetDirectorPriority().


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