Editable entity representing a player. More...

Inheritance diagram for SCR_EditablePlayerDelegateComponent:

Public Member Functions
void	InitPlayerDelegate (SCR_EditorManagerEntity editorManager, int playerID)
	Initialise the delegate.

override int	GetPlayerID ()
	Get ID of player this delegates represents.

ScriptInvoker	GetOnLimitedEditorChanged ()
	Get script invoker called when editor belonging to this player become limited (e.g., only photo mode, without any editing capabilities), or vice versa.

bool	HasLimitedEditor ()
	Check if the player has access only to limited editor (e.g., only photo mode, without any editing capabilities).

void	SetControlledEntity (IEntity controlledEntity)
	Update reference to editable entity controlled by the player this delegate represents.

SCR_EditableEntityComponent	GetControlledEntity ()
	Get reference to editable entity controlled by the player this delegate represents.

override EEditableEntityType	GetEntityType (IEntity owner=null)
	Get entity type.

override SCR_UIInfo	GetInfo (IEntity owner=null)
	Get information about the entity.

override ScriptInvoker	GetOnUIReset ()
	Get event called when GUI should reset widgets that are used for entity visualization.

override Faction	GetFaction ()
	Get entity's faction.

override SCR_EditableEntityComponent	GetAIGroup ()
	Get entity's AI group.

override SCR_EditableEntityComponent	GetVehicle ()
	Get vehicle the entity's in.

override float	GetHealth ()
	Get entity health.

override bool	GetEntityBudgetCost (out notnull array< ref SCR_EntityBudgetValue > outBudgets, IEntity owner=null)
	Get entity budget costs.

override bool	GetPos (out vector pos)
	Get position representing the entity.

override string	GetLogText (string prefix="")

override bool	RplSave (ScriptBitWriter writer)

override bool	RplLoad (ScriptBitReader reader)

override void	OnPostInit (IEntity owner)

void	~SCR_EditablePlayerDelegateComponent ()

Public Member Functions inherited from SCR_EditableEntityComponent
string	GetDisplayName ()
	Get entity name from info component.

ResourceName	GetPrefab (bool shorten=false)
	Get entity prefab.

SCR_EditableEntityComponentClass	GetEditableEntityData (IEntity owner=null)
	Get prefab data of this editable entity.

SCR_EditableEntityInteraction	GetEntityInteraction (IEntity owner=null)
	Get entity interaction rules of this entity.

ScriptInvokerEntity	GetOnDeleted ()
	Get event called when entity is deleted.

void	SetInfoInstance (SCR_UIInfo info)
	Set information about the entity on entity instance, locally on this machine.

bool	IsReplicated (out RplId replicationID=-1)
	Check component's replication.

bool	Serialize (out SCR_EditableEntityComponent outTarget=null, out int outTargetIndex=-1, out EEditableEntitySaveFlag outSaveFlags=0)
	Check if the entity can be serialized during session saving managed by SCR_EditableEntityStruct.

void	Deserialize (SCR_EditableEntityComponent target, int targetValue)
	Deserialise the entity based on given params.

GenericEntity	GetOwnerScripted ()

vector	GetIconPos ()
	Get icon offset.

bool	GetTransform (out vector outTransform[4])
	Get world transformation matrix of editable entity.

bool	GetLocalTransform (out vector outTransform[4])
	Get local transformation matrix of editable entity.

void	SetAuthor (int playerID)
	Sets AuthorID (player that modified this entity last) in Session.

void	SetAuthor (SCR_EditableEntityAuthor author)
	Sets AuthorID (player that modified this entity last) from a Save.

SCR_EditableEntityAuthor	GetAuthor ()

string	GetAuthorUID ()
	Returns author UID.

string	GetAuthorPlatformID ()
	Returns author Platform ID.

int	GetAuthorPlayerID ()
	Returns author Player ID.

int	GetAuthorLastUpdated ()
	Returns Unix Time of last modification.

