VisionFlow 1.0.0
See the version list below for details.
dotnet add package VisionFlow --version 1.0.0
NuGet\Install-Package VisionFlow -Version 1.0.0
<PackageReference Include="VisionFlow" Version="1.0.0" />
<PackageVersion Include="VisionFlow" Version="1.0.0" />
<PackageReference Include="VisionFlow" />
paket add VisionFlow --version 1.0.0
#r "nuget: VisionFlow, 1.0.0"
#:package VisionFlow@1.0.0
#addin nuget:?package=VisionFlow&version=1.0.0
#tool nuget:?package=VisionFlow&version=1.0.0
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点」),可接直线/圆拟合、距离测量;
- 边缘对(测宽度):一把卡尺同时抓两条极性相反的平行边,输出「边缘1点」「边缘2点」 「边对中点」三组点,并在报告给出宽度均值/标准差/最小/最大,图上画紫色宽度线与数值标签, 适合测带宽、测厚、测间隙、剥皮宽度;
- 按 F5 运行后,右下结果图(或双击节点的大图)上出现黄色搜索线:
- 拖两端白色方块改起终点,拖线体/中点菱形整体平移,松手即自动重跑;
- 蓝色点线是每把卡尺的投影剖面;绿点=边缘1、橙点=边缘2、青色点=边对中点; 红色点线表示该卡尺漏检;
- 参数:卡尺数量、卡尺长度(剖面长度,边缘对模式须大于被测宽度)、投影宽度(抗噪平均带宽)、 边缘极性(任意 / 黑→白 / 白→黑;边缘对模式指第一边缘极性,第二边自动相反)、 边缘阈值(梯度,灰度/px)、平滑尺度 σ(高斯预平滑,越大越抗噪但梯度峰越低)、 边对最小/最大宽度(px,过滤错误配对)、亚像素开关;
- 算法管线(工业卡尺第一梯队做法):双线性亚像素采样剖面 → 沿搜索线方向投影平均(抗噪)→ 一维高斯平滑(尺度 σ)→ 中心差分梯度 → 非极大值提取候选边缘 → 按极性/阈值筛选; 边缘对按"第一边缘极性 + 宽度范围"做相反极性峰最优配对;亚像素定位采用 误差函数 erf 阶跃模型 Levenberg-Marquardt 拟合(相机边缘=阶跃卷积高斯,erf 为其理想剖面, 同时输出边缘锐度),拟合失败自动回退抛物线插值。 注意:搜索线方向应大致平行于被测边缘(卡尺垂直于搜索线跨过边缘)。
- 「示例 ▾ → 03_卡尺测宽」一键载入:斜亮带(带宽 40.35px)→ 卡尺边缘对 → 两边各接直线拟合。
找圆工具用法(对标海康圆测量,纯鼠标操作)
- 工具箱「标定测量 → 找圆工具」拖入画布,图像源连到「图像」输入;
- F5 后结果图上出现黄色标称圆:拖圆心白方块整体平移、拖圆周或 3 点钟白方块改半径 (圆内空白区域不拦截,仍可平移图像,避免误触),松手自动重跑,可撤销;
- 工具在圆周(或起止角限定的圆弧)上等角度布 N 把径向卡尺,复用与卡尺工具完全相同的 erf-LM 亚像素管线找边缘点,再做 Kasa 最小二乘圆拟合;
- 输出:圆心(点)、边缘点、半径 / 圆度 RMS / 有效数(Number 端口,二次开发直接取值); 图上青色为拟合圆、绿色为边缘点、白色十字为圆心;报告给直径、径向极差、逐点半径与梯度;
- 极性沿径向向外判定:测暗孔(亮背景上的黑洞)选「内黑→外白」,测亮圆盘/亮轴截面 选「内白→外黑」;起止角可只测一段圆弧(缺圆、被遮挡的圆)。 自测精度:合成 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# / 命令行中运行流程(二次开发)
真实场景下的三种运行方式
- 调试 / 搭流程:编辑器里 F5。 双击
VisionFlow.exe打开工作台,从工具箱拖节点、连线、 双击节点看结果大图,F5跑全流程,调好后「文件 → 保存」为*.vflow.json; 现场常用流程直接另存到DEMO\当机型模板库,换型时「示例 ▾」一键载入再另存。 - 产线 / MES / 上位机集成:命令行。 不启动界面,按退出码判定结果(0=全部成功,
2=有节点执行失败,1=文件缺失/节点类型缺失等错误),可写进批处理、PLC 上位脚本或 CI:
VisionFlow.exe --run "D:\流程\机型A_测宽.vflow.json" --json "D:\结果\result.json"result.json含每节点状态、消息、耗时、各端口值、报告,MES 解析 JSON 即可判定 OK/NG; 流程里引用了本机没有的节点类型时命令行直接失败并指明类型名,绝不静默漏工站。 - 嵌进你自己的 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 反序列化会全部自动识别:
- 写节点(与本工程内置节点写法完全相同,详见上文「如何添加你自己的流程图功能模块」):
[FlowNode("亮度检测", Category = "我的检测", Id = "my.BrightnessCheck", Accent = "#E08A2B")]
public sealed class BrightnessCheckNode : FlowNodeBase { /* Declare() / Execute() */ }
- 程序启动时(
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 | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0-windows7.0 is compatible. net9.0-windows was computed. net10.0-windows was computed. |
-
net8.0-windows7.0
- OpenCvSharp4 (>= 4.10.0.20240616)
- OpenCvSharp4.runtime.win (>= 4.10.0.20240616)
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 流程图编辑器控件。