Struct Raster 

pub struct Raster<'a>(/* private fields */);

Borrow a complete raster through the same row-source interface. An attached exact-depth claim is preserved and verified before each push. Unsupported claimed layouts refuse before startup; this is stricter than using an otherwise identical unclaimed view.

Implementations

impl<'a> Raster<'a>

pub const fn new(pixels: PixelSlice<'a>) -> Self

Retain the caller’s raster borrow; source padding is not copied.

Trait Implementations

impl Source for Raster<'_>

type Error = CodecError

Original source error; retained in the operation’s error chain.

fn description(&self) -> Description

Fixed declaration. Changing it during read fails before the next encode.

fn mechanism(&self) -> OutputSource

Acquisition mechanism, not a retained-memory guarantee.

fn borrowed_pixels(&self) -> Option<PixelSlice<'_>>

Return a real immutable raster view retained for the entire operation. The default supplies no borrow. The driver uses this returned storage, never mechanism() or a capability flag, as exact replay evidence.

fn read_rows( &mut self, first: u32, rows: PixelSliceMut<'_>, pulse: Option<&dyn Pulse>, ) -> Result<(), Self::Error>

Fill every active sample of the requested consecutive rows, honoring destination stride. No reading beyond the declared image is requested. A late interpretation change must fail, never relabel earlier samples. None adds no per-call control; any control retained by the source remains active.

fn supports_positional_replay(&self) -> bool

Whether ordered traversals can restart at row zero without reconstructing this source. Defaults to forward-only. This proves no sample identity; positional replay is checked with per-row digests and optional identity.

fn replay_identity(&self) -> Result<Option<[u64; 4]>, Self::Error>

Optional opaque identity/version of this retained source. A stable value is weaker than sample-exact replay. The driver also checks row digests.