PlatformKind	GetAuthorPlatform ()
	Returns Unix Time of last modification.

void	SetAuthorUID (string authorUID)
	Set Author UID (for normal usage use SetAuthor())

void	SetAuthorPlatformID (string authorPlatformID)

void	SetAuthorUpdatedTime (int updatedLast)
	Set Time of last update.

void	SetAuthorPlatform (PlatformKind authorPlatform)

ScriptInvoker	GetOnUIRefresh ()
	Get event called when GUI should refresh entity's GUI, i.e., update faction color and call events in GUI widgets.

SCR_EditableEntityComponent	GetAIEntity ()
	Get entity which represents this entity as AI.

int	GetCrew (out notnull array< CompartmentAccessComponent > crewCompartmentAccess, bool ignorePlayers=true)
	Get crew of vehicle or if in a vehicle get self.

bool	CanDestroy ()

bool	IsDestroyed ()
	Check if the entity is destroyed.

void	SetStatic (bool isStatic)
	Set entity as static.

bool	GetStatic ()
	Check if the entity is marked as static.

void	UpdateStaticPos ()
	Update static cached position.

void	SetHierarchyAsDirtyInParents ()
	Mark hierarchy in all parents of the entity as dirty, i.e., modified by user.

void	SetHierarchyAsDirty ()
	Mark entity hierarchy as dirty, i.e., modified by user.

void	SetTransformWithChildren (vector transform[4])
	Update transformation of the entity and all its editor children and broadcast the changes to all clients.

void	SetTransform (vector transform[4], bool changedByUser=false)
	Update entity's transformation and broadcast the changes to all clients.

bool	Destroy ()
	Kill/destroy this editable entity.

bool	Delete (bool changedByUser=false, bool updateNavmesh=false)
	Delete this editable entity.

RplId	GetOwnerRplId ()

float	GetMaxDrawDistanceSq ()
	Get squared maximum distance in which this entity is drawn in editor (e.g., with an icon).

void	SetMaxDrawDistance (float maxDrawDistance)
	Set maximum distance in which this entity is drawn in editor (e.g., with an icon).

bool	GetEntityChildrenBudgetCost (out notnull array< ref SCR_EntityBudgetValue > outBudgets, IEntity owner=null)
	Get entity budget costs including cost of children (for groups/compositions)

bool	GetEntityAndChildrenBudgetCost (out notnull array< ref SCR_EntityBudgetValue > outBudgets, IEntity owner=null)
	Get budgets for both, entity and it's children.

bool	CanDuplicate (out notnull set< SCR_EditableEntityComponent > outRecipients)
	Can entity be duplicated by editor and which recipients should be passed to the duplicated entity Overridden by other EditableEntityComponents.

void	ForceVehicleCompartments (notnull array< ECompartmentType > forceVehicleCompartments)
	Authority Only, forces entities such as Character and Group to place characters into a specific vehicle position.

void	OnCreatedServer (notnull SCR_PlacingEditorComponent placedEditorComponent)

bool	HasEntityState (EEditableEntityState state)
	Check if given entity state is active.

EEditableEntityState	GetEntityStates ()
	Check bit array with all currently active states.

void	SetEntityState (EEditableEntityState state, bool toSet)
	Set value of an entity state.

void	ResetEntityStates ()
	Reset all entity states.

bool	HasEntityFlag (EEditableEntityFlag flag)
	Check if a flag is active.

EEditableEntityFlag	GetEntityFlags ()
	Get entity flags.

void	SetEntityFlag (EEditableEntityFlag flag, bool toSet)
	Set entity flag.

void	CopyEntityFlags (EEditableEntityFlag flags)
	Override the Entity flags.

void	Log (string prefix="", bool onlyDirect=false, LogLevel logLevel=LogLevel.DEBUG)
	Print out entity information.

void	Log (string prefix, EEditableEntityAccessKey accessKey)
	Print out the entity and all its descendants which are compatible with given key.

void	LogAccessKey ()
	Print out entity's access key.

