Struct MeshAllocator

pub struct MeshAllocator { /* private fields */ }

Manages the assignment of mesh data to GPU buffers.

The Bevy renderer tries to pack vertex and index data for multiple meshes together so that multiple meshes can be drawn back-to-back without any rebinding. This resource manages these buffers.

Within each slab, or hardware buffer, the underlying allocation algorithm is [offset-allocator], a Rust port of Sebastian Aaltonen’s hard-real-time C++ OffsetAllocator. Slabs start small and then grow as their contents fill up, up to a maximum size limit. To reduce fragmentation, vertex and index buffers that are too large bypass this system and receive their own buffers.

The MeshAllocatorSettings allows you to tune the behavior of the allocator for better performance with your application. Most applications won’t need to change the settings from their default values.

Implementations

impl MeshAllocator

pub fn mesh_vertex_slice( &self, mesh_id: &AssetId<Mesh>, ) -> Option<MeshBufferSlice<'_>>

Returns the buffer and range within that buffer of the vertex data for the mesh with the given ID.

If the mesh wasn’t allocated, returns None.

pub fn mesh_index_slice( &self, mesh_id: &AssetId<Mesh>, ) -> Option<MeshBufferSlice<'_>>

Returns the buffer and range within that buffer of the index data for the mesh with the given ID.

If the mesh has no index data or wasn’t allocated, returns None.

Trait Implementations

impl FromWorld for MeshAllocator

fn from_world(world: &mut World) -> Self

Creates Self using data from the given World.

impl Resource for MeshAllocator

where Self: Send + Sync + 'static,