11 releases
0.5.2 | Jan 16, 2024 |
---|---|
0.5.0 | Nov 27, 2023 |
0.4.4 | Jul 24, 2023 |
0.4.2 | Feb 17, 2023 |
0.3.1 | Oct 11, 2022 |
#317 in GUI
26KB
265 lines
Blue Engine egui plugin
This is a plugin that adds egui support to the Blue Engine.
Getting started
To get started, initialize the plugin:
let gui_context = blue_engine_egui::EGUI::new(&engine.event_loop, &mut engine.renderer, &engine.window);
This will essentially initializes the egui and create things required to run the plugin. The engine will then run it twice, once before everything else to fetch all inputs and events, and then during render, so that it displays the GUI. And all that's left, is to add the plugin to the engine and use it:
engine.plugins.push(Box::new(gui_context));
During the update_loop, you can get the plugin back and use it. We'll assume only one plugin is added:
// -- update loop start
// change the plugin_index from 0 to the index of the plugin when added
let egui_plugin = let egui_plugin = plugins[0]
// downcast it to obtain the plugin
.downcast_mut::<blue_engine_egui::EGUI>()
.expect("Plugin not found");
// -- rest of update loop code
Finally you can use it to add GUI code:
// -- rest of update loop code
// start the GUI addition
egui_plugin.ui(
// get the context
|ctx| {
// create the window
gui::Window::new("title").show(ctx, |ui| {
// add components
ui.horizontal(|ui| {
ui.label("Hello World!");
});
});
},
&window,
);
// -- rest of update loop code
Congrats now you have a working GUI!
Style Block
The guide will come soon, it's cool I promise!
Examples
Check the examples folder for potential UIs and as template for your new projects.
Dependency justification
blue_engine
: Used obiously for exporting some components and struct declrations required to design the APIegui-wgpu
: Used to assist in applying egui to wgpu graphics backend. Which is same graphics backend used in Blue Engine.egui-winit
: Support for Winit windowing. Which is same windowing system used in Blue Engine.egui
: The egui itself, required to obtain components and declrations for api design.
Dependencies
~23–59MB
~1M SLoC