[Halcon算子]Halcon算子之XLD(一)

1、概念

在Halcon中,图像是由像素组成的,一般的算法也都是基于像素来进行处理,所以其中Image和Region都是以像素为最小单位,XLD用来表示亚像素的轮廓或者多边形。
XLD的特征大部分跟Region很像,很多算子都是在Region的算子后加上_xld。其主要的特征如下:

1.基础特征:面积,中心坐标,宽高,左上右下坐标;
2.形状特征:长度,圆度,紧密度,矩形度,凸性,偏心率,蓬松度等;
3.云点特征:云点面积,中心,云点方向;

2、算子功能介绍

2.1 Access

1.get_contour_xld(Contour : : : Row, Col)
功能:返回XLD轮廓的坐标;
输入:XLD对象Contours;
输出:坐标值Row和Col;
2.get_lines_xld(Polygon : : : BeginRow, BeginCol, EndRow, EndCol, Length, Phi)
功能:返回一个XLD多边形的数据(以线形式);
输入:多边形XLD对象Polygon ;
输出:直线的起点坐标、终点坐标、长度和角度;
3.get_parallels_xld(Parallels : : : Row1, Col1, Length1, Phi1, Row2, Col2, Length2, Phi2)
功能:返回一个XLD平行数据(以线形式);
输入:两平行线XLD对象Parallels ;
输出:Row1, Col1, Length1, Phi1, 两平行线第一条两端点坐标与线长,线方向;
输出:Row2, Col2, Length2, Phi2两平行线第二条两端点坐标与线长,线方向;
4.get_polygon_xld(Polygon : : : Row, Col, Length, Phi)
功能:返回一个XLD多边形的数据;
输入:多边形XLD对象Polygon ;
输出:多边形每个顶点坐标Row,Col、每条边的长度和角度;

2.2 Creation

1.gen_circle_contour_xld( : ContCircle : Row, Column, Radius, StartPhi, EndPhi, PointOrder, Resolution : )
功能:根据相应的圆或者圆弧创建XLD;
输入:圆弧的圆心坐标,半径,起始角度和终止角度 ;
输入:沿着圆弧点的方向(PointOrder),可选“positive”和“negative”;
输出:创建的XLD对象ContCircle;
2.gen_contour_nurbs_xld( : Contour : Rows, Cols, Knots, Weights, Degree, MaxError, MaxDistance : )
功能:将NURBS曲线转换为XLD轮廓;
输入:NURBS曲线的参数 ;
输出:近似NURBS曲线的XLD轮廓;
3.gen_contour_polygon_rounded_xld( : Contour : Row, Col, Radius, SamplingInterval : )
功能:根据一个带圆角的多边形(以元组形式给出)创建一个XLD轮廓;
输入:多边形参数 ;
输出:多边形生成的XLD轮廓;
4.gen_contour_polygon_xld( : Contour : Row, Col : )
功能:根据一个多边形(以元组形式给出)创建一个XLD轮廓;
输入:多边形点坐标Row,Col ;
输出:多边形生成的XLD轮廓;
5.gen_contour_region_xld(Regions : Contours : Mode : )
功能:根据区域Region创建XLD轮廓;
输入:区域Region ;
输入:模式Mode,“Center”,以边界像素的中心作为轮廓点;“border”,以边界像素的外边界作为轮廓点;“border_holes”,获取外边界同时可以获得所有孔的轮廓 ;
输出:生成的XLD轮廓;
6.gen_contours_skeleton_xld(Skeleton : Contours : Length, Mode : )
功能:将骨架转换为XLD轮廓(contour);
输入:轮廓骨架Skeleton ;
输入:提取轮廓线包含的最小点数;
输入:输入过滤模式( 'filter', 'generalize1', 'generalize2');
'filter' ,因为轮廓线在端点被分割,所以会存在一种情况,就是即使很长的轮廓线也可能被分割成很多的短线,即使他们的长度大于设定参数Length;
'generalize1',这种模式下,就可以避免长的轮廓被分割,而且长度小于参数Length的线段会被舍弃;
'generalize2' ,那么短的线段会被保留下来,只要线段有两个端点,即使长度小于参数Length,也会被保留。
输出:生成的XLD轮廓;
7.gen_cross_contour_xld( : Cross : Row, Col, Size, Angle : )
功能:根据每个输入点交叉的形状创键一个XLD轮廓(contour);
输入:所有交叉点的坐标Row、Col ;
输入:交叉点的大小;
输入:每个交叉点的角度Angle;
输出:生成的XLD轮廓Cross ;
8.gen_ellipse_contour_xld( : ContEllipse : Row, Column, Phi, Radius1, Radius2, StartPhi, EndPhi, PointOrder, Resolution : )
功能:根据相应的椭圆弧创建一个XLD轮廓(contour);
输入:椭圆弧的参数Row、Col、Phi ;
输入:轮廓点的顺序,“positive”和“negative”;
输入:相邻轮廓点的最大距离Resolution;
输出:生成的XLD轮廓ContEllipse ;
9.gen_nurbs_interp( : : Rows, Cols, Tangents, Degree : CtrlRows, CtrlCols, Knots)
功能:根据给定的插值点,创建NURBS曲线的控制数据;
输入:所有交叉点的坐标Row、Col ;
输入:交叉点的大小;
输入:每个交叉点的角度Angle;
输出:生成的XLD轮廓ContEllipse ;
10.gen_parallels_xld(Polygons : Parallels : Len, Dist, Alpha, Merge : )
功能:提取平行的XLD多边形(polygon);
输入:待提取的多边形轮廓 Polygons ;
输入:提取长度超过Len的线段,投影距离小于Dist;
输入:多边形最大角度差Alpha和是否合并相邻的平行关系Merge;
输出:提取的平行XLD轮廓Parallels ;
11.gen_polygons_xld(Contours : Polygons : Type, Alpha : )
功能:根据多边形近似创建XLD轮廓(contour);
输入:想要逼近的XLD轮廓Contours ;
输入:逼近的类型Type,主要为“ramer”算法;
输入:逼近的阈值是通过Alpha 设置的;
输出:近似后的轮廓Polygons ;
12.gen_rectangle2_contour_xld( : Rectangle : Row, Column, Phi, Length1, Length2 : )
功能:创建一个Rect2矩形XLD轮廓(contour);
输入:Rect2的参数;
输出:生成的XLD轮廓Rectangle ;
13.mod_parallels_xld(Parallels, Image : ModParallels, ExtParallels : Quality, MinGray, MaxGray, MaxStandard : )
功能:提取封闭区域内的平行XLD多边形(polygon);
输入:输入的XLD轮廓Parallels;
输入:最小品质因数(并行度的度量)Quality;
输入:设定最小灰度,最大灰度和最大标准偏差MaxStandard ;
输出:返回的平行的XLD轮廓ModParallels;
输出:扩展的XLD轮廓ExtParallels ;

