Struct wgpu_core::track::TrackerIndexAllocator

struct TrackerIndexAllocator {
    unused: Vec<TrackerIndex>,
    next_index: TrackerIndex,
}

wgpu-core internally use some array-like storage for tracking resources. To that end, there needs to be a uniquely assigned index for each live resource of a certain type. This index is separate from the resource ID for various reasons:

• There can be multiple resource IDs pointing the the same resource.
• IDs of dead handles can be recycled while resources are internally held alive (and tracked).
• The plan is to remove IDs in the long run (#5121).

In order to produce these tracker indices, there is a shared TrackerIndexAllocator per resource type. Indices have the same lifetime as the internal resource they are associated to (alloc happens when creating the resource and free is called when the resource is dropped).

Fields

unused: Vec<TrackerIndex>

next_index: TrackerIndex

Implementations

impl TrackerIndexAllocator

pub fn new() -> Self

pub fn alloc(&mut self) -> TrackerIndex

pub fn free(&mut self, index: TrackerIndex)

pub fn size(&self) -> usize

Trait Implementations

impl Debug for TrackerIndexAllocator

fn fmt(&self, _: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.