定位

图案定位

用固定的十字或矩形模板在 ROI 内做归一化相关匹配，定位规则图案并输出匹配中心与分数
PatternLocate · 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 合并为同一批搜索区域
图案类型	`patternType`	enum	0	否	选择用十字还是矩形作为预定义匹配模板，两种模板都是固定的 64×64 图案，决定要找的目标形状
最小分数	`minScore`	double	0.5	否	归一化相关系数的最低匹配分数，响应峰值低于该值即停止搜索；取值越高条件越严、误报越少
最大匹配数	`maxMatches`	int	1	否	单帧最多输出的匹配个数，达到上限或峰值低于最小分数即停止；整体上限不超过 100

名称	keyId	类型	默认值	可连接	说明
运行结果	`resultCode`	int	—	否	0=成功并输出各匹配点与分数；-1=输入帧容器缺失或处理抛错（模板匹配异常、内存不足），不产出结果
运行信息	`resultInfo`	string	—	否	成功时固定为 Success；失败时给出具体原因（输入图像为空、OpenCV 处理异常或处理失败），便于排查图案匹配的数据流与配置
图像	`images`	vec_img	—	否	逐帧输出在灰度底图上以红色十字标记各匹配中心的显示图，帧数与输入一致，空帧或无法转灰度的帧原样透传
匹配数	`matchCount`	int	—	否	跨所有输入帧累计输出的匹配总数，没有达到分数阈值的目标时为 0
匹配X	`matchX`	vec_double	—	否	各匹配中心的 X 坐标数组，为模板中心换算到整幅图的全局坐标
匹配Y	`matchY`	vec_double	—	否	各匹配中心的 Y 坐标数组，为模板中心换算到整幅图的全局坐标，与 matchX 一一对应
匹配角度	`matchAngle`	vec_double	—	否	各匹配的角度数组，当前固定输出 0，表示模板不做旋转匹配
匹配分	`matchScore`	vec_double	—	否	各匹配的归一化相关系数分数数组，取值越接近 1 表示与预定义图案越相似
匹配区域	`roiRectOut`	roi	—	否	以 [0,x,y,w,h,angle] 形式给出的匹配外接框几何条目，可直接接到下游工具当作矩形 ROI 输入

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

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

联系与反馈

获取安装包与技术反馈

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

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