Documentation

Unity Engine


Unity Engine


RemoveChunkComponent<T>(Entity)

Removes a chunk component from the specified entity.
Read time 1 minuteLast updated a day ago

Definition

  • Type: Method
  • Namespace: Unity.Entities
  • Assembly: UnityEngine.EntitiesModule
public bool RemoveChunkComponent<T>(Entity entity)

Parameters

entity

The entity.

Returns

Type

Description

boolFalse if the entity did not have the component.

Remarks

A chunk component is common to all entities in a chunk. Removing the chunk component from an entity changes that entity's archetype and results in the entity being moved to a different chunk (that does not have the removed component).
Important: This method creates a sync point, which means that the EntityManager waits for all currently running jobs to complete before removing 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.