embedded-graphics-simulator is an SDL-based simulator for testing, debugging and developing embedded-graphics applications.
Unreleased - ReleaseDate
- (breaking) #71 Added support for non-square pixels.
- #72
set_max_fpsnow accepts0to disable the FPS limiter.
- #71 Fixed pixel spacing for unscaled outputs.
0.8.0 - 2025-10-10
- #63 Added support for custom binary color themes (
BinaryColorTheme::Custom). - #62 Added an SDL based audio example (sdl-audio.rs).
- #66 Added
MultiWindowto show multiple displays in one window. - #66 Added
SimulatorDisplay::output_size.
- (breaking) #65 Bump Minimum Supported Rust Version (MSRV) to latest stable.
- (breaking) #66
OutputSettings::max_fpshas been removed, useWindow::set_max_fpsorMultiWindow::set_max_fpsinstead. - (breaking) #66 Renamed
OutputImage::updatetoOutputImage::draw_displayand addedpositionparameter. - #66 Changed
Window::eventsto take&selfinstead of&mut self. - (breaking) #69 Bump
sdl2crate dependency to 0.38.0.
0.7.0 - 2024-09-10
- (breaking) #55 Bump the following crate dependencies:
imageto 0.25.1,base64to 0.22.1,sdl2to 0.37.0
0.6.0 - 2023-11-26
- (breaking) #49 Bump Minimum Supported Rust Version (MSRV) to 1.71.1.
- (breaking) #52 Bump
imagecrate dependency to 0.24.7.
0.5.0 - 2023-05-14
- (breaking) #46 Bump minimum embedded-graphics version from 0.7.1 to 0.8.
0.4.1 - 2023-03-06
- #45 Added
OutputSettingsBuilder::max_fpsto set the maximum FPS of the simulator.
- #45 Limit simulator to 60FPS by default.
0.4.0 - 2022-09-19
- #34 Bump minimum embedded-graphics version from 0.7.0 to 0.7.1.
- (breaking) #44 Bump Minimum Supported Rust Version (MSRV) to 1.61.
0.3.0 - 2021-06-05
0.3.0-beta.3 - 2021-06-04
- #28 Added
SimulatorDisplay::to_{be,le,ne}_bytesto convert the display content to raw image data. - #29 Added
SimulatorDisplay::load_png. - #29 Added support for
EG_SIMULATOR_CHECK,EG_SIMULATOR_CHECK_RAWandEG_SIMULATOR_DUMP_RAWenvironment variables. - #29 A limited version of
Windowcan now be used without thewith-sdlfeature enabled. Event handling isn't available if SDL support is disabled. - #30 Added
SimulatorDisplay::diff.
- (breaking) #29 Color types used in
Window::updateandWindow::show_staticmust now implementFrom<Rgb888>.
- #28 Fixed panic for zero sized
SimulatorDisplays.
0.3.0-beta.2 - 2021-05-04
- #25 Added
OutputImageto export PNG files and base64 encoded PNGs. - #25 Added
BinaryColorTheme::Inverted.
- (breaking) #25 Removed
SimulatorDisplay::to_image_buffer. Useto_rgb_output_imageorto_grayscale_output_imageinstead.
0.3.0-beta.1 - 2021-04-24
- #24 Upgrade to embedded-graphics 0.7.0-beta.1.
0.3.0-alpha.2 - 2021-02-05
- #16 Re-export
sdl2types.
0.3.0-alpha.1 - 2021-01-07
0.2.1 - 2020-07-29
Note: PR numbers from this point onwards are from the old
embedded-graphics/embedded-graphicsrepository. New PR numbers above this note refer to PRs in theembedded-graphics/simulatorrepository.
- #298 Added the
with-sdloption (enabled by default) to allow optionally disabling SDL2 support. - #271 Add
MouseMoveevent support to simulator.
0.2.0 - 2020-03-20
- (breaking) #266 Added image support and PNG export. See the
README.mdfor information about how to use these features. The API for creating windows was changed to make the output settings independent of theWindowtype. The pixel scaling and theme settings were moved to a newOutputSettingsstruct, that can be built using theOutputSettingsBuilder.WindowBuilderwas removed and replaced by aWindow::new(title, &output_settings)function.
0.2.0-beta.2 - 2020-02-17
- #183 Added limited mouse and keyboard event handling to the simulator in order to simulate input devices such as touch screens, buttons, or rotary encoders.
- #171 Added a more complex
analog-clockexample to the simulator - check it out for some more in-depth usage of Embedded Graphics.
- #192 Performance of drawing in the simulator is increased.
- #218 Test README examples in CI and update them to work with latest crate versions.
- (breaking) The simulator API changed.
- #203 updated simulator screenshots and added them to README
- The TGA example in the simulator now draws the image correctly
- The simulator is now available on crates.io as a standalone crate. You can now create simulated displays for testing out embedded_graphics code or showing off cool examples.
- The builtin simulator now supports colour pixel types, like
RGB565.