Struct MapContext

pub(crate) struct MapContext {
    mapped_range: Range<BufferAddress>,
    sub_ranges: Vec<Subrange>,
}

The mapped portion of a buffer, if any, and its outstanding views.

This ensures that views fall within the mapped range and don’t overlap.

Fields

mapped_range: Range<BufferAddress>

The range of the buffer that is mapped.

This is 0..0 if the buffer is not mapped. This becomes non-empty when the buffer is mapped at creation time, and when you call map_async on some BufferSlice (so technically, it indicates the portion that is or has been requested to be mapped.)

All BufferViews and BufferViewMuts must fall within this range.

sub_ranges: Vec<Subrange>

The ranges covered by all outstanding BufferViews and BufferViewMuts. These are non-overlapping, and are all contained within mapped_range.

Implementations

impl MapContext

pub(crate) fn new(mapped_range: Option<Range<BufferAddress>>) -> Self

Creates a new MapContext.

For mapped_at_creation buffers, pass the full buffer range in the mapped_range argument. For other buffers, pass None.

fn reset(&mut self)

Record that the buffer is no longer mapped.

fn validate_and_add(&mut self, new_sub: Subrange)

Record that the size bytes of the buffer at offset are now viewed.

Panics

This panics if the given range is invalid.

fn remove(&mut self, offset: BufferAddress, size: BufferSize)

Record that the size bytes of the buffer at offset are no longer viewed.

Panics

This panics if the given range does not exactly match one previously passed to MapContext::validate_and_add.

Trait Implementations

impl Debug for MapContext

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

Formats the value using the given formatter.