dear-node-editor-sys 0.15.0

Low-level FFI bindings for imgui-node-editor via cimnodes_editor
Documentation

dear-node-editor-sys

Low-level FFI bindings for imgui-node-editor through the cimnodes_editor submodule.

The public bindings are generated from the local dne_* shim rather than the raw upstream C wrapper. This keeps C++ ID helper objects out of the Rust API and lets the high-level crate expose NodeId, PinId, and LinkId as plain pointer-sized newtypes.

Upstream Sources

This crate vendors:

The Rust examples, including the blueprints-style showcase, intentionally follow the upstream imgui-node-editor examples where practical. The stack layout helpers required by those examples (BeginHorizontal, BeginVertical, and Spring) are provided by dear-imgui-sys as a repository-owned compatibility shim; they are not official Dear ImGui APIs.

Build Modes

  • Normal builds use src/bindings_pregenerated.rs and compile the native C++ sources with cc.
  • Binding regeneration requires DEAR_IMGUI_RS_REGEN_BINDINGS=1 and --features bindgen.
  • NODE_EDITOR_SYS_SKIP_CC=1 skips native compilation and uses pregenerated bindings.
  • NODE_EDITOR_SYS_LIB_DIR, NODE_EDITOR_SYS_PREBUILT_URL, and the prebuilt feature follow the same prebuilt-library flow as the other workspace *-sys crates.
  • wasm32 is intentionally unsupported in the first integration phase.

WebAssembly Scope

dear-node-editor-sys is native-only in this integration phase. This is not because imgui-node-editor can never be built for WebAssembly; it is because this workspace's WASM support uses an import-style provider module (imgui-sys-v0) with explicitly generated imports and provider exports.

To support dear-node-editor on wasm, the workspace would need a complete provider integration for cimnodes_editor / imgui-node-editor: wasm pregenerated bindings, provider export generation, Emscripten source wiring, texture/input smoke coverage, and web examples. Until that exists, use dear-imnodes, which is already part of the current wasm-capable provider path.

License Notes

This Rust crate is dual-licensed under the workspace MIT OR Apache-2.0 terms. The vendored native imgui-node-editor sources are MIT-licensed; see third-party/cimnodes_editor/imgui-node-editor/LICENSE.