Struct embedded_canvas::Canvas

source · [−]

pub struct Canvas<C: PixelColor> {
    pub canvas: Size,
    pub pixels: Box<[Option<C>]>,
}

Expand description

Canvas on which you can draw but it’s not drawable on the display yet.

Draw on the Canvas using origin of Point::zero().

Fields

canvas: Size

The size of the Canvas.

pixels: Box<[Option<C>]>

The pixels of the Canvas.

Implementations

source

impl<C: PixelColor> Canvas<C>

source

pub fn new(canvas: Size) -> Self

Create a new blank Canvas.

Panics

Panics when width * height > usize::MAX.

source

pub fn with_default_color(canvas: Size, default_color: C) -> Self

Create a Canvas filled with a default color.

Panics

Panics when width * height > usize::MAX.

source

pub fn center(&self) -> Point

Returns the center of Size of the Canvas.

source

pub fn crop(&self, area: &Rectangle) -> Option<Canvas<C>>

Create a new cropped Canvas.

This method takes into account the top left Point of the area you’d like to crop relative to the Canvas itself. If the width or height of the Rectangle is 0, this method will return None (see Rectangle::bottom_right())

source

pub fn place_at(&self, top_left: Point) -> CanvasAt<C>

Sets the place with top left offset where the canvas will be drawn to the display.

source

pub fn place_center(&self, center: Point) -> CanvasAt<C>

Sets the center of the Canvas where it will be drawn to the display.

Trait Implementations

source

impl<C: PixelColor> DrawTarget for Canvas<C>

type Color = C

The pixel color type the targetted display supports.

type Error = Infallible

Error type to return when a drawing operation fails. Read more

source

fn draw_iter(&mut self, pixels: I) -> Result<(), Self::Error> where
I: IntoIterator<Item = Pixel<Self::Color>>,

Draw individual pixels to the display without a defined order. Read more

source

fn fill_contiguous(
 &mut self,
 area: &Rectangle,
 colors: I
) -> Result<(), Self::Error> where
 I: IntoIterator<Item = Self::Color>,

Fill a given area with an iterator providing a contiguous stream of pixel colors. Read more

source

fn fill_solid(
 &mut self,
 area: &Rectangle,
 color: Self::Color
) -> Result<(), Self::Error>

Fill a given area with a solid color. Read more

source

fn clear(&mut self, color: Self::Color) -> Result<(), Self::Error>

Fill the entire display with a solid color. Read more

source

impl<C: PixelColor> OriginDimensions for Canvas<C>

source

fn size(&self) -> Size

Returns the size of the bounding box.

Auto Trait Implementations

impl<C> RefUnwindSafe for Canvas<C> where
C: RefUnwindSafe,

impl<C> Send for Canvas<C> where
C: Send,

impl<C> Sync for Canvas<C> where
C: Sync,

impl<C> Unpin for Canvas<C>

impl<C> UnwindSafe for Canvas<C> where
C: UnwindSafe,

Blanket Implementations

source

impl<T> Any for T where
T: 'static + ?Sized,

source

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

source

impl<T> Az for T

source

fn az<Dst>(self) -> Dst where
T: Cast<Dst>,

Casts the value.

source

impl<T> Borrow<T> for T where
T: ?Sized,

const: unstable · source

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

source

impl<T> BorrowMut<T> for T where
T: ?Sized,

const: unstable · source

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

source

impl<Src, Dst> CastFrom<Src> for Dst where
Src: Cast<Dst>,

source

fn cast_from(src: Src) -> Dst

Casts the value.

source

impl<T> CheckedAs for T

source

fn checked_as<Dst>(self) -> Option<Dst> where
T: CheckedCast<Dst>,

Casts the value.

source

impl<Src, Dst> CheckedCastFrom<Src> for Dst where
Src: CheckedCast<Dst>,

source

fn checked_cast_from(src: Src) -> Option<Dst>

Casts the value.

source

impl<T> Dimensions for T where
T: OriginDimensions,

source

fn bounding_box(&self) -> Rectangle

Returns the bounding box.

source

impl<T> DrawTargetExt for T where
T: DrawTarget,

source

fn translated(&mut self, offset: Point) -> Translated<'_, T>

Creates a translated draw target based on this draw target. Read more

source

fn cropped(&mut self, area: &Rectangle) -> Cropped<'_, T>

Creates a cropped draw target based on this draw target. Read more

source

fn clipped(&mut self, area: &Rectangle) -> Clipped<'_, T>

Creates a clipped draw target based on this draw target. Read more

source

fn color_converted<C>(&mut self) -> ColorConverted<'_, T, C> where
C: PixelColor + Into<<T as DrawTarget>::Color>,

