amethyst-imgui

Crates.ioamethyst-imgui
lib.rsamethyst-imgui
version0.7.1
sourcesrc
created_at2018-12-08 23:38:09.088218
updated_at2020-08-23 09:02:37.772738
descriptionimgui library for amethyst
homepage
repositoryhttps://github.com/jaynus/amethyst-imgui
max_upload_size
id100874
size1,900,069
ImGui Team (github:amethyst:imgui-team)

documentation

README

Latest release on crates.io Documentation on docs.rs

amethyst-imgui

Amethyst-imgui provides integration for the imgui-rs crate within the Amethyst game engine.

ImGUI is known industry wide for its utility in fast prototyping and debug interfaces.

Integration

This crate provides an amethyst RenderPlugin (available since amethyst 0.12) which properly renders ImGUI windows which are rendered using the imgui-rs crate. This integration is accomplished by calling the amethyst_imgui::with function anywhere within an Amethyst (a System or State is appropriate), which will render within the immediate-mode context of ImGui. All synchronization, frame handling and Amethyst input is handled within this crate.

A minimal example is available at examples/demo_window.rs

# For Windows/Linux:
cargo run --example demo_window --features vulkan
# For MacOS:
cargo run --example demo_window --features metal

Usage

This crate currently requires including the amethyst crate; this may introduce a full recompilation of amethyst due to differing features. If this is the case, you'll need to clone this git repository and and set the appropriate features.

This create uses the amethyst shader-compiler, which relies on shaderc to compile its shaders at build time. Finally, this crate exposes the same rendering features as amethyst, and will pass them along to amethyst.

Example Cargo.toml Usage:

amethyst-imgui = { version = "0.7", features = ["vulkan"] }

RenderPlugin usage:

fn main() -> amethyst::Result<()> {
    amethyst::start_logger(Default::default());
    let app_root = application_root_dir()?;
    let display_config_path = app_root.join("examples/display.ron");

    let game_data = GameDataBuilder::default()
        .with_barrier()
        .with(DemoSystem::default(), "imgui_use", &[])
        .with_bundle(amethyst::input::InputBundle::<amethyst::input::StringBindings>::default())?
        .with_bundle(
            RenderingBundle::<DefaultBackend>::new()
                .with_plugin(
                    RenderToWindow::from_config_path(display_config_path)
                        .with_clear([0.34, 0.36, 0.52, 1.0]),
                )
                .with_plugin(RenderImgui::<amethyst::input::StringBindings>::default()),
        )?;

    Application::build("/", Example)?.build(game_data)?.run();

    Ok(())
}

An example System using amethyst-imgui:

pub struct ImguiDemoSystem;
impl<'s> amethyst::ecs::System<'s> for ImguiDemoSystem {
    type SystemData = ();
    fn run(&mut self, _: Self::SystemData) {
        amethyst_imgui::with(|ui| {
            ui.show_demo_window(&mut true);
        });
    }
}
Commit count: 117

cargo fmt