Struct wgpu_core::track::texture::TextureUsageScope

pub(crate) struct TextureUsageScope<A: HalApi> {
    set: TextureStateSet,
    metadata: ResourceMetadata<A>,
}

Stores all texture state within a single usage scope.

Fields

set: TextureStateSet

metadata: ResourceMetadata<A>

Implementations

impl<A: HalApi> TextureUsageScope<A>

pub fn new() -> Self

fn tracker_assert_in_bounds(&self, index: usize)

pub fn set_size(&mut self, size: usize)

Sets the size of all the vectors inside the tracker.

Must be called with the highest possible Texture ID before all unsafe functions are called.

pub fn used(&self) -> impl Iterator<Item = Valid<TextureId>> + '_

Returns a list of all textures tracked.

pub(crate) fn is_empty(&self) -> bool

Returns true if the tracker owns no resources.

This is a O(n) operation.

pub fn merge_usage_scope( &mut self, storage: &Storage<Texture<A>, TextureId>, scope: &Self ) -> Result<(), UsageConflict>

Merge the list of texture states in the given usage scope into this UsageScope.

If any of the resulting states is invalid, stops the merge and returns a usage conflict with the details of the invalid state.

If the given tracker uses IDs higher than the length of internal vectors, the vectors will be extended. A call to set_size is not needed.

pub unsafe fn merge_bind_group( &mut self, storage: &Storage<Texture<A>, TextureId>, bind_group: &TextureBindGroupState<A> ) -> Result<(), UsageConflict>

Merge the list of texture states in the given bind group into this usage scope.

If any of the resulting states is invalid, stops the merge and returns a usage conflict with the details of the invalid state.

Because bind groups do not check if the union of all their states is valid, this method is allowed to return Err on the first bind group bound.

Safety

Self::set_size must be called with the maximum possible Buffer ID before this method is called.

pub unsafe fn merge_single( &mut self, storage: &Storage<Texture<A>, TextureId>, id: Valid<TextureId>, selector: Option<TextureSelector>, ref_count: &RefCount, new_state: TextureUses ) -> Result<(), UsageConflict>

Merge a single state into the UsageScope.

If the resulting state is invalid, returns a usage conflict with the details of the invalid state.

Safety

Unlike other trackers whose merge_single is safe, this method is only called where there is already other unsafe tracking functions active, so we can prove this unsafe “for free”.

Self::set_size must be called with the maximum possible Buffer ID before this method is called.

Trait Implementations

impl<A: Debug + HalApi> Debug for TextureUsageScope<A>

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

Formats the value using the given formatter.