输入参数 19
| 名称 | keyId | 类型 | 默认值 | 可连接 | 说明 |
|---|---|---|---|---|---|
| 图像 | images | vec_img | [] | 是 | 待搜索的图像序列，逐帧与模板比对；空帧原样透传，不参与匹配也不影响返回码 |
| 模板 | template | vec_img | [] | 是 | 用于比对的模板图像，只取第一帧；三通道图自动转为灰度，缺失或为空时返回失败 |
| 矩形ROI | roiRect | roi | [] | 否 | 矩形搜索区域，可与其他 ROI 条目合并；全部为空时按整幅图像作为搜索范围 |
| 圆ROI | roiCircle | roi | [] | 否 | 圆形搜索区域，与其他 ROI 条目一并参与搜索；全部为空时按整幅图像处理 |
| 椭圆ROI | roiEllipse | roi | [] | 否 | 椭圆搜索区域，与其他 ROI 条目一并参与搜索；全部为空时按整幅图像处理 |
| 多边形ROI | roiPolygon | roi | [] | 否 | 多边形搜索区域，与其他 ROI 条目一并参与搜索；全部为空时按整幅图像处理 |
| 模式 | mode | enum | 0 | 否 | 匹配所依据的图像形态，可选灰度相关或形状匹配；后者改用边缘图比对，各选项含义见释义 |
| 最小分数 | minScore | double | 0.5 | 否 | 接受匹配的最低归一化相关分数，取值越高结果越可靠但越容易漏检，低于该值的候选被丢弃 |
| 最大匹配数 | maxMatches | int | 1 | 否 | 最多保留的匹配结果数量，至少取 1；达到该数量后不再继续收集候选结果 |
| 角度范围低 | angleMin | double | -45 | 否 | 模板旋转搜索的最小角度，与角度范围高共同决定搜索区间；两端大小顺序会自动交换 |
| 角度范围高 | angleMax | double | 45 | 否 | 模板旋转搜索的最大角度，与角度范围低共同决定搜索区间；区间越大搜索耗时越长 |
| 缩放范围低 | scaleMin | double | 0.8 | 否 | 模板缩放搜索的最小比例，下限被限制为 0.05；小于 1 表示把模板缩小后比对 |
| 缩放范围高 | scaleMax | double | 1.2 | 否 | 模板缩放搜索的最大比例，与缩放范围低共同决定缩放区间；大于 1 表示把模板放大后比对 |
| 重叠抑制 | overlapSuppress | double | 0.8 | 否 | 结果去重的重叠率门槛，取值被限制在 0~1；两结果重叠率超过它时只保留分数更高者 |
| 排序方式 | sortBy | enum | 0 | 否 | 最终结果的输出顺序，可按分数或坐标排序；默认按分数降序，各选项含义见释义 |
| 极性 | polarity | enum | 0 | 否 | 参与匹配的明暗极性，决定使用原图、反相图还是两者都参与；各选项含义见释义 |
| 金字塔层 | pyramidLevels | int | 4 | 否 | 金字塔粗搜索的层数，取值被限制在 1~4；层数越多粗搜索图像越小、速度越快 |
| 边缘阈值 | edgeThreshold | int | 30 | 否 | 形状匹配模式下提取边缘的阈值，用于生成边缘图；灰度相关模式下该值不生效 |
| 超时(ms) | timeout | int | 0 | 否 | 单次运行的超时毫秒数，设为 0 表示不限时；超时后返回已收集到的部分匹配结果 |
输出参数 10
| 名称 | 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 | — | 否 | 各匹配结果的模板旋转角度，取自角度搜索区间并经过细化；单位为度 |
| 匹配分 | matchScore | vec_double | — | 否 | 各匹配结果的归一化相关分数，数值越高表示与模板越相似 |
| 匹配缩放 | matchScale | vec_double | — | 否 | 各匹配结果的模板缩放比例，取自缩放搜索区间；1.0 表示模板保持原始大小 |
| 匹配区域 | roiRectOut | roi | — | 否 | 匹配到的模板外接框，宽高已按缩放比例还原，可直接作为其他工具的 ROI 输入 |
接入方式
联系与反馈
获取安装包与技术反馈
安装包通过微信二维码获取。安装部署、界面组态与工具配置过程中的问题，可通过同一渠道反馈，无需注册或填写表单。
- 安装包获取与部署说明
- 界面组态与工具配置
- 功能建议与问题反馈
微信扫码 · 安装包与问题反馈