定位

四边形查找

在 ROI 内用轮廓逼近找出四边形，输出中心、宽高、倾角与顶点区域，用于外框定位
QuadFinder · v1.0 · by system

名称	keyId	类型	默认值	可连接	说明
图像	`images`	vec_img	[]	是	待查找四边形的输入图像序列，逐帧在各 ROI 内提取轮廓；空帧原样透传，不参与检测也不报错
矩形ROI	`roiRect`	roi	[]	否	矩形 ROI 条目数组，限定轮廓查找范围；绘制后自动写回，未设置时退化为整幅图像
圆ROI	`roiCircle`	roi	[]	否	圆形 ROI 条目数组，限定轮廓查找范围；与矩形等 ROI 一并合并，未设置时用整幅图像
椭圆ROI	`roiEllipse`	roi	[]	否	椭圆 ROI 条目数组，限定轮廓查找范围；按外接框裁剪子图，未设置时用整幅图像
多边形ROI	`roiPolygon`	roi	[]	否	多边形 ROI 条目数组，限定轮廓查找范围；与其余 ROI 合并处理，未设置时用整幅图像
边缘阈值	`edgeThreshold`	int	50	否	Canny 边缘检测的高阈值，默认 50，低阈值取其一半；决定能检出多细的轮廓边缘
逼近精度	`approxEpsilon`	double	0.02	否	多边形逼近精度，按轮廓周长的比例计算，默认 0.02；值越大越容易把轮廓简化成四边形
面积范围低	`minArea`	double	100	否	四边形轮廓允许的最小面积，默认 100 平方像素；低于该值的轮廓直接丢弃
面积范围高	`maxArea`	double	100000	否	四边形轮廓允许的最大面积，默认 100000 平方像素；超过该值的轮廓直接丢弃

名称	keyId	类型	默认值	可连接	说明
运行结果	`resultCode`	int	—	否	0=成功，已输出四边形几何参数与标注图像；-1=输入图像容器缺失或处理抛错，此时不产出结果
运行信息	`resultInfo`	string	—	否	成功时固定为 Success；失败时给出具体原因（输入图像为空或 OpenCV 处理异常），便于排查连线
图像	`images`	vec_img	—	否	逐帧输出绘有四边形轮廓的标注图像，帧数与输入一致，空帧原样透传
四边形数	`quadCount`	int	—	否	所有帧累计检出的四边形数量，与各几何向量长度一致，未检出时为 0
中心X	`centerX`	vec_double	—	否	每个四边形最小外接矩形中心的 X 坐标，已换算回整幅图像坐标系
中心Y	`centerY`	vec_double	—	否	每个四边形最小外接矩形中心的 Y 坐标，已换算回整幅图像坐标系
宽度	`width`	vec_double	—	否	每个四边形最小外接矩形的宽度，按检出顺序与中心、角度等向量逐项对应
高度	`height`	vec_double	—	否	每个四边形最小外接矩形的高度，按检出顺序与中心、角度等向量逐项对应
角度	`angle`	vec_double	—	否	每个四边形最小外接矩形的旋转角度，单位为度，与其余几何向量逐项对应
四边形区域	`roiPolygonOut`	roi	—	否	找到的四边形顶点序列，格式为 [4,x1,y1,x2,y2,x3,y3,x4,y4]，可直接作为 ROI 输入

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

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

联系与反馈

获取安装包与技术反馈

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

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