定位

圆查找

在 ROI 内用霍夫圆或轮廓拟合查找圆形目标，输出圆心、半径与拟合分数
CircleFinder · v1.0 · by system

输入参数 10

名称	keyId	类型	默认值	可连接	说明
图像	`images`	vec_img	[]	是	待检测的图像序列，逐帧在 ROI 内查找圆形目标；空帧或无法转灰度的帧原样透传
矩形ROI	`roiRect`	roi	[]	否	矩形 ROI 条目集合，以其外接框裁出子图做圆检测；多个条目逐一处理并累加检出结果
圆ROI	`roiCircle`	roi	[]	否	圆形 ROI 条目集合，按外接框裁剪子图后查找圆，可与矩形 ROI 同时存在并一并生效
椭圆ROI	`roiEllipse`	roi	[]	否	椭圆 ROI 条目集合，按外接矩形裁剪子图后做圆检测，留空时不额外限定检测范围
多边形ROI	`roiPolygon`	roi	[]	否	多边形 ROI 条目集合，按外接矩形裁剪后查找圆，与其余形状的 ROI 合并为同一批检测区域
方法	`method`	enum	0	否	选择霍夫圆变换还是轮廓椭圆拟合来找圆，决定半径约束方式与拟合分数的计算口径
最小半径	`minRadius`	int	10	否	允许检出的最小圆半径，小于该值的候选圆会被丢弃；两种查找方法都会按半径范围过滤
最大半径	`maxRadius`	int	500	否	允许检出的最大圆半径，大于该值的候选圆被丢弃；应与视野内目标的最大直径相匹配
最小距离	`minDist`	int	50	否	霍夫圆模式下相邻两圆圆心之间的最小距离，用于抑制同一目标被重复检出；仅在霍夫圆模式生效
边缘阈值	`edgeThreshold`	int	100	否	Canny 边缘检测的高阈值，低阈值取其一半，同时作为霍夫圆累加前的梯度阈值；调高会减少弱边缘圆

输出参数 9

名称	keyId	类型	默认值	可连接	说明
运行结果	`resultCode`	int	—	否	0=成功并输出圆心、半径与分数；-1=输入帧容器缺失或处理抛错（ROI 越界、内存不足），不产出结果
运行信息	`resultInfo`	string	—	否	成功时固定为 Success；失败时携带具体原因（输入图像为空、OpenCV 处理异常或处理失败），帮助核对圆检测的上游输出与参数
图像	`images`	vec_img	—	否	逐帧输出在灰度底图上以绿色圆圈标出所检出圆的显示图，帧数与输入一致，空帧或无法转灰度的帧原样透传
圆数量	`circleCount`	int	—	否	跨所有输入帧累计检出的圆总数，没有任何圆满足半径与分数条件时为 0
圆心X	`centerX`	vec_double	—	否	各检出圆圆心的 X 坐标数组，已换算为整幅图的全局坐标
圆心Y	`centerY`	vec_double	—	否	各检出圆圆心的 Y 坐标数组，已换算为整幅图的全局坐标，与 centerX 一一对应
半径	`radius`	vec_double	—	否	各检出圆的半径数组，以像素为单位，与圆心数组按同一顺序排列
分数	`score`	vec_double	—	否	各检出圆的拟合分数数组，霍夫圆模式下为圆周落在边缘上的比例，轮廓拟合模式下为轮廓点贴合圆的比例
圆区域	`roiCircleOut`	roi	—	否	以 [1,cx,cy,r] 形式给出的检出圆几何条目，可直接接到下游工具当作圆 ROI 输入

接入方式

在 FlowDesigner 中将「圆查找」节点加入流程画布，把上游图像或数据连接至「图像」，并将「运行结果」接至下游节点。运行后可通过 VisionQuick 的数据绑定将结果呈现在界面组件上。

完整操作步骤参见使用文档；安装与使用问题可通过联系页反馈。

← 直线查找返回定位图案定位 →

联系与反馈

获取安装包与技术反馈

安装包通过微信二维码获取。安装部署、界面组态与工具配置过程中的问题，可通过同一渠道反馈，无需注册或填写表单。

安装包获取与部署说明
界面组态与工具配置
功能建议与问题反馈

微信扫码 · 安装包与问题反馈