Function ecs_async_stage_new

Synopsis

#include <include/flecs.h>

FLECS_API ecs_world_t * ecs_async_stage_new(ecs_world_t *world)

Description

Create asynchronous stage. An asynchronous stage can be used to asynchronously queue operations for later merging with the world. An asynchronous stage is similar to a regular stage, except that it does not allow reading from the world.

Asynchronous stages are never merged automatically, and must therefore be manually merged with the ecs_merge function. It is not necessary to call defer_begin or defer_end before and after enqueuing commands, as an asynchronous stage unconditionally defers operations.

The application must ensure that no commands are added to the stage while the stage is being merged.

An asynchronous stage must be cleaned up by ecs_async_stage_free.

Parameters

world - The world.

Returns
The stage.

Source

Line 3285 in include/flecs.h.