【halcon】Metrology工具系列之 get_metrology_object_result_contour

get_metrology_object_result_contour (操作员)

名称

get_metrology_object_result_contour — 查询测量对象的结果轮廓。

签名

get_metrology_object_result_contour( : Contour : MetrologyHandle, Index, Instance, Resolution : )

描述

get_metrology_object_result_contour 返回所选测量对象和对象实例的测量结果轮廓，这些轮廓是在图像坐标中由 apply_metrology_model 执行的测量结果。

测量模型由句柄 MetrologyHandle 定义。参数 Index 指定查询哪些测量对象的结果轮廓。对于 Index 设置为 ‘all’，返回所有测量对象的结果轮廓。如果为一个测量对象计算了多个结果（实例），则参数 Instance 指定在 Contour 中返回哪些实例的结果轮廓。通过将 Instance 设置为 ‘all’ 来获得所有实例的结果轮廓。

结果轮廓 Contour 的分辨率通过 Resolution 控制，Resolution 包含相邻轮廓点之间的欧几里得距离（以像素为单位）。如果输入值低于最小可能值（1.192e-7），则分辨率在内部设置为最小有效值。

执行信息

多线程类型：可重入（与非独占操作员并行运行）。
多线程范围：全局（可以从任何线程调用）。
未并行处理。

参数

• Contour (output_object)
  xld_cont(-array) → object
  给定测量对象的结果轮廓。

• MetrologyHandle (input_control)
  metrology_model → (handle)
  测量模型的句柄。

• Index (input_control)
  integer(-array) → (integer / string)
  测量对象的索引。

  默认值：0

  建议值：‘all’, 0, 1, 2

• Instance (input_control)
  integer(-array) → (string / integer)
  测量对象的实例。

  默认值：‘all’

  建议值：‘all’, 0, 1, 2

• Resolution (input_control)
  real → (real)
  相邻轮廓点之间的距离。

  默认值：1.5

  限制：Resolution >= 1.192e-7

结果

如果参数有效，操作员 get_metrology_object_result_contour 返回值 TRUE。如有必要，会抛出异常。

可能的前驱

apply_metrology_model

另见

get_metrology_object_result, get_metrology_object_measures

小结

显示拟合后的轮廓！