nsf-imgui

Rust 对 Dear ImGui 1.66b 的绑定。一个实验性的个人项目，由于以下原因而创建

1. 想学习 Rust。
2. 对游戏开发略有兴趣。
3. 对现有的绑定并不完全满意。

目标

1. 使用 cimgui 数据文件自动生成大部分 FFI 绑定（有助于维护）。
2. 同样自动生成大部分本地包装器。
3. 本地包装器不应过于关注安全性，而是在类型（指针引用、字符串管理等）方面提供一定程度的便利。
4. 紧密遵循原始 C++ API，因此不必过于担心安全性。例如，只要原始库允许您使用不匹配的 begin()/end() 调用来破坏事物，就允许这样做。

实现细节

1. 大量代码使用 generate.js 脚本生成。生成是手动触发的，仓库包括生成的文件。要运行此脚本，您需要通过 npm install 安装 npm 软件包。除了 generate.js 脚本外，请参阅 gen.bash 脚本来了解文件是如何生成的。
2. 不安全部分使用 "bitflags" crate 来实现作为位标志的枚举。
3. 安全部分目前非常有限。只有被认为是安全的函数被包装。例如，那些不包含函数指针或 void* 或类似的东西的函数。
4. const char* 参数变为 &CStr，还有自定义的 cstr! 宏来帮助在编译时构建这些。 const char* 返回值转换为 String。其他类型按原样传播，*mut 变为 &mut，*const 变为 &。
5. 函数参数中的"格式"部分，通常由一个格式字符串和参数组成，被转换为一个单一的字符串参数。然后作为 "%s" 传递。
6. 自定义 cstr! 宏支持格式化，例如 cstr!("{}", myint)。这个变体使用了 format! 宏，它分配了一个字符串。
7. 所有 imgui 函数都是 ImGui 结构体的方法。您可以使用 ImGui::new() 创建一个实例。此结构体只允许一个实例（通过静态互斥锁保护）。虽然结构体是可复制的，但内部的 Rc。 ImGui::new() 函数将调用 igCreateContext()。当最后一个 ImGui 实例被丢弃时，它将调用 igDestroyContext(igGetCurrentContext())。
8. 原始库使用 C 类型，例如 int、unsigned int、float、double、size_t。我假设它们是 i32、u32、f32、f64、usize 等等。基本上意味着它们有固定的大小。虽然在理论上是这样的，但在实践中很多情况下都是真的。它适用于典型的 64 位桌面配置，如果要在嵌入式场景中使用 imgui，可能不适用。
9. 原始库是用 C++ 编写的，这允许指定尾随函数参数的默认值。它使用泛型 impl Into<Option<>> 类型实现。不幸的是，由于某种原因，这些类型中的引用需要显式的生命周期，因此我必须为函数签名中的所有 ref 类型生成显式的生命周期。