一套开源、可扩展的 WPF + Halcon 工业视觉平台，既好看又实用（附源码）-平芜编程栈

前言

在工业视觉检测领域，一个灵活、可扩展且界面美观的软件平台，往往能显著提升开发效率和现场调试体验。在参与多个机器视觉项目的过程中，深切感受到：市面上的通用工具要么封闭性强，难以定制；要么配置繁琐，无法快速适配不同应用场景。

本文介绍一款基于 WPF 开发的视觉平台，采用 HandyControl 对界面进行美化，集成 Halcon 强大的图像处理能力，并以 MVVM 模式组织代码，在功能性与易用性之间取得了良好平衡。

项目介绍

项目是一个基于插件机制的视觉检测平台，整体采用模块化设计。主程序负责流程调度、界面呈现与用户交互，而具体的图像处理逻辑则封装在独立的插件中，通过 PluginBase 接口统一调用。

这样设计算法可以专注于算子开发，无需关心 UI 或流程控制；同时，系统支持动态加载插件，便于后期功能扩展或现场替换。项目结构清晰，包含日志管理、参数绑定、流程图编辑、Halcon 对象可视化等关键模块，已初步形成一个小型但完整的视觉开发环境。

项目功能

1、支持 Halcon 图像（HImage）与区域（HRegion）的实时显示与交互；

2、提供可视化流程图编辑功能，通过节点（ProcessNode）连接构建图像处理流程；

3、实现参数自动绑定机制，上游节点输出可直接作为下游节点输入，减少手动配置；

4、内置插件菜单系统，可动态加载并管理各类视觉算子插件；

5、集成日志管理模块（LogMgr），支持运行时信息记录与查看。

项目技术
UI 框架：基于 WPF 桌面界面和 HandyControl 现代化控件（如圆角窗口、动画按钮、通知弹窗等）。
图像算法库：集成 Halcon 12，调用其高性能算子实现图像采集、处理与分析。
架构模式：采用 MVVM 模式，通过 mvvmlight 实现视图与逻辑解耦，支持命令绑定、消息通信与 ViewModel 生命周期管理。
数据处理：使用 Newtonsoft.Json 进行配置文件读写与插件参数序列化，便于流程保存与加载。

功能模块

日志系统：统一记录运行状态、错误信息与调试输出，支持分级管理和界面实时查看。
算子插件机制：所有图像处理功能以插件形式封装，通过 PluginBase 接口动态加载，便于扩展与维护。
插件菜单：自动扫描插件目录，生成可交互的工具菜单，支持分类展示与快捷调用。
可视化流程图：通过节点（ProcessNode）拖拽连线，构建图像处理流水线，直观呈现算法执行顺序。
参数自动绑定：上游节点输出可自动映射为下游节点输入，减少手动配置，提升流程搭建效率。
Halcon 对象显示：支持 HImage 和 HRegion 的实时渲染，结果可叠加显示在原图上，便于调试与验证。

项目代码

1、将 Halcon 的 HObject（通常是 HImage）转换为 WPF 可直接显示的 BitmapImage 对象。

2、由于 Halcon 和 WPF 使用不同的图像表示方式，不能直接互通，因此需要通过"保存到临时文件 → 读取为 BitmapImage → 调整 DPI → 再转回内存流“”的方式完成转换。

private static BitmapImage ConvertHImageToBitmapImage(object img) { if (img == null) returnnull; string tempFolderPath = Path.GetTempPath(); // 生成唯一的文件名，例如使用GUID，并假设图片格式为png string fileName = Guid.NewGuid().ToString() + ".bmp"; // 组合完整的文件路径 string filePath = Path.Combine(tempFolderPath, fileName); if (img == null) { int c = 10; } elseif (img is HObject) { int b = 10; } else { } HObject obj = img as HObject; HImage image = new HImage(obj); if (BackgroundImage == null) { BackgroundImage = image; } image.WriteImage("bmp", 255, filePath); BitmapImage originalBitmap = new BitmapImage(); originalBitmap.BeginInit(); originalBitmap.UriSource = new Uri(filePath, UriKind.Absolute); originalBitmap.CacheOption = BitmapCacheOption.OnLoad; originalBitmap.EndInit(); // 创建新的 BitmapSource 并设置标准 DPI int stride = originalBitmap.PixelWidth * ((originalBitmap.Format.BitsPerPixel + 7) / 8); byte[] pixelData = newbyte[originalBitmap.PixelHeight * stride]; // 复制像素数据 originalBitmap.CopyPixels(pixelData, stride, 0); BitmapSource correctedBitmap = BitmapSource.Create( originalBitmap.PixelWidth, // 640 originalBitmap.PixelHeight, // 480 96, // 标准 DPI X 96, // 标准 DPI Y originalBitmap.Format, originalBitmap.Palette, pixelData, originalBitmap.PixelWidth * ((originalBitmap.Format.BitsPerPixel + 7) / 8)); correctedBitmap.Freeze(); File.Delete(filePath); BitmapImage bitmapImage = new BitmapImage(); using (MemoryStream memoryStream = new MemoryStream()) { // 将 BitmapSource 编码为 BMP 并保存到内存流 BitmapEncoder encoder = new BmpBitmapEncoder(); encoder.Frames.Add(BitmapFrame.Create(correctedBitmap)); encoder.Save(memoryStream); memoryStream.Position = 0; // 从内存流加载到 BitmapImage bitmapImage.BeginInit(); bitmapImage.StreamSource = memoryStream; bitmapImage.CacheOption = BitmapCacheOption.OnLoad; bitmapImage.EndInit(); bitmapImage.Freeze(); } return bitmapImage; }