Halcon11和Halcon10C++接口使用

Halcon11和Halcon10相比采用了新的C++接口，新接口特点如下：

1） 新版本Halcon/C++接口与Halcon/.NET接口统一

2） 拥有基于异常的错误处理

3） 增加新类HString

4） 支持数据类例如：HPose

5） 使面向过程和面向对象的混合编程更加简单

值得注意的是Halcon11不是向下兼容的，也就是说 Halcon11不兼容Halcon10以及之前的版本。如果用户想将原来写的Halcon10/C++代码移植到Halcon11中则需要进行相应的改动，包括编程环境配置、变量定义、函数名称等等。下面我们对代码移植进行一个较详细说明。

1） 链接库更改：

Windows系统改为：

/libpath:"$(HALCONROOT)\lib\$(HALCONARCH)" halconcpp10.lib

Linux系统改为：

-L$(HALCONROOT)/lib/$(HALCONARCH) -lhalconcpp10 -lhalcon

2） 代码更改：

a) 命名空间修改：

// 旧版 // 新版

using namespace Halcon; using namespace HalconCpp;

... ...

b) 代码修改：

i. 函数命名更改，例如：mean_image改为MeanImage

ii. 错误处理要基于异常捕捉

iii. 新版不再支持数组标志Array，例如：HImageArray改为HImage

iv. 使用HString做文字输出

v. 从程序中移除，替换为（注意下划线部分）

vi. 运算符以及变量命名变更：

//旧版 //新版

GetEnv TupleEnvironment

ToString(pattern) TupleString(pattern)

Subset TupleSelect

Add, Sum, Sin,... TupleAdd, TupleSum, TupleSin, ...

Substring 无

Reset Clear

变更例子：

//旧版 //新版

... ...

Hobject Iconic; HObject Iconic; // upper-case O

HImage Image; HImage Image;

HImageArray Images; HImage Images;

HRegionArray Regions; HRegion Regions;

HXLDArray XLDs; HXLD XLDs;

char Characters[MAX_STRING]; HString Characters;

... ...

read_image(&Iconic,"clip") ReadImage(&Iconic,"clip") long Var; Hlong Var;

HTuple Values; HTuple Values; ... ...

Var = Values.Num(); Var = Values.Length(); ... ...

备注：#define HCPP_LEGACY_API可以使用旧的HTuple成员函数

例如：

HTuple Values;

...

Values.Reset()

3） 编译环境更改：

Include路径设定变更

旧版

$HALCONROOT/include/cpp #define HCPP_LEGACY_API HTuple Values; ... Values.Reset() // better use Clear() 新版 $HALCONROOT/include/halconcpp