easy-imgui-rs

Build full GUI applications with Rust and Dear ImGui. It currently uses version v1.92.8.

There are several crates in this repository:

• easy-imgui-sys: This is the direct binding of the C++ Dear ImGui library.
• easy-imgui: The main binding of Dear ImGui API.
• easy-imgui-renderer: A UI renderer using OpenGL and glow.
• easy-imgui-window: A fully integrated and easy to use GUI framework based on winit.
• easy-imgui-sdl3: Binding of the SDL3 Dear ImGui back, plus OpenGL. It makes it possible to use ImGui viewports.

See some examples at the examples directory. The simplest one is just a few lines of code:

use easy_imgui_window::{MainWindow, MainWindowWithRenderer,
    winit::event_loop::EventLoopBuilder,
    easy_imgui as imgui,
};

fn main() {
    let event_loop = EventLoopBuilder::new().build().unwrap();
    let main_window = MainWindow::new(&event_loop, "Example").unwrap();
    let mut window = MainWindowWithRenderer::new(main_window);

    let mut app = App;

    event_loop.run(move |event, w| {
        let res = window.do_event(&mut app, &event, w);
        if res.is_break() {
            w.exit();
        }
    }).unwrap();
}

struct App;

impl imgui::UiBuilder for App {
    fn do_ui(&mut self, ui: &imgui::Ui<Self>) {
        ui.show_demo_window(None);
    }
}