Halcon XLD相关算子(一)

(1) read_contour_xld_dxf( : Contours : FileName, GenParamName, GenParamValue : DxfStatus)

功能：从DXF文件中读取XLD轮廓。

图形输出参数：Contours：读取的XLD轮廓；

控制输入参数：FileName：.dxf文件路径；

控制输入参数：GenParamName：可以为DXF输入调整的通用参数的名称，默认为[]；

控制输入参数：GenParamValue：可以为DXF输入调整的通用参数的值，默认为[]；

控制输出参数：DxfStatus：状态信息。

(2) get_shape_model_contours( : ModelContours : ModelID, Level : )

功能：在ModelContours中以XLD轮廓的形式返回形状模型ModelID的表示。

图形输出参数：ModelContours：返回形状模型的轮廓；

控制输入参数：ModelID：模型句柄；

控制输入参数：Level：返回其轮廓表示的金字塔等级。

(3) gen_contour_polygon_xld( : Contour : Row, Col : )

功能：由一个多边形的元组数据(由Row和Col表示)生成xld轮廓。

图形输出参数：Contour：生成的轮廓；

控制输入参数：Row：多边形的行坐标，默认值[0,1,2,2,2]；

控制输入参数：Col：多边形的纵坐标，默认值[0,0,0,1,2]。

(4) get_contour_xld(Contour : : : Row, Col)

功能：获取输入轮廓的横坐标和纵坐标。

图形输入参数：Contour：输入轮廓；

控制输出参数：Row：轮廓的横坐标返回值；

控制输出参数：Col：轮廓纵坐标返回值。

(5) gen_polygons_xld(Contours : Polygons : Type, Alpha : )

功能：通过多边形来近似描述XLD轮廓。  

图形输入参数：Contour：输入轮廓；

图形输出参数：Polygons：输出运算后近似的多边形；

控制输入参数：Type：多边形近似的类型，默认 'ramer'；

控制输入参数：Alpha：输入近似值的阈值，默认2.0，范围Alpha > 0.0。

(6) split_contours_xld(Polygons : Contours : Mode, Weight, Smooth : )

功能：根据特征点(控制点、突出点)分割轮廓，并用不同的颜色显示。

图形输入参数：Polygons：将要进行轮廓分割的多边形；

图形输出参数：Contours：分割后的轮廓；

控制输入参数：Mode：轮廓分割模式，默认值 'polygon'；

控制输入参数：Weight：灵敏度权重，默认值1；

控制输入参数：Smooth：平滑掩码的宽度，默认值5。

(7) gen_ellipse_contour_xld( : ContEllipse : Row, Column, Phi, Radius1, Radius2, StartPhi, EndPhi, PointOrder, Resolution : )

功能：创建一个或多个椭圆弧或闭合椭圆。

图形输出参数：ContEllipse：创建的椭圆；

控制输入参数：Row：椭圆中心的行坐标；

控制输入参数：Column：椭圆中心的列坐标；

控制输入参数：Phi：主轴方向；

控制输入参数：Radius1：椭圆的长半轴；

控制输入参数：Radius2：椭圆的短半轴；

控制输入参数：StartPhi：起点StartPhi的角度；

控制输入参数：EndPhi：终点EndPhi的角度；

控制输入参数：PointOrder：沿着边界的点顺序， 默认值'positive'；

控制输入参数：Resolution：相邻轮廓点之间的最大欧几里得距离，默认值1.5。

(8) gen_circle_contour_xld( : ContCircle : Row, Column, Radius, StartPhi, EndPhi, PointOrder, Resolution : )

功能：创建一个或多个圆弧或闭合圆。

图形输出参数：ContCircl：生成的圆弧或闭合圆；

控制输入参数：(Row, Column):圆弧或闭合圆的圆心坐标；

控制输入参数：Radius: 圆弧或闭合圆的半径；

控制输入参数：StartPhi: 圆弧或闭合圆的起始角度；

控制输入参数：EndPhi: 圆弧或闭合圆的终止角度；

控制输入参数：PointOrder:沿着圆或圆弧的点顺序；

控制输入参数：Resolution:相邻轮廓点之间的距离。

(9) shape_trans_xld(XLD : XLDTrans : Type : )

功能：将轮廓或多边形转换成参数类型所代表的图形(比如圆，平行于坐标轴的最小封闭矩形)。

说明：可以用来求取平行于坐标轴的最小封闭矩形左上或右下坐标。

图形输入参数：XLD：输入的轮廓或多边形；

图形输出参数：XLDTrans:变换后的输出图形；

控制输入参数：Type: 'convex'：凸包围；'ellipse'：椭圆；'outer_circle'：用最小封闭圆；

控制输入参数：Type: 'rectangle1'：用平行于坐标轴的最小封闭矩形；'rectangle2'：用最小封闭矩形。

(10) select_shape_xld(XLD : SelectedXLD : Features, Operation, Min, Max : )

功能：根据特征选择轮廓或多边形(筛选轮廓)。

图形输入参数：XLD:输入要检查的轮廓或多边形；

图形输出参数：SelectedXLD:输出满足条件的轮廓或多边形；

控制输入参数：Features：提取XLD的特征依据,'area', '轮廓面积;'contlength',轮廓线总长度；'row_points'：轮廓点重心的行索引；'column_points':轮廓点重心的列索引；

控制输入参数：Operation：特征之间的逻辑关系，默认  'and'，范围'and', 'or'；

控制输入参数：Min：特征值的要求范围，输入该特征的下限或最小值[0.0 ≤ Min ≤ 99999.0]；

控制输入参数：Max：特征值的要求范围，输入该特征的上限或最大值[Max >= Min]。

(11) smooth_contours_xld(Contours : SmoothedContours : NumRegrPoints : )

功能：平滑输入的xld轮廓，并在SmoothedContours中返回平滑后的轮廓。

图形输入参数：Contours:输入的轮廓；

图形输出参数：SmoothedContours：平滑后的轮廓；

控制输入参数：NumRegrPoints：用于计算回归线的点数。

(12) height_width_ratio_xld(XLD : : : Height, Width, Ratio)

功能：计算与轮廓或多边形的坐标轴相平行的封闭矩形的宽度、高度和纵横比。

图形输入参数：XLD:输入的轮廓或多边形；

控制输出参数：Height：轮廓或多边形最小外接矩形的高度；

控制输出参数：Width：轮廓或多边形最小外接矩形的宽度；

控制输出参数：Ratio：轮廓或多边形最小外接矩形的高宽比(纵横比)。