定位

矩形查找

在 ROI 内用边缘轮廓与多边形逼近查找四顶点矩形，按宽高范围筛选后输出中心、尺寸与旋转角度
RectangleFinder · v1.0 · by system

输入参数 11

名称	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 边缘检测的高阈值，低阈值自动取它的一半；取值越大只保留越强的边缘，过大易漏检弱轮廓
逼近精度	`approxEpsilon`	double	0.02	否	多边形逼近精度，按轮廓周长的比例取逼近步长；值越小越贴合原始轮廓，越大越容易把顶点压到 4 个
宽范围低	`minWidth`	int	10	否	允许的最小矩形宽度（像素），拟合宽度小于该值的候选矩形会被剔除
宽范围高	`maxWidth`	int	1000	否	允许的最大矩形宽度（像素），拟合宽度大于该值的候选矩形会被剔除
高范围低	`minHeight`	int	10	否	允许的最小矩形高度（像素），拟合高度小于该值的候选矩形会被剔除
高范围高	`maxHeight`	int	1000	否	允许的最大矩形高度（像素），拟合高度大于该值的候选矩形会被剔除

输出参数 10

名称	keyId	类型	默认值	可连接	说明
运行结果	`resultCode`	int	—	否	0=成功，逐帧输出带矩形框的标注图及中心、宽高、角度与矩形区域；-1=输入帧容器缺失或处理抛出 OpenCV 异常、内存不足，此时不产出图像
运行信息	`resultInfo`	string	—	否	成功时固定为 Success；失败时给出具体原因（输入图像为空、OpenCV 处理异常或处理失败），用于定位连线与参数配置
图像	`images`	vec_img	—	否	逐帧输出绘有绿色旋转矩形框的标注图，帧数与输入一致；空帧原样透传，不参与检测
矩形数	`rectCount`	int	—	否	本次累计检出的矩形总数，跨所有帧与所有 ROI 累加，空帧不计入该计数
中心X	`centerX`	vec_double	—	否	各检出矩形中心的 X 坐标数组，相对整幅图，与矩形数量一一对应
中心Y	`centerY`	vec_double	—	否	各检出矩形中心的 Y 坐标数组，相对整幅图，与矩形数量一一对应
宽度	`width`	vec_double	—	否	各检出矩形的拟合宽度数组，取自最小外接旋转矩形，单位为像素
高度	`height`	vec_double	—	否	各检出矩形的拟合高度数组，取自最小外接旋转矩形，单位为像素
角度	`angle`	vec_double	—	否	各检出矩形的旋转角度数组，照实保留最小外接矩形给出的角度值
矩形区域	`roiRectOut`	roi	—	否	各检出矩形的轴对齐外接框，格式 [0,x,y,w,h,角度]，可直接作为下游矩形 ROI 输入

接入方式

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

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

← 卡尺工具返回定位四边形查找 →

联系与反馈

获取安装包与技术反馈

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

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

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