Skip to content

About

使用海康VisionMaster 4.4.0 SDK + C# WPF 开发精密零件尺寸测量系统

Resources

Stars

3 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

基于VisionMaster的精密零件尺寸测量系统

.NET Framework VisionMaster Platform License

基于海康机器人 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 位系统

安装步骤

1. 安装 VisionMaster 4.4.0

从 海康机器人官网 下载 VisionMaster 4.4.0 并安装。

  • 默认安装路径: C:\Program Files\VisionMaster4.4.0
  • 免费版支持基础测量功能
  • 安装完成后确认目录存在: C:\Program Files\VisionMaster4.4.0\Development\V4.x\ComControls\Assembly\

2. 克隆项目

git clone https://github.com/William4861/PartMeasurement_BasedOnVM.git
cd PartMeasurement_BasedOnVM

3. 打开解决方案

# 双击或用 VS 打开
start PartMeasurement.sln

4. 配置项目

  1. 在 Visual Studio 中打开 PartMeasurement.sln
  2. 确认目标平台为 x64
  3. 确认目标框架为 .NET Framework 4.7.2
  4. 确认 取消勾选 "首选32位"
  5. 检查 VM SDK 引用路径是否正确

5. 拷贝运行时依赖(重要!)

需要将 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,需要手动复制运行时依赖。也可以配置生成后事件自动复制。

6. 创建测量方案

  1. 打开 VisionMaster 4.4.0 软件
  2. 创建新的测量方案(或使用预置方案)
  3. 添加测量模块(圆查找、直线查找、距离计算等)
  4. 配置相机或设置本地图像源
  5. 测试方案确保测量流程正确
  6. 保存为 .sol 文件

示例流程结构:

流程1
├── 图像源 (本地图片/相机采集)
├── 圆查找1 (检测零件外圆)
├── 圆查找2 (检测零件内孔)
├── 直线查找1 (检测边缘)
├── P2P测量1 (圆心距计算)
└── 输出结果

7. 编译运行

# VS 中按 F5 编译运行
# 或使用 MSBuild
msbuild PartMeasurement.sln /p:Configuration=Debug /p:Platform=x64

使用流程

  1. 加载方案: 点击 📂 加载方案 选择 VM 创建的 .sol 测量方案文件
  2. 执行测量: 点击 ▶ 执行测量 触发测量流程
  3. 查看结果: 右侧面板显示当前测量数据和 OK/NG 判定
  4. 导出数据: 点击 📊 导出CSV 或 📄 导出报告 保存测量结果
  5. 历史查询: 点击 📋 历史记录 查看并筛选历史测量数据
  6. 清除结果: 点击 🗑 清除结果 清空当前测量列表

📁 项目结构

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 泛型中继命令实现

VM SDK 关键调用流程

// 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板孔径/线宽测量
  • 注塑件关键尺寸控制
  • 精密加工件在线测量
  • 汽车零部件外观尺寸检测

📝 简历描述(STAR法则)

### 基于VisionMaster的精密零件尺寸测量系统
**独立开发** | 2026.07 - 2026.08

**项目背景**:针对机械零件人工测量效率低、一致性差的问题,开发自动化视觉测量方案

**核心工作**:
- 使用海康VisionMaster搭建测量流程,完成相机标定、边缘提取、圆/直线拟合、尺寸计算
- 通过C# WPF进行SDK二次开发,实现方案加载、流程控制、结果获取、数据展示完整功能
- 封装VM渲染控件,实现原图与测量结果的实时显示

**项目成果**:
- 可测量零件直径、长度、圆心距等5+项关键尺寸,测量精度±0.01mm
- 测量效率较人工提升5倍,单工件测量时间<100ms
- 具备完整的参数配置、数据记录、历史查询功能,可直接用于工业现场

⚠️ 常见问题

Q: 编译时找不到 VM.Core.dll 等引用?

A: 确认 VisionMaster 4.4.0 已安装,检查项目文件中 HintPath 路径是否正确指向 C:\Program Files\VisionMaster4.4.0\Development\V4.x\ComControls\Assembly\。

Q: 运行时提示 "未能加载文件或程序集"?

A: 需要将 VM 运行时 DLL 复制到输出目录。参考安装步骤第5步。

Q: 控件显示空白或崩溃?

A: 请确认:

  1. 项目目标平台为 x64
  2. 取消勾选 "首选32位"
  3. 所有 VM 引用的 "复制本地" 设为 False

Q: 执行方案无结果输出?

A: 检查 VM 方案文件:

  1. 方案能在 VisionMaster 软件中正常运行
  2. 流程名称为 "流程1"
  3. 流程中有图像输出和测量结果输出

📄 License

MIT License

👤 作者


💡 提示: 本项目适合作为视觉应用工程师、上位机开发工程师的求职作品。展示了对 VisionMaster SDK 的熟练掌握和工业视觉系统的开发能力。

About

使用海康VisionMaster 4.4.0 SDK + C# WPF 开发精密零件尺寸测量系统

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages