项目简介STNodeEditor 是一个轻量且功能强大的节点编辑器基于 Windows Forms 开发。它提供了一套完整的可视化编程框架允许开发者通过拖拽连接节点的方式来构建数据处理流程。该项目受到 Blender、GNURadio 和 Davinci Resolve 等专业节点编辑软件的启发旨在为 .NET 开发者提供一个灵活、可扩展的节点式编程解决方案。算法原理核心架构设计STNodeEditor 采用分层架构设计主要包含以下核心组件STNode节点基类所有自定义节点的基类提供节点的基本属性位置、大小、标题、颜色等和生命周期管理方法OnCreate、OnDraw、OnSaveNode 等。STNodeEditor节点编辑器主控件负责管理所有节点、连线、画布缩放/移动、事件处理等。STNodeOption节点选项表示节点的输入/输出端口支持单连接圆形和多连接方形模式自动进行类型兼容性检查。STNodeHub节点集线器内置特殊节点用于分线、合并线路支持动态添加/删除连接点。STNodePropertyGrid属性网格与节点属性绑定支持自动识别和显示节点的可配置属性。STNodeTreeView节点树视图提供节点分类浏览和拖拽功能支持按路径组织节点。关键算法实现1. 连线算法类型兼容性检查在连接两个节点时自动检测数据类型是否兼容防止不匹配的数据流。环路检测通过深度优先搜索DFS算法检测是否存在环形连接避免无限循环。重复连接检测检查是否已存在相同源-目标的连接防止重复连线。曲线绘制使用贝塞尔曲线算法绘制连线支持曲度调节Curvature 属性。2. 布局与渲染算法自动布局计算节点自动计算最佳尺寸AutoSize根据标题长度、选项数量和文本宽度动态调整大小。磁铁吸附算法移动节点时自动吸附到其他节点的边界或网格线上提高布局精度。双缓冲渲染使用双缓冲技术减少闪烁提升绘制性能。区域裁剪优化只重绘发生变化的区域提高渲染效率。3. 事件处理机制事件冒泡系统鼠标事件点击、悬停、拖拽在节点层次中正确传递和处理。状态管理维护节点的选中、活动、悬停等状态并触发相应事件。异步操作支持异步加载/保存画布避免界面阻塞。4. 数据持久化二进制序列化使用自定义二进制格式保存节点状态包括位置、大小、连接关系、属性值等。类型安全存储为每个属性类型提供专门的序列化/反序列化处理器确保数据完整性。版本兼容性支持向后兼容的文件格式新版本可以打开旧版本保存的文件。环境要求开发环境操作系统Windows 7 及以上版本推荐 Windows 10/11.NET Framework.NET Framework 4.6.1 或更高版本开发工具Visual Studio 2017 或更高版本推荐 VS 2019/2022运行环境客户端Windows 操作系统.NET Framework.NET Framework 4.6.1 运行时硬件要求CPUIntel Core i3 或同等性能处理器内存2GB RAM推荐 4GB显卡支持 DirectX 9 的显卡用于硬件加速渲染安装步骤方法一从源码编译安装克隆项目gitclone https://github.com/DebugST/STNodeEditor.gitcdSTNodeEditor打开解决方案使用 Visual Studio 打开WinNodeEditorTest.sln解决方案文件或者直接双击WinNodeEditorTest.sln文件构建项目在 Visual Studio 中选择生成→重新生成解决方案确保构建成功没有错误获取编译结果编译后的程序位于WinNodeEditorDemo\bin\Debug\目录下主要文件WinNodeEditorDemo.exe和ST.Library.UI.dll方法二直接运行预编译版本下载预编译包访问 GitHub Releases 页面下载最新版本或者直接使用项目根目录下的WinNodeEditorDemo.exe如果已存在运行程序双击WinNodeEditorDemo.exe即可启动运行步骤启动程序双击WinNodeEditorDemo.exe启动应用程序程序启动后会显示主界面包含节点编辑器、节点树视图和属性网格基本操作创建节点在节点树视图中找到需要的节点类型将节点拖拽到编辑器画布中或者通过代码方式添加stNodeEditor1.Nodes.Add(new MyNode());连接节点点击源节点的输出端口并拖拽到目标节点的输入端口系统会自动检查类型兼容性和环路问题支持 Ctrl拖拽进行快速复制节点编辑节点右键点击节点标题打开上下文菜单在属性网格中修改节点属性使用鼠标滚轮缩放画布Ctrl滚轮中键拖拽移动画布保存和加载保存画布点击工具栏的保存按钮或选择文件→保存保存为.stn格式文件加载画布点击工具栏的打开按钮或选择文件→打开加载之前保存的.stn文件高级功能自定义节点开发创建继承自STNode的类在OnCreate()方法中添加输入/输出选项重写OnDrawBody()方法自定义节点外观重写OnSaveNode()和OnLoadNode()方法实现数据持久化使用STNodePropertyAttribute标记属性使其在属性网格中显示节点属性配置在节点类中使用[STNodePropertyAttribute]特性标记需要在属性网格中显示的属性支持基本类型int、float、double、bool、string、enum及其数组可以自定义属性描述器STNodePropertyDescriptor支持复杂类型注意事项使用注意事项节点命名规范节点标题应简洁明了避免使用特殊字符类型匹配连接节点时确保数据类型兼容否则连接会被拒绝环路避免避免创建可能导致无限循环的节点连接性能优化大量节点时建议关闭网格显示ShowGrid false以提高性能内存管理及时释放不再使用的节点避免内存泄漏开发注意事项构造函数要求自定义节点必须提供空参数构造函数否则无法通过反射创建线程安全所有 UI 操作必须在主线程中执行使用Invoke()或BeginInvoke()处理跨线程调用资源释放重写Dispose()方法释放 GDI 资源如 Image、Pen、Brush 等异常处理在OnSaveNode()和OnLoadNode()中添加适当的异常处理避免数据损坏常见问题解决连接失败检查数据类型是否兼容检查是否已存在相同连接检查是否形成环路查看状态栏提示信息渲染异常确认 .NET Framework 版本是否正确尝试禁用硬件加速this.SetStyle(ControlStyles.OptimizedDoubleBuffer, false);检查自定义绘制代码是否有异常性能问题减少节点数量或简化节点外观关闭不必要的视觉效果网格、边框、磁铁效果使用CanvasScale控制缩放级别文件夹结构介绍STNodeEditor/ ├── .gitignore # Git 忽略文件配置 ├── LICENSE # MIT 开源许可证 ├── README.md # 项目原始 README 文件 ├── README2.md # 本项目文档当前文件 ├── WinNodeEditorTest.sln # Visual Studio 解决方案文件 ├── WinNodeEditorTest.suo # Visual Studio 用户选项文件 ├── docs/ # 项目文档 │ ├── css/ # CSS 样式文件 │ ├── images/ # 文档图片资源 │ ├── js/ # JavaScript 脚本 │ ├── api.html # API 文档 │ ├── doc_cn.html # 中文文档入口 │ ├── doc_en.html # 英文文档入口 │ ├── index.html # 文档首页 │ ├── tutorials_cn.html # 中文教程文档 │ └── tutorials_en.html # 英文教程文档 ├── ST.Library.UI/ # 核心库项目 │ ├── NodeEditor/ # 节点编辑器核心代码 │ │ ├── FrmNodePreviewPanel.cs # 节点预览面板 │ │ ├── FrmSTNodePropertyInput.cs # 节点属性输入窗体 │ │ ├── FrmSTNodePropertySelect.cs # 节点属性选择窗体 │ │ ├── STNode.cs # 节点基类 │ │ ├── STNodeAttribute.cs # 节点特性类 │ │ ├── STNodeCollection.cs # 节点集合类 │ │ ├── STNodeControl.cs # 节点控件基类 │ │ ├── STNodeControlCollection.cs # 节点控件集合类 │ │ ├── STNodeEditor.cs # 节点编辑器主控件 │ │ ├── STNodeEditorDataType.cs # 节点编辑器数据类型 │ │ ├── STNodeEditorPannel.cs # 节点编辑器面板 │ │ ├── STNodeHub.cs # 节点集线器 │ │ ├── STNodeOption.cs # 节点选项类 │ │ ├── STNodeOptionCollection.cs # 节点选项集合类 │ │ ├── STNodePropertyAttribute.cs # 节点属性特性 │ │ ├── STNodePropertyGrid.cs # 节点属性网格 │ │ └── STNodeTreeView.cs # 节点树视图 │ ├── Properties/ # 项目属性 │ │ └── AssemblyInfo.cs # 程序集信息 │ ├── bin/Debug/ # 编译输出目录 │ │ ├── ST.Library.UI.dll # 核心库 DLL │ │ └── ST.Library.UI.pdb # 调试符号文件 │ └── ST.Library.UI.csproj # 核心库项目文件 └── WinNodeEditorDemo/ # 示例演示项目 ├── Blender/ # Blender 相关节点 │ ├── BlenderMixColorNode.cs # Blender 混合颜色节点 │ ├── FrmEnumSelect.cs # 枚举选择窗体 │ ├── STNodeCheckBox.cs # 复选框节点控件 │ ├── STNodeColorButton.cs # 颜色按钮节点控件 │ ├── STNodeProgress.cs # 进度条节点控件 │ └── STNodeSelectBox.cs # 选择框节点控件 ├── ImageNode/ # 图像处理节点 │ ├── ImageBaseNode.cs # 图像基础节点 │ ├── ImageChannelNode.cs # 图像通道节点 │ └── ImageInputNode.cs # 图像输入节点 ├── NumberNode/ # 数值处理节点 │ ├── NumberAddNode.cs # 数值加法节点 │ ├── NumberInputNode.cs # 数值输入节点 │ └── NumberNode.cs # 数值基础节点 ├── Properties/ # 项目属性 │ ├── AssemblyInfo.cs # 程序集信息 │ ├── Resources.Designer.cs # 资源设计器 │ ├── Resources.resx # 资源文件 │ ├── Settings.Designer.cs # 设置设计器 │ └── Settings.settings # 应用设置 ├── bin/Debug/ # 编译输出目录 │ ├── ST.Library.UI.dll # 核心库引用 │ ├── WinNodeEditorDemo.exe # 主程序 │ └── WinNodeEditorDemo.pdb # 调试符号文件 ├── AttrTestNode.cs # 属性测试节点 ├── CalcNode.cs # 计算节点 ├── EmptyOptionTestNode.cs # 空选项测试节点 ├── Form1.Designer.cs # 主窗体设计器 ├── Form1.cs # 主窗体逻辑 ├── Form1.resx # 主窗体资源 ├── Program.cs # 程序入口 ├── STNodeHub.cs # 节点集线器示例 ├── ToolStripRendererEx.cs # 工具栏渲染器 └── WinNodeEditorDemo.csproj # 示例项目文件源码地址https://download.csdn.net/download/FL1623863129/90010624
