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 结束的 UTF-8 传递给 ImGui 的不错方法。大多数时候需要使用宏 im_str!。有关更多信息及设计理由，请参阅 问题 #7
• 将 imgui_demo.cpp 中的部分重写为 Rust 作为 API 使用示例（examples/test_window_impl.rs）

重要但尚未实现的功能

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

核心设计问题和当前选择

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

编译和运行演示

示例位于 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许可证版本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许可证定义，应按上述方式双重许可，不得附加任何额外条款或条件。