get_contour_global_attrib_xld — 返回 XLD 轮廓的全局属性值

算子 get_contour_global_attrib_xld

名称

get_contour_global_attrib_xld — 返回 XLD 轮廓的全局属性值。

签名

get_contour_global_attrib_xld(Contour : : Name : Attrib)

描述

get_contour_global_attrib_xld 算子将 XLD 轮廓 Contour 的全局属性 Name 的值返回到 Attrib 中。全局属性是为每个轮廓定义的附加值。可以使用 query_contour_global_attribs_xld 算子查询特定轮廓设置了哪些全局属性。

以下列表包含了不同的全局轮廓属性信息，以及将这些属性添加到 XLD 轮廓的算子：

• 'bright_dark'：每个输出的 XLD 轮廓的过渡类型存储在属性 'bright_dark' 中。如果连接线段形成从亮到暗的过渡（从起点到终点看，从左到右），则该属性设置为 1.0；否则设置为 0.0。

  添加 'bright_dark' 属性的算子：connect_grid_points。

  

  示例：沿校正网格边缘的 XLD 轮廓（红色和绿色，起点到终点的方向由箭头表示）。存储在属性 'bright_dark' 中的过渡类型，红色轮廓为 1.0，绿色轮廓为 0.0。

• 'cont_approx'：属性 'cont_approx' 表示近似轮廓的最佳方式：当 'cont_approx' = -1.0 时，轮廓最好用线段近似；当 'cont_approx' = 0.0 时，用椭圆弧近似；当 'cont_approx' = 1.0 时，用圆弧近似。

  添加 'cont_approx' 属性的算子：segment_contours_xld。

• 'is_hole'：对于包围孔洞的边界，全局轮廓属性 'is_hole' 设置为 1.0；否则设置为 0.0。

  添加 'is_hole' 属性的算子：symm_difference_closed_contours_xld、difference_closed_contours_xld、intersection_closed_contours_xld、union2_closed_contours_xld。

  

  对 XLD 轮廓或轮廓集应用不同的集合运算会将全局属性 'is_hole' 添加到结果轮廓中。在上面的示例中，对两组（红色和绿色）封闭轮廓执行不同的集合运算。如果结果边界包围了一个孔洞（蓝色轮廓），'is_hole' 设置为 1.0；否则 'is_hole' 的值为 0.0（橙色轮廓）。

• 'regr_dev_dist'：'regr_dev_dist'（单位：像素）表示轮廓点与回归线之间（欧几里得）距离的标准差（见下图）。 添加 'regr_dev_dist' 属性的算子：regress_contours_xld。

• 'regr_dist'：'regr_dist'（单位：像素）表示回归线到图像坐标系原点的最小距离（见下图）。 添加 'regr_dist' 属性的算子：regress_contours_xld。

• 'regr_mean_dist'：属性 'regr_mean_dist'（单位：像素）包含每个轮廓点与回归线之间欧几里得距离的平均值（见下图）。 添加 'regr_mean_dist' 属性的算子：regress_contours_xld。

• 'regr_norm_col'：'regr_norm_col'（单位：像素）是回归线单位法向量的列坐标，法向量从原点指向直线（见下图）。 添加 'regr_norm_col' 属性的算子：regress_contours_xld。

• 'regr_norm_row'：'regr_norm_row'（单位：像素）是回归线单位法向量的行坐标，法向量从原点指向直线（见下图）。 添加 'regr_norm_row' 属性的算子：regress_contours_xld。

  

XLD 轮廓（红色）回归的属性 'regr_dist'、'regr_norm_col'、'regr_norm_row' 示意图。'regr_mean_dist' 和 'regr_dev_dist' 是根据轮廓点与回归线（黑色实线）之间的距离（黑色箭头）计算得出的。

参数

输入参数

1. Contour (输入轮廓)

   • 类型：XLD 轮廓对象

   • 描述：待查询全局属性的输入轮廓。

2. Name (属性名称)

   • 类型：字符串

   • 默认值：'regr_norm_row'

   • 可选值：

     属性名	含义	生成该属性的算子
     'bright_dark'	亮暗过渡类型（1.0=亮到暗，0.0=暗到亮，沿起点到终点方向）	connect_grid_points
     'cont_approx'	最佳近似类型（-1.0=线段，0.0=椭圆弧，1.0=圆弧）	segment_contours_xld
     'is_hole'	孔洞标记（1.0=孔洞，0.0=非孔洞）	symm_difference_closed_contours_xld 等集合操作算子
     'regr_dev_dist'	轮廓点到回归线的距离标准差（像素）	regress_contours_xld
     'regr_dist'	回归线到图像原点的最小距离（像素）	regress_contours_xld
     'regr_mean_dist'	轮廓点到回归线的平均距离（像素）	regress_contours_xld
     'regr_norm_col'	回归线单位法向量的列分量（从原点指向回归线）	regress_contours_xld
     'regr_norm_row'	回归线单位法向量的行分量（从原点指向回归线）	regress_contours_xld

输出参数

1. Attrib (属性值)

   • 类型：实数

   • 描述：单个全局属性值（若轮廓为数组，返回每个轮廓的属性值数组）。

可能的前置算子

lines_gauss、lines_facet、edges_sub_pix、segment_contours_xld

可能的后续算子

fit_circle_contour_xld、fit_ellipse_contour_xld、fit_line_contour_xld、fit_rectangle2_contour_xld

相关算子

query_contour_global_attribs_xld、get_contour_attrib_xld、query_contour_attribs_xld