Method AddComponents

AddComponents(Entity, ComponentTypes)

Adds a set of component to an entity.

Declaration

public void AddComponents(Entity entity, ComponentTypes types)

Parameters

Type	Name	Description
Entity	entity	The entity to modify.
ComponentTypes	types	The types of components to add.

Remarks

Can add any kinds of components.

Adding components changes the entity's archetype and results in the entity being moved to a different chunk.

The added components have the default values for the type.

If the Entity object refers to an entity that has been destroyed, this function throws an ArgumentError exception.

Important: This function creates a sync point, which means that the EntityManager waits for all currently running Jobs to complete before adding these components and no additional Jobs can start before the function is finished. A sync point can cause a drop in performance because the ECS framework may not be able to make use of the processing power of all available cores.

Exceptions

Type	Condition
ArgumentException	The Entity does not exist.