C#调用Halcon绘制工具实战：如何优雅取消绘制操作

1次阅读

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

在工业视觉开发中，Halcon 的交互式绘图工具（如 draw_rectangle1、draw_circle 等）经常需要嵌入到 C# 应用程序中。但直接调用时往往会遇到两个棘手问题：一是长时间绘图操作会冻结 UI 线程，二是无法安全取消正在进行的绘制操作。今天我们就来彻底解决这个痛点。

当我们在 WinForms/WPF 中直接调用 Halcon 绘图算子时（对应 HDevelop 命令例如draw_rectangle1(WindowHandle, Row1, Column1, Row2, Column2)），会发生以下典型问题：

UI 线程阻塞：绘图操作会同步阻塞调用线程，用户界面完全卡死
资源泄漏风险：直接使用 hDevWindowStack.Push/Pop 时，若发生异常会导致 Halcon 窗口句柄未正确释放
强制终止隐患 ：使用 Thread.Abort() 中断线程可能导致 Halcon 内部状态不一致

我们测试了三种常见的取消方案：

暴力终止（不推荐）

var thread = new Thread(() => DrawCircle());
thread.Start();
// 需要取消时：thread.Abort(); // 可能导致 Halcon 资源泄漏

ManualResetEvent 信号量（可用但繁琐）

ManualResetEventSlim cancelEvent = new();
// 绘图循环中需要不断检查：if(cancelEvent.Wait(0)) throw new OperationCanceledException();

CancellationToken 方案（推荐）

using var cts = new CancellationTokenSource();
await Task.Run(() => DrawWithCancel(cts.Token));
// 需要取消时：cts.Cancel();

public sealed class HalconDrawingContext : IDisposable
{
    private HTuple windowHandle;
    private CancellationTokenRegistration? ctr;

    public HalconDrawingContext(HTuple window, CancellationToken ct)
    {
        this.windowHandle = window;
        // 设置 Halcon 错误处理模式（对应 HDevelop 命令：set_check('~give_error')）HOperatorSet.SetSystem('do_not_raise_exception', 'true');
        ctr = ct.Register(() => HOperatorSet.SetSystem('flush_graphic', 'true'));
    }

    public void Dispose()
    {ctr?.Dispose();
        // 恢复默认检查模式（HDevelop 命令：set_check('give_error')）HOperatorSet.SetSystem('do_not_raise_exception', 'false');
        GC.SuppressFinalize(this);
    }
}

public static (double, double, double, double) DrawRectangle1(
    HTuple windowHandle, 
    CancellationToken ct,
    IProgress<string> progress = null)
{using var ctx = new HalconDrawingContext(windowHandle, ct);

    // 对应 HDevelop 的 draw_rectangle1
    HOperatorSet.DrawRectangle1(windowHandle, 
        out HTuple row1, out HTuple col1, 
        out HTuple row2, out HTuple col2);

    // 检查是否已被取消
    ct.ThrowIfCancellationRequested();

    return (row1.D, col1.D, row2.D, col2.D);
}

⚠️ Halcon 资源泄漏检测
执行前后可通过以下代码检查对象泄漏（对应 HDevelop 命令：count_obj）：

long startCount = HOperatorSet.CountObj(new HObject()).L;
// 执行绘图操作...
long endCount = HOperatorSet.CountObj(new HObject()).L;
Debug.Assert(startCount == endCount, "Halcon 对象泄漏！");

⚠️ 高 DPI 适配方案
在应用程序入口添加：

[STAThread]
static void Main()
{if (Environment.OSVersion.Version.Major >= 6)
        SetProcessDPIAware();
    // ...
}

[System.Runtime.InteropServices.DllImport("user32.dll")]
private static extern bool SetProcessDPIAware();

我们使用 Stopwatch 测试取消响应时间：