Struct PixelSliceMut 

#[non_exhaustive]
pub struct PixelSliceMut<'a, P = ()> { /* private fields */ }

Mutable borrowed view of pixel data.

Same semantics as PixelSlice but allows writing to rows. The type parameter P tracks pixel format at compile time.

Implementations

impl<'a> PixelSliceMut<'a>

pub fn new( data: &'a mut [u8], width: u32, rows: u32, stride_bytes: usize, descriptor: PixelDescriptor, ) -> Result<PixelSliceMut<'a>, At<BufferError>>

Create a new mutable pixel slice with validation.

stride_bytes is the byte distance between the start of consecutive rows.

Errors

Returns an error if the data is too small, the stride is too small, or the data is not aligned for the channel type.

impl<'a, P> PixelSliceMut<'a, P>

pub fn erase(self) -> PixelSliceMut<'a>

Erase the pixel type, returning a type-erased mutable slice.

pub fn try_typed<Q>(self) -> Option<PixelSliceMut<'a, Q>>

where Q: Pixel,

Try to reinterpret as a typed mutable pixel slice.

Succeeds if the descriptors are layout-compatible.

pub fn with_descriptor( self, descriptor: PixelDescriptor, ) -> PixelSliceMut<'a, P>

Replace the descriptor with a layout-compatible one.

See PixelSlice::with_descriptor() for details.

pub fn reinterpret( self, descriptor: PixelDescriptor, ) -> Result<PixelSliceMut<'a, P>, At<BufferError>>

Reinterpret the buffer with a different physical layout.

See PixelSlice::reinterpret() for details.

pub fn with_transfer(self, tf: TransferFunction) -> PixelSliceMut<'a, P>

Return a copy with a different transfer function.

pub fn with_primaries(self, cp: ColorPrimaries) -> PixelSliceMut<'a, P>

Return a copy with different color primaries.

pub fn with_signal_range(self, sr: SignalRange) -> PixelSliceMut<'a, P>

Return a copy with a different signal range.

pub fn with_alpha_mode(self, am: Option<AlphaMode>) -> PixelSliceMut<'a, P>

Return a copy with a different alpha mode.

pub fn width(&self) -> u32

Image width in pixels.

pub fn rows(&self) -> u32

Number of rows in this slice.

pub fn stride(&self) -> usize

Byte stride between row starts.

pub fn descriptor(&self) -> PixelDescriptor

Pixel format descriptor.

pub fn color_context(&self) -> Option<&Arc<ColorContext>>

Source color context (ICC/CICP metadata), if set.

pub fn with_color_context(self, ctx: Arc<ColorContext>) -> PixelSliceMut<'a, P>

Return a copy of this slice with a color context attached.

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

Reborrow as an immutable PixelSlice (zero-copy).

The returned slice borrows from self, so the mutable slice cannot be used while the immutable reborrow is alive.

pub fn as_strided_bytes(&self) -> &[u8]

Zero-copy access to the raw backing bytes, including any stride padding.

Unlike PixelSlice::as_strided_bytes() (which clips to the image extent), this returns the full backing buffer so callers can write stride padding (zeroing, codec requirements, etc.).

pub fn as_strided_bytes_mut(&mut self) -> &mut [u8]

Mutable access to the raw backing bytes, including any stride padding.

Returns the full backing buffer so callers can write stride padding.

pub fn row(&self, y: u32) -> &[u8]

Pixel bytes for row y (immutable, no padding).

Panics

Panics if y >= rows.

pub fn row_mut(&mut self, y: u32) -> &mut [u8]

Mutable pixel bytes for row y (no padding).

Panics

Panics if y >= rows.

pub fn sub_rows_mut(&mut self, y: u32, count: u32) -> PixelSliceMut<'_, P>

Borrow a mutable sub-range of rows.

Panics

Panics if y + count > rows.

impl<'a, P> PixelSliceMut<'a, P>

where P: Pixel,

pub fn new_typed( data: &'a mut [u8], width: u32, rows: u32, stride_pixels: u32, ) -> Result<PixelSliceMut<'a, P>, At<BufferError>>

Create a typed mutable pixel slice.

stride_pixels is the number of pixels per row (>= width). The byte stride is stride_pixels * size_of::<P>().

impl<'a> PixelSliceMut<'a, Rgbx>

pub fn swap_to_bgrx(self) -> PixelSliceMut<'a, Bgrx>

Byte-swap R<->B channels in place, converting to BGRX.

impl<'a> PixelSliceMut<'a, Bgrx>

pub fn swap_to_rgbx(self) -> PixelSliceMut<'a, Rgbx>

Byte-swap B<->R channels in place, converting to RGBX.

Trait Implementations

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

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

Formats the value using the given formatter.

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

Consume a mutable pixel slice and produce an immutable one (zero-copy).

fn from(mut_slice: PixelSliceMut<'a, P>) -> PixelSlice<'a, P>

Converts to this type from the input type.

impl<'a, P> From<PixelSliceMut<'a, P>> for PixelSliceMut<'a>

where P: Pixel,

fn from(typed: PixelSliceMut<'a, P>) -> PixelSliceMut<'a>

Converts to this type from the input type.