C#联合Halcon实现人机交互图像平移与缩放：从零开始的工业视觉开发指南

1次阅读

没有评论

共计 3343 个字符，预计需要花费 9 分钟才能阅读完成。

在工业视觉领域，人机交互功能是质检员与系统沟通的重要桥梁。例如：

PCB 板检测：需要放大查看焊点缺陷，拖动检查边缘毛刺
零件尺寸测量：通过缩放比对公差范围，平移定位关键特征点
流水线监控：快速定位异常区域，动态调整检测区域(ROI)

这类场景的共同特点是：既要保持高精度图像处理能力，又需提供符合直觉的交互体验。

相比 OpenCV 等通用库，Halcon 的独特价值在于：

工业级优化：对千兆像素图像的处理速度提升 3 - 5 倍
硬件加速：自动利用 GPU 进行仿射变换计算
控件集成：原生 HWindowControl 支持触摸手势和鼠标事件
计量标定：内置世界坐标系转换，避免手动换算像素尺寸

但需注意其商用授权模式，社区版有功能限制。

Halcon 安装：从官网获取 HDevelop 安装包（建议 18.11+ 版本）
VS 配置：创建 C# WinForms 项目，添加 HalconDotNet 引用
控件引入：在工具箱右键→选择项→浏览添加 halcondotnet.dll
许可证部署：将 license 文件放入程序运行目录（关键！）

在窗体设计器中拖入 HWindowControl 后，需处理三个基础事件：

hWindowControl1.HMouseDown += OnMouseDown;
hWindowControl1.HMouseMove += OnMouseMove; 
hWindowControl1.HMouseUp += OnMouseUp;

基于鼠标位移计算平移量，核心逻辑：

// 在类成员变量中记录状态
Point startPos;
HTuple hv_Row1, hv_Column1;

void OnMouseDown(object sender, HMouseEventArgs e)
{
    startPos = e.Position;
    hWindowControl1.HalconWindow.GetMposition(out hv_Row1, out hv_Column1, out _);
}

void OnMouseMove(object sender, HMouseEventArgs e)
{if (e.Button == MouseButtons.Left)
    {
        // 计算位移差并应用仿射变换
        double offsetX = (e.X - startPos.X) * zoomFactor;
        double offsetY = (e.Y - startPos.Y) * zoomFactor;

        HOperatorSet.HomMat2dIdentity(out HTuple hv_HomMat2D);
        HOperatorSet.HomMat2dTranslate(hv_HomMat2D, offsetY, offsetX, out hv_HomMat2D);
        ApplyTransform(hv_HomMat2D);
    }
}

采用鼠标位置作为缩放中心点：

void OnMouseWheel(object sender, HMouseEventArgs e)
{
    // 获取当前鼠标图像坐标
    hWindowControl1.HalconWindow.GetMposition(out HTuple row, out HTuple col, out _);

    // 计算缩放系数（滚轮每格 5%）double scale = e.Delta > 0 ? 1.05 : 0.95;
    zoomFactor *= scale;

    // 构建变换矩阵
    HOperatorSet.HomMat2dIdentity(out HTuple hv_HomMat2D);
    HOperatorSet.HomMat2dTranslate(hv_HomMat2D, -row, -col, out hv_HomMat2D);
    HOperatorSet.HomMat2dScale(hv_HomMat2D, scale, scale, 0, 0, out hv_HomMat2D);
    HOperatorSet.HomMat2dTranslate(hv_HomMat2D, row, col, out hv_HomMat2D);

    ApplyTransform(hv_HomMat2D);
}

public class ImageViewer
{
    // 状态变量
    private double zoomFactor = 1.0;
    private HImage currentImage;
    private HTuple lastHomMat;

    // 初始化方法
    public void Init(HWindowControl window)
    {// 事件绑定代码...}

    // 应用变换核心方法
    private void ApplyTransform(HTuple homMat)
    {
        try
        {using (HDevDisposeHelper dh = new HDevDisposeHelper())
            {
                // 双缓冲处理
                System.Drawing.Rectangle rect = hWindowControl1.ImagePart;
                HOperatorSet.SetSystem("flush_graphic", "false");

                // 叠加原始图像与变换矩阵
                HOperatorSet.AffineTransImage(currentImage, out HImage transImage, 
                    homMat, "constant", "false");

                // 显示处理
                hWindowControl1.HalconWindow.ClearWindow();
                transImage.DispObj(hWindowControl1.HalconWindow);
                HOperatorSet.SetSystem("flush_graphic", "true");
                transImage.Dispose();}
        }
        catch(HOperatorException ex)
        {
            // 越界等异常处理
            ResetView();}
    }

    // 重置视图
    public void ResetView()
    {
        zoomFactor = 1.0;
        HOperatorSet.HomMat2dIdentity(out lastHomMat);
        currentImage.DispObj(hWindowControl1.HalconWindow);
    }
}

图像金字塔：加载时生成多级缩放版本

HOperatorSet.GenPyramid(currentImage, out HImage pyramidImage, "reduce");

异步渲染：对 4K 以上图像启用 Task 并行处理
区域缓存：将 ROI 转换为 XLD 轮廓而非像素数组
精度分级：缩放级别 <30% 时切换为快速插值法
显存管理 ：定期调用 GC.Collect() 释放 Halcon 对象
事件节流：用 Timer 限制 MouseMove 触发频率

错误提示：”No valid HALCON license found”
检查步骤：
确认 license 文件与 exe 同目录
检查系统日期是否在有效期范围内
在 Halcon 安装目录运行 license 检测工具

在 App.config 中添加：

<System.Windows.Forms.ApplicationConfigurationSection>
  <add key="DpiAwareness" value="PerMonitorV2" />
</System.Windows.Forms.ApplicationConfigurationSection>