Crate planck_ecs

A minimalist, safe and fast ECS. Composed of two libraries:

• entity_component
• world_dispatcher

Planck ECS is a library that brings those two smaller parts together. It adds the maintain function to world, which takes care of cleaning up dead entities after running systems.

Macros

izip	Create an iterator running multiple iterators in lockstep.
join	The join macro makes it very easy to iterate over multiple components of the same Entity at once.
system_error	Returns a custom error from a System during execution.

Structs

ComponentIterator	Iterates over components using a provided bitset. Each time the bitset has a 1 in index i, the iterator will fetch data from the storage at index i and return it as an Option.
ComponentIteratorMut	Iterates over components using a provided bitset. Each time the bitset has a 1 in index i, the iterator will fetch data from the storage at index i and return it as an Option.
Components	Holds components of a given type indexed by Entity. We do not check if the given entity is alive here, this should be done using Entities.
Dispatcher	A dispatcher is used to execute a collection of System in order and possibly in parallel using World’s resources. A dispatcher automatically avoids mutable borrow collisions which would normally lead to data corruption, dead locks and more.
DispatcherBuilder	A builder that accumulates systems to be inserted into a Dispatcher.
Entities	Holds a list of alive entities. It also holds a list of entities that were recently killed, which allows to remove components of deleted entities at the end of a game frame.
Entity	An entity index. They are created using the Entities struct. They are used as indices with Components structs.
EntityIterator	Iterator over entities using the provided bitset.
System	Struct used to run a system function using the world. This struct is also used internally by the Dispatcher to create a coherent execution sequence.
World	Contains data indexed by type. World allows to dynamically enforce the rust rules of borrowing and ownership at runtime:

Enums

EcsError

The types of errors a System can create.

Traits

BitSet	The BitSet API.
IntoSystem	Converts a function into a System. It is required to execute a function automatically from World’s resources. This trait is automatically implemented for functions taking 12 arguments (22 if using the big_systems feature) or less where:
WorldExt	Extension to the World struct that adds a maintain() method.

Functions

create_bitset

Creates a bitset big enough to contain the index of each entity. Mostly used to create caches.

Type Definitions

BitSetVec	The type of bitsets used to track entities in component storages. Mostly used to create caches.
SystemResult	The result of a System’s execution. Returns Ok(()) on success, EcsError on failure. To return a custom error from a system, use the system_error! macro.