SCR_EditableEntityComponent	EOnEditorPlace (out SCR_EditableEntityComponent parent, SCR_EditableEntityComponent recipient, EEditorPlacingFlags flags, bool isQueue, int playerID=0)
	Event called on server when the entity is placed in the editor.

void	EOnEditorSessionLoad (SCR_EditableEntityComponent parent)
	Event called on server when the session is being loaded by SCR_EditableEntityStruct.

override void	OnDelete (IEntity owner)

void	SCR_EditableEntityComponent (IEntityComponentSource src, IEntity ent, IEntity parent)

void	Attach (notnull SCR_EditableEntityComponent attachable)
	Add the received attachable waypoint to the attached entities (runs on parent)

void	Detach (notnull SCR_EditableEntityComponent attachable)
	Removes the received attachable waypoint from the attached entities (runs on parent)

set< SCR_EditableEntityComponent >	GetAttachedEntities ()
	Returns attached entities of self.

bool	IsAttachable ()
	Returns if current entity is attachable.

bool	IsAttached ()
	Returns if current entity is attached.

SCR_EditableEntityComponent	GetAttachedTo ()
	Returns current entity which this editable task is attached to.

bool	CanSetParent (SCR_EditableEntityComponent parentEntity)
	Check if the entity can be moved to intended parent.

SCR_EditableEntityComponent	SetParentEntity (SCR_EditableEntityComponent parentEntity, bool changedByUser=false)
	Set parent of the entity.

void	RestoreParentEntity ()
	Add the entity to its previous parent after it was unregistered using RemoveParentEntity() Allowed only on server.

void	RemoveParentEntity ()
	Remove entity from its parent.

SCR_EditableEntityComponent	GetParentEntity ()
	Get parent entity.

void	GetParentEntities (out notnull array< SCR_EditableEntityComponent > entities)
	Get hierarchy of all parent entities, all the way to the root.

bool	IsChildOf (SCR_EditableEntityComponent entity)
	Check if the entity is in hierarchy of given entity.

set< SCR_EditableEntityComponent >	GetChildrenRef ()
	Get direct reference to entity's immediate children.

void	GetChildren (out notnull set< SCR_EditableEntityComponent > entities, bool onlyDirect=false, bool skipIgnored=false)
	Get child entities.

void	GetChildren (out notnull set< SCR_EditableEntityComponent > entities, bool onlyDirect, EEditableEntityAccessKey accessKey)
	Get child entities with compatible key.

int	GetChildrenCount (bool onlyDirect=false)
	Get number of child entities.

SCR_EditableEntityComponent	GetChild (int index)
	Get child on given index.

bool	IsLayer ()
	Check if the entity is also a layer, i.e., has some child entities.

bool	CanEnterLayer (SCR_LayersEditorComponent layersManager=null, bool toExtreme=false)
	Checks if can enter layer.

bool	IsRegistered ()
	Check if the entity is registered.

void	SetVisible (bool show)
	Set entity visibility.

void	EnableVisibilityReplication (bool enable)

bool	CanReplicateVisibility ()

void	OnRplVisibilityChanged ()

bool	GetVisibleSelf ()
	Check visibility setting of the entity.

bool	GetVisibleInHierarchy ()
	Check visibility setting of the entity in hierarchy (e.g., if an entity is set as visible, but its parent is not, false will be returned).

void	AddAccessKey (EEditableEntityAccessKey accessKey)
	Add access key.

void	RemoveAccessKey (EEditableEntityAccessKey accessKey)
	Remove access key.

void	ClearAccessKeys ()
	Clear all access keys.

EEditableEntityAccessKey	GetAccessKey ()
	Get entity's access key.

bool	HasAccessSelf (EEditableEntityAccessKey accessKey)
	Check access key of the entity.

bool	HasAccessInHierarchy (EEditableEntityAccessKey accessKey)
	Check acces keys of the entity in hierarchy (e.g., if an entity is compatible, but its parent is not, false will be returned).

