2.3 构造函数与Halcon算子

Halcon/C++提供了构造函数,主要基于适合的Halcon算子。比如说HImage和HBarCode基于read_image and create_bar_code_model。

请注意当前的Halcon版本针对不同的算子构造函数的功能不同。如下我们介绍了一些最常用的Halcon算子,而一个完整的构造函数列表可以在%HALCONROOT%\include\cpp中找到。

  • Images:

HImage基于算子read_image,gen_image1,gen_image1_extern,and gen_image_const提供了构造器。

在通过HImage使用其构造函数时请注意以下的陷阱:与直觉正好相反,该算子并不能修改调用它的实例,相反,被创建好的图像需要通过算子返回值返回。这样,我们看如下的代码,事实上并没有初始化图像.

HImage image;
image.ReadImage("barcode/ean13/ean1301"); // incorrect

正确的方法是:

image = HImage::ReadImage("barcode/ean13/ean1301"); // correct

从上面可以看出ReadImage是静态成员函数。
注意: HImage作为输出参数出现的任何算子都要注意这种陷阱,例如GrabImage.

  • Regions:

类HRegion提供了基于像gen_rectangle2 or gen_circle生成的构造函数。并且,也提供了直接的派生类HRectangle2 or HCircle.

请注意HRegion也表现了和HImage一样的陷阱。比如像GenRectangle2并不能直接修改调用它的实例HRegion,但是可以返回生成的初始化region.

  • XLDs:
    XLDs(HXLD,HXLDCont等等)没有提供相应的构造函数。

  • Windows:

类HWindow提供了基于open_window and new_extern_window的构造函数.注意:前者(指open_window)对于所有的参数可以使用默认值实现,这样就可以生成默认的构造器,因此一旦创建即打开。

当然了,你可以选择使用CloseWindow关闭窗口,然后使用OpenWindow再次打开它。

与图形化参数不同,你可以用一个直观的方式使用HWindow实例调用“类构造器”样的算子如OpenWindow。因此,对应的句柄被返回。

  • Other Handle Classes:

其他封装了句柄的类,如HBarCode 和 HFramegrabber,更系统地提供了构造函数:如果类作为输入参数出现在算子中,则自动存在一个基于此算子的构造函数。这样 ,基于create_bar_code_model创建了HBarcode,基于create_shape_model创建了HShapeModel,基于open_framegrabber创建了HFramegrabber.

与图形化的参数不同,句柄类允许用一个直观的方式使用类实例调用“类构造器”样的算子,并且调用对象被修改。比如,你可以创建一个带有默认构造器的HBarCode对象,并且使用CreateBarCodeModel初始化它。

HBarCode barcode;
barcode.CreateBarCodeModel(HTuple(), HTuple());

如果对象已经被初始化,在调用和重新初始化之前,原先的数据将自动销毁。

2.4 析构函数和Halcon算子

所有的HALCON/C++类都提供了默认的析构函数用来自动销毁对应的内存。对于某些类,析构函数基于适合的算子:

  • Windows:
    HWindow类的析构函数基于close_window关闭窗口。注意:算子本身不是析构器。你可以选择调用CloseWindow关闭窗口,并且使用OpenWindow再次打开它。

  • Other Handle Classes:
    其他句柄类的默认析构函数,如HShapeModel or HFramegrabber ,相应地应用了像clear_shape_model and close_framegrabber算子。与close_window不同,这些算子不能通过类对象调用,这个对于clear_all_shape_models一样适用。事实上,你没必要调用调用它,直接重新初始化即可,如5.2节描述的那样。

请注意: 你不能调用适用类对象来调用如下的算子:clear_shape_model,clear_all_shape_models, or close_framegrabber

2.5 Tuple模式

所谓tuple模式就是HALCON算子被调用。用这种模式,你可以使用一个简单的调用区处理许多图像或者区域。标准情况下,用一张单独的照片去调用一个算子叫做简单模式。一个算子是否支持这种tuple模式可以在查询手册中查询。比如,看下图5.5,展现了算子char_threshold的用法。


观察算子的说明,参数Image被描述成一个image(-array);这表明你可以应用此算子一次性到多个图片。

如果你使用多张图片调用算子char_threshold,比如说,用一个图像数组,那么输出参数也自动变为数组。因此,参数Characters and Threshold被描述成region(-array)和integer(-array).

注意观察图5.5的算子签名,我们发现面向过程的方法,调用char_threshold的简单模式和数组模式仅仅在输出参数Threshold上不同:一个指向long的指针,一个指向long的数组的指针。

面向对象的方法,简单模式和数组模式关于图形化参数使用了不同的类:HImage and HRegion vs.HImageArray and HRegionArray.正如面向过程的方法一样,控制参数可以是基本类型(仅仅简单模式)或者HTuple类型(简单和数组模式)

