GetOrCreateSystem
Retrieve the handle for the instance of a system of type T from the current World. If the system does not exist in this World, it will first be created.
Read time 2 minutesLast updated a day ago
Definition
- Type: Method
- Namespace: Unity.Entities
- Assembly: UnityEngine.EntitiesModule
GetOrCreateSystem<T>()
Retrieve the handle for the instance of a system of type from the current World. If the system does not exist in this World, it will first be created.
Tpublic SystemHandle GetOrCreateSystem<T>() where T : ComponentSystemBase
Returns
Type | Description |
|---|---|
| SystemHandle | The handle for the instance of system type |
Remarks
Important: This function creates a sync point if a system is created, which means that the EntityManager waits for all currently running Jobs to complete before creating the system, 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.
GetOrCreateSystem(Type)
Retrieve the handle for the instance of a system of type from the current World. If the system does not exist in this World, it will first be created.
typepublic SystemHandle GetOrCreateSystem(Type type)
Parameters
The system type
Returns
Type | Description |
|---|---|
| SystemHandle | The handle for the instance of system type |
Remarks
Important: This function creates a sync point if a system is created, which means that the EntityManager waits for all currently running Jobs to complete before creating the system, 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.
GetOrCreateSystem(SystemTypeIndex)
Retrieve the handle for the instance of a system of type from the current World. If the system does not exist in this World, it will first be created.
typepublic SystemHandle GetOrCreateSystem(SystemTypeIndex type)
Parameters
The system type
Returns
Type | Description |
|---|---|
| SystemHandle | The handle for the instance of system type |