//! Graphics Support for EPDs use crate::buffer_len; use crate::color::Color; use embedded_graphics::{pixelcolor::BinaryColor, prelude::*}; /// Displayrotation #[derive(Clone, Copy)] pub enum DisplayRotation { /// No rotation Rotate0, /// Rotate by 90 degrees clockwise Rotate90, /// Rotate by 180 degrees clockwise Rotate180, /// Rotate 270 degrees clockwise Rotate270, } impl Default for DisplayRotation { fn default() -> Self { DisplayRotation::Rotate0 } } /// Necessary traits for all displays to implement for drawing /// /// Adds support for: /// - Drawing (With the help of DrawTarget/Embedded Graphics) /// - Rotations /// - Clearing pub trait Display: DrawTarget { /// Clears the buffer of the display with the chosen background color fn clear_buffer(&mut self, background_color: Color) { for elem in self.get_mut_buffer().iter_mut() { *elem = background_color.get_byte_value(); } } /// Returns the buffer fn buffer(&self) -> &[u8]; /// Returns a mutable buffer fn get_mut_buffer(&mut self) -> &mut [u8]; /// Sets the rotation of the display fn set_rotation(&mut self, rotation: DisplayRotation); /// Get the current rotation of the display fn rotation(&self) -> DisplayRotation; /// Helperfunction for the Embedded Graphics draw trait /// /// Becomes uneccesary when const_generics become stablised fn draw_helper( &mut self, width: u32, height: u32, pixel: Pixel, ) -> Result<(), Self::Error> { let rotation = self.rotation(); let buffer = self.get_mut_buffer(); let Pixel(point, color) = pixel; if outside_display(point, width, height, rotation) { return Ok(()); } // Give us index inside the buffer and the bit-position in that u8 which needs to be changed let (index, bit) = find_position(point.x as u32, point.y as u32, width, height, rotation); let index = index as usize; // "Draw" the Pixel on that bit match color { // Black BinaryColor::On => { buffer[index] &= !bit; } // White BinaryColor::Off => { buffer[index] |= bit; } } Ok(()) } } /// A variable Display without a predefined buffer /// /// The buffer can be created as following: /// buffer: [DEFAULT_BACKGROUND_COLOR.get_byte_value(); WIDTH / 8 * HEIGHT] /// If WIDTH is not a multiple of 8, don't forget to round it up (ie. (WIDTH + 7) / 8) /// /// Example: /// ```rust,no_run /// # use epd_waveshare::epd2in9::DEFAULT_BACKGROUND_COLOR; /// # use epd_waveshare::prelude::*; /// # use epd_waveshare::graphics::VarDisplay; /// # use epd_waveshare::color::Black; /// # use embedded_graphics::prelude::*; /// # use embedded_graphics::primitives::{Circle, Line}; /// # use embedded_graphics::style::PrimitiveStyle; /// let width = 128; /// let height = 296; /// /// let mut buffer = [DEFAULT_BACKGROUND_COLOR.get_byte_value(); 128 / 8 * 296]; /// let mut display = VarDisplay::new(width, height, &mut buffer); /// /// display.set_rotation(DisplayRotation::Rotate90); /// /// let _ = Line::new(Point::new(0, 120), Point::new(0, 295)) /// .into_styled(PrimitiveStyle::with_stroke(Black, 1)) /// .draw(&mut display); /// ``` pub struct VarDisplay<'a> { width: u32, height: u32, rotation: DisplayRotation, buffer: &'a mut [u8], //buffer: Box//[u8; 15000] } impl<'a> VarDisplay<'a> { /// Create a new variable sized display. /// /// Buffersize must be at least (width + 7) / 8 * height bytes. pub fn new(width: u32, height: u32, buffer: &'a mut [u8]) -> VarDisplay<'a> { let len = buffer.len() as u32; assert!(buffer_len(width as usize, height as usize) >= len as usize); VarDisplay { width, height, rotation: DisplayRotation::default(), buffer, } } } impl<'a> DrawTarget for VarDisplay<'a> { type Error = core::convert::Infallible; fn draw_pixel(&mut self, pixel: Pixel) -> Result<(), Self::Error> { self.draw_helper(self.width, self.height, pixel) } fn size(&self) -> Size { Size::new(self.width, self.height) } } impl<'a> Display for VarDisplay<'a> { fn buffer(&self) -> &[u8] { &self.buffer } fn get_mut_buffer(&mut self) -> &mut [u8] { &mut self.buffer } fn set_rotation(&mut self, rotation: DisplayRotation) { self.rotation = rotation; } fn rotation(&self) -> DisplayRotation { self.rotation } } // Checks if a pos is outside the defined display fn outside_display(p: Point, width: u32, height: u32, rotation: DisplayRotation) -> bool { if p.x < 0 || p.y < 0 { return true; } let (x, y) = (p.x as u32, p.y as u32); match rotation { DisplayRotation::Rotate0 | DisplayRotation::Rotate180 => { if x >= width || y >= height { return true; } } DisplayRotation::Rotate90 | DisplayRotation::Rotate270 => { if y >= width || x >= height { return true; } } } false } #[rustfmt::skip] //returns index position in the u8-slice and the bit-position inside that u8 fn find_position(x: u32, y: u32, width: u32, height: u32, rotation: DisplayRotation) -> (u32, u8) { let nx; let ny; match rotation { DisplayRotation::Rotate0 => { nx = x; ny = y; }, DisplayRotation::Rotate90 => { nx = width - 1 - y; ny = x; } , DisplayRotation::Rotate180 => { nx = width - 1 - x; ny = height - 1 - y; }, DisplayRotation::Rotate270 => { nx = y; ny = height - 1 - x; }, } ( nx / 8 + ((width + 7) / 8) * ny, 0x80 >> (nx % 8), ) } #[cfg(test)] mod tests { use super::{buffer_len, find_position, outside_display, Display, DisplayRotation, VarDisplay}; use crate::color::Black; use crate::color::Color; use embedded_graphics::{prelude::*, primitives::Line, style::PrimitiveStyle}; #[test] fn buffer_clear() { use crate::epd4in2::{HEIGHT, WIDTH}; let mut buffer = [Color::Black.get_byte_value(); buffer_len(WIDTH as usize, HEIGHT as usize)]; let mut display = VarDisplay::new(WIDTH, HEIGHT, &mut buffer); for &byte in display.buffer.iter() { assert_eq!(byte, Color::Black.get_byte_value()); } display.clear_buffer(Color::White); for &byte in display.buffer.iter() { assert_eq!(byte, Color::White.get_byte_value()); } } #[test] fn rotation_overflow() { use crate::epd4in2::{HEIGHT, WIDTH}; let width = WIDTH as u32; let height = HEIGHT as u32; test_rotation_overflow(width, height, DisplayRotation::Rotate0); test_rotation_overflow(width, height, DisplayRotation::Rotate90); test_rotation_overflow(width, height, DisplayRotation::Rotate180); test_rotation_overflow(width, height, DisplayRotation::Rotate270); } fn test_rotation_overflow(width: u32, height: u32, rotation2: DisplayRotation) { let max_value = width / 8 * height; for x in 0..(width + height) { //limit x because it runs too long for y in 0..(u32::max_value()) { if outside_display(Point::new(x as i32, y as i32), width, height, rotation2) { break; } else { let (idx, _) = find_position(x, y, width, height, rotation2); assert!(idx < max_value); } } } } #[test] fn graphics_rotation_0() { use crate::epd2in9::DEFAULT_BACKGROUND_COLOR; let width = 128; let height = 296; let mut buffer = [DEFAULT_BACKGROUND_COLOR.get_byte_value(); 128 / 8 * 296]; let mut display = VarDisplay::new(width, height, &mut buffer); let _ = Line::new(Point::new(0, 0), Point::new(7, 0)) .into_styled(PrimitiveStyle::with_stroke(Black, 1)) .draw(&mut display); let buffer = display.buffer(); assert_eq!(buffer[0], Color::Black.get_byte_value()); for &byte in buffer.iter().skip(1) { assert_eq!(byte, DEFAULT_BACKGROUND_COLOR.get_byte_value()); } } #[test] fn graphics_rotation_90() { use crate::epd2in9::DEFAULT_BACKGROUND_COLOR; let width = 128; let height = 296; let mut buffer = [DEFAULT_BACKGROUND_COLOR.get_byte_value(); 128 / 8 * 296]; let mut display = VarDisplay::new(width, height, &mut buffer); display.set_rotation(DisplayRotation::Rotate90); let _ = Line::new(Point::new(0, 120), Point::new(0, 295)) .into_styled(PrimitiveStyle::with_stroke(Black, 1)) .draw(&mut display); let buffer = display.buffer(); extern crate std; std::println!("{:?}", buffer); assert_eq!(buffer[0], Color::Black.get_byte_value()); for &byte in buffer.iter().skip(1) { assert_eq!(byte, DEFAULT_BACKGROUND_COLOR.get_byte_value()); } } }