AddComponent
Adds a component to an entity.
Read time 9 minutesLast updated 2 days ago
Definition
- Type: Method
- Namespace: Unity.Entities
- Assembly: UnityEngine.EntitiesModule
AddComponent(Entity, ComponentType)
Adds a component to an entity.
public bool AddComponent(Entity entity, ComponentType componentType)
Parameters
Returns
Type | Description |
|---|---|
| bool | If the component was successfully added to the entity. |
Remarks
Can add any kind of component except chunk components. For chunk components, use EntityManager.AddChunkComponentData.
Adding a component changes the entity's archetype and results in the entity being moved to a different chunk.
The added component has the default values for the type.
If the Entity object refers to an entity that already has the specified ComponentType, the function returns false without performing any modifications.
Important: This method creates a sync point, which means that the EntityManager waits for all currently running jobs to complete before adding the component. No additional jobs can start before the method is finished. A sync point can cause a drop in performance because the ECS framework might not be able to use the processing power of all available cores.
AddComponent(SystemHandle, ComponentType)
Adds a component to an entity associated with a system.
public bool AddComponent(SystemHandle system, ComponentType componentType)
Parameters
Returns
Type | Description |
|---|---|
| bool | If the component was successfully added to the entity. |
Remarks
Can add any kind of component except chunk components. For chunk components, use EntityManager.AddChunkComponentData.
Adding a component changes the entity's archetype and results in the entity being moved to a different chunk.
The added component has the default values for the type.
If the Entity object refers to an entity that already has the specified ComponentType, the function returns false without performing any modifications.
Important: This method creates a sync point, which means that the EntityManager waits for all currently running jobs to complete before adding the component. No additional jobs can start before the method is finished. A sync point can cause a drop in performance because the ECS framework might not be able to use the processing power of all available cores.
AddComponent<T>(Entity)
Adds a component to an entity.
public bool AddComponent<T>(Entity entity)
Parameters
The Entity.
Returns
Type | Description |
|---|---|
| bool | If the component was successfully added to the entity. |
Remarks
Can add any kind of component except chunk components. For chunk components, use EntityManager.AddChunkComponentData.
Adding a component changes the entity's archetype and results in the entity being moved to a different chunk.
The added component has the default values for the type.
If the Entity object refers to an entity that already has the specified ComponentType, the function returns false without performing any modifications.
Important: This method creates a sync point, which means that the EntityManager waits for all currently running jobs to complete before addting the component. No additional jobs can start before the method is finished. A sync point can cause a drop in performance because the ECS framework might not be able to use the processing power of all available cores.
AddComponent<T>(SystemHandle)
Adds a component to an entity associated with a system.
public bool AddComponent<T>(SystemHandle system)
Parameters
The system handle.
Returns
Type | Description |
|---|---|
| bool | If the component was successfully added to the entity. |
Remarks
Can add any kind of component except chunk components. For chunk components, use EntityManager.AddChunkComponentData.
Adding a component changes the entity's archetype and results in the entity being moved to a different chunk.
The added component has the default values for the type.
If the Entity object refers to an entity that already has the specified ComponentType, the function returns false without performing any modifications.
Important: This method creates a sync point, which means that the EntityManager waits for all currently running jobs to complete before addting the component. No additional jobs can start before the method is finished. A sync point can cause a drop in performance because the ECS framework might not be able to use the processing power of all available cores.
AddComponent(EntityQuery, ComponentType)
Adds a component to a set of entities defined by a EntityQuery.
public void AddComponent(EntityQuery entityQuery, ComponentType componentType)
Parameters
The EntityQuery defining the entities to modify.
The type of component to add.
Remarks
Can add any kind of component.
Adding a component changes an entity's archetype and results in the entity being moved to a different chunk.
The added components have the default values for the type.
Important: This method creates a sync point, which means that the EntityManager waits for all currently running jobs to complete before addting the component. No additional jobs can start before the method is finished. A sync point can cause a drop in performance because the ECS framework might not be able to use the processing power of all available cores.
AddComponent(EntityQuery, ComponentTypeSet)
Adds components to a set of entities defined by a EntityQuery.
public void AddComponent(EntityQuery entityQuery, in ComponentTypeSet componentTypeSet)
Parameters
The EntityQuery defining the entities to modify.
The type of components to add.
Remarks
You can use this method to add a component to an Entity.
The added components have the default values for the type.
Important: This method creates a sync point, which means that the EntityManager waits for all currently running jobs to complete before addting the component. No additional jobs can start before the method is finished. A sync point can cause a drop in performance because the ECS framework might not be able to use the processing power of all available cores.
AddComponent<T>(EntityQuery)
Adds a component to a set of entities defined by a EntityQuery.
public void AddComponent<T>(EntityQuery entityQuery)
Parameters
The EntityQuery defining the entities to modify.
Remarks
Can add any kind of component except chunk components.
Adding a component changes an entity's archetype and results in the entity being moved to a different chunk.
The added components have the default values for the type.
Important: This method creates a sync point, which means that the EntityManager waits for all currently running jobs to complete before adding the component. No additional jobs can start before the method is finished. A sync point can cause a drop in performance because the ECS framework might not be able to use the processing power of all available cores.
AddComponent(NativeArray<Entity>, ComponentType)
Adds a component to a set of entities.
public void AddComponent(NativeArray<Entity> entities, ComponentType componentType)
Parameters
An array of Entity objects.
The type of component to add.
Remarks
Can add any kind of component except chunk components.
Adding a component changes an entity's archetype and results in the entity being moved to a different chunk.
The added components have the default values for the type.
Important: This method creates a sync point, which means that the EntityManager waits for all currently running jobs to complete before creating the chunk. No additional jobs can start before the method is finished. A sync point can cause a drop in performance because the ECS framework might not be able to use the processing power of all available cores.
AddComponent(NativeArray<Entity>, ComponentTypeSet)
Adds components to a specified collection of entities.
public void AddComponent(NativeArray<Entity> entities, in ComponentTypeSet componentTypeSet)
Parameters
The collection of entities to modify.
The type of components to add.
Remarks
You can use this method to add a component to an Entity.
The added components have the default values for the type.
Important: This method creates a sync point, which means that the EntityManager waits for all currently running jobs to complete before adding the component. No additional jobs can start before the method is finished. A sync point can cause a drop in performance because the ECS framework might not be able to use the processing power of all available cores.
AddComponent<T>(NativeArray<Entity>)
Adds a component to a set of entities.
public void AddComponent<T>(NativeArray<Entity> entities)
Parameters
An array of Entity objects.
Remarks
Can add any kind of component.
Adding a component changes an entity's archetype and results in the entity being moved to a different chunk.
The added components have the default values for the type.
Important: This method creates a sync point, which means that the EntityManager waits for all currently running jobs to complete before adding the component. No additional jobs can start before the method is finished. A sync point can cause a drop in performance because the ECS framework might not be able to use the processing power of all available cores.
AddComponent(SystemHandle, ComponentTypeSet)
Adds a set of component to an entity associated with a system.
public void AddComponent(SystemHandle system, in ComponentTypeSet componentTypeSet)
Parameters
Remarks
You can use this method to add a component to an Entity.
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 InvalidOperationException exception.
Important: This method creates a sync point, which means that the EntityManager waits for all currently running jobs to complete before setting the component. No additional jobs can start before the method is finished. A sync point can cause a drop in performance because the ECS framework might not be able to use the processing power of all available cores.
AddComponent(Entity, ComponentTypeSet)
Adds a set of component to an entity.
public void AddComponent(Entity entity, in ComponentTypeSet componentTypeSet)
Parameters
Remarks
You can use this method to add a component to an Entity.
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 InvalidOperationException exception.
Important: This method creates a sync point, which means that the EntityManager waits for all currently running jobs to complete before adding the component. No additional jobs can start before the method is finished. A sync point can cause a drop in performance because the ECS framework might not be able to use the processing power of all available cores.