C#集成Halcon绘制工具实战：如何优雅实现绘制取消功能

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

开篇：当绘图像 502 胶水一样粘住 UI 时

最近在 WPF 项目里集成 Halcon 的绘制工具（比如画 ROI 区域），发现一个抓狂的现象：一旦开始绘制，整个 UI 就卡死，鼠标点取消按钮根本没反应。查文档才知道，Halcon 的绘图操作默认是 同步阻塞 的，会死死占着 UI 线程不放。

// 典型的问题代码（千万别这么写！）private void btnDrawCircle_Click(object sender, EventArgs e)
{
    // 这个调用会让 UI 冻结直到绘制完成
    HOperatorSet.DrawCircle(hWindowControl.HalconWindow, out row, out column, out radius);
}

技术方案选型：三套方案对比

方案 1：同步调用（简单但危险）

• 优点：代码直白，5 分钟搞定
• 致命伤：UI 线程阻塞，用户以为软件卡死了

方案 2：Halcon 原生异步事件

Halcon 其实有异步绘图机制，通过 set_callback 注册事件。但实际用起来发现两个坑：

1. 事件响应有延迟，快速操作时可能丢失指令
2. 需要处理复杂的跨线程 HWindow 访问

方案 3：HDevWindowStack + CancellationToken（推荐）

结合.NET 的取消令牌和 Halcon 的窗口堆栈管理，实现效果如下：

flowchart TD
    A[点击绘制按钮] --> B[创建 CancellationTokenSource]
    B --> C[启动后台绘制 Task]
    C --> D{用户点击取消?}
    D -->| 是 | E[调用 Cancel 方法]
    D -->| 否 | F[正常完成绘制]
    E --> G[通过 HDevWindowStack 中断绘制]

核心代码实现（带线程安全防护）

关键类准备

// 在窗体类中声明
private CancellationTokenSource _drawingCts;
private readonly object _drawingLock = new object();

安全的绘制启动方法

private async void btnStartDraw_Click(object sender, EventArgs e)
{lock (_drawingLock)
    {_drawingCts?.Dispose();
        _drawingCts = new CancellationTokenSource();}

    try
    {await Task.Run(() => SafeDrawCircle(_drawingCts.Token), 
                      _drawingCts.Token);
    }
    catch (OperationCanceledException)
    {// 正常取消无需处理}
    finally
    {lock (_drawingLock) _drawingCts?.Dispose();}
}

带中断检测的绘制逻辑

private void SafeDrawCircle(CancellationToken ct)
{
    // 必须用 Invoke 跨线程访问 Halcon 窗口
    hWindowControl.Invoke((Action)(() => 
    {HDevWindowStack.Push(hWindowControl.HalconWindow);
        try
        {
            HTuple row, col, radius;
            HOperatorSet.SetColor("green");

            // 关键：循环检查取消请求
            while (!ct.IsCancellationRequested)
            {
                // 这个重载版本支持超时检测
                HOperatorSet.DrawCircleMod(
                    hWindowControl.HalconWindow, 
                    100, 100, 50, 
                    out row, out col, out radius);

                // 绘制完成自动退出循环
                if (row.D != 0 || col.D != 0 || radius.D != 0)
                    break;
            }
        }
        finally
        {
            // 必须确保弹出窗口堆栈
            if (HDevWindowStack.IsOpen())
                HDevWindowStack.Pop();}
    }));
}

避坑指南（血泪经验总结）

资源释放三大原则

1. 每个 HDevWindowStack.Push() 必须对应Pop()
2. 取消操作后要调用HOperatorSet.ClearDrawingObject()
3. 窗体关闭时检查残留的绘图对象

跨线程访问规范

• 所有 Halcon 窗口操作必须通过Control.Invoke
• 推荐使用 HDevWindowStack 代替直接操作HWindow

超时恢复方案

建议添加超时控制，双重保险：

_drawingCts.CancelAfter(TimeSpan.FromSeconds(30));

性能实测数据

在 i7-11800H 处理器上测试 1000×1000 图像：

检测内存泄漏的命令（在 Halcon 命令行执行）：

dump_image_variables := 1
check_memory_leaks()

扩展思考：多图层管理

如果要支持多图层独立绘制控制，可以：
1. 为每个图层创建独立的CancellationTokenSource
2. 使用 HDevWindowStack 的计数特性管理层级
3. 设计绘制上下文对象跟踪状态

下次可以聊聊怎么用 HDevEngine 实现更复杂的脚本化绘图~