imgui-rs：ImGui的Rust绑定

仍然相当实验性！

最低 Rust 版本：1.20

ui.window(im_str!("Hello world"))
    .size((300.0, 100.0), ImGuiCond::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));
    })

当前实现的功能

• 低级API（imgui-sys）
• 与 Glium 项目轻松集成的渲染器（可选）
• 高级API的部分功能
• 定义和传递 null-terminated UTF-8 到 ImGui 的不错方法。大多数情况下需要使用宏 im_str!。有关更多信息以及此设计的原因，请参阅 问题 #7
• imgui_demo.cpp 的部分在 Rust 中重新实现，作为API使用示例（examples/test_window_impl.rs）

重要但未实现的功能

• 文档（rustdoc）
• 支持将自定义 Program 传递给 Glium 渲染器（例如，从着色器缓存或自定义着色器）

核心设计问题和当前选择

• 闭包 VS begin/end 对（当前选择：闭包）
• 可变引用 VS 返回值（当前选择：可变引用）
• 传递 Ui<'ui> VS 传递 &'ui Ui（当前选择：Ui<'ui>）
• 将 API 分割成更小的部分 VS 在 Ui 中所有绘制调用（当前选择：在 Ui 中所有绘制调用）
• 可选参数的构建器模式 VS 其他（当前选择：构建器）
• 构建器中的突变函数 VS 自消耗函数（当前选择：自消耗）

编译和运行演示

示例位于 imgui-examples 目录下。

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

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

注意 Windows 用户：您需要使用 Rust 编译器的 MSVC ABI 版本及其相关 依赖项 来构建此库并运行示例。

如何贡献

1. 更改或添加内容

2. 运行 rustfmt 以保证代码风格一致性

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

3. 在 Github 上打开一个 pull request

许可证

许可协议为以下之一

• Apache License 2.0版本，(LICENSE-APACHE 或 http://www.apache.org/licenses/LICENSE-2.0)
• MIT许可证 (LICENSE-MIT 或 http://opensource.org/licenses/MIT)

由您自行选择。

使用了 ImGui 和 cimgui。

贡献

除非您明确表示，否则根据Apache-2.0许可证定义，您有意提交给作品的所有贡献将如上双许可，没有任何附加条款或条件。