定位

灰度匹配

用归一化相关法在图像中查找与灰度模板最相似的位置，输出匹配中心、分数与模板外接框
GrayMatch · v1.0 · by system

名称	keyId	类型	默认值	可连接	说明
图像	`images`	vec_img	[]	是	待搜索的图像序列，逐帧与灰度模板做相关匹配；空帧原样透传且不报错
模板	`template`	vec_img	[]	是	用于比对的灰度模板，只取第一帧；三通道图自动转灰度，缺失或为空时返回失败
矩形ROI	`roiRect`	roi	[]	否	矩形搜索区域，可与其他 ROI 条目合并；全部为空时按整幅图像作为搜索范围
圆ROI	`roiCircle`	roi	[]	否	圆形搜索区域，与其他 ROI 条目一并参与搜索；全部为空时按整幅图像处理
椭圆ROI	`roiEllipse`	roi	[]	否	椭圆搜索区域，与其他 ROI 条目一并参与搜索；全部为空时按整幅图像处理
多边形ROI	`roiPolygon`	roi	[]	否	多边形搜索区域，与其他 ROI 条目一并参与搜索；全部为空时按整幅图像处理
最小分数	`minScore`	double	0.5	否	接受匹配的最低归一化相关分数，取值越高结果越可靠但越容易漏检，低于该值的峰值被跳过
最大匹配数	`maxMatches`	int	1	否	每个搜索区域内最多保留的匹配数，上限为 1000；达到上限或分数不足时停止查找

名称	keyId	类型	默认值	可连接	说明
运行结果	`resultCode`	int	—	否	0=成功并输出匹配结果；-1=模板图像缺失或为空、输入图像容器缺失，或处理过程异常，此时不产出匹配
运行信息	`resultInfo`	string	—	否	成功时固定为 Success；失败时给出具体原因，如模板图像为空或处理异常，便于排查连线与参数
图像	`images`	vec_img	—	否	逐帧输出绘制了匹配框的彩色图像，帧数与输入一致；空帧原样透传
匹配数	`matchCount`	int	—	否	全部搜索区域内保留的匹配结果总数；没有合格目标时该值为 0
匹配X	`matchX`	vec_double	—	否	各匹配结果中心的 X 坐标，采用整图坐标系，与匹配 Y 按序一一对应
匹配Y	`matchY`	vec_double	—	否	各匹配结果中心的 Y 坐标，采用整图坐标系，顺序与匹配 X 保持一致
匹配角度	`matchAngle`	vec_double	—	否	各匹配结果的旋转角度，固定为 0，因为该工具不做旋转匹配
匹配分	`matchScore`	vec_double	—	否	各匹配结果的归一化相关分数，数值越高表示与模板越相似
匹配区域	`roiRectOut`	roi	—	否	匹配到的模板外接框，尺寸与模板一致且无旋转，可直接作为其他工具的 ROI 输入

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

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

联系与反馈

获取安装包与技术反馈

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

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