查找图片 - FindImageFromPath

函数简介

在指定图片中查找指定图像，源图与模板均通过文件路径指定，返回第一个匹配结果。

接口名称

FindImageFromPath

DLL调用

long FindImageFromPath(long instance, string source, string templ, string deltaColor, double matchVal, int dir);

参数说明

参数名	类型	说明
instance	长整数型	OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
source	字符串	源图片的路径
templ	字符串	模板图片的路径，可以是多个图片，如"test.bmp|test2.bmp|test3.bmp"
deltaColor	字符串	颜色差值，格式为"RRGGBB"，如"101010"
matchVal	双精度浮点数	相似度，如0.85，最大为1
dir	整数型	查找方向：0-从左到右从上到下；1-从左到右从下到上；2-从右到左从上到下；3-从右到左从下到上；4-从中心往外查找；5-从上到下从左到右；6-从上到下从右到左；7-从下到上从左到右；8-从下到上从右到左

示例

C++

long instance = CreateCOLAPlugInterFace();
// 从源图中查找模板，颜色差值101010，从左上到右下查找
long resultPtr = FindImageFromPath(instance, "source.bmp", "templ.bmp", "101010", 0.85, 0);
char* result = GetStringFromPtr(instance, resultPtr);
FreeStringPtr(instance, resultPtr);

Python

# 待补充

返回值

字符串指针，返回JSON格式的匹配结果。DLL调用返回字符串指针地址，需要调用 FreeStringPtr 接口释放内存。

返回数据格式：

{
    "MatchVal": 0.85,
    "MatchState": true,
    "Index": 0,
    "X": 100,
    "Y": 200,
    "Width": 100,
    "Height": 100
}

字段名	类型	说明
MatchVal	浮点数	匹配相似度。
MatchState	布尔	是否匹配成功。
Index	整数	结果索引（从 0 开始）。
X	整数	X 坐标。
Y	整数	Y 坐标。
Width	整数	宽度。
Height	整数	高度。