[−][src]Crate embedded_graphics_simulator
Embedded graphics simulator
The simulator can be used to test and debug embedded-graphics code, or produce snazzy examples for people to try drivers out without needing physical hardware to run on.
Setup
The simulator uses SDL and its development libraries which must be installed to build and run it.
Linux (apt
)
sudo apt install libsdl2-dev
macOS (brew
)
brew install sdl2
Windows
The Windows install process is a bit more involved, but it does work. See the SDL2 wiki for instructions.
Examples
Simulate a 128x64 SSD1306 OLED
use embedded_graphics::pixelcolor::BinaryColor; use embedded_graphics::prelude::*; use embedded_graphics::{egcircle, egline, egtext, primitive_style, text_style}; use embedded_graphics::fonts::Font6x8; use embedded_graphics_simulator::{ BinaryColorTheme, SimulatorDisplay, SimulatorEvent, WindowBuilder, }; use std::thread; use std::time::Duration; fn main() { let mut display = SimulatorDisplay::new(Size::new(128, 64)); let mut window = WindowBuilder::new(&display) .theme(BinaryColorTheme::OledBlue) .build(); egtext!(text = "Hello World!", top_left = Point::zero(), style = text_style!(font = Font6x8)).draw(&mut display); egcircle!(center = (96, 32), radius = 31, style = primitive_style!(stroke_color = BinaryColor::On)).draw(&mut display); egline!(start = (32, 32), end = (1, 32), style = primitive_style!(stroke_color = BinaryColor::On)) .translate(Point::new(64, 0)) .draw(&mut display); egline!(start = (32, 32), end = (40, 40), style = primitive_style!(stroke_color = BinaryColor::On)) .translate(Point::new(64, 0)) .draw(&mut display); 'running: loop { window.update(&display); for event in window.events() { match event { SimulatorEvent::MouseButtonUp { point, .. } => { println!("Click event at ({}, {})", point.x, point.y); } SimulatorEvent::Quit => break 'running, _ => {} } thread::sleep(Duration::from_millis(200)); } } }
Structs
SimulatorDisplay | Display |
Window | Simulator window |
WindowBuilder | Builder for simulator windows. |
Enums
BinaryColorTheme | Color theme for binary displays |
SimulatorEvent | A derivation of sdl2::event::Event mapped to embedded-graphics coordinates |