Skip to main content

DelayedComponentEnablerSystem Class

System that processes delayed component activations each frame. More...

Declaration​

class helios::engine::mechanics::lifecycle::systems::DelayedComponentEnablerSystem { ... }

Public Member Typedefs Index​

usingEngineRoleTag = helios::engine::common::tags::SystemRole

Public Member Functions Index​

voidupdate (helios::engine::runtime::world::UpdateContext &updateContext) noexcept

Processes all deferred components and activates expired ones. More...

Private Member Attributes Index​

std::vector< helios::engine::ecs::types::ComponentTypeId >sync_

Temporary buffer for components that completed their delay. More...

Description​

System that processes delayed component activations each frame.

DelayedComponentEnablerSystem iterates over all entities with a DelayedComponentEnabler component and decrements the delay timers. When a timer reaches zero, the corresponding component is enabled.

This system enables gameplay patterns such as:

  • **Spawn immunity:** Projectiles/enemies ignore collisions briefly
  • **Staggered activation:** Wave spawns activate progressively
  • **Effect sequencing:** Components enable in a defined order
info

Should be scheduled in the gameplay phase to ensure proper timing.

See Also

DelayedComponentEnabler

See Also

DelayedComponentEnablerInitializer

Definition at line 43 of file DelayedComponentEnablerSystem.ixx.

Public Member Typedefs​

EngineRoleTag​

using helios::engine::mechanics::lifecycle::systems::DelayedComponentEnablerSystem::EngineRoleTag = helios::engine::common::tags::SystemRole

Definition at line 53 of file DelayedComponentEnablerSystem.ixx.

53 using EngineRoleTag = helios::engine::common::tags::SystemRole;

Public Member Functions​

update()​

void helios::engine::mechanics::lifecycle::systems::DelayedComponentEnablerSystem::update (helios::engine::runtime::world::UpdateContext & updateContext)
 inline noexcept

Processes all deferred components and activates expired ones.

For each entity with DelayedComponentEnabler: 1. Decrements all delay timers by deltaTime 2. Enables components whose timers reach zero 3. Removes activated components from the deferred list

Parameters
updateContext

Provides deltaTime for timer updates.

Definition at line 64 of file DelayedComponentEnablerSystem.ixx.

64 void update(helios::engine::runtime::world::UpdateContext& updateContext) noexcept {
65
66 const float delta = updateContext.deltaTime();
67
68 for (auto [entity, dce, active] : updateContext.view<
69 helios::engine::mechanics::lifecycle::components::DelayedComponentEnabler,
70 helios::engine::mechanics::lifecycle::components::Active
71 >().whereEnabled()) {
72
73 sync_.clear();
74
75 auto deferredComponents = dce->deferredComponents();
76
77 for (auto& deferredComponent : deferredComponents) {
78
79 deferredComponent.delta = std::max(deferredComponent.delta - delta, 0.0f);
80
81 const auto componentTypeId = deferredComponent.componentTypeId;
82
83 if (deferredComponent.delta <= 0) {
84 auto* rawCmp = entity.raw(componentTypeId);
85 auto ops = helios::engine::ecs::ComponentOpsRegistry::ops(componentTypeId);
86
87 if (rawCmp && ops.enable) {
88 ops.enable(rawCmp);
89 }
90
91 sync_.push_back(componentTypeId);
92 }
93 }
94
95 dce->sync(sync_);
96 }
97 }

Reference helios::engine::ecs::ComponentOpsRegistry::ops.

Private Member Attributes​

sync_​

std::vector<helios::engine::ecs::types::ComponentTypeId> helios::engine::mechanics::lifecycle::systems::DelayedComponentEnablerSystem::sync_

Temporary buffer for components that completed their delay.

Definition at line 48 of file DelayedComponentEnablerSystem.ixx.

48 std::vector<helios::engine::ecs::types::ComponentTypeId> sync_;

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

Generated via doxygen2docusaurus 2.0.0 by Doxygen 1.15.0.