imgui-rs: Rust bindings for ImGui

Ultra hyper turbo cyber mega extra über experimental!!!

ui.window(im_str!("Hello world"))
    .size((300.0, 100.0), ImGuiSetCond_FirstUseEver)
    .build(|| {
        ui.text(im_str!("Hello world!"));
        ui.text(im_str!("This...is...imgui-rs!"));
        ui.separator();
        let mouse_pos = ui.imgui().mouse_pos();
        ui.text(im_str!("Mouse Position: ({:.1},{:.1})", mouse_pos.0, mouse_pos.1));
    })

Currently implemented things

• Low-level API (imgui-sys)
• Renderer for easy integration with Glium projects (optional)
• Parts of high-level API
• Not horrible way of defining and passing null-terminated UTF-8 to ImGui. The macro im_str! needs to be used most of the time. For more information and justification for this design, please see issue #7
• Parts of imgui_demo.cpp reimplemented in Rust as an API usage example (examples/test_window_impl.rs)

Important but unimplemented things

• Documentation (rustdoc)
• Support passing a custom Program to Glium renderer (e.g. from a shader cache, or custom shader)

Core design questions and current choices

• Closures VS begin/end pairs (current choice: closures)
• Mutable references VS return values (current choice: mutable references)
• Passing around Ui<'ui> VS passing around &'ui Ui (current choice: Ui<'ui>)
• Splitting the API to smaller pieces VS all draw calls in Ui (current choice: all draw calls in Ui)
• Builder pattern for optional arguments VS something else (current choice: builder)
• Mutation functions in builders VS self-consuming functions in builders (current choice: self-consuming)

Compiling and running the demos

git clone https://github.com/Gekkio/imgui-rs
cd imgui-rs
git submodule update --init --recursive
cargo test

cargo run --example hello_world
cargo run --example test_window
cargo run --example test_window_impl

How to contribute

1. Change or add something

2. Run rustfmt to guarantee code style conformance

    cargo install fmt
    cargo fmt -- --write-mode=overwrite
   

3. Open a pull request in Github

License

Licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Uses ImGui and cimgui.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.