基于海康机器人 VisionMaster 4.4.0 SDK 的 C# WPF 精密零件自动尺寸测量系统
本项目是一个面向工业现场的精密零件尺寸测量系统,使用海康机器人 VisionMaster 视觉算法平台进行图像处理与尺寸计算,通过 C# WPF 进行二次开发,实现完整的自动化测量工作站。
- 方案加载与管理:加载 VisionMaster 创建的
.sol测量方案文件 - 自动测量流程:一键触发 VM 测量流程,获取直径、长度、圆心距等多项关键尺寸
- 实时图像显示:通过 VM 渲染控件实时显示原始图像与测量标注结果
- 结果判定:支持标称值与公差配置,自动进行 OK/NG 判定
- 数据导出:支持导出为 CSV 和 TXT 格式的测量报告
- 历史记录:内置历史查询窗口,支持按日期范围筛选查看
- 参数配置:集成 VM 参数配置控件,支持在线调整测量参数
| 指标 | 参数 |
|---|---|
| 可测量项目 | 直径、长度、圆心距、角度等 5+ 项 |
| 测量精度 | ±0.01mm(取决于相机标定精度) |
| 单次测量时间 | <100ms |
| 支持相机 | 海康工业相机 / 本地图片 |
┌──────────────────────────────────────────────────────┐
│ 精密零件尺寸测量系统 v1.0 │
├──────────────────────────────────────────────────────┤
│ [📂 加载方案] [▶ 执行测量] [📊 导出CSV] [📄 导出报告] │
│ [📋 历史记录] [🗑 清除结果] 统计: 总数 12 | 合格 10 │
├────────────────────────────┬─────────────────────────┤
│ │ 📏 当前测量结果 │
│ 📷 测量图像显示 │ ┌─────────────────────┐│
│ │ │ 测量项 │ 值 │ 判定 ││
│ (VM RenderControl) │ │ 直径A │ 10.02 │ OK ││
│ │ │ 直径B │ 5.01 │ OK ││
│ │ │ 圆心距 │ 25.00 │ OK ││
│ │ └─────────────────────┘│
│ │ 📋 测量历史 │
│ │ ┌─────────────────────┐│
│ │ │ 时间 │ 方案 │ 判定 ││
│ │ │ 14:32 │ demo │ OK ││
│ │ └─────────────────────┘│
├────────────────────────────┴─────────────────────────┤
│ [状态] 测量完成 - 判定: 合格 (OK) - 共3项 │
└──────────────────────────────────────────────────────┘
| 软件 | 版本要求 | 说明 |
|---|---|---|
| Visual Studio | 2019+ 或 2022 | 需安装 .NET Framework 4.7.2 SDK |
| .NET Framework | 4.7.2 | 开发目标框架 |
| VisionMaster | 4.4.0 | 海康视觉算法平台 |
| Windows | Windows 10/11 (x64) | 仅支持 64 位系统 |
从 海康机器人官网 下载 VisionMaster 4.4.0 并安装。
- 默认安装路径:
C:\Program Files\VisionMaster4.4.0 - 免费版支持基础测量功能
- 安装完成后确认目录存在:
C:\Program Files\VisionMaster4.4.0\Development\V4.x\ComControls\Assembly\
git clone https://github.com/William4861/PartMeasurement_BasedOnVM.git
cd PartMeasurement_BasedOnVM# 双击或用 VS 打开
start PartMeasurement.sln- 在 Visual Studio 中打开
PartMeasurement.sln - 确认目标平台为 x64
- 确认目标框架为 .NET Framework 4.7.2
- 确认 取消勾选 "首选32位"
- 检查 VM SDK 引用路径是否正确
需要将 VM 运行时的 x64 DLL 文件拷贝到输出目录:
# 源目录
$source = "C:\Program Files\VisionMaster4.4.0\Development\V4.x\ComControls\Assembly\"
# 目标目录(编译后)
$target = "src\PartMeasurement\bin\x64\Debug\"
# 复制所有 DLL 和依赖文件
Copy-Item -Path "$source\*" -Destination $target -Recurse -Force
⚠️ 注意: VM SDK 的 DLL 引用已设置Copy Local = False,需要手动复制运行时依赖。也可以配置生成后事件自动复制。
- 打开 VisionMaster 4.4.0 软件
- 创建新的测量方案(或使用预置方案)
- 添加测量模块(圆查找、直线查找、距离计算等)
- 配置相机或设置本地图像源
- 测试方案确保测量流程正确
- 保存为
.sol文件
示例流程结构:
流程1
├── 图像源 (本地图片/相机采集)
├── 圆查找1 (检测零件外圆)
├── 圆查找2 (检测零件内孔)
├── 直线查找1 (检测边缘)
├── P2P测量1 (圆心距计算)
└── 输出结果
# VS 中按 F5 编译运行
# 或使用 MSBuild
msbuild PartMeasurement.sln /p:Configuration=Debug /p:Platform=x64- 加载方案: 点击
📂 加载方案选择 VM 创建的.sol测量方案文件 - 执行测量: 点击
▶ 执行测量触发测量流程 - 查看结果: 右侧面板显示当前测量数据和 OK/NG 判定
- 导出数据: 点击
📊 导出CSV或📄 导出报告保存测量结果 - 历史查询: 点击
📋 历史记录查看并筛选历史测量数据 - 清除结果: 点击
🗑 清除结果清空当前测量列表
PartMeasurement_BasedOnVM/
├── PartMeasurement.sln # 解决方案文件
├── README.md # 项目说明文档
├── .gitignore # Git忽略规则
├── plan.md # 开发计划
│
├── src/
│ └── PartMeasurement/
│ ├── PartMeasurement.csproj # 项目文件(含VM SDK引用)
│ ├── App.xaml # WPF应用入口
│ ├── App.xaml.cs
│ │
│ ├── Models/
│ │ └── MeasurementResult.cs # 测量结果数据模型
│ │
│ ├── ViewModels/
│ │ ├── BaseViewModel.cs # MVVM基类(INotifyPropertyChanged)
│ │ ├── RelayCommand.cs # ICommand中继实现
│ │ └── MainViewModel.cs # 主视图模型(核心业务逻辑)
│ │
│ ├── Views/
│ │ ├── MainWindow.xaml # 主窗口界面
│ │ ├── MainWindow.xaml.cs
│ │ ├── HistoryWindow.xaml # 历史记录查询窗口
│ │ └── HistoryWindow.xaml.cs
│ │
│ ├── Services/
│ │ ├── VmService.cs # VM SDK封装服务
│ │ └── ExportService.cs # 数据导出服务(CSV/TXT)
│ │
│ └── Resources/
│ └── Styles.xaml # 全局样式资源
│
├── samples/ # 示例方案文件目录
│ └── .gitkeep
│
└── docs/ # 文档和截图
└── .gitkeep
- UI框架: WPF (Windows Presentation Foundation)
- 架构模式: MVVM (Model-View-ViewModel)
- 视觉平台: 海康 VisionMaster 4.4.0 SDK
- 图像渲染: VMControls.WPF.Release (VmRenderControl)
- 数据导出: 原生 CSV/TXT 导出
- 目标框架: .NET Framework 4.7.2 (x64)
| 类名 | 文件 | 职责 |
|---|---|---|
VmService |
Services/VmService.cs | VM SDK 封装:初始化、方案加载、流程执行、结果获取 |
MainViewModel |
ViewModels/MainViewModel.cs | 主业务逻辑:命令绑定、状态管理、数据流转 |
ExportService |
Services/ExportService.cs | 测量数据导出:CSV 和 TXT 格式 |
MeasurementResult |
Models/MeasurementResult.cs | 测量结果数据模型 |
BaseViewModel |
ViewModels/BaseViewModel.cs | MVVM 基类:INotifyPropertyChanged 实现 |
RelayCommand |
ViewModels/RelayCommand.cs | ICommand 泛型中继命令实现 |
// 1. 加载方案
VmSolution.Load(solutionPath);
// 2. 异步执行流程(后台线程,避免UI卡死)
await Task.Run(() => VmSolution.Instance.Run());
// 3. 获取流程对象
var procedure = (VmProcedure)VmSolution.Instance["流程1"];
// 4. 获取渲染图像源(绑定到 VmRenderControl)
RenderModuleSource = procedure;
// 5. 获取测量结果
var outputInfos = procedure.ModuResult.GetAllOutputNameInfo();
foreach (var info in outputInfos)
{
var value = procedure.ModuResult.GetOutputFloat(info.Name);
}- 机械零件出厂尺寸检测
- PCB板孔径/线宽测量
- 注塑件关键尺寸控制
- 精密加工件在线测量
- 汽车零部件外观尺寸检测
### 基于VisionMaster的精密零件尺寸测量系统
**独立开发** | 2026.07 - 2026.08
**项目背景**:针对机械零件人工测量效率低、一致性差的问题,开发自动化视觉测量方案
**核心工作**:
- 使用海康VisionMaster搭建测量流程,完成相机标定、边缘提取、圆/直线拟合、尺寸计算
- 通过C# WPF进行SDK二次开发,实现方案加载、流程控制、结果获取、数据展示完整功能
- 封装VM渲染控件,实现原图与测量结果的实时显示
**项目成果**:
- 可测量零件直径、长度、圆心距等5+项关键尺寸,测量精度±0.01mm
- 测量效率较人工提升5倍,单工件测量时间<100ms
- 具备完整的参数配置、数据记录、历史查询功能,可直接用于工业现场
A: 确认 VisionMaster 4.4.0 已安装,检查项目文件中 HintPath 路径是否正确指向 C:\Program Files\VisionMaster4.4.0\Development\V4.x\ComControls\Assembly\。
A: 需要将 VM 运行时 DLL 复制到输出目录。参考安装步骤第5步。
A: 请确认:
- 项目目标平台为 x64
- 取消勾选 "首选32位"
- 所有 VM 引用的 "复制本地" 设为 False
A: 检查 VM 方案文件:
- 方案能在 VisionMaster 软件中正常运行
- 流程名称为 "流程1"
- 流程中有图像输出和测量结果输出
MIT License
- GitHub: @William4861
💡 提示: 本项目适合作为视觉应用工程师、上位机开发工程师的求职作品。展示了对 VisionMaster SDK 的熟练掌握和工业视觉系统的开发能力。