Struct BufferLookup<T>
A [NativeContainer] that provides access to all instances of DynamicBuffer components with elements of type T, indexed by Entity.
Namespace: Unity.Entities
Syntax
[NativeContainer]
public struct BufferLookup<T>
where T : struct, IBufferElementDataType Parameters
| Name | Description |
|---|---|
| T | The type of IBufferElementData to access. |
Remarks
BufferLookup is a native container that provides array-like access to DynamicBuffer components of a specific type. For example, while iterating over a set of entities, you can use BufferLookup to get and set DynamicBuffers of unrelated entities.
To get a BufferLookup, call GetBufferLookup<T>(Boolean).
Pass a BufferLookup container to a job by defining a public field of the appropriate type in your IJob implementation. You can safely read from BufferLookup in any job, but by default, you cannot write to components in the container in parallel jobs (including IJobEntity, Query<T1>() and IJobChunk). If you know that two instances of a parallel job can never write to the same index in the container, you can disable the restriction on parallel writing by adding NativeDisableParallelForRestrictionAttribute to the BufferLookup field definition in the job struct.
Properties
| Name | Description |
|---|---|
| Item[Entity] | Gets the DynamicBuffer<T> instance of type |
Methods
| Name | Description |
|---|---|
| DidChange(Entity, UInt32) | Reports whether any of IBufferElementData components of the type T, in the chunk containing the specified Entity, could have changed. |
| HasBuffer(Entity) | Reports whether the specified Entity instance still refers to a valid entity and that it has a buffer component of type T. |
| HasComponent(Entity) | Obsolete. Use HasBuffer(Entity) instead. |
| IsBufferEnabled(Entity) | Checks whether the IBufferElementData of type T is enabled on the specified Entity. For the purposes of EntityQuery matching, an entity with a disabled component will behave as if it does not have that component. The type T must implement the IEnableableComponent interface. |
| IsComponentEnabled(Entity) | Obsolete. Use IsBufferEnabled(Entity) instead. |
| SetBufferEnabled(Entity, Boolean) | Enable or disable the IBufferElementData of type T on the specified Entity. This operation does not cause a structural change (even if it occurs on a worker thread), or affect the value of the component. For the purposes of EntityQuery matching, an entity with a disabled component will behave as if it does not have that component. The type T must implement the IEnableableComponent interface. |
| SetComponentEnabled(Entity, Boolean) | Obsolete. Use SetBufferEnabled(Entity, Boolean) instead. |
| TryGetBuffer(Entity, out DynamicBuffer<T>) | Retrieves the buffer components associated with the specified Entity, if it exists. Then reports if the instance still refers to a valid entity and that it has a buffer component of type T. |
| Update(SystemBase) | When a BufferLookup is cached by a system across multiple system updates, calling this function inside the system's OnUpdate() method performs the minimal incremental updates necessary to make the type handle safe to use. |
| Update(ref SystemState) | When a BufferLookup is cached by a system across multiple system updates, calling this function inside the system's OnUpdate() method performs the minimal incremental updates necessary to make the type handle safe to use. |