TaskWorldFacade.h File Reference

Lightweight ECS component accessor bridge for the Task System. More...

#include "../ECS/Components/PositionComponent.h"
#include "../ECS/Components/MovementComponent.h"

Include dependency graph for TaskWorldFacade.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
struct	Olympe::TaskWorldFacade
	Lightweight ECS component accessor passed through AtomicTaskContext. More...

Namespaces
namespace	Olympe
	< Provides AssetID and INVALID_ASSET_ID

Detailed Description

Lightweight ECS component accessor bridge for the Task System.

Author

Olympe Engine

Date

2026-02-24

TaskWorldFacade provides a simple, SDL-free bridge between the Task System and the ECS layer. It holds raw pointers to the PositionComponent and MovementComponent that belong to the entity currently executing a task.

In production, the ECS system responsible for driving task execution (e.g. a TaskExecutionSystem) populates a TaskWorldFacade and places it in the AtomicTaskContext before calling TaskSystem::ExecuteNode().

In unit tests, a TaskWorldFacade is built directly by the test, pointing at stack-allocated component instances. This allows the World mode branch of Task_MoveToLocation (and similar tasks) to be exercised without requiring a live World / SDL context.

Design notes

• Raw (non-owning) pointers are intentional: the lifetime of the pointed-to components is managed by the caller (ECS system or test fixture).
• nullptr members are safe: tasks MUST check for nullptr before use and fall back to the LocalBlackboard path when components are absent.

C++14 compliant - no C++17/20 features.

Definition in file TaskWorldFacade.h.