thedmd/imgui-node-editor
Imgui Node Editor
imgui-node-editor is a C++ extension for Dear ImGui that adds a fully interactive node graph editor, enabling visual programming and blueprint-style graph editing within immediate-mode GUI applications. At its core, it provides a customizable node graph UI component where users can place, drag, and connect nodes with pins, supporting Bézier curve connections, automatic highlights, and a default theme modeled after blueprint editors. The editor handles graph navigation with smooth zooming, scrolling, selection rectangles, group dragging, and keyboard shortcuts for cut, copy, paste, and delete operations.
The project distinguishes itself through its immediate-mode architecture, rendering the entire node graph each frame using Dear ImGui's API with no retained scene graph or incremental update logic. It features Bézier curve connection routing with automatic path calculation based on pin positions and canvas zoom, pin-based connection validation that checks type compatibility and prevents circular or duplicate links at runtime, and selection-rectangle hit testing using axis-aligned bounding box intersection tests. The editor also includes a context-menu action dispatch system that maps user-selected actions to immediate-mode button callbacks without an event queue, and a serialization-through-callback system that persists node layout and state by invoking user-provided callbacks, leaving the serialization format and storage entirely to the host application.
The editor supports fully custom content rendering inside nodes and pins, allowing developers to define the visual appearance of each element, along with a customizable theme system that includes Bézier curve links and automatic highlights. Graph layout persistence saves and restores node positions, connections, and state across sessions using a custom serialization system. The project provides a complete visual programming editor with canvas coordinate transforms for smooth zooming and panning through a single matrix multiplication per frame.
Features
- Blueprint-Style Editors - Provides a customizable blueprint-style node graph editor with Bézier connections and highlights.
- Node Graph Connection Routings - Provides automatic Bézier curve routing for node connections in the graph editor.
- 2D Affine Transformation Engines - Applies 2D affine transforms for smooth zooming and panning of the node graph canvas.
- Graph Node Visualizations - Renders fully custom content inside nodes and pins, letting users define visual appearance.
- Node Graph Engines - Provides a visual programming interface with draggable nodes, connectable pins, and interactive editing.
- ImGui Extensions - Extends Dear ImGui with node-based workspace and graph manipulation capabilities.
- Node UI Customization - Renders fully custom content inside nodes and pins, letting developers define visual appearance.
- Immediate-Mode Rendering - Renders the entire node graph each frame using Dear ImGui's immediate-mode API.
- Graph Navigation and Selection - Provides smooth zooming, scrolling, selection rectangles, and keyboard shortcuts for graph navigation.
- Visual Node Editors - Provides an interactive workspace for designing logic maps and node-based layouts with zoom and selection.
- Layout Persisters - Saves and restores node positions, connections, and state across sessions using custom serialization.
- Callback-Based Serialization - Persists node layouts and state through user-provided callbacks for flexible serialization.
- Immediate-Mode Context Menu Dispatchers - Ships an immediate-mode context menu dispatch system for node graph actions.
- Editor Themes - Applies a fully customizable theme with blueprint-style Bézier curve links and automatic highlights.
- Blueprint-Style Themes - Applies a customizable blueprint-style theme with Bézier links and automatic highlights.
- Layout Persistence - Persists node positions and state in user-defined context across sessions.
- Node Layout Serialization - Persists node layouts, positions, and properties across sessions with user-defined context handling.
- Connection Validation Rules - Validates node connections by checking pin types and preventing circular or duplicate links.
- Selection Area Hit Testing - Performs axis-aligned bounding box intersection tests for selection rectangle hit detection.
- أدوات التطوير - Node-based editing framework.
