An Entity Component System (ECS) for the D Programming Language.
Additional information on Entity Component Systems is broadly available but often differs in implementation.
See also:
T-machine,
Wikipedia and
RichardLords blog.
Entities are just unique identifiers. Components can be attached or detached at runtime.
Entity e;
Components are just data (structs without functions). They allow simple composition of objects, while avoiding class inheritance and virtual function performance penalties altogether.
@Component struct PlayerComponent { string name; int x; int y; int z; }
@Component struct MovementComponent { int x; int y; }
Systems encapsulate the logic of specific aspects of the program. They are modular and can easily be extended, removed or replaced.
@System class GravitySystem(ECM) { void run(ECM ecm) { /*...*/ } }
@System class MovementSystem(ECM) { void run(ECM ecm) { /*...*/ } }
...
auto ecm = new EntityComponentManager!(PlayerComponent, WeaponComponent)();
...
alias ECM = EntityComponentManager!(PlayerComponent, WeaponComponent);
auto sm = new SystemManager!(ECM, GravitySystem, MovementSystem)();
Queries result in a QueryResults (forward ranges) containing all Entities with the requested Components.
auto result = ecs.query!(PlayerComponent, WeaponComponent);
@Component struct PlayerComponent {
string name;
int x;
int y;
int z;
}
@Component struct MovementComponent {
int x;
int y;
}
@System class GravitySystem(ECM) {
void run(ECM ecm) {
foreach(entity; ecm.query!PlayerComponent()) {
auto playerComponent = entity.getComponent!PlayerComponent();
playerComponent.z -= 1;
}
}
}
@System class MovementSystem(ECM) {
void run(ECM ecm) {
foreach(entity; ecm.query!(PlayerComponent, MovementComponent)()) {
auto playerComponent = entity.getComponent!PlayerComponent();
auto movementComponent = entity.getComponent!MovementComponent();
playerComponent.x += movementComponent.x;
playerComponent.y += movementComponent.y;
}
}
}
alias ECM = EntityComponentManager!(PlayerComponent, WeaponComponent);
auto sm = new SystemManager!(ECM, GravitySystem, MovementSystem)();
for(;;) {
sm.run();
}All parts of nitro are released under the Boost software license - version 1.0
ECS is a combination of of the concepts of entities, components and systems. Systems encapsulate the execution logic and while they are intended to define the flow of the program, in nitro they are optional. In addition to these basic components nitro.gen contains helpers that aim to automate specific parts of the implementation.
To work with entities and components you first have to create an instance of EntityComponentManager with all component types you want to use as template parameters. For example:
auto myECM = new EntityComponentManager!(MyComponent)();A component can be any struct consisting of fields, for example:
struct MyComponent {
int id;
string msg;
}To see how to automatically generate The EntityComponentManager type can also be automatically generated, see nitro.gen.
Nitro works with the combination of entities and components, where components contain data and can be attatched to entities which are represented by an unique id.
TODO:
TODO:
TODO:
Nitro stores everything as a Structure of Arrays (SoA).
For each Component Nitro generates a flat structure of arrays.
Let's assume we have:
struct Point {int x,y,z; }
@Component struct TestComp { int a; Point b; }Nitro will store it internally as:
int[] //a
int[] //b.x
int[] //b.y
int[] //b.zgetComponent!TestComp() returns an Accessor!TestComp that mimics all fields of the original TestComp.
Why?
Let's say we only access TestComp.a but have lots of TestComp components we want to iterate. Normally we'd pull all fields of TestComp into our CPU cache. By using Accessor!TestComp only TestComp.a is pulled in.