在看了理论上的介绍后,我们来看一个简单的例子。图5.6,char_threshold被应用于简单模式,即一幅单个的图片,图5.7 一次性应用于两张图片。


 HImageArray    images;
  HRegionArray   regions;
  HTuple         thresholds;

  for (int i=1; i<=2; i++)
  {
    images[i-1] = HImage::ReadImage(HTuple("alpha") + i);
  }

  regions = images.CharThreshold(images[0].GetDomain(), 2, 95, &thresholds);

  for (int i=0; i<images.Num(); i++)
  {
    images[i].Display(window);
    regions[i].Display(window);
    cout << "Threshold for 'alpha" << i+1 << "': " << thresholds[i].L();
    window.Click();

Hobject        images, image;
  Hobject        regions, region;
  long           num;
  HTuple         thresholds;

  gen_empty_obj(&images);

  for (int i=1; i<=2; i++)
  {
    read_image(&image, HTuple("alpha") + i);
    concat_obj(images, image, &images);
  }

  char_threshold(images, image, &regions, 2, 95, &thresholds);
  count_obj(images, &num);

  for (int i=0; i<num; i++)
  {
    select_obj(images, &image, i+1);
    disp_obj(image, window);
    select_obj(regions, &region, i+1);
    disp_obj(region, window);
    cout << "Threshold for 'alpha" << i+1 << "': " << thresholds[i].L();
  }

Figure 5.7: Using CharThreshold in tuple mode, via HImageArray, or in the procedural approach (declaration and opening of window omitted).

两个例子都使用面向对象和面向过程的方法实现。例子中概括了以下几个有趣的点:

  • 图形化数组的创建和初始化:
    在面向对象的方法中,图像数组可以通过众所周知的运算符[]来创建。而面向过程的方法,你必须使用gen_empty_obj创建一个空的对象(即数组),然后通过concat_obj增加图像。

  • 访问图形化对象
    正如所期望的那样,在面向对象的方法中,单个图像和区域可以通过[]来访问;数组的个数可以通过方法Num()来获得。而面向过程的方法中,对象必须显式地使用算子select_obj来获得;个数必须通过count_obj获得。

  • Hobject的多态性:(part I)
    正如已经提到的那样,Hobject的实例既可以使用简单模式也可以使用数组模式。但是与之相反的是,面向对象的方法中当从简单模式切换到数组模式时,你必须使用不同的类。

  • Hobject的多态性:(part II)
    Hobject可以用于所有图形化对象。并且,图像对象可以当做region使用作为参数。在这种情况下,图像的domain,即像素“有效”的区域(即ROI)
    自动提取。而面向对象的方法,你必须使用GetDomain显式地提取。

  • Array(tuple) indices:(数组目录)
    面向对象的图形化数组以0开始,比如对于HTuple就是这样。但是Hobject数组就是从1开始。

大多数时候,你将使用数组模式:只要你通过算子Connection将一个region分成连通的区域,你就将以HRegionArray结束。这样,任何子序列的处理,比如形态学处理,像DilationCircle or 或者使用AreaCenter计算region的位置都将自动在数组的所有区域中呈现,也就是数组模式。这样,数组模式终究也是一个简单的模式!

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,911评论 5 460
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 82,014评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 142,129评论 0 320
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,283评论 1 264
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,159评论 4 357
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,161评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,565评论 3 382
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,251评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,531评论 1 292
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,619评论 2 310
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,383评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,255评论 3 313
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,624评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,916评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,199评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,553评论 2 342
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,756评论 2 335

推荐阅读更多精彩内容

  • 第5章 引用类型(返回首页) 本章内容 使用对象 创建并操作数组 理解基本的JavaScript类型 使用基本类型...
    大学一百阅读 3,196评论 0 4
  • 前言 把《C++ Primer》[https://book.douban.com/subject/25708312...
    尤汐Yogy阅读 9,484评论 1 51
  • 1. Java基础部分 基础部分的顺序:基本语法,类相关的语法,内部类的语法,继承相关的语法,异常的语法,线程的语...
    子非鱼_t_阅读 31,505评论 18 399
  • 别人笑我太疯癫,我笑他人看不穿 我身边的同学朋友多称我作挑剔的多情种,其实,他们不知,我本质上是一颗早熟种子。 那...
    添一抹岚阅读 1,071评论 32 17
  • 在白洋淀度五一, 同学一起,在赏风景、瞻仰名胜古迹之余, 学会了一种扑克牌玩法。 名字挺有意思,叫:“干瞪眼” 光...
    毛英勇阅读 1,309评论 0 1