Struct image_texel::layout::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> Layout<P>

pub fn width_and_height_for_texel(
    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 with_matrix(pixel: Texel<P>, matrix: MatrixBytes) -> Option<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) -> Layout<Q>

Reinterpret to another, same size pixel type.

See transmute_to for details.

pub fn transmute_to<Q>(self, pixel: Texel<Q>) -> Layout<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<Layout<Q>>

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

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

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

Trait Implementations

impl<P> Clone for Layout<P>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<P> Debug for Layout<P>

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

Formats the value using the given formatter.

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

fn default() -> Self

Returns the “default value” for a type.

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

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

Converts to this type from the input type.

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

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

Converts to this type from the input type.

impl<P> Layout for Layout<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<Matrix<P>> for Layout<P>

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl<P> PartialOrd<Matrix<P>> for Layout<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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

This method 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 Layout<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.

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

fn strided(&self) -> StridedBytes

The valid strided specification of this layout.

impl<P> Take for Layout<P>

fn take(&mut self) -> Self

impl<P> Copy for Layout<P>

impl<P> Eq for Layout<P>