全局模型灰度匹配

## 全局模型灰度匹配

![](/media/202606/2026-06-22_140358_2071620.896272828598038.png)基于模板图像的轮廓特征信息寻找相似的图形区域。

### 模块原理
基于模板图像的轮廓特征信息寻找相似的图形区域, 与灰度匹配不同的是，使用了全局模型。

### 使用场景
查找拥有一定轮廓特征的物体, 可以节省一些重复模型的内存，可以重复使用某种模型，需要结合主界面右侧全局模型界面使用

### 使用方法

#### 前后序模块
一般结合相机采图模块、匹配模型树界面使用

### 参数配置说明
#### 匹配模型树

![](/media/202606/2026-06-22_140639_1840650.3234790306116424.png)
先在匹配模型树中新增一个模型

![](/media/202606/2026-06-22_140748_1150050.23541217878145582.png)

#### 基本参数

![](/media/202606/2026-06-22_140926_9098900.8251293319647477.png)

![](/media/202606/2026-06-22_141811_1154580.14199161509351244.png)

“模型选择”处选择刚才新增的全局模型，勾选“读写”，点击新增按钮新增子模型

【模型选择】选择匹配模型树中的模型
【读写】勾选后，可修改选择的模型，若此模块只是使用模型而不需要修改，则不要勾选此项
【新增、删除、清空、复制模型四个按钮】可新增、删除、清空、复制匹配模型树中的子模型数量
【模型编辑】编辑左侧列表中选中的子模型

![](/media/202606/2026-06-22_142942_9422220.11208871610386562.png)
点击"新增模型"或"编辑模型"后进入模型编辑界面

【更新图像】点击后，会将此模块的图像输入端口读取到界面上，在点击生成模型后将模板图像切换为当前图像，需要切换模型图像时需点击此按钮
【位置调整】指定调整模型roi位置，用于更精细的roi调整
【生成模型】点击后，根据当前图像和参数，生成新的模型

【基准点】基准点用于为特征匹配过程提供一个固定的参考点， 下方五个图标依次为新增、删除、上移、下移、清空基准点

![](/media/202606/2026-06-22_114308_8938590.18169767932598047.png)
【启用掩膜】勾选启用掩膜后，可以编辑掩膜参数。 掩膜参数核心作用是精准控制匹配区域，用于限定特征检测与匹配的有效区域，它是一种空间约束工具，允许用户指定图像中哪些区域参与特征提取与匹配，哪些区域被忽略。

【掩盖所有】整个图像都添加上掩膜
【擦除所有】擦除掉所有掩膜

【手动】通过画笔、橡皮擦等，手动绘制、擦除所需掩膜

【掩膜画笔】画笔：根据绘制添加掩膜；
【画笔尺寸】选择画笔和橡皮擦的直径大小
【掩膜擦除】类似于橡皮擦，根据绘制擦除掩膜

![](/media/202606/2026-06-22_114400_7020800.06248495809866539.png)
【自动】根据条件自动进行掩膜添加
【自动阈值】将符合的根据颜色快速添加上掩膜
【灰度阈值】和自动阈值参数配合使用，符合灰度范围和自动阈值时快速添加上掩膜。例如自动掩膜选择阈值中间时，符合灰度阈值范围之内的将会加上掩膜。

![](/media/202606/2026-06-22_114510_2738410.15158734895105763.png)
【掩膜形状】根据所选形状的roi快速添加掩膜，
【掩膜形状】矩形、圆形等不同的roi形状
【添加】点击后，根据roi生成掩膜
【位置调整】调整roi的位置

![](/media/202606/2026-06-22_114552_0037110.3942013221155676.png)

【掩膜处理】根据所选掩膜处理进行添加
【滤波尺寸】滤波尺寸

![](/media/202606/2026-06-22_171611_7152980.3213447977264019.png)
【匹配度】模板与搜索图像中目标的相似程度，搜索到的目标在相似度大于设置值时才会被搜索到，默认为0.7。
【搜索角度】输入最小和最大搜索角度，在这个角度范围内的目标才能匹配到，范围从-180~180。
【显示设置】ROI区域，图形结果，掩膜显示等显示设置，包括是否显示，颜色选择，字体大小等。
【搜索数量】待查找目标的最大搜索数量。

【位置调整】调整ROI的位置及大小。

#### ROI设置

![](/media/202606/2026-06-22_171727_9479760.9814079710649608.png)
【ROI类型】默认检测区域的ROI类型为斜矩形。
【ROI来源】手动ROI：可在窗口手动拖动ROI的位置及大小；引用ROI:可在端口连接外部ROI。
【位置修正】选择姿态修正后可连接坐标系使ROI区域跟随坐标系移动。

#### 高级参数

![](/media/202606/2026-06-22_171952_1395950.4036261161317717.png)

![](/media/202606/2026-06-22_172016_4001580.8974650238271052.png)
【最大重叠率】当搜索多个目标时，两个被检测目标彼此重合时，两者匹配框所被允许的最大重叠比例。 值越大则允许两目标重叠的程度就越大。
【排序标准】按标准对匹配到的结果进行排序
【排序间隔】排序的间隔

### 输出说明

![](/media/202606/2026-06-22_172301_3677790.07109382943732279.png)
【运行结果】匹配到目标，输出为真，否则为假
【目标个数】匹配到的目标个数
【匹配度】匹配结果对应的匹配度值
【角度偏移】匹配结果的角度
【位置偏移】匹配结果相对于模板的位置偏移
【检测角度】匹配结果的角度
【检测位置】匹配结果对应的检测位置
【输出坐标系】匹配结果的坐标系，以检测位置和检测角度构造的坐标系
【匹配度数组】匹配结果对应的匹配度值数组，数组大小与匹配目标个数相同
【检测点数组】匹配结果对应的检测位置数组，数组大小与匹配目标个数相同
【检测角度数组】匹配结果对应的检测角度数组，数组大小与匹配目标个数相同
【基准点数组】根据检测位置生成的偏移后的基准点数组，数组大小与模型编辑添加的基准点数量有关，若未添加基准点，则此选项无效
【正矩形ROI】此模块的roi绘制成的矩形边框
【掩膜区域】此模块编辑的掩膜区域

点击此处跳转到对应的中文说明书文章页:&nbsp;[Feature Matching](/doc/413)