bool	HasAccessSelf ()
	Check access key of the entity compared to those defined in SCR_AccessKeysEditorComponent.

bool	HasAccessInHierarchy ()
	Check access key of the entity in hierarchy (e.g., if an entity is compatible, but its parent is not, false will be returned).

Protected Member Functions
void	SetControlledEntityOwner (RplId entityID)

void	OnRplPlayerID ()

void	OnRplLimitedEditor ()

void	OnEditorLimitedChange (bool isLimited)

Protected Member Functions inherited from SCR_EditableEntityComponent
bool	IsServer ()

bool	CanRpc ()

void	SetTransformOwner (vector transform[4])

void	SetTransformBroadcast (vector transform[4])

void	OnAuthorChangedServer (string authorUID, int authorID, string authorPlatformID, int platform, int lastUpdated)

void	OnAuthorChangedSaveServer (string authorUID, int authorID, string authorPlatformID, int platform, int lastUpdated)

void	OnAuthorChanged (string authorUID, int authorID, string authorPlatformID, int platform, int lastUpdated)

void	OnParentEntityChanged (SCR_EditableEntityComponent parentEntity, SCR_EditableEntityComponent parentEntityPrev, bool changedByUser)

void	SetParentEntityBroadcast (SCR_EditableEntityComponent parentEntity, SCR_EditableEntityComponent parentEntityPrev, bool changedByUser=false, bool isAutoRegistration=false)

void	SetParentEntityBroadcastReceive (RplId parentEntityID, RplId parentEntityPrevID, bool changedByUser)

void	OnRegistrationChanged (bool toRegister)

EEditableEntityRegister	GetAutoRegister ()

void	Register ()

void	Unregister (IEntity owner=null)

void	AddToParent (SCR_EditableEntityComponent parentEntity, bool changedByUser)

void	RemoveFromParent (SCR_EditableEntityComponent parentEntity, bool changedByUser)

void	AddChild (SCR_EditableEntityComponent entity)

void	RemoveChild (SCR_EditableEntityComponent entity)

void	UpdateGameHierarchy (IEntity parent, IEntity child, bool toAdd)

void	OnChildEntityChanged (SCR_EditableEntityComponent child, bool isAdded)

void	SetEntityStateInChildren (IEntity owner, EEditableEntityState state, bool toSet, out array< Managed > components=null)

void	OnVisibilityChanged ()

void	OnAccessKeyChanged (EEditableEntityAccessKey accessKey)

void	Refresh ()

RplComponent	GetRplComponent ()

bool	ValidateType ()

Protected Attributes
int	m_iPlayerID = 0

bool	m_bHasLimitedEditor

SCR_EditableEntityComponent	m_ControlledEntity

ref ScriptInvoker	m_OnUIReset = new ScriptInvoker()

ref ScriptInvoker	m_OnLimitedEditorChanged = new ScriptInvoker()

Protected Attributes inherited from SCR_EditableEntityComponent
EEditableEntityRegister	m_bAutoRegister

vector	m_vIconPos

bool	m_bEnabledVisibilityReplication

bool	m_bVisible

bool	m_bStatic

float	m_fMaxDrawDistance

EEditableEntityAccessKey	m_AccessKey

EEditableEntityFlag	m_Flags

SCR_EditableEntityComponent	m_ParentEntity

GenericEntity	m_Owner

EEditableEntityState	m_EntityState

SCR_UIInfo	m_UIInfoInstance

ref set< SCR_EditableEntityComponent >	m_Entities

vector	m_vStaticPos

int	m_iIconBoneIndex = -1

ref ScriptInvokerEntity	m_OnDeleted

ref SCR_EditableEntityAuthor	m_Author

int	m_iAuthorLastUpdated

ref set< SCR_EditableEntityComponent >	m_aAttachedEntities

Additional Inherited Members
Static Public Member Functions inherited from SCR_EditableEntityComponent
static SCR_EditableEntityComponent	GetEditableEntity (IEntity owner)
	Get editable entity component on given entity.

