Struct bevy_ecs::query::BatchingStrategy

pub struct BatchingStrategy {
    pub batch_size_limits: Range<usize>,
    pub batches_per_thread: usize,
}

Dictates how a parallel query chunks up large tables/archetypes during iteration.

A parallel query will chunk up large tables and archetypes into chunks of at most a certain batch size.

By default, this batch size is automatically determined by dividing the size of the largest matched archetype by the number of threads (rounded up). This attempts to minimize the overhead of scheduling tasks onto multiple threads, but assumes each entity has roughly the same amount of work to be done, which may not hold true in every workload.

See Query::par_iter for more information.

Fields

batch_size_limits: Range<usize>

The upper and lower limits for how large a batch of entities.

Setting the bounds to the same value will result in a fixed batch size.

Defaults to [1, usize::MAX].

batches_per_thread: usize

The number of batches per thread in the ComputeTaskPool. Increasing this value will decrease the batch size, which may increase the scheduling overhead for the iteration.

Defaults to 1.

Implementations

impl BatchingStrategy

pub const fn new() -> Self

Creates a new unconstrained default batching strategy.

pub const fn fixed(batch_size: usize) -> Self

Declares a batching strategy with a fixed batch size.

pub const fn min_batch_size(self, batch_size: usize) -> Self

Configures the minimum allowed batch size of this instance.

pub const fn max_batch_size(self, batch_size: usize) -> Self

Configures the maximum allowed batch size of this instance.

pub fn batches_per_thread(self, batches_per_thread: usize) -> Self

Configures the number of batches to assign to each thread for this instance.

Trait Implementations

impl Clone for BatchingStrategy

fn clone(&self) -> BatchingStrategy

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.