WPF+Halcon实战：用HSmartWindowControl和HDrawingObject搞定交互式ROI（附完整C#代码）

张

张建站

2026/6/6 14:46:16

10分钟阅读

WPF+Halcon实战：用HSmartWindowControl和HDrawingObject搞定交互式ROI（附完整C#代码）

WPFHalcon深度整合HSmartWindowControl与HDrawingObject的工业级交互设计在工业视觉检测领域WPF与Halcon的结合已经成为高精度图像处理的标准方案。不同于传统的WinForms开发WPF提供了更现代的UI框架和灵活的布局系统而Halcon的HSmartWindowControl控件则弥补了WPF在专业图像显示方面的不足。本文将深入探讨如何利用HDrawingObject实现真正符合工业场景需求的交互式ROI设计解决实际项目中遇到的三大核心痛点可视化交互、参数精确控制和跨线程操作。1. 环境搭建与基础架构设计1.1 WPF与Halcon的工程化集成在开始ROI交互设计前需要建立稳健的工程基础结构。推荐使用NuGet进行HalconDotNet包的引用管理PackageReference IncludeHalconDotNet Version20.11.0 /创建基础窗口类时需特别注意DPI感知设置这对高分辨率显示器下的图像显示至关重要public partial class MainWindow : Window { [DllImport(user32.dll)] private static extern bool SetProcessDPIAware(); public MainWindow() { if (Environment.OSVersion.Version.Major 6) SetProcessDPIAware(); InitializeComponent(); } }1.2 HSmartWindowControl的进阶配置标准HSmartWindowControl需要扩展以下功能才能满足工业场景需求HalconDotNet:HSmartWindowControlWPF x:NamehswControl HKeepAspectRatioTrue HZoomContentWheelForwardZoomsIn HMoveContentDragWithLeft HDoubleClickToFitContentTrue SizeChangedHswControl_SizeChanged HMouseMoveHswControl_HMouseMove/关键属性说明属性值工业场景作用HKeepAspectRatioTrue防止图像变形影响测量精度HZoomContentWheelForwardZoomsIn符合工程师操作直觉HMoveContentDragWithLeft避免与ROI操作冲突2. HDrawingObject的工业级实现2.1 多类型ROI的创建与管理实际项目中往往需要支持多种ROI类型以下工厂方法可扩展性强public HDrawingObject CreateROI(HDrawingObject.HDrawingObjectType type, HTuple row, HTuple col, HTuple size) { var drawingObject HDrawingObject.CreateDrawingObject(type, row, col, size); // 设置通用交互属性 drawingObject.SetDrawingObjectParams(line_width, 2); drawingObject.SetDrawingObjectParams(color, green); // 绑定回调事件 drawingObject.OnDrag(OnROIDrag); drawingObject.OnResize(OnROIResize); return drawingObject; } private void OnROIDrag(HDrawingObject drawObj, HWindow window, string type) { // 实时更新参数显示 UpdateROIParameters(drawObj); }2.2 ROI参数的双向绑定工业软件需要将ROI参数实时同步到UI控件实现MVVM模式public class ROIParameters : INotifyPropertyChanged { private double _row1; public double Row1 { get _row1; set { _row1 value; OnPropertyChanged(); } } // 其他参数... public void UpdateFromDrawingObject(HDrawingObject obj) { var param obj.GetDrawingObjectParams(new HTuple(row1, column1, row2, column2)); Row1 param[0].D; // 更新其他参数... } public event PropertyChangedEventHandler PropertyChanged; protected virtual void OnPropertyChanged([CallerMemberName] string propertyName null) { PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName)); } }3. 复杂交互场景实现3.1 多ROI协同工作在PCB检测等场景中常需要多个ROI协同工作private Dictionarystring, HDrawingObject _roiDictionary new Dictionarystring, HDrawingObject(); public void AddROI(string name, HDrawingObject.HDrawingObjectType type) { if (_roiDictionary.ContainsKey(name)) return; var roi CreateROI(type, 100, 100, 50); _roiDictionary.Add(name, roi); hswControl.HalconWindow.AttachDrawingObjectToWindow(roi); // 设置Z序确保新ROI在最上层 roi.SetDrawingObjectParams(z_position, _roiDictionary.Count); }3.2 ROI的持久化与恢复工业软件需要保存和加载ROI配置public string SerializeROIs() { var sb new StringBuilder(); foreach (var kvp in _roiDictionary) { var param kvp.Value.GetDrawingObjectParams(new HTuple(type, row1, column1, row2, column2)); sb.AppendLine(${kvp.Key}|{param[0].S}|{param[1].D}|{param[2].D}|{param[3].D}|{param[4].D}); } return sb.ToString(); } public void DeserializeROIs(string config) { ClearAllROIs(); foreach (var line in config.Split(new[] { Environment.NewLine }, StringSplitOptions.RemoveEmptyEntries)) { var parts line.Split(|); var type (HDrawingObject.HDrawingObjectType)Enum.Parse(typeof(HDrawingObject.HDrawingObjectType), parts[1]); var roi CreateROI(type, double.Parse(parts[2]), double.Parse(parts[3]), double.Parse(parts[4])); _roiDictionary.Add(parts[0], roi); } }4. 性能优化与异常处理4.1 大图像下的流畅交互处理高分辨率图像时的优化策略private void OnImageLoaded(HImage image) { // 先显示缩略图 var smallImage image.ZoomImageSize(800, 600, constant); hswControl.HalconWindow.DispImage(smallImage); // 后台加载全尺寸图像 Task.Run(() { _fullImage image.CopyImage(); Dispatcher.Invoke(() hswControl.HalconWindow.DispImage(_fullImage)); }); }4.2 工业级异常处理框架private void SafeHalconCall(Action action) { try { hswControl.HalconWindow.SetSystem(flush_graphic, false); action(); hswControl.HalconWindow.SetSystem(flush_graphic, true); hswControl.HalconWindow.FlushBuffer(); } catch (HalconException hex) { Logger.Error($Halcon Error {hex.ErrorCode}: {hex.Message}); ShowStatusMessage($处理失败: {hex.GetErrorMessage()}); } catch (Exception ex) { Logger.Error(ex, UI操作异常); ShowStatusMessage($系统错误: {ex.Message}); } }5. 实际应用案例智能定位系统在半导体晶圆检测项目中我们实现了以下高级功能动态ROI生成根据模板匹配结果自动放置检测ROI参数联动调整一个ROI时自动计算相关ROI位置智能吸附ROI靠近特征边缘时自动吸附对齐核心代码结构public class WaferInspectionSystem { private HSmartWindowControlWPF _hsw; private HImage _currentImage; private ListHDrawingObject _inspectionROIs new ListHDrawingObject(); public void AutoPlaceROIs(HRegion matchedRegion) { SafeHalconCall(() { // 1. 获取匹配区域特征 var area matchedRegion.AreaCenter(out HTuple row, out HTuple column); // 2. 生成放射变换矩阵 var homMat2D HHomMat2D.Identity(); homMat2D homMat2D.HomMat2dTranslate(row, column); // 3. 应用预设ROI模板 foreach (var template in _roiTemplates) { var newROI template.Clone(); newROI.ApplyTransform(homMat2D); _inspectionROIs.Add(newROI); _hsw.HalconWindow.AttachDrawingObjectToWindow(newROI); } }); } }