C# 与 Halcon 目标检测实战：工业视觉场景下的高效解决方案

1次阅读

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

在工业视觉检测场景中，高并发图像处理常常面临以下挑战：

处理延迟问题 ：传统同步调用方式导致流水线阻塞，例如当检测单个工件超过 50ms 时，产线速度会被限制在 20fps 以下
内存泄漏风险 ：Halcon 的 HImage/HObject 未及时释放时，每处理 1000 张 2000×2000 图像会泄露约 1.2GB 内存
线程安全问题 ：多相机采集时，Halcon 许可证的线程绑定机制可能导致随机崩溃

优点：部署简单，直接引用 HalconDotNet.dll 即可
缺点：
单线程性能瓶颈（实测吞吐量 <15fps @i7-11800H）
跨线程调用需手动同步
内存回收依赖 GC，不可控

优点：
支持脚本预编译（速度提升 40%）
原生异步执行能力
精确控制内存生命周期
缺点：
需要额外处理脚本上下文
调试信息获取较复杂

// 图像处理工作队列
public class ProcessingQueue : IDisposable
{
    private readonly BlockingCollection<HImage> _inputQueue;
    private readonly HDevEngine _engine;
    private readonly CancellationTokenSource _cts;

    public ProcessingQueue(string hdevPath)
    {_engine = new HDevEngine();
        _engine.LoadProgram(hdevPath);
        _inputQueue = new BlockingCollection<HImage>(10); // 背压控制
        _cts = new CancellationTokenSource();

        // 启动处理线程
        Task.Run(() => ProcessImages(_cts.Token));
    }

    private void ProcessImages(CancellationToken token)
    {using var procedure = _engine.GetProc("detect_defects");
        while (!token.IsCancellationRequested)
        {
            try
            {var image = _inputQueue.Take(token);
                procedure.Execute(() => {procedure.SetInputIconicParamObject("image", image);
                    procedure.Execute();
                    var results = procedure.GetOutputCtrlParamTuple("defects");
                    // 结果回调...
                });
            }
            catch (OperationCanceledException) {break;}
        }
    }
}

public class HalconObjectPool<T> where T : HObject, new()
{private readonly ConcurrentBag<T> _pool = new();
    private readonly Func<T> _objectFactory;

    public HalconObjectPool(Func<T> factory) => _objectFactory = factory;

    public T Get() => _pool.TryTake(out var obj) ? obj : _objectFactory();

    public void Return(T obj)
    {obj.Dispose();
        _pool.Add(_objectFactory()); // 创建新实例替代旧对象
    }
}

图像缓冲区复用 ：

// 预分配图像内存池
var imagePool = new HalconObjectPool<HImage>(() => new HImage());

// 使用时获取缓冲对象
var buffer = imagePool.Get();
buffer.GenImageConst("byte", 2048, 2048);

ROI 对象复用 ：

// 共享 ROI 模板
private static readonly HRegion _roiTemplate = new HRegion(100, 100, 500, 500);

// 使用时克隆而非新建
using var roi = _roiTemplate.Clone();

Parallel.For(0, imageCount, new ParallelOptions {MaxDegreeOfParallelism = Environment.ProcessorCount - 1}, i => {using var engine = new HDevEngine();
    engine.SetEngineAttribute("execute_thread", "true");
    // 处理逻辑...
});

现象：多线程环境下随机抛出 ”No valid license” 异常
解决方案 ：

// 每个线程单独初始化引擎
[ThreadStatic]
private static HDevEngine _threadEngine;

public static HDevEngine GetEngine()
{if (_threadEngine == null)
    {_threadEngine = new HDevEngine();
        _threadEngine.SetEngineAttribute("init_new_license", "true");
    }
    return _threadEngine;
}

try
{using var obj = new HObject();
    // 操作代码...
}
catch (HOperatorException hex)
{Logger.Error($"Halcon 错误 {hex.GetErrorCode()}: {hex.Message}");
    throw new VisionException("处理失败", hex);
}
finally
{GC.Collect(); // 强制回收非托管资源
}

测试环境：Intel i7-11800H/32GB DDR4/NVIDIA RTX 3060