6 releases

new 0.2.0 Nov 13, 2024
0.1.4 Aug 20, 2024

#1283 in WebAssembly

Download history 36/week @ 2024-08-04 86/week @ 2024-08-11 581/week @ 2024-08-18 23/week @ 2024-08-25 1/week @ 2024-09-01 7/week @ 2024-09-15 7/week @ 2024-09-22 2/week @ 2024-09-29 1/week @ 2024-10-06 3/week @ 2024-11-03 112/week @ 2024-11-10

115 downloads per month

MIT/Apache and GPL-3.0-or-later

92KB
2K SLoC

egui_wings

Crates.io Docs.rs

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