Struct ExclusiveEntityTransaction
Provides an interface to safely perform a subset of EntityManager operations from a single worker thread, by temporarily giving that thread exclusive access to a World's EntityManager.
Namespace: Unity.Entities
Assembly: Unity.Entities.dll
Syntax
public struct ExclusiveEntityTransactionRemarks
The intended use case for this interface is to let a worker thread stream Entity data into a staging World and perform any necessary post-processing structural changes, prior to moving the final data into the main simulation world using MoveEntitiesFrom(EntityManager). This lets the main thread continue to safely process the primary world while the new data is loading in, and not require a main-thread sync point until the new Entities are fully loaded and ready to be injected.
Warning: Only the EntityManager operations exposed by this struct are supported within the context of an exclusive entity transaction. For more information, refer to Safety in Entities.
Properties
| Name | Description |
|---|---|
| EntityManager | Return the entity manager this transaction operates upon. |
Methods
| Name | Description |
|---|---|
| AddBuffer<T>(Entity) | Adds a dynamic buffer component to an entity. |
| AddComponent(Entity, ComponentType) | Adds a component to an entity. |
| AddSharedComponentData<T>(Entity, T) | Obsolete. Use AddSharedComponentManaged<T>(Entity, T) instead. |
| AddSharedComponentManaged<T>(NativeArray<Entity>, T) | Adds a shared component to an array of entities |
| AddSharedComponentManaged<T>(Entity, T) | Adds a shared component to an entity. |
| AddSharedComponent<T>(NativeArray<Entity>, T) | Adds a shared component to multiple entities |
| AddSharedComponent<T>(Entity, T) | Adds a shared component to an entity. |
| CreateArchetype(params ComponentType[]) | Creates an archetype from a set of component types. |
| CreateEntity(params ComponentType[]) | Creates an entity having components of the specified types. |
| CreateEntity(EntityArchetype) | Creates an entity having the specified archetype. |
| CreateEntity(EntityArchetype, NativeArray<Entity>) | Creates a set of entities of the specified archetype. |
| DestroyEntity(NativeArray<Entity>) | Destroys all entities in an array. |
| DestroyEntity(NativeSlice<Entity>) | Destroys all entities in a slice of an array. |
| DestroyEntity(Entity) | Destroys an entity. |
| Exists(Entity) | Reports whether an Entity object is still valid. |
| GetBuffer<T>(Entity, bool) | Gets the dynamic buffer of an entity. |
| GetComponentData<T>(Entity) | Gets the value of a component for an entity. |
| GetSharedComponentData<T>(Entity) | Obsolete. Use GetSharedComponentManaged<T>(Entity) instead. |
| GetSharedComponentManaged<T>(Entity) | Gets a shared component from an entity. |
| GetSharedComponent<T>(Entity) | Gets a shared component from an entity. |
| HasBuffer<T>(Entity) | Checks whether an entity has a dynamic buffer of a specific IBufferElementData type. |
| HasComponent(Entity, ComponentType) | Checks whether an entity has a specific type of component. |
| Instantiate(Entity) | Clones an entity. |
| Instantiate(Entity, NativeArray<Entity>) | Makes multiple clones of an entity. |
| IsComponentEnabled(Entity, ComponentType) | Checks whether a given ComponentType is enabled on the specified Entity. |
| IsComponentEnabled<T>(Entity) | Checks whether a given ComponentType is enabled on the specified Entity. |
| RemoveComponent(Entity, ComponentType) | Removes a component from an entity. |
| SetComponentData<T>(Entity, T) | Sets the value of a component of an entity. |
| SetComponentEnabled(Entity, ComponentType, bool) | Enable or disable ComponentType on the specified Entity. |
| SetComponentEnabled<T>(Entity, bool) | Enable or disable a ComponentType on the specified Entity. |
| SetSharedComponentData<T>(Entity, T) | Obsolete. Use SetSharedComponentManaged<T>(Entity, T) instead. |
| SetSharedComponentManaged<T>(NativeArray<Entity>, T) | Sets the shared component on an array of entities |
| SetSharedComponentManaged<T>(Entity, T) | Sets the shared component of an entity. |
| SetSharedComponent<T>(NativeArray<Entity>, T) | Sets the shared component value on an array of entities |
| SetSharedComponent<T>(Entity, T) | Sets the shared component of an entity. |
| SwapComponents(ArchetypeChunk, int, ArchetypeChunk, int) | Swaps the components of two entities. |