emilk/egui
 Watch   
 Star   
 Fork   
简介统计版本
25 days ago
egui
emilk

0.33.0 - `egui::Plugin`, better kerning, kitdiff viewer

egui is an easy-to-use immediate mode GUI for Rust that runs on both web and native.

Try it now: https://www.egui.rs/

egui development is sponsored by Rerun, a startup building an SDK for visualizing streams of multimodal data.

egui 0.33.0 changelog

Highlights from this release:

  • egui::Plugin a improved way to create and access egui plugins
  • kitdiff, a viewer for egui_kittest image snapshots (and a general image diff tool)
  • better kerning

Improved kerning

As a step towards using parley for font rendering, @valadaptive has refactored the font loading and rendering code. A result of this (next to the font rendering code being much nicer now) is improved kerning. Notice how the c moved away from the k:

Oct-09-2025 16-21-58

egui::Plugin trait

We've added a new trait-based plugin api, meant to replace Context::on_begin_pass and Context::on_end_pass. This makes it a lot easier to handle state in your plugins. Instead of having to write to egui memory it can live right on your plugin struct. The trait based api also makes easier to add new hooks that plugins can use. In addition to on_begin_pass and on_end_pass, the Plugin trait now has a input_hook and output_hook which you can use to inspect / modify the RawInput / FullOutput.

kitdiff, a image diff viewer

At rerun we have a ton of snapshots. Some PRs will change most of them (e.g. the one that updated egui and introduced the kerning improvements, ~500 snapshots changed!). If you really want to look at every changed snapshot it better be as efficient as possible, and the experience on github, fiddeling with the sliders, is kind of frustrating. In order to fix this, we've made kitdiff. You can use it locally via

  • kitdiff files . will search for .new.png and .diff.png files
  • kitdiff git will compare the current files to the default branch (main/master) Or in the browser via
  • going to https://rerun-io.github.io/kitdiff/ and pasting a PR or github artifact url
  • linking to kitdiff via e.g. a github workflow https://rerun-io.github.io/kitdiff/?url=<link_to_pr_or_artifact>

To install kitdiff run cargo install --git https://github.com/rerun-io/kitdiff. You might need to login with your github account for viewing artifacts and to prevent running into rate limits.

Here is a video showing the kerning changes in kitdiff (try it yourself):

https://github.com/user-attachments/assets/74640af1-09ba-435a-9d0c-2cbeee140c8f

Migration guide

  • egui::Mutex now has a timeout as a simple deadlock detection
    • If you use a egui::Mutex in some place where it's held for longer than a single frame, you should switch to the std mutex or parking_lot instead (egui mutexes are wrappers around parking lot)
  • screen_rect is deprecated
    • In order to support safe areas, egui now has viewport_rect and content_rect.
    • Update all usages of screen_rect to content_rect, unless you are sure that you want to draw outside the safe area (which would mean your Ui may be covered by notches, system ui, etc.)

⭐ Added

🔧 Changed

🔥 Removed

🐛 Fixed

2025-09-12 14:26:15
egui
emilk

0.32.3 - Fix tooltips for ellided text

egui is an easy-to-use immediate mode GUI for Rust that runs on both web and native.

Try it now: https://www.egui.rs/

egui development is sponsored by Rerun, a startup building an SDK for visualizing streams of multimodal data.

egui

egui_extras

  • Fix deadlock in FileLoader and EhttpLoader #7515 by @emilk
2025-09-04 21:14:55
egui
emilk

0.32.2 - Ui::place, Harness::mask and more bug fixes

egui is an easy-to-use immediate mode GUI for Rust that runs on both web and native.

Try it now: https://www.egui.rs/

egui development is sponsored by Rerun, a startup building an SDK for visualizing streams of multimodal data.

Add Ui::place

Ui::place is similar to Ui::put, but it doesn't update the current Uis cursor. This is very useful when using the new Atoms or making badge-like widgets. The following breaks with Ui::put but works just fine with Ui::place:

Screenshot 2025-07-14 at 10 58 30