Creates a color conversion draw target. Read more

source

impl<T> From<T> for T

const: unstable · source

fn from(t: T) -> T

Returns the argument unchanged.

source

impl<T, U> Into for T where
U: From<T>,

const: unstable · source

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source

impl<T> OverflowingAs for T

source

fn overflowing_as<Dst>(self) -> (Dst, bool) where
T: OverflowingCast<Dst>,

Casts the value.

source

impl<Src, Dst> OverflowingCastFrom<Src> for Dst where
Src: OverflowingCast<Dst>,

source

fn overflowing_cast_from(src: Src) -> (Dst, bool)

OverflowingCasts the value.

source

impl<T> SaturatingAs for T

source

fn saturating_as<Dst>(self) -> Dst where
T: SaturatingCast<Dst>,

Casts the value.

source

impl<Src, Dst> SaturatingCastFrom<Src> for Dst where
Src: SaturatingCast<Dst>,

source

fn saturating_cast_from(src: Src) -> Dst

Casts the value.

source

impl<T, U> TryFrom for T where
U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

const: unstable · source

fn try_from(value: U) -> Result<T, <T as TryFrom>::Error>

Performs the conversion.

source

impl<T, U> TryInto for T where
U: TryFrom<T>,

type Error = >::Error

The type returned in the event of a conversion error.

const: unstable · source

fn try_into(self) -> Result<U, >::Error>

Performs the conversion.

source

impl<T> UnwrappedAs for T

source

fn unwrapped_as<Dst>(self) -> Dst where
T: UnwrappedCast<Dst>,

Casts the value.

source

impl<Src, Dst> UnwrappedCastFrom<Src> for Dst where
Src: UnwrappedCast<Dst>,

source

fn unwrapped_cast_from(src: Src) -> Dst

UnwrappedCasts the value.

source

impl<T> WrappingAs for T

source

fn wrapping_as<Dst>(self) -> Dst where
T: WrappingCast<Dst>,

Casts the value.

source

impl<Src, Dst> WrappingCastFrom<Src> for Dst where
Src: WrappingCast<Dst>,

source

fn wrapping_cast_from(src: Src) -> Dst

WrappingCasts the value.

Struct embedded_canvas::Canvas

Fields

Implementations

impl<C: PixelColor> Canvas<C>

pub fn new(canvas: Size) -> Self

pub fn with_default_color(canvas: Size, default_color: C) -> Self

pub fn center(&self) -> Point

pub fn crop(&self, area: &Rectangle) -> Option<Canvas<C>>

pub fn place_at(&self, top_left: Point) -> CanvasAt<C>

pub fn place_center(&self, center: Point) -> CanvasAt<C>

Trait Implementations

impl<C: PixelColor> DrawTarget for Canvas<C>

type Color = C

type Error = Infallible

fn draw_iter<I>(&mut self, pixels: I) -> Result<(), Self::Error> where I: IntoIterator<Item = Pixel<Self::Color>>,

fn fill_contiguous<I>( &mut self, area: &Rectangle, colors: I) -> Result<(), Self::Error> where I: IntoIterator<Item = Self::Color>,

fn fill_solid( &mut self, area: &Rectangle, color: Self::Color) -> Result<(), Self::Error>

fn clear(&mut self, color: Self::Color) -> Result<(), Self::Error>

impl<C: PixelColor> OriginDimensions for Canvas<C>

fn size(&self) -> Size

Auto Trait Implementations

impl<C> RefUnwindSafe for Canvas<C> where C: RefUnwindSafe,

impl<C> Send for Canvas<C> where C: Send,

impl<C> Sync for Canvas<C> where C: Sync,

impl<C> Unpin for Canvas<C>

impl<C> UnwindSafe for Canvas<C> where C: UnwindSafe,

Blanket Implementations

impl<T> Any for T where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

impl<T> Az for T

fn az<Dst>(self) -> Dst where T: Cast<Dst>,

impl<T> Borrow<T> for T where T: ?Sized,

fn borrow(&self) -> &T

impl<T> BorrowMut<T> for T where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

impl<Src, Dst> CastFrom<Src> for Dst where Src: Cast<Dst>,

fn cast_from(src: Src) -> Dst

impl<T> CheckedAs for T

fn checked_as<Dst>(self) -> Option<Dst> where T: CheckedCast<Dst>,

impl<Src, Dst> CheckedCastFrom<Src> for Dst where Src: CheckedCast<Dst>,

fn checked_cast_from(src: Src) -> Option<Dst>

impl<T> Dimensions for T where T: OriginDimensions,

fn bounding_box(&self) -> Rectangle

impl<T> DrawTargetExt for T where T: DrawTarget,

