Appearance
2D图像模板匹配
算子功能
在目标图片中查找模板图像，输出它的中心坐标和外接正矩形参数
参数介绍
输入参数
| 参数 | 范围 | 默认值 | 说明 | 图示 |
|---|---|---|---|---|
| 输入图像 | 图像输入的IM编号 | |||
| 模板图像源 | 选择输入模板图像的方式，包括： IM编号：图像输入的IM编号 模板文件路径：图像输入的文件路径 |
计算参数
| 参数 | 范围 | 默认值 | 说明 | 图示 |
|---|---|---|---|---|
| 使用区域参数 | true/false | false | 启用则以区域作为输入，不启用则以输入图像作为输入 | |
| 区域 | 2D窗口 | 2D窗口 | 设置搜索区域的范围 | |
| 边缘亮度阈值 | Canny寻找边缘的参数，数值越大，过滤掉的细节越多 |  | ||
| 低阈值 | 0-255 | 50 | 弱边缘的阈值，影响边缘的保留 | |
| 高阈值 | 0-255 | 100 | 强边缘的阈值，影响边缘的确定 | |
| 匹配精度 | 0-2 | 0.8 | 越小匹配到的越精细 | |
| 匹配速度 | 慢速/中速/快速 | 中速 | 算法运行速度，速度越快精确度可能下降，包括： 慢速：不做特征金字塔 中速：金字塔level设置为2 快速：金字塔level设置为4 | |
| 缩小比例 | 0.5-1 | 1.000 | 目标轮廓面积相对于模板轮廓允许的缩小比例 | |
| 放大比例 | 1-1.5 | 1.000 | 目标轮廓面积相对于模板轮廓允许的放大比例 | |
| 负角度 | -180-0 | 0 | 训练模板时逆时针旋转的角度 | |
| 正角度 | 0-180 | 0 | 训练模板时顺时针旋转的角度 | |
| 得分筛选 | 0-1 | 0.900 | 目标轮廓形状相对于模板轮廓形状的差异，越小越好 | |
| 查找数量 | 1-500 | 5 | 查找目标模板的数量 |
结果显示
| 参数 | 范围 | 默认值 | 说明 | 图示 |
|---|---|---|---|---|
| 中心点 | true/false | false | 若启用，则将找到的目标中心点显示在IM图像 | |
| 外接矩形 | true/false | false | 若启用，则将找到的目标外接矩形显示在IM图像 | |
| 特征 | true/false | false | 若启用，则将找到的目标轮廓显示在IM图像 |
输出参数
| 名称 | 类型 | 范围 | 说明 |
|---|---|---|---|
| Result | bool | true/false | true为成功 false为失败 |
| Warning | bool | true/false | true表示有警告 false表示没有 |
| Message | string | 输出成功或错误或警告信息,如果没有错误或警告为空 | |
| Time | float | 算子执行时间，单位: ms | |
| point_array | point2d[] | 找到的目标中心点信息 | |
| rect_array | rect2d[] | 找到的目标矩形信息（中心点，大小，相对于模板图像的角度） |
异常排查
| 序号 | 异常信息 | 对应参数 | 解决方法 |
|---|---|---|---|
| 1 | 文件“{0}”不存在或无法访问 | 文件路径 | 创建该文件或更换到有读取权限的文件 |
| 2 | 文件“{0}”无法成功打开 | 文件路径 | 1.关闭占用文件的程序 2.检查磁盘是否正常 3.确保文件格式正确 |
| 3 | 输入的图像为空 | 检查模板图像是否为空 | |
| 4 | 减少得分 | 减少得分，目标得分过高了，把所有结果过滤掉了 | |
| 5 | 没有找到 | 调整精度和角度 | |
| 6 | 输入的值是{0t}，无效的区域类型 | 区域类型 | 只支持window2d |
示例介绍
工程设计
选择
加载图片工具，加载需要处理的2d图片到IM0。选择
2D模板创建工具，创建模板文件并输出模板图像到IM1选择
2D图像模板匹配工具
工具使用
选择输入图像IM0，模板图像源为图像寄存器，选择图像寄存器1即IM1
设置参数
在结果显示栏中勾选想要显示的内容
点击
测试，查看图像窗口和参数是否符合预期没有问题后点击
保存，在运行列表中运行该算子，即可在对应的IM查看运行结果
