Entity Lifecycle – Arma Reforger
Jump to navigation
Jump to search
Definitions
- Frame: every drawing frame (frame as in FPS)
- Fixed Frame: a fixed event happening 30 times per second
- Physics Simulation Frame: a fixed event at 60 simulations per second (frequency defined in Workbench → Options → Game Project → Modules → Physics Settings → Ticks)
Lifecycle
| Section | Mode | Method | Description | ||
|---|---|---|---|---|---|
|
WB Play |
WB Edit | Entity | Component | ||
| Instantiation | 
|
|
Constructor | ||
|
|
|
Constructor | |||
|
|
|
OnPostInit | |||
|
|
|
EOnInit | |||
|
|
|
EOnInit | |||
|
|
_WB_SetTransform | ||||
|
|
_WB_SetTransform | ||||
|
|
_WB_OnInit | ||||
|
|
_WB_OnInit | ||||
|
|
_WB_MakeVisible | ||||
| Workbench
Execution loop (World Editor) |
|
_WB_AfterWorldUpdate | |||
|
|
_WB_AfterWorldUpdate | ||||
| Simulation init |
|
EOnActivate | |||
| Simulation loop |
|
EOnFrame | |||
|
|
EOnFrame | ||||
|
|
EOnDiag | ||||
|
|
EOnDiag | ||||
|
|
EOnFixedFrame | if 1/30s passed since the last execution | |||
|
|
EOnFixedFrame | if 1/30s passed since the last execution | |||
|
|
EOnSimulate | ||||
|
|
EOnSimulate | ||||
|
|
EOnPostSimulate | ||||
|
|
EOnPostSimulate | ||||
|
|
EOnPhysicsMove | if 1/60s passed since the last execution - can be executed multiple times per frame | |||
|
|
EOnPhysicsMove | if 1/60s passed since the last execution - can be executed multiple times per frame | |||
|
|
EOnPostFrame | ||||
|
|
EOnPostFrame | ||||
|
|
EOnPostFixedFrame | If EOnFixedFrame executed this frame | |||
|
|
EOnFixedPostFrame | If EOnFixedFrame executed this frame | |||
| Destruction |
|
|
OnDelete | ||
|
|
|
Destructor | Do NOT delete components in an entity's destructor - this could lead to nullpointer exceptions | ||
|
|
|
Destructor | Do NOT reference the parent entity in a component's destructor - the entity is already deleted by then | ||
Example Code
The following code is to be placed in a .c file in the scripts
#define _PRINT_EVENTS // this flag enables/disables all event prints
// #define _WB_WORLD_UPDATES // this flag enables/disables Workbench's world updates-related event prints
[EntityEditorProps(category: "Test", description: "Test entity")]
class SCR_MyEntityClass : GenericEntityClass
{
}
class SCR_MyEntity : GenericEntity
{
#ifdef _PRINT_EVENTS
protected static const int DELETE_AFTER = 3000; //!< duration in ms after which the entity deletes itself - for log's sake
protected void DeleteThis()
{
Print("DELETE THIS");
delete this; // delete this
}
protected void _Print(string input)
{
Print("ENTITY : " + input, LogLevel.NORMAL);
}
// IEntity events
override void EOnTouch(IEntity owner, IEntity other, int touchTypesMask) { _Print("EOnTouch"); }
override void EOnInit(IEntity owner) { _Print("EOnInit"); }
override void EOnVisible(IEntity owner, int frameNumber) { _Print("EOnVisible"); }
override void EOnFrame(IEntity owner, float timeSlice) { _Print("EOnFrame"); }
override void EOnPostFrame(IEntity owner, float timeSlice) { _Print("EOnPostFrame"); }
override void EOnAnimEvent(IEntity owner, int type, int slot) { _Print("EOnAnimEvent"); }
override void EOnSimulate(IEntity owner, float timeSlice) { _Print("EOnSimulate"); }
override void EOnPostSimulate(IEntity owner, float timeSlice) { _Print("EOnPostSimulate"); }
override void EOnJointBreak(IEntity owner, IEntity other) { _Print("EOnJointBreak"); }
override void EOnPhysicsMove(IEntity owner) { _Print("EOnPhysicsMove"); }
override void EOnContact(IEntity owner, IEntity other, Contact contact) { _Print("EOnContact"); }
override void EOnPhysicsActive(IEntity owner, bool activeState) { _Print("EOnPhysicsActive"); }
override void EOnDiag(IEntity owner, float timeSlice) { _Print("EOnDiag"); }
override void EOnFixedFrame(IEntity owner, float timeSlice) { _Print("EOnFixedFrame"); }
override void EOnFixedPostFrame(IEntity owner, float timeSlice) { _Print("EOnFixedPostFrame"); }
// GenericEntity events
override void EOnActivate(IEntity owner)
{
Physics physics = GetPhysics();
if (physics)
physics.SetActive(ActiveState.ALWAYS_ACTIVE);
_Print("EOnActivate");
// delete after some time
GetGame().GetCallqueue().CallLater(DeleteThis, DELETE_AFTER);
}
override void EOnDeactivate(IEntity owner) { _Print("EOnDeactivate"); }
override IEntity _WB_GetEditableOwner() { _Print("_WB_GetEditableOwner"); return super._WB_GetEditableOwner(); }
override void _WB_MakeVisible(IEntitySource src, bool visible) { _Print("_WB_MakeVisible"); }
override void _WB_SetTransform(inout vector mat[4], IEntitySource src) { _Print("_WB_SetTransform"); }
override void _WB_OnInit(inout vector mat[4], IEntitySource src) { _Print("_WB_OnInit"); }
override bool _WB_CanDelete(IEntitySource src) { _Print("_WB_CanDelete"); return super._WB_CanDelete(src); }
override bool _WB_CanRename(IEntitySource src) { _Print("_WB_CanRename"); return super._WB_CanRename(src); }
override bool _WB_CanCopy(IEntitySource src) { _Print("_WB_CanCopy"); return super._WB_CanCopy(src); }
override bool _WB_CanSelect(IEntitySource src) { _Print("_WB_CanSelect"); return super._WB_CanSelect(src); }
override int _WB_GetAnchorCount(IEntitySource src) { _Print("_WB_GetAnchorCount"); return super._WB_GetAnchorCount(src); }
override void _WB_GetAnchor(inout vector position, IEntitySource src, int index) { _Print("_WB_GetAnchor"); }
override void _WB_OnAnchorSnapped(IEntitySource thisSrc, int thisAnchor, IEntitySource otherSrc, int otherAnchor, bool isReceiver) { _Print("_WB_OnAnchorSnapped"); }
override bool _WB_CanAnchorSnap(IEntitySource thisSrc, int thisAnchor, IEntitySource otherSrc, int otherAnchor, bool isReceiver) { _Print("_WB_CanAnchorSnap"); return super._WB_CanAnchorSnap(thisSrc, thisAnchor, otherSrc, otherAnchor, isReceiver); }
override void _WB_GetBoundBox(inout vector min, inout vector max, IEntitySource src) { _Print("_WB_GetBoundBox"); }
override bool _WB_ShouldShowBoundBox(IEntitySource src) { _Print("_WB_ShouldShowBoundBox"); return super._WB_ShouldShowBoundBox(src); }
override void _WB_SetExtraVisualiser(EntityVisualizerType type, IEntitySource src) { _Print("_WB_SetExtraVisualiser"); }
override array<ref WB_UIMenuItem> _WB_GetContextMenuItems() { _Print("_WB_GetContextMenuItems"); return super._WB_GetContextMenuItems(); }
override bool _WB_OnPhysSimulPlacementBegin(IEntitySource src) { _Print("_WB_OnPhysSimulPlacementBegin"); return super._WB_OnPhysSimulPlacementBegin(src); }
override bool _WB_EnablePhysics(IEntitySource src, bool physics) { _Print("_WB_EnablePhysics"); return super._WB_EnablePhysics(src, physics); }
override array<ref ParamEnum> _WB_GetUserEnums(string varName, IEntitySource src) { _Print("_WB_GetUserEnums"); return super._WB_GetUserEnums(varName, src); }
override bool _WB_OnKeyChanged(BaseContainer src, string key, BaseContainerList ownerContainers, IEntity parent) { _Print("_WB_OnKeyChanged"); return super._WB_OnKeyChanged(src, key, ownerContainers, parent); }
#ifdef _WB_WORLD_UPDATES
override void _WB_AfterWorldUpdate(float timeSlice) { _Print("_WB_AfterWorldUpdate"); }
#endif
override void _WB_OnContextMenu(int id) { _Print("_WB_OnContextMenu"); }
override void _WB_OnKeyDown(int keyCode) { _Print("_WB_OnKeyDown"); }
override void _WB_OnCreate(IEntitySource src) { _Print("_WB_OnCreate"); }
override void _WB_OnDelete(IEntitySource src) { _Print("_WB_OnDelete"); }
override void _WB_OnRename(IEntitySource src, string oldName) { _Print("_WB_OnRename"); }
void SCR_MyEntity(IEntitySource src, IEntity parent)
{
SetEventMask(EntityEvent.ALL);
_Print("Constructor");
}
void ~SCR_MyEntity() { _Print("Destructor"); }
#endif
}
//
// Component below
//
[ComponentEditorProps(category: "Test", description: "Test component")]
class SCR_MyComponentClass : ScriptComponentClass
{
}
class SCR_MyComponent : ScriptComponent // which itself inherits from GenericComponent
{
#ifdef _PRINT_EVENTS
protected void _Print(string input)
{
Print("COMPONENT: " + input, LogLevel.NORMAL);
}
// GenericComponent events
override void _WB_SetTransform(IEntity owner, inout vector mat[4], IEntitySource src) { _Print("_WB_SetTransform"); }
override void _WB_OnInit(IEntity owner, inout vector mat[4], IEntitySource src) { _Print("_WB_OnInit"); }
override bool _WB_CanDelete(IEntity owner, IEntitySource src) { _Print("_WB_CanDelete"); return super._WB_CanDelete(owner, src); };
override bool _WB_CanRename(IEntity owner, IEntitySource src) { _Print("_WB_CanRename"); return super._WB_CanRename(owner, src); };
override bool _WB_CanCopy(IEntity owner, IEntitySource src) { _Print("_WB_CanCopy"); return super._WB_CanCopy(owner, src); };
override bool _WB_CanSelect(IEntity owner, IEntitySource src) { _Print("_WB_CanSelect"); return super._WB_CanSelect(owner, src); };
override void _WB_GetBoundBox(IEntity owner, inout vector min, inout vector max, IEntitySource src) { _Print("_WB_GetBoundBox"); }
override void _WB_SetExtraVisualiser(IEntity owner, EntityVisualizerType type, IEntitySource src) { _Print("_WB_SetExtraVisualiser"); }
override array<ref WB_UIMenuItem> _WB_GetContextMenuItems(IEntity owner) { _Print("_WB_GetContextMenuItems"); return super._WB_GetContextMenuItems(owner); }
override bool _WB_OnPhysSimulPlacementBegin(IEntity owner, IEntitySource src) { _Print("_WB_OnPhysSimulPlacementBegin"); return super._WB_OnPhysSimulPlacementBegin(owner, src); };
override bool _WB_EnablePhysics(IEntity owner, IEntitySource src, bool physics) { _Print("_WB_EnablePhysics"); return super._WB_EnablePhysics(owner, src, physics); }
override bool _WB_OnKeyChanged(IEntity owner, BaseContainer src, string key, BaseContainerList ownerContainers, IEntity parent) { _Print("_WB_OnKeyChanged"); return super._WB_OnKeyChanged(owner, src, key, ownerContainers, parent); }
#ifdef _WB_WORLD_UPDATES
override void _WB_AfterWorldUpdate(IEntity owner, float timeSlice) { _Print("_WB_AfterWorldUpdate"); }
#endif
override void _WB_OnContextMenu(IEntity owner, int id) { _Print("_WB_OnContextMenu"); }
override void _WB_OnKeyDown(IEntity owner, int keyCode) { _Print("_WB_OnKeyDown"); }
override void _WB_OnCreate(IEntity owner, IEntitySource src) { _Print("_WB_OnCreate"); }
override void _WB_OnDelete(IEntity owner, IEntitySource src) { _Print("_WB_OnDelete"); }
override void _WB_OnRename(IEntity owner, IEntitySource src, string oldName) { _Print("_WB_OnRename"); }
override array<ref ParamEnum> _WB_GetUserEnums(string varName, IEntity owner, IEntityComponentSource src) { _Print("_WB_GetUserEnums"); return super._WB_GetUserEnums(varName, owner, src); }
override void OnTransformResetImpl(TransformResetParams params) { _Print("OnTransformResetImpl"); };
// ScriptComponent events
override void EOnTouch(IEntity owner, IEntity other, int touchTypesMask) { _Print("EOnTouch"); }
override void EOnInit(IEntity owner) { _Print("EOnInit"); }
override void EOnVisible(IEntity owner, int frameNumber) { _Print("EOnVisible"); }
override void EOnFrame(IEntity owner, float timeSlice) { _Print("EOnFrame"); }
override void EOnPostFrame(IEntity owner, float timeSlice) { _Print("EOnPostFrame"); }
override void EOnAnimEvent(IEntity owner, int type, int slot) { _Print("EOnAnimEvent"); }
override void EOnSimulate(IEntity owner, float timeSlice) { _Print("EOnSimulate"); }
override void EOnPostSimulate(IEntity owner, float timeSlice) { _Print("EOnPostSimulate"); }
override void EOnJointBreak(IEntity owner, IEntity other) { _Print("EOnJointBreak"); }
override void EOnPhysicsMove(IEntity owner) { _Print("EOnPhysicsMove"); }
override void EOnContact(IEntity owner, IEntity other, Contact contact) { _Print("EOnContact"); }
override void EOnPhysicsActive(IEntity owner, bool activeState) { _Print("EOnPhysicsActive"); }
override void EOnDiag(IEntity owner, float timeSlice) { _Print("EOnDiag"); }
override void EOnFixedFrame(IEntity owner, float timeSlice) { _Print("EOnFixedFrame"); }
override void EOnPostFixedFrame(IEntity owner, float timeSlice) { _Print("EOnPostFixedFrame"); }
override void EOnActivate(IEntity owner) { _Print("EOnActivate"); }
override void EOnDeactivate(IEntity owner) { _Print("EOnDeactivate"); }
override void OnPostInit(IEntity owner) { _Print("OnPostInit"); }
override void OnDelete(IEntity owner) { _Print("OnDelete"); }
override void OnAddedToParent(IEntity child, IEntity parent) { _Print("OnAddedToParent"); }
override void OnRemovedFromParent(IEntity child, IEntity parent) { _Print("OnRemovedFromParent"); }
override void OnChildAdded(IEntity parent, IEntity child) { _Print("OnChildAdded"); }
override void OnChildRemoved(IEntity parent, IEntity child) { _Print("OnChildRemoved"); }
void SCR_MyComponent(IEntityComponentSource src, IEntity ent, IEntity parent)
{
SetEventMask(GetOwner(), EntityEvent.ALL);
_Print("Constructor");
}
void ~SCR_MyComponent() { _Print("Destructor"); }
#endif
}