5 releases
0.1.4 | Aug 20, 2024 |
---|---|
0.1.3 | Aug 20, 2024 |
0.1.2 | Aug 19, 2024 |
0.1.1 | Aug 18, 2024 |
0.1.0 | Aug 10, 2024 |
#1269 in WebAssembly
87KB
1.5K
SLoC
egui_wings
This crate facilitates sharing an egui::Context
between a host and multiple guest WASM modules. This allows WASM plugins to draw UI and easily display it via the host.
Usage
The following code snippet shows how to use egui_wings
from a WASM plugin (the complete example may be found in the egui_wings_example
folder). It defines a WingsSystem
which will store the WASM plugin's state. Each frame, the draw_ui
method is invoked. It accesses the host egui::Context
via a system dependency and then makes normal egui
calls to draw a UI.
use egui_wings::*;
use example_host::*;
use wings::*;
instantiate_systems!(ExampleHost, [PluginSystem]);
/// An object that will be instantiated inside a WASM plugin.
#[export_system]
pub struct PluginSystem {
/// A handle for accessing system dependencies.
ctx: WingsContextHandle<Self>,
}
impl PluginSystem {
/// Submits the `egui` commands to draw the debug windows.
fn draw_ui(&mut self, _: &example_host::on::Render) {
let egui = self.ctx.get::<dyn Egui>();
Window::new("webassembly says hello!")
.resizable(true)
.vscroll(true)
.default_open(false)
.show(&egui.context(), |ui| {
ui.label("Hello there!");
});
}
}
impl WingsSystem for PluginSystem {
const DEPENDENCIES: Dependencies = dependencies().with::<dyn Egui>();
const EVENT_HANDLERS: EventHandlers<Self> = event_handlers().with(Self::draw_ui);
fn new(ctx: WingsContextHandle<Self>) -> Self {
Self { ctx }
}
}
Dependencies
~6–13MB
~176K SLoC