Struct CCanvasAt

pub struct CCanvasAt<C: PixelColor, const W: usize, const H: usize> {
    pub top_left: Point,
    pub pixels: [[Option<C>; H]; W],
    /* private fields */
}

Canvas which is drawable at the provided Point (location) on the display.

Fields

top_left: Point

The top left offset where the CCanvasAt will be drawn to the display.

pixels: [[Option<C>; H]; W]

The pixels of the CCanvasAt.

Implementations

impl<C, const W: usize, const H: usize> CCanvasAt<C, W, H>

where C: PixelColor,

pub fn new(top_left: Point) -> Self

Create a new blank CCanvasAt.

Panics

If either of width (W) or heigh (H) is larger than u32::MAX due to the internal Size used for implementing Dimensions.

pub fn with_default_color(top_left: Point, default_color: C) -> Self

Create a CCanvasAt filled with a default color.

If either of width (W) or heigh (H) is larger than u32::MAX due to the internal Size used for implementing Dimensions.

pub fn with_center(center: Point) -> Self

Create a new blank CCanvasAt with a set center on the display.

Panics

If either of width (W) or heigh (H) is larger than u32::MAX due to the internal Size used for implementing Dimensions.

pub fn center(&self) -> Point

Returns the center of the bounding box.

pub fn get_pixel(&self, point: Point) -> Option<C>

Returns the color of the pixel at a given Point.

Returns None if the Point is outside of the CCanvasAt.

Trait Implementations

impl<C: Clone + PixelColor, const W: usize, const H: usize> Clone for CCanvasAt<C, W, H>

fn clone(&self) -> CCanvasAt<C, W, H>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<C: Debug + PixelColor, const W: usize, const H: usize> Debug for CCanvasAt<C, W, H>

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

Formats the value using the given formatter.

impl<C: PixelColor, const W: usize, const H: usize> Dimensions for CCanvasAt<C, W, H>

fn bounding_box(&self) -> Rectangle

Returns the bounding box.

impl<C: PixelColor, const W: usize, const H: usize> DrawTarget for CCanvasAt<C, W, H>

type Color = C

The pixel color type the targetted display supports.

type Error = Infallible

Error type to return when a drawing operation fails.

fn draw_iter<I>(&mut self, pixels: I) -> Result<(), Self::Error>

where I: IntoIterator<Item = Pixel<Self::Color>>,

Draw individual pixels to the display without a defined order.

fn fill_contiguous<I>( &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.

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

Fill a given area with a solid color.

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

Fill the entire display with a solid color.

impl<C, const W: usize, const H: usize> Drawable for CCanvasAt<C, W, H>

where C: PixelColor,

type Color = C

The pixel color type.

type Output = ()

The return type of the draw method.

fn draw<D>(&self, target: &mut D) -> Result<Self::Output, D::Error>

where D: DrawTarget<Color = C>,

Draw the graphics object using the supplied DrawTarget.

impl<C: PixelColor, const W: usize, const H: usize> Transform for CCanvasAt<C, W, H>

Available on crate feature transform only.

fn translate(&self, by: Point) -> Self

Move the origin of an object by a given number of (x, y) pixels, returning a new object

fn translate_mut(&mut self, by: Point) -> &mut Self

Move the origin of an object by a given number of (x, y) pixels, mutating the object in place

impl<C: Copy + PixelColor, const W: usize, const H: usize> Copy for CCanvasAt<C, W, H>