Struct DirtySprite 

pub struct DirtySprite<C, const W: u16, const H: u16, const N: usize, const MAX_REGIONS: usize>
where
    C: PixelColor + Copy + Default,
{ /* private fields */ }

Off-screen framebuffer that tracks the rectangles touched by draw calls.

Use a full-screen sprite (W=320, H=240) when RAM is available, or create smaller sprites per widget. N must be at least W * H; it is separate from W/H to stay on stable Rust without generic-const arithmetic.

Implementations

impl<C, const W: u16, const H: u16, const N: usize, const MAX_REGIONS: usize> DirtySprite<C, W, H, N, MAX_REGIONS>

where C: PixelColor + Copy + Default,

pub fn new(clear: C) -> Result<Self, DirtySpriteError>

pub fn dirty_regions(&self) -> impl Iterator<Item = Rectangle> + '_

pub fn clear_dirty(&mut self)

pub fn invalidate(&mut self, area: Rectangle) -> Result<(), DirtySpriteError>

Marks the portion of area inside the sprite as dirty.

pub fn invalidate_all(&mut self) -> Result<(), DirtySpriteError>

Marks the entire sprite as dirty.

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

pub fn region_pixels(&self, area: Rectangle) -> SpriteRegionPixels<'_, C>

Returns pixels from a clipped sprite-local region in row-major order.

pub fn draw_region_at<T>( &self, target: &mut T, source_area: Rectangle, dest_top_left: Point, ) -> Result<(), T::Error>

where T: DrawTarget<Color = C>,

Draws a clipped sprite-local region into another draw target.

pub fn set_pixel( &mut self, point: Point, color: C, ) -> Result<(), DirtySpriteError>

pub fn flush_dirty<T>(&mut self, target: &mut T) -> Result<(), T::Error>

where T: DrawTarget<Color = C>,

Repaint only dirty rectangles into a concrete display draw target.

pub fn flush_dirty_at<T>( &mut self, target: &mut T, origin: Point, ) -> Result<(), T::Error>

where T: DrawTarget<Color = C>,

Repaint only dirty rectangles into a concrete display draw target at origin.

Trait Implementations

impl<C, const W: u16, const H: u16, const N: usize, const MAX_REGIONS: usize> DrawTarget for DirtySprite<C, W, H, N, MAX_REGIONS>

where C: PixelColor + Copy + Default,

type Color = C

The pixel color type the targetted display supports.

type Error = !

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 clear(&mut self, color: Self::Color) -> Result<(), Self::Error>

Fill the entire display with a solid color.

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.

impl<C, const W: u16, const H: u16, const N: usize, const MAX_REGIONS: usize> OriginDimensions for DirtySprite<C, W, H, N, MAX_REGIONS>

where C: PixelColor + Copy + Default,

fn size(&self) -> Size

Returns the size of the bounding box.