Detailed Description

Editable entity representing a player.

Used to guarantee player representation even when controlled entity is not present (e.g., player is dead)

Constructor & Destructor Documentation

◆ ~SCR_EditablePlayerDelegateComponent()

void SCR_EditablePlayerDelegateComponent.~SCR_EditablePlayerDelegateComponent ( )

Member Function Documentation

◆ GetAIGroup()

override SCR_EditableEntityComponent SCR_EditablePlayerDelegateComponent.GetAIGroup ( )

Get entity's AI group.

Returns: Editable entity of the group

Implements SCR_EditableEntityComponent.

◆ GetControlledEntity()

SCR_EditableEntityComponent SCR_EditablePlayerDelegateComponent.GetControlledEntity ( )

Get reference to editable entity controlled by the player this delegate represents.

Returns: Controlled entity

◆ GetEntityBudgetCost()

override bool SCR_EditablePlayerDelegateComponent.GetEntityBudgetCost	(	out notnull array< ref SCR_EntityBudgetValue >	outBudgets,
		IEntity	owner = null )

Get entity budget costs.

Parameters

[out]	outBudgets	Array to be filled with budget values
[in]	owner

Returns: true if the entity cost should be based on outBudgets array, return false to fallback on entityType cost, return true with an empty array to avoid fallback entityType cost

Implements SCR_EditableEntityComponent.

◆ GetEntityType()

override EEditableEntityType SCR_EditablePlayerDelegateComponent.GetEntityType ( IEntity owner = null )

Get entity type.

Avoid basing your functionality on specific entity types! If everyone checked for specific types, adding a new type would mean all conditions have to be revised. Instead, base your system on a function inside this class. Such function can be overrided by inherited classes to give desired result.

Parameters

[in] Owner entity of this component

Returns: Type

Implements SCR_EditableEntityComponent.

◆ GetFaction()

override Faction SCR_EditablePlayerDelegateComponent.GetFaction ( )

Get entity's faction.

Returns: Faction

Implements SCR_EditableEntityComponent.

◆ GetHealth()

override float SCR_EditablePlayerDelegateComponent.GetHealth ( )

Get entity health.

Returns: Health value in range 0-1

Implements SCR_EditableEntityComponent.

◆ GetInfo()

override SCR_UIInfo SCR_EditablePlayerDelegateComponent.GetInfo ( IEntity owner = null )

Get information about the entity.

When none exist, create a dummy one.

Returns: Info class

Implements SCR_EditableEntityComponent.

◆ GetLogText()

override string SCR_EditablePlayerDelegateComponent.GetLogText ( string prefix = "" )

Parameters

[in] prefix

Returns

Implements SCR_EditableEntityComponent.

◆ GetOnLimitedEditorChanged()

ScriptInvoker SCR_EditablePlayerDelegateComponent.GetOnLimitedEditorChanged ( )

Get script invoker called when editor belonging to this player become limited (e.g., only photo mode, without any editing capabilities), or vice versa.

Returns: ScriptInvoker

◆ GetOnUIReset()

override ScriptInvoker SCR_EditablePlayerDelegateComponent.GetOnUIReset ( )

Get event called when GUI should reset widgets that are used for entity visualization.

To be overridden by inherited classes.

Returns: Script invoker

Implements SCR_EditableEntityComponent.

◆ GetPlayerID()

override int SCR_EditablePlayerDelegateComponent.GetPlayerID ( )

Get ID of player this delegates represents.

Returns: Player ID

Implements SCR_EditableEntityComponent.

◆ GetPos()

override bool SCR_EditablePlayerDelegateComponent.GetPos ( out vector pos )

Get position representing the entity.

Parameters

[out] pos Entity's position

Returns: true if the entity has a position

Implements SCR_EditableEntityComponent.

◆ GetVehicle()

override SCR_EditableEntityComponent SCR_EditablePlayerDelegateComponent.GetVehicle ( )

