Struct image::flat::ViewMut[][src]

pub struct ViewMut<Buffer, P: Pixel> where
    Buffer: AsMut<[P::Subpixel]>, 
{ /* fields omitted */ }

A mutable owning version of a flat buffer.

While this wraps a buffer similar to ImageBuffer, this is mostly intended as a utility. The library endorsed normalized representation is still ImageBuffer. Also, the implementation of AsMut<[P::Subpixel]> must always yield the same buffer. Therefore there is no public way to construct this with an owning buffer.

Inner invariants

Implementations

impl<Buffer, P: Pixel> ViewMut<Buffer, P> where
    Buffer: AsMut<[P::Subpixel]>, 
[src]

pub fn into_inner(self) -> FlatSamples<Buffer>[src]

Take out the sample buffer.

Gives up the normalization invariants on the buffer format.

pub fn flat(&self) -> &FlatSamples<Buffer>[src]

Get a reference on the sample buffer descriptor.

There is no mutable counterpart as modifying the buffer format, including strides and lengths, could invalidate the accessibility invariants of the View. It is not specified if the inner buffer is the same as the buffer of the image from which this view was created. It might have been truncated as an optimization.

pub fn samples(&self) -> &Buffer[src]

Get a reference on the inner buffer.

There is no mutable counter part since it is not intended to allow you to reassign the buffer or otherwise change its size or properties. However, its contents can be accessed mutable through a slice with image_mut_slice.

pub fn min_length(&self) -> usize[src]

Get the minimum length of a buffer such that all in-bounds samples have valid indices.

See FlatSamples::min_length. This method will always succeed.

pub fn get_sample(&self, channel: u8, x: u32, y: u32) -> Option<&P::Subpixel> where
    Buffer: AsRef<[P::Subpixel]>, 
[src]

Get a reference to a selected subpixel.

This method will return None when the sample is out-of-bounds. All errors that could occur due to overflow have been eliminated while construction the View.

pub fn get_mut_sample(
    &mut self,
    channel: u8,
    x: u32,
    y: u32
) -> Option<&mut P::Subpixel>
[src]

Get a mutable reference to a selected sample.

This method will return None when the sample is out-of-bounds. All errors that could occur due to overflow have been eliminated while construction the View.

pub fn image_slice(&self) -> &[P::Subpixel] where
    Buffer: AsRef<[P::Subpixel]>, 
[src]

Return the portion of the buffer that holds sample values.

While this can not fail–the validity of all coordinates has been validated during the conversion from FlatSamples–the resulting slice may still contain holes.

pub fn image_mut_slice(&mut self) -> &mut [P::Subpixel][src]

Return the mutable buffer that holds sample values.

pub fn shrink_to(&mut self, width: u32, height: u32)[src]

Shrink the inner image.

The new dimensions will be the minimum of the previous dimensions. Since the set of in-bounds pixels afterwards is a subset of the current ones, this is allowed on a View. Note that you can not change the number of channels as an intrinsic property of P.

Trait Implementations

impl<Buffer: Clone, P: Clone + Pixel> Clone for ViewMut<Buffer, P> where
    Buffer: AsMut<[P::Subpixel]>, 
[src]

impl<Buffer: Debug, P: Debug + Pixel> Debug for ViewMut<Buffer, P> where
    Buffer: AsMut<[P::Subpixel]>, 
[src]

impl<Buffer, P: Pixel> GenericImage for ViewMut<Buffer, P> where
    Buffer: AsMut<[P::Subpixel]> + AsRef<[P::Subpixel]>, 
[src]

type InnerImage = Self

Underlying image type. This is mainly used by SubImages in order to always have a reference to the original image. This allows for less indirections and it eases the use of nested SubImages. Read more

impl<Buffer, P: Pixel> GenericImageView for ViewMut<Buffer, P> where
    Buffer: AsMut<[P::Subpixel]> + AsRef<[P::Subpixel]>, 
[src]

type Pixel = P

The type of pixel.

type InnerImageView = Self

Underlying image type. This is mainly used by SubImages in order to always have a reference to the original image. This allows for less indirections and it eases the use of nested SubImages. Read more

Auto Trait Implementations

impl<Buffer, P> RefUnwindSafe for ViewMut<Buffer, P> where
    Buffer: RefUnwindSafe,
    P: RefUnwindSafe

impl<Buffer, P> Send for ViewMut<Buffer, P> where
    Buffer: Send,
    P: Send

impl<Buffer, P> Sync for ViewMut<Buffer, P> where
    Buffer: Sync,
    P: Sync

impl<Buffer, P> Unpin for ViewMut<Buffer, P> where
    Buffer: Unpin,
    P: Unpin

impl<Buffer, P> UnwindSafe for ViewMut<Buffer, P> where
    Buffer: UnwindSafe,
    P: UnwindSafe

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized
[src]

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

impl<T> From<T> for T[src]

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

impl<T> ToOwned for T where
    T: Clone
[src]

type Owned = T

The resulting type after obtaining ownership.

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.