Enum PixelCow 

pub enum PixelCow<'a, P = ()> {
    Borrowed(PixelSlice<'a, P>),
    Owned(PixelBuffer<P>),
}

Borrowed-or-owned pixels with the same metadata and stride-aware view.

This is the pixel-buffer analogue of alloc::borrow::Cow: operations can return a borrowed PixelSlice on their fast path and an owned PixelBuffer only when conversion or mutation requires allocation.

Variants

Borrowed(PixelSlice<'a, P>)

Pixels borrowed from the caller.

Owned(PixelBuffer<P>)

Independently owned pixels.

Implementations

impl<P> PixelCow<'_, P>

pub const fn is_borrowed(&self) -> bool

Whether this value still borrows its pixel storage.

pub const fn is_owned(&self) -> bool

Whether this value owns its pixel storage.

pub fn as_slice(&self) -> PixelSlice<'_, P>

Borrow either representation as a uniform pixel slice.

impl<'a> PixelCow<'a>

pub fn to_mut(&mut self) -> &mut PixelBuffer

Obtain mutable owned pixels, cloning the borrowed pixels if needed.

pub fn into_owned(self) -> PixelBuffer

Consume this value, cloning the pixels only when they are borrowed.

Trait Implementations

impl<P> Debug for PixelCow<'_, P>

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

Formats the value using the given formatter.

impl<'a, P> From<PixelBuffer<P>> for PixelCow<'a, P>

fn from(value: PixelBuffer<P>) -> PixelCow<'a, P>

Converts to this type from the input type.

impl<'a, P> From<PixelSlice<'a, P>> for PixelCow<'a, P>

fn from(value: PixelSlice<'a, P>) -> PixelCow<'a, P>

Converts to this type from the input type.