Halcon union_collinear_contours_xld详解

union_collinear_contours_xld

原型

union_collinear_contours_xld(Contours : UnionContours : MaxDistAbs, MaxDistRel, MaxShift, MaxAngle, Mode : )

功能

将近似共线轮廓合并

参数列表

Contours (input_object) ：输入XLD轮廓
UnionContours (output_object) ：合并后输出轮廓
MaxDistAbs (input_control) ：沿参考轮廓的回归线测量两个轮廓之间的最大间隙长度（间隙在参考轮廓拟合直线上的投影）。
MaxDistRel (input_control) ：间隙在参考轮廓拟合直线上的投影长度与参考轮廓长度的比值上限（见下面详解）
MaxShift (input_control) ：第二个轮廓与参考轮廓拟合直线的最大距离
MaxAngle (input_control) ：两个轮廓拟合直线的角度（ 0.0 ≤ MaxAngle ≤ 0.78539816339（45度））
Mode (input_control) ：定义轮廓属性处理的模式，即，是否保留或丢弃轮廓属性

详解

这个算子目的是将近似共线（大致在一条直线上）的轮廓合并起来。合并后的轮廓由各轮廓的轮廓点关联起来组成，然后与未合并的轮廓一起输出。
MaxDistAbs, MaxDistRel, MaxShift, MaxAngle这四个参数用来控制轮廓共线的条件，Mode控制输入轮廓属性的处理方式。
原则上，前三个参数（MaxDistAbs, MaxDistRel, MaxShift）依赖每对要合并轮廓的顺序，也即是说两个轮廓哪一个轮廓作为参考轮廓去连接另外一个轮廓，选择不同，参数值设置也不同。为了避免这种依赖性，执行过程中会各自计算两个轮廓分别作为参考轮廓的参数值，然后根据最小的结果值来选择参考轮廓的顺序（决定哪个轮廓作为参考轮廓）。请注意，为了说明方便，在下图中，均以左侧的轮廓作为参考轮廓。

参数MaxDistAbs决定了两个轮廓绝对距离的上限。两个轮廓的距离沿着参考轮廓的拟合直线来测量，所以这个距离是两个轮廓直线间隙在参考轮廓拟合直线上的投影的长度，即是下图中的a，如果a<=MaxDistAbs，则满足条件。
参数MaxDistRel决定了两个轮廓相对距离的上限，相对距离由绝对距离a除以参考轮廓长度计算得出。
参数MaxShift 决定了第二个轮廓距离参考轮廓拟合直线最大距离的上限。此距离是垂直于参考轮廓的拟合直线测量的。

参数MaxAngle决定了两个轮廓的拟合直线之间角度的上限

参数Mode控制轮廓的属性名称有无。如果选择’attr_keep’，则输出的轮廓拥有属性名称，如果选择’attr_forget’则输出的轮廓没有属性名称。
比如选择’attr_keep’

比如选择’attr_forget’，如果不需要每个轮廓的属性，选择’attr_forget’可以提升处理性能。

应用

由于图像对比度差，提取的线条或者边界不连续，算子union_collinear_contours_xld不仅可以将不连续的线条间隙桥接起来，而且还可以合并共线的边界以及根据轮廓节点分割的线段。这个算子的应用意义就是将近似共线的轮廓合并成你想要的边界。
下面介绍的例子将会说明这一点。
下图中左边是一组待连接的输入轮廓，并且矩形每一边上的轮廓近似共线。右边显示的是经过算子处理后的结果（共线的轮廓被合并），仔细观察，会发现矩形四个边上的轮廓分别合并了，但每个边的轮廓不会合并。所以很形象的说明了算子只会将近似共线的轮廓合并，也就是说如果两个轮廓的拟合直线之间角度>=45度，那么，无论你如何设置参数，这个算子都不会将这两个轮廓合并。

举例

代码

gen_contour_polygon_xld (FirstContour, [500,1000], [1,1])
gen_contour_polygon_xld (SecondContour, [1001,1500], [2,501])
concat_obj (FirstContour, SecondContour, ConcatContour)
union_collinear_contours_xld (ConcatContour, UnionContours1, 1, 0.002, 500, rad(45), ‘attr_keep’)