enum2egui

github crates.io docs.rs

enum2egui is a rust derive macro that creates egui UI's from arbitrary structs and enums. This is useful for generating data bindings that can be modified and displayed in an egui ui.

Default and Display are required. enum2str is recommended for deriving Display on enums.

Usage

Add this to your Cargo.toml:

toml enum2egui = "0.1.4"

Example

Declare your data:

```rust use enum2egui::{Gui, GuiInspect};

[derive(Gui, EnumStr, Debug, Clone, Default, serde::Deserialize, serde::Serialize, PartialEq)]

pub enum Color { #[default] Red, Green, #[enum2str("Custom")] Custom(u8, u8, u8), NamedCustom { red: u8, blue: u8, green: u8, metadata: Metadata, }, }

[derive(Gui, Clone, serde::Deserialize, serde::Serialize, Default)]

pub struct Data { string: String, i8: i8, i16: i16, i32: i32, i64: i64, bool: bool, u8: u8, u16: u16, u32: u32, f32: f32, f64: f64, nestedstruct: SubData, unnamedstruct: TupleStruct, primarycolor: Color, secondarycolor: Color, optional: Option, }

[derive(Gui, Clone, serde::Deserialize, serde::Serialize, PartialEq)]

pub struct TupleStruct(u8, u32, String, SubData);

impl Default for TupleStruct { fn default() -> Self { Self(3, 24, "Hello!".to_string(), SubData::default()) } }

[derive(Gui, Clone, Default, serde::Deserialize, serde::Serialize, PartialEq, Debug)]

pub struct Metadata { message: String, }

[derive(Gui, Clone, Default, serde::Deserialize, serde::Serialize, PartialEq)]

pub struct SubData { value: String, number: u32, } ```

Then render it with GuiInspect::ui(..) or GuiInspect::ui_mut(). For example, with eframe:

```rust impl eframe::App for DemoApp { fn update(&mut self, ctx: &egui::Context, _frame: &mut eframe::Frame) { let Self { data } = self;

    egui::CentralPanel::default().show(ctx, |ui| {
        // Read-Only UI
        data.ui(ui):

        // Mutable UI
        data.ui_mut(ui);
    });
}

} ```

image