Screenshot 2025-07-14 at 10 58 51

Add Harness::mask

Harness::mask allows for simple masking of Rects you don't want to be visible in snapshot test images. The rect will be masked with a ugly color to make it obvious whats going on:

image

egui

  • Add Ui::place, to place widgets without changing the cursor #7359 by @lucasmerlin
  • Fix: SubMenu should not display when ui is disabled #7428 by @ozwaldorf
  • Remove line breaks when pasting into single line TextEdit #7441 by @YgorSouza
  • Panic mutexes that can't lock for 30 seconds, in debug builds #7468 by @emilk
  • Fix: prevent calendar popup from closing on dropdown change #7409 by @AStrizh

egui_extras

egui_kittest

epaint

  • Panic mutexes that can't lock for 30 seconds, in debug builds #7468 by @emilk
  • Skip zero-length layout job sections #7430 by @HactarCE

Unsorted commits

  • Add track_caller to Mutex and RwLock for deadlock_detection b17d716
2025-08-15 19:41:22
egui
emilk

0.32.1 - Misc bug fixes

egui is an easy-to-use immediate mode GUI for Rust that runs on both web and native.

Try it now: https://www.egui.rs/

egui development is sponsored by Rerun, a startup building an SDK for visualizing streams of multimodal data.

egui changelog

⭐ Added

🐛 Fixed

eframe changelog

  • Enable wgpu default features in eframe / egui_wgpu default features #7344 by @lucasmerlin
  • Request a redraw when the url change through the popstate event listener #7403 by @irevoire

egui_kittest changelog

  • Fix UPDATE_SNAPSHOTS: only update if we didn't pass the test #7455 by @emilk
2025-07-10 23:00:13
egui
emilk

0.32.0 - Atoms, popups, and better SVG support

egui is an easy-to-use immediate mode GUI for Rust that runs on both web and native.

Try it now: https://www.egui.rs/

egui development is sponsored by Rerun, a startup building an SDK for visualizing streams of multimodal data.

egui 0.32.0 changelog

This is a big egui release, with several exciting new features!

  • Atoms are new layout primitives in egui, for text and images
  • Popups, tooltips and menus have undergone a complete rewrite
  • Much improved SVG support
  • Crisper graphics (especially text!)

Let's dive in!

⚛️ Atoms

egui::Atom is the new, indivisible building block of egui (hence the name). It lets you mix images and text in many places where you would previously only be able to add text.

Atoms is the first step towards a more powerful layout engine in egui - more to come!

Right now an Atom is an enum that can be either WidgetText, Image, or Custom.

The new AtomLayout can be used within widgets to do basic layout. The initial implementation is as minimal as possible, doing just enough to implement what Button could do before. There is a new IntoAtoms trait that works with tuples of Atoms. Each atom can be customized with the AtomExt trait which works on everything that implements Into<Atom>, so e.g. RichText or Image. So to create a Button with text and image you can now do:

let image = include_image!("my_icon.png").atom_size(Vec2::splat(12.0));
ui.button((image, "Click me!"));

Anywhere you see impl IntoAtoms you can add any number of images and text, in any order.

As of 0.32, we have ported the Button, Checkbox, RadioButton to use atoms (meaning they support adding Atoms and are built on top of AtomLayout). The Button implementation is not only more powerful now, but also much simpler, removing ~130 lines of layout math.

In combination with ui.read_response, custom widgets are really simple now, here is a minimal button implementation:

pub struct ALButton<'a> {
    al: AtomLayout<'a>,
}

impl<'a> ALButton<'a> {
    pub fn new(content: impl IntoAtoms<'a>) -> Self {
        Self {
            al: AtomLayout::new(content.into_atoms()).sense(Sense::click()),
        }
    }
}