2.3 Geometric-Transformations

1.affine_trans_contour_xld(Contours : ContoursAffineTrans : HomMat2D : )
功能:对XLD轮廓(contour)进行任意二维仿射变换;
输入:圆弧的圆心坐标,半径,起始角度和终止角度 ;
输入:沿着圆弧点的方向(PointOrder),可选“positive”和“negative”;
输出:创建的XLD对象ContCircle;
2.gen_contour_nurbs_xld( : Contour : Rows, Cols, Knots, Weights, Degree, MaxError, MaxDistance : )
功能:将NURBS曲线转换为XLD轮廓;
输入:NURBS曲线的参数 ;
输出:近似NURBS曲线的XLD轮廓;
3.gen_contour_polygon_rounded_xld( : Contour : Row, Col, Radius, SamplingInterval : )
功能:根据一个带圆角的多边形(以元组形式给出)创建一个XLD轮廓;
输入:多边形参数 ;
输出:多边形生成的XLD轮廓;
4.gen_contour_polygon_xld( : Contour : Row, Col : )
功能:根据一个多边形(以元组形式给出)创建一个XLD轮廓;
输入:多边形点坐标Row,Col ;
输出:多边形生成的XLD轮廓;
5.gen_contour_region_xld(Regions : Contours : Mode : )
功能:根据区域Region创建XLD轮廓;
输入:区域Region ;
输入:模式Mode,“Center”,以边界像素的中心作为轮廓点;“border”,以边界像素的外边界作为轮廓点;“border_holes”,获取外边界同时可以获得所有孔的轮廓 ;
输出:生成的XLD轮廓;
6.gen_contours_skeleton_xld(Skeleton : Contours : Length, Mode : )
功能:将骨架转换为XLD轮廓(contour);
输入:轮廓骨架Skeleton ;
输入:提取轮廓线包含的最小点数;
输入:输入过滤模式( 'filter', 'generalize1', 'generalize2');
'filter' ,因为轮廓线在端点被分割,所以会存在一种情况,就是即使很长的轮廓线也可能被分割成很多的短线,即使他们的长度大于设定参数Length;
'generalize1',这种模式下,就可以避免长的轮廓被分割,而且长度小于参数Length的线段会被舍弃;
'generalize2' ,那么短的线段会被保留下来,只要线段有两个端点,即使长度小于参数Length,也会被保留。
输出:生成的XLD轮廓;

你可能感兴趣的:([Halcon算子]Halcon算子之XLD(一))