docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

    Method WithPresentChunkComponentRW

    WithPresentChunkComponentRW<T>()

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

    Declaration
    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@)

    In This Article
    Back to top
    Copyright © 2024 Unity Technologies — Trademarks and terms of use
    • Legal
    • Privacy Policy
    • Cookie Policy
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)