C# HDevEngine引擎实战：从图像处理到直接导出C#函数调用的完整指南

1次阅读

没有评论

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

HDevEngine 是 Halcon 提供的脚本引擎，允许开发者通过 HDevelop 脚本语言执行图像处理任务。它与 Halcon 的关系可以理解为：

运行时依赖 ：HDevEngine 依赖 Halcon 运行时库（hdevelop.dll 等）
脚本解释器 ：将 HDevelop 语法解析为 Halcon 底层操作指令
桥梁作用 ：在 C# 等宿主语言中嵌入图像处理逻辑

核心组件包括：

引擎实例 ：HDevEngine 类作为主入口点
程序容器 ：HDevProgram 和 HDevProcedure 封装脚本单元
执行上下文 ：HDevProcedureCall 处理参数传递

引用 HalconDotNet.dll 和 hdevenginedotnet.dll
设置 DLL 搜索路径（解决常见部署问题）：

using HalconDotNet;
using HDevEngineDotNet;

static void InitEngine()
{
    // 必须指定 Halcon 依赖库路径
    HDevEngine.SetEngineAttribute("path_to_halcon_dll", @"C:\halcon\bin");
    HDevEngine.Engine.InitializeEngine();}

public class ImageProcessor : IDisposable
{
    private readonly HDevProcedure _proc;

    public ImageProcessor(string hdevPath)
    {
        // 加载脚本文件（异常处理关键点）try 
        {var program = new HDevProgram(hdevPath);
            _proc = new HDevProcedure(program, "threshold_image");
        }
        catch (HDevEngineException ex)
        {
            // 典型错误：脚本语法错误 / 找不到文件
            throw new InvalidOperationException($"HDev 脚本加载失败: {ex.Message}");
        }
    }

    public HImage Process(HImage input)
    {using (var call = _proc.CreateCall())
        {
            // 输入参数绑定
            call.SetInputIconicParamObject("input_image", input);

            // 执行并获取输出
            call.Execute();
            return call.GetOutputIconicParamObject("output_image") as HImage;
        }
    }

    public void Dispose()
    {_proc?.Dispose();
    }
}

关键注意事项：

所有 HImage 对象必须及时 Dispose
SetInputIconicParamObject/GetOutputIconicParamObject 是类型安全的关键
建议为每个脚本过程创建单独类（高内聚设计）

对象池模式 ：复用 HImage 对象

private readonly ConcurrentQueue<HImage> _imagePool = new();

HImage GetImage() => _imagePool.TryDequeue(out var img) ? img : new HImage();

void ReturnImage(HImage img)
{img.Dispose();
    // 或清除后复用: img.Clear();
    _imagePool.Enqueue(img);
}

及时释放资源 ：
HDevProcedureCall 必须 using 包裹
避免在循环中重复创建 HDevProgram

每个线程独立 HDevEngine 实例（开销约 5MB/ 线程）

共享程序实例需加锁：

private static readonly object _engineLock = new();

void ThreadSafeProcess()
{lock (_engineLock)
    {using var call = _proc.CreateCall();
        // ...
    }
}

必须同时部署：
hdevenginedotnet.dll
halcondotnet.dll
对应版本的 Halcon 基础 DLL（如 hacq*.dll）

版本匹配检查代码：

var engineVer = HDevEngine.GetEngineAttribute("version");
var halconVer = HOperatorSet.GetSystem("version");
if(engineVer != halconVer)
    throw new DllNotFoundException($"版本不匹配: 引擎 {engineVer} Halcon{halconVer}");

错误代码 1002：DLL 路径未正确设置
错误代码 1400：Halcon 许可证失效
内存泄漏 ：检查是否遗漏 Dispose 调用

完整工作流实现：

加载脚本

* threshold_image.hdev
read_image(Image, 'input')
threshold(Image, Regions, 128, 255)
connection(Regions, ConnectedRegions)
select_shape(ConnectedRegions, FinalRegions, 'area', 'and', 500, 99999)
count_obj(FinalRegions, NumberOfDefects)

C# 调用封装

public class PcbInspector
{public (int DefectCount, HImage Result) Detect(HImage pcbImage)
    {using var program = new HDevProgram("threshold_image.hdev");
        using var call = program.CreateProcedureCall("threshold_image");

        call.SetInputIconicParamObject("input_image", pcbImage);
        call.Execute();

        var defects = call.GetOutputCtrlParamTuple("NumberOfDefects").I;
        var result = call.GetOutputIconicParamObject("FinalRegions");

        return ((int)defects, (HImage)result);
    }
}