跳到主要内容

霍夫检测

用于从边缘图中检测圆和线段。

霍夫圆检测​

HoughCircles · 可执行

使用霍夫梯度法检测图像中的圆形。

签名​

var houghCircles = HoughCircles(dp: 1, minDist: 10, param1: 100, param2: 20, minRadius: 0, maxRadius: 0);

输入​

inputImage
  • 输入
  • 必填
  • 约束 必须是非空 8-bit 图像。允许 1、3 或 4 通道;彩色图像会先转为灰度。
输入图像,由视觉图连接提供。

参数​

dpdouble
  • 输入
  • 可选
  • 默认 1
  • 约束 范围为 0.1–100。
累加器分辨率与图像分辨率的反比。
minDistdouble
  • 输入
  • 可选
  • 默认 10
  • 约束 必须大于或等于 1 且有限。
检测到的圆心之间的最小距离。
param1double
  • 输入
  • 可选
  • 默认 100
  • 约束 必须大于或等于 1 且有限。
Canny 边缘检测高阈值。
param2double
  • 输入
  • 可选
  • 默认 20
  • 约束 必须大于或等于 1 且有限。
累加器阈值(越小检测到越多假圆)。
minRadiusint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0–32768。
最小圆半径。
maxRadiusint
  • 输入
  • 可选
  • 默认 0
  • 约束 范围为 0–32768。不能小于 minRadius。
最大圆半径(0 表示无限制)。

输出​

imageImage
BGR8 圆形叠加图像。
countdouble
检测到的圆数量。

行为​

  • 特征族分派器先转灰度,再做核边长 5 的中值模糊,然后按霍夫梯度法检测圆。
  • 圆心与半径以绿色圆叠加到 BGR 输出;量测键为 {nodeId}.count。
  • maxRadius 为 0 表示不限制最大半径;若 maxRadius 非 0 且小于 minRadius,执行失败。
  • 取消令牌在绘制每个圆之前被检查。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:dp、minDist、param1、param2、minRadius 或 maxRadius 越出特征族合同范围。
  • 节点参数 maxRadius 非 0 且小于 minRadius 时抛出参数异常,不输出假圆。

示例​

用执行器默认阈值检测圆

var houghCircles = HoughCircles(dp: 1, minDist: 10, param1: 100, param2: 20, minRadius: 0, maxRadius: 0);

霍夫线段检测​

HoughLines · 可执行

使用概率霍夫变换检测图像中的直线段。

签名​

var houghLines = HoughLines(threshold: 30, minLineLength: 10, maxLineGap: 5);

输入​

inputImage
  • 输入
  • 必填
  • 约束 必须是非空 8-bit 图像。允许 1、3 或 4 通道;检测前会转为灰度并提取边缘。
输入图像,由视觉图连接提供。

参数​

thresholdint
  • 输入
  • 可选
  • 默认 30
  • 约束 范围为 1–2147483647。
累加器阈值。
minLineLengthdouble
  • 输入
  • 可选
  • 默认 10
  • 约束 必须大于或等于 0 且有限。
最小线段长度。
maxLineGapdouble
  • 输入
  • 可选
  • 默认 5
  • 约束 必须大于或等于 0 且有限。
同一直线上点之间的最大间隙。

输出​

imageImage
BGR8 线段叠加图像。
countdouble
检测到的线段数量。

行为​

  • 特征族分派器先转灰度,再以固定 Canny(50, 150) 提边缘,然后调用概率霍夫变换。
  • 线段以绿色叠加到 BGR 输出;量测键为 {nodeId}.count。
  • 霍夫距离分辨率为 1 像素,角度分辨率为 π/180。
  • 取消令牌在绘制每条线段之前被检查。

错误与限制​

  • VISION_PIPELINE_PARAMETER_RANGE:threshold、minLineLength 或 maxLineGap 越出特征族合同范围。

示例​

用执行器默认投票阈值检测线段

var houghLines = HoughLines(threshold: 30, minLineLength: 10, maxLineGap: 5);