Version: Unity 7.0 Alpha (7000.0)
LanguageEnglish
  • C#

World.GetOrCreateSystem

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Declaration

public SystemHandle GetOrCreateSystem();

Returns

SystemHandle The handle for the instance of system type T in this World. If the system does not exist in this World, it will first be created.

Description

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.

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.


Declaration

public SystemHandle GetOrCreateSystem(Type type);

Parameters

Parameter Description
type The system type

Returns

SystemHandle The handle for the instance of system type type in this World. If the system does not exist in this World, it will first be created.

Description

Retrieve the handle for the instance of a system of type type from the current World. If the system does not exist in this World, it will first be created.

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.


Declaration

public SystemHandle GetOrCreateSystem(SystemTypeIndex type);

Parameters

Parameter Description
type The system type

Returns

SystemHandle The handle for the instance of system type type in this World. If the system does not exist in this World, it will first be created.

Description

Retrieve the handle for the instance of a system of type type from the current World. If the system does not exist in this World, it will first be created.