Flecs v3.1
A fast entity component system (ECS) for C & C++
Loading...
Searching...
No Matches
Pipeline

Pipelines order and schedule systems for execution. More...

Classes

struct  ecs_pipeline_desc_t
 

Macros

#define FLECS_PIPELINE_H
 
#define ECS_PIPELINE_DEFINE(world, id_, ...)
 
#define ECS_PIPELINE(world, id, ...)
 
#define ecs_pipeline(world, ...)    ecs_pipeline_init(world, &(ecs_pipeline_desc_t) __VA_ARGS__ )
 

Typedefs

typedef struct ecs_pipeline_desc_t ecs_pipeline_desc_t
 

Functions

FLECS_API ecs_entity_t ecs_pipeline_init (ecs_world_t *world, const ecs_pipeline_desc_t *desc)
 Create a custom pipeline.
 
FLECS_API void ecs_set_pipeline (ecs_world_t *world, ecs_entity_t pipeline)
 Set a custom pipeline. More...
 
FLECS_API ecs_entity_t ecs_get_pipeline (const ecs_world_t *world)
 Get the current pipeline. More...
 
FLECS_API bool ecs_progress (ecs_world_t *world, ecs_ftime_t delta_time)
 Progress a world. More...
 
FLECS_API void ecs_set_time_scale (ecs_world_t *world, ecs_ftime_t scale)
 Set time scale. More...
 
FLECS_API void ecs_reset_clock (ecs_world_t *world)
 Reset world clock. More...
 
FLECS_API void ecs_run_pipeline (ecs_world_t *world, ecs_entity_t pipeline, ecs_ftime_t delta_time)
 Run pipeline. More...
 
FLECS_API void ecs_set_threads (ecs_world_t *world, int32_t threads)
 Set number of worker threads. More...
 
FLECS_API void FlecsPipelineImport (ecs_world_t *world)
 

Detailed Description

Pipelines order and schedule systems for execution.

Macro Definition Documentation

◆ ECS_PIPELINE

#define ECS_PIPELINE (   world,
  id,
  ... 
)
Value:
ecs_entity_t id = 0, ecs_id(id) = 0; ECS_PIPELINE_DEFINE(world, id, __VA_ARGS__);\
(void)id;\
(void)ecs_id(id);
ecs_id_t ecs_entity_t
An entity identifier.
Definition: flecs.h:220

Definition at line 60 of file pipeline.h.

◆ ecs_pipeline

#define ecs_pipeline (   world,
  ... 
)     ecs_pipeline_init(world, &(ecs_pipeline_desc_t) __VA_ARGS__ )

Definition at line 65 of file pipeline.h.

◆ ECS_PIPELINE_DEFINE

#define ECS_PIPELINE_DEFINE (   world,
  id_,
  ... 
)
Value:
{ \
ecs_pipeline_desc_t desc = {0}; \
ecs_entity_desc_t edesc = {0}; \
edesc.id = id_;\
edesc.name = #id_;\
desc.entity = ecs_entity_init(world, &edesc);\
desc.query.filter.expr = #__VA_ARGS__; \
id_ = ecs_pipeline_init(world, &desc); \
ecs_id(id_) = id_;\
} \
ecs_assert(id_ != 0, ECS_INVALID_PARAMETER, NULL);
FLECS_API ecs_entity_t ecs_pipeline_init(ecs_world_t *world, const ecs_pipeline_desc_t *desc)
Create a custom pipeline.
ecs_entity_t ecs_entity_init(ecs_world_t *world, const ecs_entity_desc_t *desc)
Find or create an entity.
Used with ecs_entity_init.
Definition: flecs.h:685
const char * name
Name of the entity.
Definition: flecs.h:690
ecs_entity_t id
Set to modify existing entity (optional)
Definition: flecs.h:688
const char * expr
Filter expression.
Definition: flecs.h:797
ecs_filter_desc_t filter
Filter for the query.
Definition: flecs.h:811

Definition at line 47 of file pipeline.h.

◆ FLECS_PIPELINE_H

#define FLECS_PIPELINE_H

Definition at line 39 of file pipeline.h.

Function Documentation

◆ ecs_get_pipeline()

FLECS_API ecs_entity_t ecs_get_pipeline ( const ecs_world_t world)

Get the current pipeline.

This operation gets the current pipeline.

Parameters
worldThe world.
Returns
The current pipeline.

◆ ecs_progress()

FLECS_API bool ecs_progress ( ecs_world_t world,
ecs_ftime_t  delta_time 
)

Progress a world.

This operation progresses the world by running all systems that are both enabled and periodic on their matching entities.

An application can pass a delta_time into the function, which is the time passed since the last frame. This value is passed to systems so they can update entity values proportional to the elapsed time since their last invocation.

When an application passes 0 to delta_time, ecs_progress will automatically measure the time passed since the last frame. If an application does not uses time management, it should pass a non-zero value for delta_time (1.0 is recommended). That way, no time will be wasted measuring the time.

Parameters
worldThe world to progress.
delta_timeThe time passed since the last frame.
Returns
false if ecs_quit has been called, true otherwise.

◆ ecs_reset_clock()

FLECS_API void ecs_reset_clock ( ecs_world_t world)

Reset world clock.

Reset the clock that keeps track of the total time passed in the simulation.

Parameters
worldThe world.

◆ ecs_run_pipeline()

FLECS_API void ecs_run_pipeline ( ecs_world_t world,
ecs_entity_t  pipeline,
ecs_ftime_t  delta_time 
)

Run pipeline.

This will run all systems in the provided pipeline. This operation may be invoked from multiple threads, and only when staging is disabled, as the pipeline manages staging and, if necessary, synchronization between threads.

If 0 is provided for the pipeline id, the default pipeline will be ran (this is either the builtin pipeline or the pipeline set with set_pipeline()).

When using progress() this operation will be invoked automatically for the default pipeline (either the builtin pipeline or the pipeline set with set_pipeline()). An application may run additional pipelines.

Note: calling this function from an application currently only works in single threaded applications with a single stage.

Parameters
worldThe world.
pipelineThe pipeline to run.

◆ ecs_set_pipeline()

FLECS_API void ecs_set_pipeline ( ecs_world_t world,
ecs_entity_t  pipeline 
)

Set a custom pipeline.

This operation sets the pipeline to run when ecs_progress is invoked.

Parameters
worldThe world.
pipelineThe pipeline to set.

◆ ecs_set_threads()

FLECS_API void ecs_set_threads ( ecs_world_t world,
int32_t  threads 
)

Set number of worker threads.

Setting this value to a value higher than 1 will start as many threads and will cause systems to evenly distribute matched entities across threads. The operation may be called multiple times to reconfigure the number of threads used, but never while running a system / pipeline.

◆ ecs_set_time_scale()

FLECS_API void ecs_set_time_scale ( ecs_world_t world,
ecs_ftime_t  scale 
)

Set time scale.

Increase or decrease simulation speed by the provided multiplier.

Parameters
worldThe world.
scaleThe scale to apply (default = 1).