Struct Matrix 

pub struct Matrix<P> { /* private fields */ }

A matrix of packed texels (channel groups).

The underlying buffer may have more data allocated than this region and cause the overhead to be reused when resizing the image. All ways to construct this already check that all pixels within the resulting image can be addressed via an index.

Implementations

impl<P> Matrix<P>

pub fn from_width_height( pixel: Texel<P>, width: usize, height: usize, ) -> Option<Self>

pub fn width_and_height(width: usize, height: usize) -> Option<Self>

where P: AsTexel,

pub const fn empty(pixel: Texel<P>) -> Self

pub fn into_matrix_bytes(self) -> MatrixBytes

pub fn byte_len(self) -> usize

Get the required bytes for this layout.

pub fn len(self) -> usize

The number of pixels in this layout

pub fn width(self) -> usize

pub fn height(self) -> usize

pub fn pixel(self) -> Texel<P>

pub fn transmute<Q: AsTexel>(self) -> Matrix<Q>

Reinterpret to another, same size pixel type.

See transmute_to for details.

pub fn transmute_to<Q>(self, pixel: Texel<Q>) -> Matrix<Q>

Reinterpret to another, same size pixel type.

Panics

Like std::mem::transmute, the size of the two types need to be equal. This ensures that all indices are valid in both directions.

pub fn map<Q: AsTexel>(self) -> Option<Matrix<Q>>

Utility method to change the pixel type without changing the dimensions.

pub fn map_to<Q>(self, pixel: Texel<Q>) -> Option<Matrix<Q>>

Utility method to change the pixel type without changing the dimensions.

impl<P> Matrix<P>

pub fn with_matrix(pixel: Texel<P>, matrix: MatrixBytes) -> Option<Self>

Trait Implementations

impl<P> Clone for Matrix<P>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<P> Copy for Matrix<P>

impl<P> Debug for Matrix<P>

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

Formats the value using the given formatter.

impl<P: AsTexel> Default for Matrix<P>

fn default() -> Self

Returns the “default value” for a type.

impl<P> Eq for Matrix<P>

impl<P> From<Matrix<P>> for MatrixBytes

fn from(mat: Matrix<P>) -> Self

Converts to this type from the input type.

impl<P> From<Matrix<P>> for Bytes

fn from(layout: Matrix<P>) -> Self

Converts to this type from the input type.

impl<P> Layout for Matrix<P>

fn byte_len(&self) -> usize

impl<P> MatrixLayout for Matrix<P>

fn matrix(&self) -> MatrixBytes

The valid matrix specification of this layout.

impl<P> PartialEq for Matrix<P>

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<P> PartialOrd for Matrix<P>

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<P> Raster<P> for Matrix<P>

Note: on 64-bit targets only the first u32::MAX dimensions appear accessible.

fn dimensions(&self) -> Coord

fn get(from: ImageRef<'_, &Self>, Coord: Coord) -> Option<P>

impl<P> RasterMut<P> for Matrix<P>

fn put(into: ImageMut<'_, &mut Self>, Coord: Coord, val: P)

fn shade(image: ImageMut<'_, &mut Self>, f: impl FnMut(u32, u32, &mut Pixel))

Evaluate a function on each texel of the raster image.

impl<P> SliceLayout for Matrix<P>

type Sample = P

The sample type itself.

fn sample(&self) -> Texel<P>

Get the sample description.

fn len(&self) -> usize

The number of samples.

fn as_index(&self) -> TexelRange<Self::Sample>

impl<P: AsTexel> StridedLayout for Matrix<P>

fn strided(&self) -> StridedBytes

The valid strided specification of this layout.

impl<P> Take for Matrix<P>

fn take(&mut self) -> Self