【halcon】Metrology工具系列之 set_metrology_object_param

set_metrology_object_param

名称

set_metrology_object_param — 为测量模型的测量对象设置参数。

签名

set_metrology_object_param( : : MetrologyHandle, Indices, GenParamName, GenParamValue : )

描述

set_metrology_object_param 用于设置或更改测量对象的不同参数（有关2D测量的基本原理，请参阅 create_metrology_model）。

测量模型由句柄 MetrologyHandle 定义。参数 Indices 指定要设置参数的测量对象。如果参数 Indices 设置为 ‘all’，则为所有测量对象设置参数。所有参数也可以在创建测量对象时设置，使用的是 add_metrology_object_circle_measure、add_metrology_object_ellipse_measure、add_metrology_object_line_measure 或 add_metrology_object_rectangle2_measure。测量模型的当前配置可以通过 get_metrology_object_param 访问。可以通过 set_metrology_object_param 设置的所有参数都可以使用 reset_metrology_object_param 重置。

以下列出了所有通用参数及其默认值。但请注意，对于许多应用，默认值已足够，无需调整。以下是 GenParamName 和 GenParamValue 可能的值 - 按不同类别排序：

创建测量区域：

• ‘measure_length1’：此参数的值指定与测量对象边界垂直的测量区域的半长度。等同于测量公差。该值的单位是像素。

  • 值列表：10.0, 20.0, 30.0
  • 默认值：20.0
  • 限制：‘measure_length1’ >= 1.0

• ‘measure_length2’：此参数的值指定与测量对象边界相切的测量区域的半长度。该值的单位是像素。

  • 值列表：3.0, 5.0, 10.0
  • 默认值：5.0
  • 限制：‘measure_length2’ >= 0.0

• ‘measure_distance’：此参数的值指定两个测量区域中心之间的期望距离。

  • 值列表：5.0, 15.0, 20.0, 30.0
  • 默认值：10.0

• ‘num_measures’：此参数的值指定期望的测量区域数量。

  • 值列表：8, 10, 16, 20, 30, 50, 100

边缘检测：

• ‘measure_sigma’

• ‘measure_threshold’

• ‘measure_select’ 这个可以选择某些点 frist 和 last

• ‘measure_transition’：该参数指定使用暗/亮或亮/暗边缘。

  • 值列表：‘all’, ‘negative’, ‘positive’, ‘uniform’
  • 默认值：‘all’

• ‘measure_interpolation’

拟合几何形状：

• ‘min_score’
• ‘num_instances’
• ‘max_num_iterations’
• ‘rand_seed’
• ‘instances_outside_measure_regions’

校准：

• ‘camera_param’
• ‘world_pose’

注意

测量模型 ‘MetrologyHandle’ 不能在两个或多个用户的线程之间共享。不同的测量模型可以独立且安全地在不同的线程中使用。

小结

我们在添加模型时可以设置一些参数。比如调用add_metrology_object_line_measure的时候。如果此时没有设置任何参数。
后面也可以通过set_metrology_object_param进行设置！