matchTemplates

abstract fun matchTemplates(srcPath: String, templatePath: String, similarity: Int?, limit: Int?, config: MatchTemplatesConfig.() -> Unit): Results<RegionResult>

在图像中查找匹配的模板(多目标支持)。

从源图像中搜索与模板图像相似的所有区域,返回按相似度降序排列的匹配结果。 适用于在大图中定位小图元素,如在界面截图中查找按钮、图标等。

Return

包含所有匹配区域的Results对象,每个结果包含区域坐标和相似度

Parameters

srcPath

源图像文件路径(大图),作为搜索范围

templatePath

模板图像文件路径(小图),作为搜索目标

similarity

匹配相似度阈值(0-100),值越高匹配要求越严格;null使用默认值

limit

最大返回结果数量,null表示无限制

config

配置构建器,用于设置高级匹配参数

See also

了解更多配置选项

Throws

当相似度超出范围、文件路径无效或图像无法解析时抛出