Method WithPresentChunkComponentRW

WithPresentChunkComponentRW<T>()

Add a required Chunk Component type to the query, whether it is enabled or disabled.

Declaration

[GenerateTestsForBurstCompatibility(GenericTypeArguments = new Type[] { typeof(BurstCompatibleComponentData) })]
public EntityQueryBuilder WithPresentChunkComponentRW<T>()

Returns

Type	Description
EntityQueryBuilder	The builder object that invoked this method.

Type Parameters

Name	Description
T	Component type to use as a required, read-only Chunk Component

Remarks

Call this method on the query builder to find entities that have all the specified chunk components, whether it is enabled or disabled. Chunk components are a distinct component type, which are different from adding the same type as a standard component.

var entityWithPlayerComponent = EntityManager.CreateEntity();
EntityManager.AddComponent<Player>(entityWithPlayerComponent);

     var entityWithPlayerChunkComponent = EntityManager.CreateEntity();
     EntityManager.AddComponent(entityWithPlayerChunkComponent, ComponentType.ChunkComponent<Player>());

     // This query will only match entityWithPlayerComponent
     var playerQuery = new EntityQueryBuilder(Allocator.Temp)
         .WithAll<Player>()
         .Build(this);

     // This query will only match entityWithPlayerChunkComponent
     var chunkPlayerQuery = new EntityQueryBuilder(Allocator.Temp)
         .WithAllChunkComponent<Player>()
         .Build(this);</code></pre></example>

To add additional required Chunk Components, call this method multiple times.

The query will request read-only access to the referenced component(s). To request read/write access, use Unity.Entities.EntityQueryBuilder.WithPresentChunkComponentRW``1(``0@)