VisionFlow 1.0.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package VisionFlow --version 1.0.0
                    
NuGet\Install-Package VisionFlow -Version 1.0.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="VisionFlow" Version="1.0.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="VisionFlow" Version="1.0.0" />
                    
Directory.Packages.props
<PackageReference Include="VisionFlow" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add VisionFlow --version 1.0.0
                    
#r "nuget: VisionFlow, 1.0.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package VisionFlow@1.0.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=VisionFlow&version=1.0.0
                    
Install as a Cake Addin
#tool nuget:?package=VisionFlow&version=1.0.0
                    
Install as a Cake Tool

VisionFlow —— 纯 C# 流程图工作台(单工程 · net8.0)

参考 SubPixelCaliper(C++ 算法库 + C# 演示)重构的纯 C# 版本。核心目标是把"流程图模块" 做成方便你持续添加自己功能模块的框架:以后做海康 VisionMaster 式的数据工具时, 新增一个节点 = 新增一个类,工具箱、参数面板、序列化、引擎全部自动支持。

  • 一个工程(VisionFlow.csproj,net8.0-windows),核心代码按文件夹分开;
  • 流程图核心(Core\):100% 纯 C#,零第三方依赖,不引用 WinForms / OpenCvSharp / System.Drawing;
  • 视觉演示(Vision\,测试用):基于 OpenCvSharp 的图像处理节点 + 一个纯 C# 自定义节点示例;
  • 界面(UI\):WinForms,只消费核心库的通用模型与节点注册表。

目录结构

VisionFlow\                        (单工程,根目录即项目目录)
├─ VisionFlow.csproj               net8.0-windows / WinExe / x64
├─ Program.cs                      入口(--selftest / --run / --flowimage / 默认编辑器)
├─ Core\                           ★ 流程图核心(纯 C#,可整体迁移复用)
│  ├─ Model\                       数据模型:端口/参数/节点基类/文档/运行状态
│  │  ├─ Enums.cs                  PortType / NodeStatus / NodeParameterKind
│  │  ├─ FlowPort.cs
│  │  ├─ NodeParameter.cs
│  │  ├─ FlowNodeBase.cs           节点抽象基类(Declare 声明 + Execute 执行)
│  │  ├─ FlowDocument.cs           流程图文档(节点+连线,序列化根对象)
│  │  └─ NodeRuntime.cs            单次运行状态
│  ├─ Data\                        数据层(UI 无关)
│  │  ├─ FlowGeometry.cs           FlowPoint / FlowRect / FlowColor
│  │  ├─ FlowImage.cs              8bit 灰度图
│  │  ├─ FlowPoints.cs             点集 / 轮廓集
│  │  ├─ FlowCalibration.cs        仿射标定模型
│  │  └─ OverlayShapes.cs          结果叠加图形(点/框/轮廓/圆/线段/标签)
│  ├─ Nodes\
│  │  ├─ FlowNodeAttribute.cs      [FlowNode] 注册特性
│  │  ├─ NodeBuilder.cs            声明期构建器(流式声明端口/参数)
│  │  ├─ NodeRegistry.cs           ★ 节点注册表:类型名 -> 工厂,支持程序集扫描
│  │  ├─ MissingNode.cs            外来流程缺节点类型时的占位节点(橙色警示,不进工具箱)
│  │  └─ BuiltInNodes.cs           内置输出节点(图像显示 / 数据结果)
│  ├─ Engine\
│  │  ├─ NodeExecutionContext.cs   节点执行上下文(读输入/写输出/回溯图像/叠加)
│  │  └─ FlowEngine.cs             ★ Kahn 拓扑排序 + 顺序执行 + 失败隔离 + 成环检测
│  ├─ Algo\                        纯 C# 算法(可复用)
│  │  ├─ AffineCalibrator.cs       平面仿射最小二乘标定
│  │  └─ GridSorter.cs             标定板点阵按行列排序
│  └─ IO\FlowJson.cs               流程 JSON 序列化(版本头/中文直出/容错反序列化)
│  └─ Flow.cs                      ★ 二次开发门面:Flow.Run/Open 一行运行、按中文端口名取结果、结果 JSON
├─ DEMO\                           ★ 示例库(*.vflow.json):文件夹里有什么,示例菜单就显示什么
│  ├─ 01_九点标定.vflow.json
│  ├─ 02_轮廓追踪.vflow.json
│  ├─ 03_卡尺测宽.vflow.json
│  ├─ 04_找圆测量.vflow.json
│  └─ 05_几何测量.vflow.json
├─ Vision\                         视觉演示节点(测试用,OpenCvSharp)
│  ├─ OpenCvBridge.cs              FlowImage <-> Mat 双向转换
│  ├─ SyntheticImages.cs           合成测试图(纯 C#)
│  ├─ InvertNode.cs                ★ 自定义节点示例(图像取反,纯 C#)
│  ├─ CaliperAlgo.cs               卡尺共享算法(剖面采样/erf-LM 亚像素/极性/边对),直线卡尺与找圆共用
│  ├─ GeometryAlgo.cs              几何算法(质心/PCA直线/点线距/垂足/交点/夹角/Kasa圆拟合)
│  └─ Nodes\                       图像源/滤波/阈值/形态学/Blob/轮廓/标定/坐标转换/卡尺/找圆/几何等
├─ UI\                             WinForms 编辑器
│  ├─ FlowCanvas.cs                可拖拽流程画布(撤销/重做/复制粘贴/右键菜单/缺失节点橙色警示)
│  ├─ FlowParamPanel.cs            节点参数面板(按元数据动态生成控件 + 数字软键盘入口)
│  ├─ NumericPad.cs                数字软键盘(鼠标输入数值,可拖动,范围提示)
│  ├─ DemoLibrary.cs               ★ DEMO 文件夹扫描与动态示例菜单(运行中增删文件即时刷新)
│  ├─ ImageBox.cs                  ★ CAD 风格图像查看器(滚轮缩放/拖拽平移/坐标灰度/叠加/ROI 宿主)
│  ├─ InteractiveRoi.cs            可交互 ROI 接口(通用框架,卡尺/矩形/圆 ROI 复用)
│  ├─ CaliperRoi.cs                卡尺搜索线 ROI(端点手柄/整体拖动,回写节点参数)
│  ├─ CircleRoi.cs                 找圆标称圆 ROI(圆心方块平移/圆周改半径/圆内不拦截防误触)
│  ├─ ResultPreview.cs             节点结果预览(ImageBox + 叠加 + 报告)
│  ├─ Examples.cs                  仅"打开真实图片"即时构造流程(示例已全部文件化到 DEMO\)
│  └─ MainForm.cs
└─ README.md

快速开始

环境要求

  • .NET 8 SDK(项目 net8.0-windows);
  • Windows x64(OpenCvSharp 原生运行时)。

构建与运行

cd VisionFlow
dotnet build -c Release
dotnet run -c Release                       REM 打开流程编辑器
bin\Release\net8.0-windows\VisionFlow.exe
dotnet run -c Release -- --selftest         REM 无界面自测

当前自测覆盖(全部通过):

  • 九点标定链:Blob 检出 9 点 → 仿射标定 RMS ≈ 0.0016 mm → 物理网格 (0,0)→(20,20) 9/9 命中;
  • 轮廓追踪链:小翅膀 4 条轮廓、最长 ~1929 px;
  • JSON 保存/加载往返:7 节点 7 连线无损,重跑结果一致;
  • 节点注册表目录:内置 + 视觉 + 自定义示例(图像取反)全部自动注册;
  • 新模块冒烟测试:连通域提取 9 区域 + 标签图、距离测量、圆拟合、圆检测(半径 200.7 vs 真实 200.25)、 直线检测、模板匹配 9 点命中、旋转+缩放 300x300、锐化/均衡/自动阈值/灰度统计全部通过;
  • 卡尺工具:合成垂直/水平阶跃边缘,8/8 亚像素边缘点误差 0(x=99.50 / y=119.50), 边缘点接直线拟合方向正确,阈值过高时安全漏检 0 点不失败; 边缘对测宽:合成 -12° 斜亮带(真实带宽 40.35px、高斯模糊+噪声),12/12 边对, 宽度均值 40.345px(误差 0.005px)、标准差 0.006px,两边直线拟合成功;示例流程一键载入同结果;
  • ImageBox 坐标互转往返一致、叠加图形离屏渲染、卡尺 ROI 命中/拖端点/整体拖动回写参数全部通过;
  • 找圆工具:合成 r=200.25 圆盘(模糊+噪声),32/32 径向卡尺命中,拟合半径 200.252、 圆心 (320.41,319.70)(真实 320.4,319.7)、圆度 RMS 0.025px;圆 ROI 命中/拖圆心/拖圆周/圆内不拦截全部通过;
  • 几何计算:点距 (0,0)→(3,4)=5、点线距=1 且垂足正确、水平/竖直线夹角=90°、两线交点=(1,1); 几何示例两边夹角 0.0004°、中点到边线 20.172px(理论半宽 20.175);
  • 二次开发门面:自动注册 32 种节点、Flow.Run 一行运行按中文端口名取宽度(40.3446)、 会话改参数重跑生效、结果 JSON 导出全部通过。

编辑器操作

界面皮肤(工业扁平风):WPF 式扁平化 + 工业视觉软件配色——中灰底色(#C4CAD3)作缝隙,把工具箱 / 流程图 / 图像预览 / 参数 / 输出 / 日志托成一张张白色卡片;每个卡片是深炭灰标题条(#2F3640,左侧 3px 工业蓝竖条 + 浅色粗体字),分区边界一眼可辨;菜单栏、工具栏、右键菜单统一深色(#2A2F37),工业蓝 #1677C7 只用于运行按钮、选中态、确定键等唯一强调;状态语义色(绿成功 / 红失败 / 橙警示 / 灰空闲)。工具箱为扁平自绘树(分类头浅灰粗体、叶子悬停浅蓝、选中蓝底白字)。

节点卡片与布局:顶条采用反差配色——内置节点工业蓝底(#5A7DB0)+ 明黄标题字(#FFD23A);宿主/第三方二次开发节点(来自 VisionFlow.dll 之外的程序集)自动用琥珀黄底(#F0A810)+ 深蓝标题字(#143A66),一眼分辨内置与自定义节点;缺失节点为橙底白字警示。节点宽度按标题与最长端口名自适应(168~280px),标题/端口文字随画布等比缩放、超长省略,多端口长名称不挤叠。菜单栏与快捷按钮同排:文件/编辑/流程/帮助 之后直接排 适应/撤销/重做/示例/清空,「▶ 运行」贴最右。 | 操作 | 功能 | |---|---| | 从工具箱拖拽节点到画布 | 添加节点(拖到哪个就建哪个) | | 双击工具箱项 | 在画布中央添加节点 | | 在端口圆点上按住左键拖到另一端口 | 建立连线(输出→输入,任一端起拖均可) | | 拖动节点卡片 | 移动节点(连线自动跟随) | | 单击节点 / 连线 | 选中(节点蓝框,参数面板加载参数) | | Delete | 删除选中节点(连带连线)或连线 | | 滚轮 | 以鼠标为锚缩放(0.4×–2×) | | 左键空白 / 中键拖动 | 平移画布 | | 双击节点 | 弹出该节点结果大图与完整报告 | | 结果图滚轮 | 以鼠标位置为锚缩放(适应尺寸的 0.2×–50×) | | 结果图拖拽 / 双击 | 平移图像 / 双击适应窗口;左下角实时显示 X、Y、灰度值、尺寸、缩放比 | | 卡尺节点:结果图上拖白色端点方块 | 调整搜索线起终点(参数面板坐标同步,松手自动重跑) | | 卡尺节点:拖搜索线本体 / 中点菱形 | 整体平移搜索线(松手自动重跑,可撤销) | | 找圆节点:拖圆心白方块 | 整体平移标称圆(松手自动重跑,可撤销) | | 找圆节点:拖圆周 / 3 点钟白方块 | 改变标称半径;圆内空白处仍可平移图像(防误触) | | 菜单「文件→保存/打开流程」 | 流程存为 / 载入 *.vflow.json | | F5 或「运行」 | 按拓扑顺序执行整个流程 | | Ctrl+Z / Ctrl+Y 或工具栏「↶ 撤销 / ↷ 重做」 | 撤销 / 重做(添加、删除、连线、移动、改参数全部可撤,上限 60 步) | | Ctrl+C / Ctrl+V 或右键菜单「复制 / 粘贴」 | 复制选中节点(含参数)并粘贴到目标位置 | | 右键菜单 | 复制 / 粘贴 / 删除 / 适应画布(现场鼠标调试利器) | | 点击参数行右侧「⌨」按钮 | 弹出数字软键盘(按住标题栏可拖动):0-9 / 退格 / C 清除 / ± / 小数点,顶部实时显示范围 Min~Max 与小数位,超出范围红字警示(确定时自动取边界) |

节点右上角状态灯:灰=未运行、蓝=运行中、绿=成功、红=失败;连线颜色随源节点状态变化。

DEMO 示例库(工具栏「示例 ▾」,文件即菜单)

示例不写死在代码里:exe 同目录的 DEMO\ 文件夹下,每个 *.vflow.json 就是一条示例, 工具栏「示例 ▾」下拉与「流程 → 载入示例」菜单在每次展开时重新扫描——文件夹里有什么就显示什么, 运行中拷入/删除文件无需重启。出厂自带 5 个模板(编号前缀固定排序,启动默认载入 01):

文件 内容
01_九点标定.vflow.json 图像源→高斯→Blob→多点标定→坐标转换(9 点,RMS≈0.0016mm)
02_轮廓追踪.vflow.json 小翅膀→高斯→轮廓追踪→显示/数据
03_卡尺测宽.vflow.json 斜亮带(带宽 40.35px)→卡尺边缘对→两边直线拟合
04_找圆测量.vflow.json 合成圆盘(r=200.25)→圆周卡尺找圆→圆心结果
05_几何测量.vflow.json 斜亮带两边→两线夹角 + 中点到边线距离
  • 不要某个示例:菜单里点「打开 DEMO 文件夹」,直接删文件即可(不需要专门的删除按钮), 也可以把自己调好的流程另存进去当模板;现场换型时把各机型流程存成 机型A_测宽.vflow.json、 机型B_测宽.vflow.json,换型一键载入;
  • 出厂模板随构建自动复制到输出目录(PreserveNewest,不会覆盖你改过的同名文件);
  • 命令行 --flowimage <图片路径> 仍可直接对真实图片建一条轮廓流程。

打开"外来流程"缺节点类型时(强容错)

DEMO 里的文件可能是从别的机器/别的项目拷来的,里面引用了本机没有的定制节点:

  • 编辑器:绝不开不了文件。缺失节点显示为橙色「⚠ 缺失: 类型名」占位卡片,端口按连线自动补全、 参数原样只读展示,连线、坐标、参数全部保留;参数面板顶部给出原因与处理提示; 该节点运行会明确失败(消息注明缺哪个类型),其他节点照常运行(失败隔离); 文件另存时类型名与参数原样写回,拷回装有对应模块的环境即完整恢复,不丢任何东西;
  • 命令行 / Flow.Run(严格模式):缺类型直接报错并指明类型名、退出码 1, 避免产线静默跑出缺工站的结果;
  • 连线引用了不存在的节点/端口、当前版本已删除的参数,也只记录警告并跳过,不影响其余部分加载。

卡尺工具用法(对标海康 Caliper 并增强,纯鼠标操作)

  1. 工具箱「标定测量 → 卡尺工具」拖入画布,图像源输出连到卡尺「图像」输入;
  2. 测量模式:
    • 单边缘:输出一条边上的亚像素点(端口「边缘1点」),可接直线/圆拟合、距离测量;
    • 边缘对(测宽度):一把卡尺同时抓两条极性相反的平行边,输出「边缘1点」「边缘2点」 「边对中点」三组点,并在报告给出宽度均值/标准差/最小/最大,图上画紫色宽度线与数值标签, 适合测带宽、测厚、测间隙、剥皮宽度;
  3. 按 F5 运行后,右下结果图(或双击节点的大图)上出现黄色搜索线:
    • 拖两端白色方块改起终点,拖线体/中点菱形整体平移,松手即自动重跑;
    • 蓝色点线是每把卡尺的投影剖面;绿点=边缘1、橙点=边缘2、青色点=边对中点; 红色点线表示该卡尺漏检;
  4. 参数:卡尺数量、卡尺长度(剖面长度,边缘对模式须大于被测宽度)、投影宽度(抗噪平均带宽)、 边缘极性(任意 / 黑→白 / 白→黑;边缘对模式指第一边缘极性,第二边自动相反)、 边缘阈值(梯度,灰度/px)、平滑尺度 σ(高斯预平滑,越大越抗噪但梯度峰越低)、 边对最小/最大宽度(px,过滤错误配对)、亚像素开关;
  5. 算法管线(工业卡尺第一梯队做法):双线性亚像素采样剖面 → 沿搜索线方向投影平均(抗噪)→ 一维高斯平滑(尺度 σ)→ 中心差分梯度 → 非极大值提取候选边缘 → 按极性/阈值筛选; 边缘对按"第一边缘极性 + 宽度范围"做相反极性峰最优配对;亚像素定位采用 误差函数 erf 阶跃模型 Levenberg-Marquardt 拟合(相机边缘=阶跃卷积高斯,erf 为其理想剖面, 同时输出边缘锐度),拟合失败自动回退抛物线插值。 注意:搜索线方向应大致平行于被测边缘(卡尺垂直于搜索线跨过边缘)。
  6. 「示例 ▾ → 03_卡尺测宽」一键载入:斜亮带(带宽 40.35px)→ 卡尺边缘对 → 两边各接直线拟合。

找圆工具用法(对标海康圆测量,纯鼠标操作)

  1. 工具箱「标定测量 → 找圆工具」拖入画布,图像源连到「图像」输入;
  2. F5 后结果图上出现黄色标称圆:拖圆心白方块整体平移、拖圆周或 3 点钟白方块改半径 (圆内空白区域不拦截,仍可平移图像,避免误触),松手自动重跑,可撤销;
  3. 工具在圆周(或起止角限定的圆弧)上等角度布 N 把径向卡尺,复用与卡尺工具完全相同的 erf-LM 亚像素管线找边缘点,再做 Kasa 最小二乘圆拟合;
  4. 输出:圆心(点)、边缘点、半径 / 圆度 RMS / 有效数(Number 端口,二次开发直接取值); 图上青色为拟合圆、绿色为边缘点、白色十字为圆心;报告给直径、径向极差、逐点半径与梯度;
  5. 极性沿径向向外判定:测暗孔(亮背景上的黑洞)选「内黑→外白」,测亮圆盘/亮轴截面 选「内白→外黑」;起止角可只测一段圆弧(缺圆、被遮挡的圆)。 自测精度:合成 r=200.25 圆盘(高斯模糊+噪声),32/32 命中,拟合半径 200.252、圆度 RMS 0.025px。

几何计算用法(对标海康几何测量族)

「测量 → 几何计算」,两个点集输入(点取质心;直线对点集做 PCA 最小二乘拟合, 因此可直接接卡尺边缘点/直线拟合输出),Combo 选模式:

  • 点-点距离:两点集质心间距,图上画连线与数值;
  • 点到直线距离:输入1 为点、输入2 为线,输出垂直距离与垂足点,画垂线段;
  • 两直线夹角:输出锐角 0~90°(平行 0°、垂直 90°),顶点画角度弧,可用于平行度/垂直度检查;
  • 两直线交点:输出交点与夹角,画交点标记(两线平行时安全报错)。

「示例 ▾ → 04_找圆测量 / 05_几何测量」一键载入;几何示例中斜亮带两边缘夹角 0.0004°(平行)、 边对中点到边线距离 20.172px(理论半宽 20.175px)。


内置模块清单(工具箱自动扫描)

分类 模块 说明
输入 图像源 5 种合成测试图 / 外部图片文件
预处理 滤波 均值 / 高斯 / 中值
预处理 阈值分割 固定阈值二值化(亮/暗目标)
预处理 自动阈值 Otsu 大津法 / 三角法,自适应计算阈值
预处理 直方图均衡 拉伸灰度分布增强对比度
预处理 图像锐化 非锐化掩模,增强边缘细节
预处理 图像运算 常数加/减/乘/除;双图相加/相减/绝对差/平均
预处理 形态学 腐蚀 / 膨胀 / 开运算 / 闭运算
特征提取 连通域提取 阈值分割 + 8 连通域标记,输出伪彩色标签图与区域统计(质心/面积/外接框/最小外接圆)
特征提取 Blob 分析 连通域统计,输出质心/面积/外接框标注
特征提取 轮廓追踪 Canny 边缘 + 轮廓提取
特征提取 边缘提取 Sobel / Canny / Laplacian
特征提取 直线检测 概率霍夫直线检测,输出线段端点与角度
特征提取 圆检测 霍夫梯度圆检测,输出圆心与半径
特征提取 角点检测 Shi-Tomasi 角点检测
特征提取 模板匹配 归一化相关/相关系数/平方差 + 非极大值抑制,输出匹配点与分数
图像变换 图像缩放 按比例或目标尺寸,三种插值
图像变换 图像旋转 任意角度绕中心旋转,背景可设灰度
图像变换 图像翻转 水平 / 垂直 / 双向镜像
图像变换 ROI 裁剪 矩形区域裁剪(可自动裁剪到边界)
标定测量 多点标定 九点仿射最小二乘标定(像素 → 物理 mm)
标定测量 卡尺工具 沿搜索线布卡尺:高斯平滑+梯度 NMS+erf 模型 LM 亚像素拟合;支持单边缘与边缘对测宽(输出两边点/中点/宽度均值±标准差),搜索线可在结果图上直接鼠标拖拽、松手自动重跑
标定测量 找圆工具 圆周等角度布径向卡尺找亚像素边缘点 → Kasa 最小二乘拟合圆,输出圆心/半径/直径/圆度 RMS/径向极差;支持圆弧角度范围;标称圆可图上拖拽(圆心方块平移、圆周改半径),用于孔径/轴径/芯线直径
标定测量 坐标转换 像素坐标 → 物理坐标(mm)
测量 距离测量 相邻点距离 / 折线总长统计,单位可设
测量 几何计算 点-点距离 / 点到直线距离(垂足) / 两直线夹角 / 两线交点,点取质心、线对点集 PCA 拟合,结果带连线/角度弧/交点标注
测量 圆拟合 最小二乘(Kasa)圆拟合,输出圆心/半径/残差
测量 直线拟合 最小二乘直线拟合,输出方向与角度
测量 灰度统计 均值/标准差/极值/中值/目标占比
输出 图像显示 / 数据结果 内置结果展示节点

如何添加你自己的流程图功能模块(核心用法)

注册是全自动的:程序启动时扫描本程序集内所有带 [FlowNode] 特性的类,自动出现在工具箱。 你只需要写一个类(参考 Vision\InvertNode.cs):

// 1. 写节点类 —— 文件名/放哪个文件夹都随意(Core\Nodes 或你自己的子文件夹均可)
[FlowNode("我的测量工具", Category = "测量", Id = "my.Measure",
    Description = "输入图像,输出宽度")]
public sealed class MeasureNode : FlowNodeBase
{
    public override void Declare(NodeBuilder b)
    {
        b.In("i0", "图像", PortType.Image);
        b.Out("o0", "宽度值", PortType.Points);              // 端口声明
        b.Number("minWidth", "最小宽度", 0, 0, 1000, 2);     // 参数声明
        b.Combo("mode", "模式", 0, "模式A", "模式B");
    }

    public override void Execute(NodeExecutionContext ctx)
    {
        var img = ctx.Input<FlowImage>("i0");
        if (img == null) { ctx.Fail("未连接图像"); return; }
        // ... 你的算法 ...
        ctx.Output("o0", new FlowPoints { Items = { new FlowPoint(x, y) } });
        ctx.SetMessage("测量完成");
    }
}

2. 完成。 重新编译后,工具箱自动出现该节点,画布、参数面板、保存/加载、引擎全部自动支持, 不需要改任何其他代码。

端口与数据包

  • 端口数据类型:Image / Points / Contours / Calibration / Number / Any,连线只允许类型兼容(Any 万能); Number 为标量数值(计数/宽度/角度/RMS),二次开发可直接强类型取值;
  • 数据包:FlowImage(灰度图)、FlowPoints(点集)、FlowContours(轮廓集)、 FlowCalibration(标定模型);
  • 参数类型:Number / Combo / String / File / Bool,参数面板按元数据自动生成控件。

在 C# / 命令行中运行流程(二次开发)

真实场景下的三种运行方式

  1. 调试 / 搭流程:编辑器里 F5。 双击 VisionFlow.exe 打开工作台,从工具箱拖节点、连线、 双击节点看结果大图,F5 跑全流程,调好后「文件 → 保存」为 *.vflow.json; 现场常用流程直接另存到 DEMO\ 当机型模板库,换型时「示例 ▾」一键载入再另存。
  2. 产线 / MES / 上位机集成:命令行。 不启动界面,按退出码判定结果(0=全部成功, 2=有节点执行失败,1=文件缺失/节点类型缺失等错误),可写进批处理、PLC 上位脚本或 CI:
    VisionFlow.exe --run "D:\流程\机型A_测宽.vflow.json" --json "D:\结果\result.json"
    
    result.json 含每节点状态、消息、耗时、各端口值、报告,MES 解析 JSON 即可判定 OK/NG; 流程里引用了本机没有的节点类型时命令行直接失败并指明类型名,绝不静默漏工站。
  3. 嵌进你自己的 C# 程序:一行 API。 引用本工程(或把 Core\+Vision\ 编进你的程序集), 启动时自动扫描注册全部节点,然后:

编辑器里搭好、保存的 .vflow.json 流程,在你的程序里运行只要一行(using VisionFlow.Core;):

// 一行运行:节点自动注册、文件自动加载,失败不抛异常(看 r.Success / r.FailedNodes)
var r = Flow.Run(@"D:\流程\测宽.vflow.json");
if (!r.Success)
    foreach (var f in r.FailedNodes) Console.WriteLine($"{f.Title}: {f.Message}");

// 按"节点标题 + 端口中文名"直接取结果(也支持节点 Id、类型名寻址)
double n     = r["卡尺工具"].Number("有效数") ?? 0;
double width = r["卡尺工具"].Number("宽度均值") ?? 0;      // 标量端口
double sd    = r["卡尺工具"].Number("宽度标准差") ?? 0;
var midPts   = r["卡尺工具"].Output<FlowPoints>("边对中点"); // 点集端口
var img      = r["卡尺工具"].DisplayImage;                 // 结果预览图
string report = r["卡尺工具"].Report;                      // 完整文本报告

需要改参数后反复运行(换型号、扫阈值)用会话对象:

using var s = Flow.Open(@"测宽.vflow.json");
s.SetNumber("卡尺工具", "threshold", 25)
 .SetOption("卡尺工具", "polarity", 1);          // 链式;另有 SetString / SetBool
var r1 = s.Run();
s.SetNumber("卡尺工具", "threshold", 40);
var r2 = s.Run();                                // 同一流程可反复跑
// 纯代码搭流程:s.AddNode("vision.Caliper", x, y) / s.Connect("图像源","图像","卡尺工具","图像") / s.Save(path)

高频调用:流程文件内存缓存

产线节拍下反复 Flow.Run 同一文件时,默认启用按文件路径的内存缓存,省去重复读盘与 JSON 反序列化:

  • 首次调用:读盘 + 反序列化,缓存一份"干净原型";之后调用只做一次内存深拷贝(节点重新声明、 参数/连线复制),每次运行拿到的都是互不影响的独立副本,可改参数、可多线程并发;
  • 自动监视文件变更:按"最后修改时间(UTC) + 文件大小"判断,文件被编辑器另存、外部程序改写后, 下次调用自动重新加载,无需重启;本进程 session.Save() 后也会立即让该路径缓存失效;
  • 可控/可观测接口:
Flow.CacheEnabled = false;          // 排障时关掉缓存,每次强制读盘
Flow.ClearCache();                  // 清空全部缓存
Flow.InvalidateCache(@"测宽.vflow.json"); // 指定文件强制下次重载
int hits  = Flow.CacheHitCount;     // 累计命中次数
int loads = Flow.CacheLoadCount;    // 累计磁盘加载次数
int n     = Flow.CachedFileCount;   // 当前缓存文件数

实测参考(5 节点卡尺示例,本机):冷打开约 0.7 ms,缓存命中约 0.2 ms/次;流程越大、 文件在网络盘上时收益越明显。Flow.FromJson(jsonText) 直接吃内存字符串,不经文件缓存。

机器集成可直接导出结果 JSON(每节点状态、消息、耗时、各端口值、报告;点集带坐标、图像给尺寸):

File.WriteAllText("result.json", r.ToJson());

完全不写代码也行——命令行模式(退出码 0=全部成功,2=有节点失败,1=文件/运行错误):

VisionFlow.exe --run "测宽.vflow.json" --json "result.json"

与海康 VisionMaster 二次开发对比:VM 需要安装 VM 平台与 Runtime、引用多个 SDK 程序集、 持有加密狗授权,再经 IMVSVisionMaster.LoadSolution → Run(流程名) → GetModule → GetOutputInfo(端口名, out type, out value) 多级 COM 风格调用、object 自行强转,且 SDK 与 VM 后台服务跨进程通信。VisionFlow 是纯托管库:无需安装平台/授权/后台服务, 节点自动扫描注册,结果按中文端口名强类型获取,另提供命令行与 JSON 两种免开发集成方式。

以 NuGet 类库引用:外部工程的自定义节点怎么进工具箱

把 VisionFlow 以 NuGet 包(包 id VisionFlow,本地文件夹源即可)装进你自己的 WinForms 工程后, 自定义节点只需两步,编辑器工具箱、Flow.Run/Open 门面、流程 JSON 反序列化会全部自动识别:

  1. 写节点(与本工程内置节点写法完全相同,详见上文「如何添加你自己的流程图功能模块」):
[FlowNode("亮度检测", Category = "我的检测", Id = "my.BrightnessCheck", Accent = "#E08A2B")]
public sealed class BrightnessCheckNode : FlowNodeBase { /* Declare() / Execute() */ }
  1. 程序启动时(Application.Run 之前)把你的程序集登记一次:
NodeRegistry.RegisterExternalAssembly(typeof(BrightnessCheckNode).Assembly);
Application.Run(new VisionFlow.UI.MainForm());   // 工具箱自动出现「我的检测 → 亮度检测」
  • 门面 Flow.Run / Open / FromJson / CreateRegistry 会自动扫描已登记的外部程序集;
  • 若 MainForm 已创建后才想追加节点,可调 mainForm.RegisterExternalNodes(asm) 现场重建工具箱;
  • 外部程序集按"安全扫描"注册:单个节点类型重复 Id 或加载异常不会拖垮其余节点;
  • NuGet 包已依赖 OpenCvSharp4.runtime.win(OpenCV 原生运行时随包自动部署), 内置 5 个 DEMO\*.vflow.json 作为 contentFiles 自动复制到消费工程输出目录 DEMO\。

需要完全控制时仍可用底层 API:new NodeRegistry().RegisterAssembly(asm) → FlowJson.Deserialize(text, reg) → new FlowEngine().Run(doc) → 结果在 node.Runtime.Status / Message / Report / DisplayImage / Overlay / Outputs(键为端口 Id)。


相对参考项目的优化点

原 SubPixelCaliper 流程模块 VisionFlow 改进
NodeType 枚举 + NodeDef switch + 引擎大 switch,加节点要改多处 注册表 + [FlowNode] 特性 + 程序集自动扫描,加节点只写一个类
模型直接引用 System.Drawing 与 Imaging.GrayImage,核心与 UI 强耦合 核心零依赖,数据层用中立类型(FlowPoint/FlowImage/OverlayShape),编辑器负责渲染
节点参数无元数据,面板与序列化靠硬编码 参数带 Min/Max/Decimals/Options 元数据,UI 自动生成
引擎内嵌业务逻辑(标定板点阵排序等) 业务算法提取为 Algo/AffineCalibrator、Algo/GridSorter 可复用
结果输出用裸 PointF[],靠源节点类型猜语义 强类型数据包 + 端口类型系统
JSON 无版本头,升级即坏 FlowJson 带格式版本号,加载时按类型重建端口/参数,旧参数自动忽略;外来流程缺节点类型时编辑器橙色占位、命令行严格报错

保留的设计:Kahn 拓扑排序、成环拒绝、失败隔离(单节点异常不影响其他节点)、 一端口一线(新线自动替换旧线)、状态灯与结果叠加体系。


说明与限制

  • 视觉节点基于 OpenCvSharp4(OpenCvSharp4 + OpenCvSharp4.runtime.win),为演示/测试用途; 生产测量请自行替换为你的算法;
  • 轮廓追踪为 Canny 整图提取(未实现极性过滤与亚像素链跟踪,可作为你的扩展点);
  • 引擎为单线程顺序执行,适合中小规模流程;需要并行时可扩展为分层并行执行;
  • 本项目按约定保持单工程(WinExe)。二次开发两种方式: ① 直接在本工程里加节点类(推荐,工具箱/自测/DEMO 全部立即可用); ② 在你自己的 WinForms/控制台工程中引用本工程源码或把 Core\(零依赖,不含 WinForms/OpenCV) 拷成一个 classlib 项目,调用 Flow.Run 门面即可——程序集名不影响节点注册, 注册靠 [FlowNode] 特性的程序集扫描(new NodeRegistry().RegisterAssembly(你的程序集))。
Product Compatible and additional computed target framework versions.
.NET net8.0-windows7.0 is compatible.  net9.0-windows was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.2.93 48 11/20/2026
1.2.92 54 11/20/2026
1.2.83 76 11/19/2026
1.2.52 94 11/16/2026
1.2.48 97 11/15/2026
1.2.33 100 11/13/2026
1.2.30 105 11/11/2026
1.2.21 99 11/9/2026
1.2.18 100 11/8/2026
1.2.17 99 11/7/2026
1.2.13 104 11/6/2026
1.2.12 122 11/5/2026
1.2.11 111 11/4/2026
1.2.10 104 11/3/2026
1.2.9 119 11/3/2026
1.2.4 124 10/28/2026
1.2.3 107 10/27/2026
1.2.2 111 10/27/2026
1.0.0 168 9/20/2026
0.2.0 115 10/25/2026

首个公开版本:流程引擎 + 视觉节点库 + WinForms 流程图编辑器控件。