A [NativeContainer] that provides access to all instances of DynamicBuffer components with elements of type T, indexed by Entity.
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 SystemAPI.GetBufferLookup.
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, SystemAPI.Query 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.
[NativeContainer]: https://docs.unity3d.com/ScriptReference/Unity.Collections.LowLevel.Unsafe.NativeContainerAttribute
[NativeDisableParallelForRestrictionAttribute]: https://docs.unity3d.com/ScriptReference/Unity.Collections.NativeDisableParallelForRestrictionAttribute.html
| Property | Description |
|---|---|
| this[Entity] | Gets the DynamicBuffer<T0> instance of type T for the specified entity. |
| Method | Description |
|---|---|
| DidChange | Reports whether any of IBufferElementData components of the type T, in the chunk containing the specified Entity, could have changed. |
| EntityExists | Reports whether the specified entity exists. Does not consider whether this buffer exists on the given entity. |
| GetEnabledRefRO | Gets a safe reference to the component enabled state. |
| GetEnabledRefROOptional | Gets a safe reference to the component enabled state. |
| GetEnabledRefRW | Gets a safe reference to the buffer component enabled state. |
| GetEnabledRefRWOptional | Gets a safe reference to the component enabled state. |
| HasBuffer | Reports whether the specified Entity instance still refers to a valid entity and that it has a buffer component of type T. |
| IsBufferEnabled | 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. |
| SetBufferEnabled | 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. |
| TryGetBuffer | 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 | 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. |