卡尺工具¶
功能描述¶
该步骤可用于沿狭长 ROI 垂直方向检测边缘点或边缘点对，并输出边缘点坐标及点对间距离（若检测的是边缘点对）。
使用场景¶
该步骤用于测量物体指定部分的宽度，或找出沿某一直线排布的边缘点，通常后接 将像素距离转换为实际距离 步骤，以得出实际宽度值。
输入与输出¶
参数说明¶
- ROI
- 参数解释：该参数用于指定检测边缘点或边缘点对的区域，并在该区域生成一个细长边缘检测框。调节建议：需在 测量模式 下框选 ROI，具体操作可参考 测量圆 。当图像质量较好时，可令 ROI 的 宽 为 1， 高 覆盖目标检测区域即可。
- 位置与朝向修正
- 参数解释：该参数用于转换 ROI 至合适位置。调节说明：若勾选该参数，则会根据输入的“2D 位姿”将此前运行时设置的 ROI 转换至合适位置。
- 灰度变化下限阈值
- 参数解释：该参数用于指定边缘检测框内点的灰度变化下限阈值。当该点的灰度变化高于此阈值时，则该点将被视为边缘点。默认值：20
- 高斯滤波系数
- 参数解释：高斯滤波的目的是剔除图像噪声，该参数用于设置边缘检测框在垂直方向上滤波的系数。默认值：1.0推荐值：1.0调节建议：若图像质量较好，使用默认值 1 即可；若图像质量较差，可适当调大此参数。
- 最大结果数
- 参数解释：该参数用于指定该步骤输出的边缘点或边缘点对的最大数量。
对于边缘点，灰度梯度较大的边缘点具有更高的输出优先级。
对于边缘点对，距离值与 边缘对期望距离 较近的边缘点对具有更高的输出优先级。
默认值：1调节建议：需根据实际需求设置该参数。 - 输出顺序
- 参数解释：该参数用于指定检测结果将以何种方式排序并输出。值列表：从上到下、从下到上、从中间到两边。
从上到下：越靠近 ROI 顶部的结果在输出列表中越靠前。
从下到上：越靠近 ROI 底部的结果在输出列表中越靠前。
从中间到两边：越靠近 ROI 中心的结果在输出列表中越靠前。
默认值：从上到下。 - 边缘类型
- 参数解释：该参数用于指定该步骤检测的边缘类型。值列表：单边缘、边缘对。
单边缘：仅检测单侧的边缘，然后输出单个边缘点的列表。
边缘对：检测两侧的边缘，然后输出两个边缘点列表，来表示各个点对。
默认值：单边缘。调节说明：具体效果见 调节示例 。提示
当边缘类型为 边缘对 时，既要设置 边缘极性 0 ，又要设置 边缘极性 1 和 边缘对期望距离 。
- 边缘极性 0
- 参数解释：边缘极性用于指定何种灰度变化的边缘会被视为物体边缘，该参数用于检测出单边缘点或边缘点对的单侧点。值列表：白到黑、黑到白、兼可。
白到黑：ROI 内由白到黑的灰度变化之处会被认为是物体边缘点。
黑到白：ROI 内由黑到白的灰度变化之处会被认为是物体边缘点。
兼可：ROI 内由黑到白或由白到黑的灰度变化之处会被认为是物体边缘点。
注解
灰度变化指 ROI 内由上往下的灰度变化。
默认值：白到黑。调节说明：具体效果见 调节示例 。 - 边缘极性 1
- 参数解释：边缘极性用于指定何种灰度变化的边缘会被视为物体边缘，该参数用于检测出边缘点对另一侧的点。当边缘类型为 边缘对 时，需设置该参数。值列表：同 边缘极性 0 。
- 边缘对期望距离
- 参数解释：该参数用于指定边缘点对间的期望距离（单位：像素）。默认值：10调节说明：当边缘点对的距离值越靠近该参数时，其输出优先级越高。
提示
设置 最大结果数 后，优先级较低的边缘点对可能会被忽略。