fn translated(&mut self, offset: Point) -> Translated<'_, T>

fn cropped(&mut self, area: &Rectangle) -> Cropped<'_, T>

fn clipped(&mut self, area: &Rectangle) -> Clipped<'_, T>

fn color_converted<C>(&mut self) -> ColorConverted<'_, T, C> where C: PixelColor + Into<<T as DrawTarget>::Color>,

impl<T> From<T> for T

fn from(t: T) -> T

impl<T, U> Into<U> for T where U: From<T>,

fn into(self) -> U

impl<T> OverflowingAs for T

fn overflowing_as<Dst>(self) -> (Dst, bool) where T: OverflowingCast<Dst>,

impl<Src, Dst> OverflowingCastFrom<Src> for Dst where Src: OverflowingCast<Dst>,

fn overflowing_cast_from(src: Src) -> (Dst, bool)

impl<T> SaturatingAs for T

fn saturating_as<Dst>(self) -> Dst where T: SaturatingCast<Dst>,

impl<Src, Dst> SaturatingCastFrom<Src> for Dst where Src: SaturatingCast<Dst>,

fn saturating_cast_from(src: Src) -> Dst

impl<T, U> TryFrom<U> for T where U: Into<T>,

type Error = Infallible

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

impl<T, U> TryInto<U> for T where U: TryFrom<T>,

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

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

impl<T> UnwrappedAs for T

fn unwrapped_as<Dst>(self) -> Dst where T: UnwrappedCast<Dst>,

impl<Src, Dst> UnwrappedCastFrom<Src> for Dst where Src: UnwrappedCast<Dst>,

fn unwrapped_cast_from(src: Src) -> Dst

impl<T> WrappingAs for T

fn wrapping_as<Dst>(self) -> Dst where T: WrappingCast<Dst>,

impl<Src, Dst> WrappingCastFrom<Src> for Dst where Src: WrappingCast<Dst>,

fn wrapping_cast_from(src: Src) -> Dst

fn draw_iter<I>(&mut self, pixels: I) -> Result<(), Self::Error> where
I: IntoIterator<Item = Pixel<Self::Color>>,

fn fill_contiguous<I>(
&mut self,
area: &Rectangle,
colors: I
) -> Result<(), Self::Error> where
I: IntoIterator<Item = Self::Color>,

fn fill_solid(
&mut self,
area: &Rectangle,
color: Self::Color
) -> Result<(), Self::Error>

impl<C> RefUnwindSafe for Canvas<C> where
C: RefUnwindSafe,

impl<C> Send for Canvas<C> where
C: Send,

impl<C> Sync for Canvas<C> where
C: Sync,

impl<C> UnwindSafe for Canvas<C> where
C: UnwindSafe,

impl<T> Any for T where
T: 'static + ?Sized,

fn az<Dst>(self) -> Dst where
T: Cast<Dst>,

impl<T> Borrow<T> for T where
T: ?Sized,

impl<T> BorrowMut<T> for T where
T: ?Sized,

impl<Src, Dst> CastFrom<Src> for Dst where
Src: Cast<Dst>,

fn checked_as<Dst>(self) -> Option<Dst> where
T: CheckedCast<Dst>,

impl<Src, Dst> CheckedCastFrom<Src> for Dst where
Src: CheckedCast<Dst>,

impl<T> Dimensions for T where
T: OriginDimensions,

impl<T> DrawTargetExt for T where
T: DrawTarget,

fn color_converted<C>(&mut self) -> ColorConverted<'_, T, C> where
C: PixelColor + Into<<T as DrawTarget>::Color>,

impl<T, U> Into<U> for T where
U: From<T>,

fn overflowing_as<Dst>(self) -> (Dst, bool) where
T: OverflowingCast<Dst>,

impl<Src, Dst> OverflowingCastFrom<Src> for Dst where
Src: OverflowingCast<Dst>,

fn saturating_as<Dst>(self) -> Dst where
T: SaturatingCast<Dst>,

impl<Src, Dst> SaturatingCastFrom<Src> for Dst where
Src: SaturatingCast<Dst>,

impl<T, U> TryFrom<U> for T where
U: Into<T>,

impl<T, U> TryInto<U> for T where
U: TryFrom<T>,

fn unwrapped_as<Dst>(self) -> Dst where
T: UnwrappedCast<Dst>,

impl<Src, Dst> UnwrappedCastFrom<Src> for Dst where
Src: UnwrappedCast<Dst>,

fn wrapping_as<Dst>(self) -> Dst where
T: WrappingCast<Dst>,

impl<Src, Dst> WrappingCastFrom<Src> for Dst where
Src: WrappingCast<Dst>,