定位

椭圆查找

在 ROI 内用轮廓拟合椭圆，输出中心、长短半轴、角度与贴合分数，可按点数与面积过滤
EllipseFinder · v1.0 · by system

输入参数 8

名称	keyId	类型	默认值	可连接	说明
图像	`images`	vec_img	[]	是	待拟合椭圆的图像序列，逐帧独立处理；空帧或无法转成 8 位灰度的帧原样透传
矩形ROI	`roiRect`	roi	[]	否	矩形 ROI 条目数组，把每帧检测限定在指定矩形范围内；多个条目分别裁剪处理
圆ROI	`roiCircle`	roi	[]	否	圆形 ROI 条目数组，按圆心与半径换算成外接正方形后裁剪检测；多个条目分别处理
椭圆ROI	`roiEllipse`	roi	[]	否	椭圆 ROI 条目数组，按椭圆的投影外接矩形裁剪检测，旋转椭圆取真实外接框
多边形ROI	`roiPolygon`	roi	[]	否	多边形 ROI 条目数组，按所有顶点的最小外接矩形裁剪检测；多个条目分别处理
边缘阈值	`edgeThreshold`	int	50	否	Canny 边缘检测的高阈值，低阈值自动取其一半；影响椭圆边缘轮廓能否被完整检出
最小点数	`minPoints`	int	5	否	拟合椭圆所需的最少轮廓点数，实际下限为 5；点数不足的轮廓会被跳过
过滤面积	`minArea`	double	10	否	允许的最小轮廓面积，面积的绝对值小于该值的轮廓不参与椭圆拟合

输出参数 11

名称	keyId	类型	默认值	可连接	说明
运行结果	`resultCode`	int	—	否	0=成功，逐帧输出绘有椭圆的标注图及各几何量与分数；-1=输入帧容器缺失或处理抛出 OpenCV 异常、内存不足，此时不产出图像
运行信息	`resultInfo`	string	—	否	成功时固定为 Success；失败时给出具体原因（输入图像为空、OpenCV 处理异常或处理失败），用于定位连线与参数配置
图像	`images`	vec_img	—	否	逐帧输出绘有绿色椭圆曲线的标注图，帧数与输入一致；空帧原样透传
椭圆数	`ellipseCount`	int	—	否	本次累计拟合出的椭圆总数，跨所有帧与所有 ROI 累加，空帧不计入
中心X	`centerX`	vec_double	—	否	各拟合椭圆中心的 X 坐标数组，相对整幅图，与椭圆数量一一对应
中心Y	`centerY`	vec_double	—	否	各拟合椭圆中心的 Y 坐标数组，相对整幅图，与椭圆数量一一对应
长轴	`semiMajor`	vec_double	—	否	各椭圆的长半轴数组，工具保证长半轴始终不小于短半轴
短轴	`semiMinor`	vec_double	—	否	各椭圆的短半轴数组，与长半轴配套，角度已换算到 0~180 度
角度	`angle`	vec_double	—	否	各椭圆长轴的旋转角度数组，已归一化到 0~180 度区间
分数	`score`	vec_double	—	否	各椭圆的贴合分数，取落在拟合椭圆容差内的轮廓点比例，范围 0~1
椭圆区域	`roiEllipseOut`	roi	—	否	各拟合椭圆的几何描述，格式 [3,cx,cy,长半轴,短半轴,角度]，可直接作为下游椭圆 ROI 输入

接入方式

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

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

返回定位模板匹配 →

联系与反馈

获取安装包与技术反馈

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

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

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