Struct PlaneView 

pub struct PlaneView<'a> { /* private fields */ }

One plane borrowed from a mapping. The stride is in bytes, as in zenpixels; rows exclude padding. Construction checks the geometry, not the samples.

Implementations

impl<'a> PlaneView<'a>

pub fn new( samples: PlaneSamples<'a>, width: usize, height: usize, stride_bytes: usize, encoding: SampleEncoding, ) -> Result<PlaneView<'a>, PlaneError>

A width x height plane over samples with rows stride_bytes apart.

Errors

A PlaneError when the storage does not fit the geometry.

pub fn width(&self) -> usize

Width in samples.

pub fn height(&self) -> usize

Height in rows.

pub fn stride_bytes(&self) -> usize

Distance between rows, in bytes.

pub fn encoding(&self) -> SampleEncoding

The sample encoding.

pub fn as_strided_samples(&self) -> PlaneSamples<'a>

Borrow the strided storage through the last active sample, including padding between rows but excluding trailing allocation space.

Empty geometry returns an empty slice. This does not copy, normalize, shift or mask samples: consumers must honor Self::encoding and Self::stride_bytes. Padding has no sample meaning. The borrow is bounded by the native mapping guard, just like Self::row.

pub fn row(&self, y: usize) -> Option<PlaneSamples<'a>>

Row y, without padding. A zero-width row is empty regardless of stride.

pub fn code(&self, x: usize, y: usize) -> Option<u16>

The code value at (x, y): the stored word shifted and masked per the encoding.

Trait Implementations

impl<'a> Clone for PlaneView<'a>

fn clone(&self) -> PlaneView<'a>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a> Copy for PlaneView<'a>

impl<'a> Debug for PlaneView<'a>

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

Formats the value using the given formatter.