mirror of https://github.com/emilk/egui.git synced 2026-08-29 04:40:03 -04:00

Files

Emil Ernerfeldt 2f6fe9c572 eframe: Replace Frame::update with fn logic and fn ui (#7775 )

* Part of https://github.com/emilk/egui/issues/5113
* Part of https://github.com/emilk/egui/issues/3524

## What
This deprecates `eframe::App::update` and replaces it with two new
functions:

```rs
pub trait App {
	/// Called just before `ui`, and in the future this will
    /// also be called for background apps when needed.
	fn logic(&mut self, ctx: &egui::Context, frame: &mut Frame) { }
	
    /// Show your user interface to the user.
	fn ui(&mut self, ui: &mut egui::Ui, frame: &mut Frame);

	…
}
```

Similarly, `Context::run` is deprecated in favor of `Context::run_ui`.

`Plugin`s are now handed a `Ui` instead of just a `Context` in
`on_begin/end_frame`.

## TODO
…either in this PR or a later one
* [x] Deprecate `App::update`
* [x] Deprecate `Context::run`
* [x] Change plugins to get a `Ui`
* [x] Update kittest
* [x] Change viewports to get UI:s (`show_viewport_immediate` etc)
  - https://github.com/emilk/egui/pull/7779

## Later PRs
* [ ] Deprecate `Panel::show`
* [ ] Deprecate `CentralPanel::show`
* [ ] Deprecate `CentralPanel` ?

2025-12-16 17:05:50 +01:00

benches

eframe: Replace Frame::update with fn logic and fn ui (#7775 )

2025-12-16 17:05:50 +01:00

data

Add snapshot test for image blending (#7309 )

2025-07-07 13:58:22 +02:00

src

eframe: Replace Frame::update with fn logic and fn ui (#7775 )

2025-12-16 17:05:50 +01:00

tests

Viewports: give the caller a Ui instead of Context (#7779 )

2025-12-15 18:51:57 +01:00

Cargo.toml

Add taplo.toml for toml formatting (#7618 )

2025-10-09 15:38:00 +02:00

README.md

Add button benchmark (#6854 )

2025-04-28 11:58:05 +02:00

README.md

`egui` demo library

This crate contains example code for egui.

The demo library is a separate crate for three reasons:

To ensure it only uses the public egui api.
To remove the amount of code in egui proper.
To make it easy for 3rd party egui integrations to use it for tests.
- See for instance https://github.com/not-fl3/egui-miniquad/blob/master/examples/demo.rs

This crate also contains benchmarks for egui. Run them with

# Run all benchmarks
cargo bench -p egui_demo_lib 

# Run a single benchmark
cargo bench -p egui_demo_lib "benchmark name"

# Profile benchmarks with cargo-flamegraph (--root flag is necessary for MacOS)
CARGO_PROFILE_BENCH_DEBUG=true cargo flamegraph --bench benchmark --root -p egui_demo_lib  -- --bench "benchmark name"

# Profile with cargo-instruments
CARGO_PROFILE_BENCH_DEBUG=true cargo instruments --profile bench --bench benchmark -p egui_demo_lib -t time -- --bench "benchmark name"

README.md

egui demo library

`egui` demo library