Struct wgpu_core::track::ResourceTracker

pub struct ResourceTracker<S: ResourceState> { /* fields omitted */ }

A tracker for all resources of a given type.

Methods

impl<S: ResourceState> ResourceTracker<S>

pub fn new(backend: Backend) -> Self

Create a new empty tracker.

pub fn remove(&mut self, id: S::Id) -> bool

Remove an id from the tracked map.

pub fn remove_abandoned(&mut self, id: S::Id) -> bool

Removes the resource from the tracker if we are holding the last reference.

pub fn optimize(&mut self)

Try to optimize the internal representation.

pub fn used<'a>(&'a self) -> impl 'a + Iterator<Item = S::Id>

Return an iterator over used resources keys.

pub fn is_empty(&self) -> bool

Returns true if the tracker is empty.

pub fn init(
    &mut self,
    id: S::Id,
    ref_count: RefCount,
    state: S
) -> Result<(), &S>

Initialize a resource to be used.

Returns false if the resource is already registered.

pub fn query(&self, id: S::Id, selector: S::Selector) -> Option<S::Usage>

Query the usage of a resource selector.

Returns Some(Usage) only if this usage is consistent across the given selector.

pub fn change_extend(
    &mut self,
    id: S::Id,
    ref_count: &RefCount,
    selector: S::Selector,
    usage: S::Usage
) -> Result<(), PendingTransition<S>>

Extend the usage of a specified resource.

Returns conflicting transition as an error.

pub fn change_replace(
    &mut self,
    id: S::Id,
    ref_count: &RefCount,
    selector: S::Selector,
    usage: S::Usage
) -> Drain<PendingTransition<S>>

Replace the usage of a specified resource.

pub fn merge_extend(&mut self, other: &Self) -> Result<(), PendingTransition<S>>

Merge another tracker into self by extending the current states without any transitions.

pub fn merge_replace<'a>(
    &'a mut self,
    other: &'a Self
) -> Drain<PendingTransition<S>>

Merge another tracker, adding it's transitions to self. Transitions the current usage to the new one.

pub fn use_extend<'a, T: 'a + Borrow<RefCount>>(
    &mut self,
    storage: &'a Storage<T, S::Id>,
    id: S::Id,
    selector: S::Selector,
    usage: S::Usage
) -> Result<&'a T, S::Usage>

Use a given resource provided by an Id with the specified usage. Combines storage access by 'Id' with the transition that extends the last read-only usage, if possible.

Returns the old usage as an error if there is a conflict.

pub fn use_replace<'a, T: 'a + Borrow<RefCount>>(
    &mut self,
    storage: &'a Storage<T, S::Id>,
    id: S::Id,
    selector: S::Selector,
    usage: S::Usage
) -> (&'a T, Drain<PendingTransition<S>>)

Use a given resource provided by an Id with the specified usage. Combines storage access by 'Id' with the transition that replaces the last usage with a new one, returning an iterator over these transitions.

Trait Implementations

impl<S: ResourceState + Debug> Debug for ResourceTracker<S>

fn fmt(&self, formatter: &mut Formatter) -> Result

Formats the value using the given formatter.