Struct MeshAllocatorSettings

pub struct MeshAllocatorSettings {
    pub min_slab_size: u64,
    pub max_slab_size: u64,
    pub large_threshold: u64,
    pub growth_factor: f64,
}

Tunable parameters that customize the behavior of the allocator.

Generally, these parameters adjust the tradeoff between memory fragmentation and performance. You can adjust them as desired for your application. Most applications can stick with the default values.

Fields

min_slab_size: u64

The minimum size of a slab (hardware buffer), in bytes.

The default value is 1 MiB.

max_slab_size: u64

The maximum size of a slab (hardware buffer), in bytes.

When a slab reaches this limit, a new slab is created.

The default value is 512 MiB.

large_threshold: u64

The maximum size of vertex or index data that can be placed in a general slab, in bytes.

If a mesh has vertex or index data that exceeds this size limit, that data is placed in its own slab. This reduces fragmentation, but incurs more CPU-side binding overhead when drawing the mesh.

The default value is 256 MiB.

growth_factor: f64

The factor by which we scale a slab when growing it.

This value must be greater than 1. Higher values result in more fragmentation but fewer expensive copy operations when growing the buffer.

The default value is 1.5.

Trait Implementations

impl Default for MeshAllocatorSettings

fn default() -> Self

Returns the “default value” for a type.

impl Resource for MeshAllocatorSettings

where Self: Send + Sync + 'static,