1. In your systems, statically import com.artemis.E. This exposes E(entityId).
2. Make sure com.artemis.SuperMapper is one of the first systems in your world!
3. Obtain it within your systems, during initialization or world processing cycle!

Pass entityId or entity to E(..).

E(entityId).pos(5,5).angle(10).anim("lion")

Fluid interface directly exposes methods to create, remove, and access and alter components it knows about. Method calls can be chained.

Omit the id.

E().pos(50,50).entity();

Finish the chain with entity() or id() to obtain a reference to the entity

given class Pos extends Component {}

Add component

E(id).pos();

Access component

Pos pos = E(entityId).getPos();

Conventions:

• Returns null if no component exists.

Remove component

E(id).removePos()

Access component field

given Anim .. { public Cell cell; }

Example:

Cell cell = E(entityId).animCell();
E(entityId).animCell(cell);

Conventions:

• This call creates missing components to avoid NPE checks.
• See internals below for conventions generating field getters/setters.

Access component method

given

class Anim extends Component
{ 
  public Vector getXY() { .. } 
  public void setXY(int x, int y) { .. }  
  public void setXY(Vector v) { .. }  
}

Example:

e = E(Id);
Vector v2 = e.posXY();
e.posXY(5,5).posXY(new Vector(10,10));

Conventions:

• This call creates missing components to avoid NPE checks.
• See internals below for conventions generating field getters/setters.

Components without public fields and methods are considered flags.

class Invisible extends Component {}

E(id).invisible(false); // remove
E(id).invisible(true); // add
boolean invisible = E(id).isInvisible(true); // invisible?

Conventions for components