Method CreateSingleton
CreateSingleton<T>(EntityManager, FixedString64Bytes)
Creates and supports only a single entity with a given managed component.
Declaration
public static Entity CreateSingleton<T>(this EntityManager manager, FixedString64Bytes name = default) where T : class, IComponentData, new()Parameters
| Type | Name | Description |
|---|---|---|
| EntityManager | manager | This entity manager. |
| FixedString64Bytes | name | The debug friendly name associated with the singleton component entity. |
Returns
| Type | Description |
|---|---|
| Entity | The Entity object that you can use to access the singleton component entity. |
Type Parameters
| Name | Description |
|---|---|
| T | The type of component to create. |
Remarks
Note that while zero-size component may be created, they can not be accessed directly in code. They are only usable for situations such as in calling RequireForUpdate<T>().
Exceptions
| Type | Condition |
|---|---|
| InvalidOperationException | Thrown if the component type has no fields, is enableable, or an entity containing it already exists. |
CreateSingleton<T>(EntityManager, T, FixedString64Bytes)
Creates and supports only a single entity with a given managed component.
Declaration
public static Entity CreateSingleton<T>(this EntityManager manager, T componentData, FixedString64Bytes name = default) where T : class, IComponentData, new()Parameters
| Type | Name | Description |
|---|---|---|
| EntityManager | manager | This entity manager. |
| T | componentData | The data to assign to the singleton component. |
| FixedString64Bytes | name | The debug friendly name associated with the singleton component entity. |
Returns
| Type | Description |
|---|---|
| Entity | The Entity object that you can use to access the singleton component entity. |
Type Parameters
| Name | Description |
|---|---|
| T | The type of component to create. |
Remarks
Note that while zero-size component may be created, they can not be accessed directly in code. They are only usable for situations such as in calling RequireForUpdate<T>().
Exceptions
| Type | Condition |
|---|---|
| InvalidOperationException | Thrown if the component type has no fields, is enableable, or an entity containing it already exists. |