impl<'a> Widget for ALButton<'a> {
    fn ui(mut self, ui: &mut Ui) -> Response {
        let Self { al } = self;
        let response = ui.ctx().read_response(ui.next_auto_id());

        let visuals = response.map_or(&ui.style().visuals.widgets.inactive, |response| {
            ui.style().interact(&response)
        });

        let al = al.frame(
            Frame::new()
                .inner_margin(ui.style().spacing.button_padding)
                .fill(visuals.bg_fill)
                .stroke(visuals.bg_stroke)
                .corner_radius(visuals.corner_radius),
        );

        al.show(ui).response
    }
}

You can even use Atom::custom to add custom content to Widgets. Here is a button in a button:

https://github.com/user-attachments/assets/8c649784-dcc5-4979-85f8-e735b9cdd090

let custom_button_id = Id::new("custom_button");
let response = Button::new((
    Atom::custom(custom_button_id, Vec2::splat(18.0)),
    "Look at my mini button!",
))
.atom_ui(ui);
if let Some(rect) = response.rect(custom_button_id) {
    ui.put(rect, Button::new("🔎").frame_when_inactive(false));
}

Currently, you need to use atom_ui to get a AtomResponse which will have the Rect to use, but in the future this could be streamlined, e.g. by adding a AtomKind::Callback or by passing the Rects back with egui::Response.

Basing our widgets on AtomLayout also allowed us to improve Response::intrinsic_size, which will now report the correct size even if widgets are truncated. intrinsic_size is the size that a non-wrapped, non-truncated, non-justified version of the widget would have, and can be useful in advanced layout calculations like egui_flex.

Details

❕ Improved popups, tooltips, and menus

Introduces a new egui::Popup api. Checkout the new demo on https://egui.rs:

https://github.com/user-attachments/assets/74e45243-7d05-4fc3-b446-2387e1412c05

We introduced a new RectAlign helper to align a rect relative to an other rect. The Popup will by default try to find the best RectAlign based on the source widgets position (previously submenus would annoyingly overlap if at the edge of the window):

https://github.com/user-attachments/assets/0c5adb6b-8310-4e0a-b936-646bb4ec02f7

Tooltip and menu have been rewritten based on the new Popup api. They are now compatible with each other, meaning you can just show a ui.menu_button() in any Popup to get a sub menu. There are now customizable MenuButton and SubMenuButton structs, to help with customizing your menu buttons. This means menus now also support PopupCloseBehavior so you can remove your close_menu calls from your click handlers!

The old tooltip and popup apis have been ported to the new api so there should be very little breaking changes. The old menu is still around but deprecated. ui.menu_button etc now open the new menu, if you can't update to the new one immediately you can use the old buttons from the deprecated egui::menu menu.

We also introduced ui.close() which closes the nearest container. So you can now conveniently close Windows, Collapsibles, Modals and Popups from within. To use this for your own containers, call UiBuilder::closable and then check for closing within that ui via ui.should_close().

Details

▲ Improved SVG support

You can render SVG in egui with