Get vehicle the entity's in.

Returns: Editable entity of the vehicle

Implements SCR_EditableEntityComponent.

◆ HasLimitedEditor()

bool SCR_EditablePlayerDelegateComponent.HasLimitedEditor ( )

Check if the player has access only to limited editor (e.g., only photo mode, without any editing capabilities).

Returns: True when limited

◆ InitPlayerDelegate()

void SCR_EditablePlayerDelegateComponent.InitPlayerDelegate	(	SCR_EditorManagerEntity	editorManager,
		int	playerID )

Initialise the delegate.

Can be called only once.

Parameters

[in]	editorManager
[in]	playerID	Player ID

◆ OnEditorLimitedChange()

void SCR_EditablePlayerDelegateComponent.OnEditorLimitedChange ( bool isLimited )

protected

◆ OnPostInit()

override void SCR_EditablePlayerDelegateComponent.OnPostInit ( IEntity owner )

Implements SCR_EditableEntityComponent.

◆ OnRplLimitedEditor()

void SCR_EditablePlayerDelegateComponent.OnRplLimitedEditor ( )

protected

◆ OnRplPlayerID()

void SCR_EditablePlayerDelegateComponent.OnRplPlayerID ( )

protected

◆ RplLoad()

override bool SCR_EditablePlayerDelegateComponent.RplLoad ( ScriptBitReader reader )

Implements SCR_EditableEntityComponent.

◆ RplSave()

override bool SCR_EditablePlayerDelegateComponent.RplSave ( ScriptBitWriter writer )

Implements SCR_EditableEntityComponent.

◆ SetControlledEntity()

void SCR_EditablePlayerDelegateComponent.SetControlledEntity ( IEntity controlledEntity )

Update reference to editable entity controlled by the player this delegate represents.

Parameters

[in] controlledEntity New controlled entity

◆ SetControlledEntityOwner()

void SCR_EditablePlayerDelegateComponent.SetControlledEntityOwner ( RplId entityID )

protected

Member Data Documentation

◆ m_bHasLimitedEditor

bool SCR_EditablePlayerDelegateComponent.m_bHasLimitedEditor

protected

◆ m_ControlledEntity

SCR_EditableEntityComponent SCR_EditablePlayerDelegateComponent.m_ControlledEntity

protected

◆ m_iPlayerID

int SCR_EditablePlayerDelegateComponent.m_iPlayerID = 0

protected

◆ m_OnLimitedEditorChanged

ref ScriptInvoker SCR_EditablePlayerDelegateComponent.m_OnLimitedEditorChanged = new ScriptInvoker()

protected

◆ m_OnUIReset

ref ScriptInvoker SCR_EditablePlayerDelegateComponent.m_OnUIReset = new ScriptInvoker()

protected

The documentation for this interface was generated from the following file:

Game/Editor/Components/EditableEntity/SCR_EditablePlayerDelegateComponent.c

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ~SCR_EditablePlayerDelegateComponent()

Member Function Documentation

◆ GetAIGroup()

◆ GetControlledEntity()

◆ GetEntityBudgetCost()

◆ GetEntityType()

◆ GetFaction()

◆ GetHealth()

◆ GetInfo()

◆ GetLogText()

◆ GetOnLimitedEditorChanged()

◆ GetOnUIReset()

◆ GetPlayerID()

◆ GetPos()

◆ GetVehicle()

◆ HasLimitedEditor()

◆ InitPlayerDelegate()

◆ OnEditorLimitedChange()

◆ OnPostInit()

◆ OnRplLimitedEditor()

◆ OnRplPlayerID()

◆ RplLoad()

◆ RplSave()

◆ SetControlledEntity()

◆ SetControlledEntityOwner()

Member Data Documentation

◆ m_bHasLimitedEditor

◆ m_ControlledEntity

◆ m_iPlayerID

◆ m_OnLimitedEditorChanged

◆ m_OnUIReset