ui.add(egui::Image::new(egui::include_image!("icon.svg"));

(Requires the use of egui_extras, with the svg feature enabled and a call to install_image_loaders).

Previously this would sometimes result in a blurry SVG, epecially if the Image was set to be dynamically scale based on the size of the Ui that contained it. Now SVG:s are always pixel-perfect, for truly scalable graphics.

svg-scaling

Details

✨ Crisper graphics

Non-SVG icons are also rendered better, and text sharpness has been improved, especially in light mode.

image

Details
  • Improve text sharpness #5838 by @emilk
  • Improve text rendering in light mode #7290 by @emilk
  • Improve texture filtering by doing it in gamma space #7311 by @emilk
  • Make text underline and strikethrough pixel perfect crisp #5857 by @emilk

Migration guide

We have some silently breaking changes (code compiles fine but behavior changed) that require special care:

wgpu backend features

  • wgpu 25 made the gles and vulkan backends optional
    • We missed this, so for now you need to manually opt in to those backends. Add the following to you Cargo.toml 
      wgpu = "25" # enables the wgpu default features so we get the default backends

Menus close on click by default

  • Previously menus would only close on click outside
  • Either
    • Remove the ui.close_menu() calls from button click handlers since they are obsolete
    • If the menu should stay open on clicks, change the PopupCloseBehavior: 
          // Change this
  ui.menu_button("Text", |ui| { /* Menu Content */ });
    // To this:
  MenuButton::new("Text").config(
      MenuConfig::default().close_behavior(PopupCloseBehavior::CloseOnClickOutside),
  ).ui(ui, |ui| { /* Menu Content */ });
      You can also change the behavior only for a single SubMenu by using SubMenuButton, but by default it should be passed to any submenus when using MenuButton.

Memory::is_popup_open api now requires calls to Memory::keep_popup_open

  • The popup will immediately close if keep_popup_open is not called.
  • It's recommended to use the new Popup api which handles this for you.
  • If you can't switch to the new api for some reason, update the code to call keep_popup_open: 
        if ui.memory(|mem| mem.is_popup_open(popup_id)) {
      ui.memory_mut(|mem| mem.keep_popup_open(popup_id)); // <- add this line
      let area_response = Area::new(popup_id).show(...)
    }

⭐ Other improvements

🔧 Changed

🔥 Removed

🐛 Fixed

🚀 Performance

eframe 0.32.0 changelog

⭐ Added

  • Add pointer events and focus handling for apps run in a Shadow DOM #5627 by @xxvvii
  • MacOS: Add movable_by_window_background option to viewport #5412 by @jim-ec
  • Add macOS-specific has_shadow and with_has_shadow to ViewportBuilder #6850 by @gaelanmcmillan
  • Add external eventloop support #6750 by @wpbrown

🔧 Changed

🐛 Fixed

  • Mark all keys as up if the app loses focus #5743 by @emilk
  • Fix text input on Android #5759 by @StratusFearMe21
  • Fix text distortion on mobile devices/browsers with glow backend #6893 by @wareya
  • Workaround libpng crash on macOS by not creating NSImage from png data #7252 by @Wumpf
  • Fix incorrect window sizes for non-resizable windows on Wayland #7103 by @GoldsteinE
  • Web: only consume copy/cut events if the canvas has focus #7270 by @emilk
2025-03-05 15:35:23
egui
emilk

0.31.1 - TextEdit and egui_kittest fixes

egui is an easy-to-use immediate mode GUI for Rust that runs on both web and native.

Try it now: https://www.egui.rs/

egui development is sponsored by Rerun, a startup building an SDK for visualizing streams of multimodal data.

egui

egui_extras

egui_kittest

epaint

  • Fix panic when rendering thin textured rectangles #5692 by @PPakalns
2025-02-04 23:58:39
egui
emilk

0.31.0 - Scene container, improved rendering quality

egui is an easy-to-use immediate mode GUI for Rust that runs on both web and native.

Try it now: https://www.egui.rs/

egui development is sponsored by Rerun, a startup building an SDK for visualizing streams of multimodal data.

Highlights ✨

Scene container

This release adds the Scene container to egui. It is a pannable, zoomable canvas that can contain Widgets and child Uis. This will make it easier to e.g. implement a graph editor.

scene

Clearer, pixel perfect rendering

The tessellator has been updated for improved rendering quality and better performance. It will produce fewer vertices and shapes will have less overdraw. We've also defined what CornerRadius (previously Rounding) means.

We've also added a tessellator test to the demo app, where you can play around with different values to see what's produced:

https://github.com/user-attachments/assets/adf55e3b-fb48-4df0-aaa2-150ee3163684

Check the PR for more details.

CornerRadius, Margin, Shadow size reduction

In order to pave the path for more complex and customizable styling solutions, we've reduced the size of CornerRadius, Margin and Shadow values to i8 and u8.

Migration guide

  • Add a StrokeKind to all your Painter::rect calls #5648
  • StrokeKind::default was removed, since the 'normal' value depends on the context #5658
    • You probably want to use StrokeKind::Inside when drawing rectangles
    • You probably want to use StrokeKind::Middle when drawing open paths
  • Rename Rounding to CornerRadius #5673
  • CornerRadius, Margin and Shadow have been updated to use i8 and u8 #5563, #5567, #5568
    • Remove the .0 from your values
    • Cast dynamic values with as i8 / as u8 or as _ if you want Rust to infer the type
      • Rust will do a 'saturating' cast, so if your f32 value is bigger than 127 it will be clamped to 127
  • RectShape parameters changed #5565
    • Prefer to use the builder methods to create it instead of initializing it directly
  • Frame now takes the Stroke width into account for its sizing, so check all views of your app to make sure they still look right. Read the PR for more info.

⭐ Added

🔧 Changed

  • ⚠️ Frame now includes stroke width as part of padding #5575 by @emilk
  • Rename Rounding to CornerRadius #5673 by @emilk
  • Require a StrokeKind when painting rectangles with strokes #5648 by @emilk
  • Round widget coordinates to even multiple of 1/32 #5517 by @emilk
  • Make all lines and rectangles crisp #5518 by @emilk
  • Tweak window resize handles #5524 by @emilk

🔥 Removed

🐛 Fixed

  • Use correct minimum version of profiling crate #5494 by @lucasmerlin
  • Fix interactive widgets sometimes being incorrectly marked as hovered #5523 by @emilk
  • Fix panic due to non-total ordering in Area::compare_order() #5569 by @HactarCE
  • Fix hovering through custom menu button #5555 by @M4tthewDE

🚀 Performance

  • Use u8 in CornerRadius, and introduce CornerRadiusF32 #5563 by @emilk
  • Store Margin using i8 to reduce its size #5567 by @emilk
  • Shrink size of Shadow by using i8/u8 instead of f32 #5568 by @emilk
  • Avoid allocations for loader cache lookup #5584 by @mineichen
  • Use bitfield instead of bools in Response and Sense #5556 by @polwel
2024-12-17 01:10:48
egui
emilk

0.30.0 - egui_kittest and modals

egui is an easy-to-use immediate mode GUI for Rust that runs on both web and native.

Try it now: https://www.egui.rs/

egui development is sponsored by Rerun, a startup building an SDK for visualizing streams of multimodal data.

egui_kittest

This release welcomes a new crate to the family: egui_kittest. egui_kittest is a testing framework for egui, allowing you to test both automation (simulated clicks and other events), and also do screenshot testing (useful for regression tests). egui_kittest is built using kittest, which is a general GUI testing framework that aims to work with any Rust GUI (not just egui!). kittest uses the accessibility library AccessKit for automatation and to query the widget tree.

kittest and egui_kittest are written by @lucasmerlin.

Here's a quick example of how to use egui_kittest to test a checkbox:

use egui::accesskit::Toggled;
use egui_kittest::{Harness, kittest::Queryable};

fn main() {
    let mut checked = false;
    let app = |ui: &mut egui::Ui| {
        ui.checkbox(&mut checked, "Check me!");
    };

    let mut harness = egui_kittest::Harness::new_ui(app);

    let checkbox = harness.get_by_label("Check me!");
    assert_eq!(checkbox.toggled(), Some(Toggled::False));
    checkbox.click();

    harness.run();

    let checkbox = harness.get_by_label("Check me!");
    assert_eq!(checkbox.toggled(), Some(Toggled::True));

    // You can even render the ui and do image snapshot tests
    #[cfg(all(feature = "wgpu", feature = "snapshot"))]
    harness.wgpu_snapshot("readme_example");
}

egui changelog

✨ Highlights

⭐ Added

🔧 Changed

🐛 Fixed

eframe changelog

BREAKING: you now need to enable the wayland and/or x11 features to get Linux support, including getting it to work on most CI systems.

⭐ Added

🔧 Changed

🐛 Fixed

  • iOS: Support putting UI next to the dynamic island #5211 by @frederik-uni
  • Prevent panic when copying text outside of a secure context #5326 by @YgorSouza
  • Fix accidental change of FallbackEgl to PreferEgl #5408 by @e00E
2024-10-01 16:10:27
egui
emilk

0.29.1 - Bug fixes

egui is an easy-to-use immediate mode GUI for Rust that runs on both web and native.

Try it now: https://www.egui.rs/

egui development is sponsored by Rerun, a startup building an SDK for visualizing streams of multimodal data.

egui

  • Remove debug-assert triggered by with_layer_id/dnd_drag_source #5191 by @emilk
  • Fix id clash in Ui::response #5192 by @emilk
  • Do not round panel rectangles to pixel grid #5196 by @emilk

eframe

  • Linux: Disable IME to fix backspace/arrow keys #5188 by @emilk
2024-09-26 21:32:28
egui
emilk

0.29.0 - Multipass, `UiBuilder`, & visual improvements

egui is an easy-to-use immediate mode GUI for Rust that runs on both web and native.

Try it now: https://www.egui.rs/

egui development is sponsored by Rerun, a startup building an SDK for visualizing streams of multimodal data.

egui changelog

✨ Highlights

This release adds initial support for multi-pass layout, which is a tool to circumvent a common limitation of immediate mode. You can use the new UiBuilder::sizing_pass (#4969) to instruct the Ui and widgets to shrink to their minimum size, then store that size. Then call the new Context::request_discard (#5059) to discard the visual output and do another pass immediately after the current finishes. Together, this allows more advanced layouts that is normally not possible in immediate mode. So far this is only used by egui::Grid to hide the "first-frame jitters" that would sometimes happen before, but 3rd party libraries can also use it to do much more advanced things.

There is also a new UiBuilder for more flexible construction of Uis (#4969). By specifying a sense for the Ui you can make it respond to clicks and drags, reading the result with the new Ui::response (#5054). Among other things, you can use this to create buttons that contain arbitrary widgets.

0.29 also adds improve support for automatic switching between light and dark mode. You can now set up a custom Style for both dark and light mode, and have egui follow the system preference (#4744 #4860).

There also has been several small improvements to the look of egui:

  • Fix vertical centering of text (e.g. in buttons) (#5117)
  • Sharper rendering of lines and outlines (#4943)
  • Nicer looking text selection, especially in light mode (#5017)

The new text selection

New text selection in light mode

New text selection in dark mode

What text selection used to look like

Old text selection in light mode

Old text selection in dark mode

🧳 Migration

  • id_source is now called id_salt everywhere (#5025)
  • Ui::new now takes a UiBuilder (#4969)
  • Deprecated (replaced with UiBuilder):
    • ui.add_visible_ui
    • ui.allocate_ui_at_rect
    • ui.child_ui
    • ui.child_ui_with_id_source
    • ui.push_stack_info

⭐ Added

🚀 Performance

🔧 Changed

🐛 Fixed

  • Prevent text shrinking in tooltips; round wrap-width to integer #5161 by @emilk
  • Fix bug causing tooltips with dynamic content to shrink #5168 by @emilk
  • Remove some debug asserts #4826 by @emilk
  • Handle the IME event first in TextEdit to fix some bugs #4794 by @rustbasic
  • Slider: round to decimals after applying step_by #4822 by @AurevoirXavier
  • Fix: hint text follows the alignment set on the TextEdit #4889 by @PrimmR
  • Request focus on a TextEdit when clicked #4991 by @Zoxc
  • Fix Id clash in Frame styling widget #4967 by @YgorSouza
  • Prevent ScrollArea contents from exceeding the container size #5006 by @DouglasDwyer
  • Fix bug in size calculation of truncated text #5076 by @emilk
  • Fix: Make sure RawInput::take clears all events, like it says it does #5104 by @emilk
  • Fix DragValue range clamping #5118 by @emilk
  • Fix: panic when dragging window between monitors of different pixels_per_point #4868 by @rustbasic

eframe changelog

✨ Highlights

🧳 Migration

  • WebRunner::start now expects a HtmlCanvasElement rather than the id of it (#4780)
  • NativeOptions::follow_system_theme and default_theme is gone, and is now in egui::Options instead (#4860)

⭐ Added

🔧 Changed

🐛 Fixed