图色函数

设置

image.setInitParam 初始化参数

设置图色模块初始化参数
@param params 参数待定

function main() {
    image.setInitParam({});
}

main();

image.useOpencvMat 初始化参数

切换图片存储模式为opencv的mat格式
适合EC iOS 4.6.0+
切换后抓图、读取图片、找图、找色等都会切换到mat格式，速度更快内存更少
实测内存减少50%-80%，CPU减少20%-30%，速度提升100%-200%
如果让图片格式切换请参考 imageToMatFormat和matToImageFormat两个函数
@param use 1 是 0 否
@return {boolean|*} true 成功 false 失败

function main() {
    let r = image.useOpencvMat(1);
    logd(r)
    //剩下的代码和之前一样 找色 找图等操作
}

main();

普通截图 jpg

image.captureFullScreenEx 截取全屏Image对象

抓取全屏，格式是JPG
@param ext 扩展参数，可以调整截图的方式和质量，可以分别是
fetchImageMode: 1 代表截图 jpg格式的方式1 2 代表截图 jpg格式方式2 3代表png格式，png不支持质量参数，根据自己机器情况调用
fetchImageQuality: 图片质量，fetchImageMode =1的时候，支持 1， 50， 100，三种不同的质量标准
当 fetchImageMode =2 的时候，支持1-100图片质量
@return {null|AutoImage}

function main() {
    logd("isServiceOk " + isServiceOk());
    startEnv()
    logd("isServiceOk " + isServiceOk());
    for (let i = 0; i < 10; i++) {
        console.time(1)
        let cap = image.captureFullScreenEx({"fetchImageMode": "1", "fetchImageQuality": 50})
        logd("截图数据: " + cap + "  耗时: " + console.timeEnd(1))
        image.saveTo(cap, "b.jpg");
        sleep(1000)
        //图片要回收
        image.recycle(cap)
    }
}

image.captureFullScreen 截取全屏Image对象

截取当前屏幕并返回一个Image对象, 这个格式是jpg。
@return AutoImage对象或者null

function main() {
    logd("isServiceOk " + isServiceOk());
    startEnv()
    logd("isServiceOk " + isServiceOk());
    for (let i = 0; i < 10; i++) {
        let cap = image.captureFullScreen()
        logd("截图数据: " + cap)
        sleep(1000)
        //图片要回收
        image.recycle(cap)
    }
}

main();

image.captureFullScreenUIImage 截屏UIImage对象

截屏UIImage对象
适配EC 4.2.0+
@param ext 扩展参数，可以调整截图的方式和质量，可以分别是
type: 1 代表截图 jpg格式的方式1
2 代表截图 jpg格式方式 2
3 代表png格式，png不支持质量参数，根据自己机器情况调用
quality: 图片质量，type=1的时候，支持 1， 50， 100，三种不同的质量标准
当type =2 的时候，支持1-100图片质量
@return swift中的UIImage对象或者null

function main() {
    logd("isServiceOk " + isServiceOk());
    startEnv()
    logd("isServiceOk " + isServiceOk());
    setComputeMode(1)
    let img1 = image.captureFullScreen();
    logd(img1)

    // 测试1
    let uiimage = image.autoImageToUIImage(img1)
    logd("autoImageToUIImage uiimage " + uiimage)
    let x = pluginLoader.callMethodAny(name, clzName, "testMethod", uiimage)
    logd(x)
    image.recycle(img1)


    let img2 = image.captureFullScreenUIImage({})
    let xX = pluginLoader.callMethodAny(name, clzName, "testMethod", img2)
    logd(xX)


    let au = image.uiimageToAutoImage(uiimage)
    logd("au " + au)

    // 保存到文件中
    image.saveTo(au, file.getSandBoxFilePath("a.jpg"))
    image.recycle(au)
    image.recycle(img2)
}

main();

比色

image.cmpColor 多点比色

单点或者多点比色，找到所有符合标准的点，如果都符合返回true，否则是false
@param image1 图片
@param points 字符串类似这样 6|1|0x969696-0x000010,1|12|0x969696,-4|0|0x969696
@param threshold 找色时颜色相似度取值为 0.0 ~ 1.0
@param x 区域的X起始坐标，默认填写0全屏查找
@param y 区域的Y起始坐标，默认填写0全屏查找
@param ex 终点X坐标，默认填写0全屏查找
@param ey 终点Y坐标，默认填写0全屏查找
@return 布尔型，true代表找到了 false代表未找到

function main() {
    let req = startEnv();
    if (!req) {
        logd("申请权限失败");
        return;
    }
    let aimage = image.captureFullScreen();
    if (aimage != null) {
        let points3 = "205|1130|0xff944b-0x101010,211|1158|0xff8e42,191|1175|0xfcfbf7";
        let points = image.cmpColor(aimage, points3, 0.9, 0, 0, 0, 0);
        logd("points " + points);
        //图片要回收
        image.recycle(aimage)
    }

}

main();

image.cmpColorJ 多点比色(JSON)

单点或者多点比色，找到所有符合标准的点，如果都符合返回true，否则是false
@param image1 图片
@param jsonFileName 使用图色工具生成JSON文件,存储到res文件夹中,例如 a.json
@return {boolean} true代表找到了 false代表未找到

function main() {
    let req = startEnv();
    if (!req) {
        logd("申请权限失败");
        return;
    }
    let aimage = image.captureFullScreen();
    if (aimage != null) {
        let points = image.cmpColorJ(aimage, "a.json");
        logd("points " + points);
        //图片要回收
        image.recycle(aimage)
    }
}

main();

image.cmpColorEx 多点比色扩展

单点或者多点比色，找到所有符合标准的点，自动截图，如果都符合返回true，否则是false
@param points 字符串类似这样 6|1|0x969696-0x000010,1|12|0x969696,-4|0|0x969696
@param threshold 找色时颜色相似度取值为 0.0 ~ 1.0
@param x 区域的X起始坐标，默认填写0全屏查找
@param y 区域的Y起始坐标，默认填写0全屏查找
@param ex 终点X坐标，默认填写0全屏查找
@param ey 终点Y坐标，默认填写0全屏查找
@return 布尔型，true代表找到了 false代表未找到

function main() {
    let req = startEnv();
    if (!req) {
        logd("申请权限失败");
        return;
    }
    let points3 = "205|1130|0xff944b-0x101010,211|1158|0xff8e42,191|1175|0xfcfbf7";
    let points = image.cmpColorEx(points3, 0.9, 0, 0, 0, 0);
    logd("points " + points);

}

main();

image.cmpMultiColor 多组比色

多点或者多点数组比色，找到所有符合标准的点，依次查找，如果找到就返回当前points的索引值，如果返回-1，说明都没有找到
@param image1 图片
@param points 数组类似这样 ["6|1|0x969696-0x000010,1|12|0x969696,-4|0|0x969696","6|1|0x969696"]
@param threshold 找色时颜色相似度取值为 0.0 ~ 1.0
@param x 区域的X起始坐标，默认填写0全屏查找
@param y 区域的Y起始坐标，默认填写0全屏查找
@param ex 终点X坐标，默认填写0全屏查找
@param ey 终点Y坐标，默认填写0全屏查找
@return 整型，如果找到就返回当前points的索引值，如果返回-1，说明都没有找到

function main() {
    let req = startEnv();
    if (!req) {
        logd("申请权限失败");
        return;
    }
    let aimage = image.captureFullScreen();
    if (aimage != null) {
        let points1 = "205|112230|0xff944b,211|1158|0xff8e42,191|1175|0xfcfbf7";
        let points2 = "205|113022|0xff944b,211|1158|0xff8e42,191|1175|0xfcfbf7";
        let points3 = "205|1130|0xff944b,211|1158|0xff8e42,191|1175|0xfcfbf7";
        let points = image.cmpMultiColor(aimage, [points1, points2, points3], 0.9, 0, 0, 0, 0);
        logd("points " + points);
        //图片要回收
        image.recycle(aimage)
    }
}

main();

image.cmpMultiColorJ 多组比色(JSON)

多点或者多点数组比色，找到所有符合标准的点，依次查找，如果找到就返回当前points的索引值，如果返回-1，说明都没有找到
运行环境: 无限制
@param image1 图片
@param jsonFileName 使用图色工具生成JSON文件,存储到res文件夹中,例如 a.json
@return {boolean} true代表找到了 false代表未找到

function main() {
    let req = startEnv();
    if (!req) {
        logd("申请权限失败");
        return;
    }
    let aimage = image.captureFullScreen();
    if (aimage != null) {
        let points = image.cmpMultiColorJ(aimage, "a.json");
        logd("points " + points);
        //图片要回收
        image.recycle(aimage)
    }
}

main();

image.cmpMultiColorEx 多组比色扩展

多点或者多点数组比色，找到所有符合标准的点，自动截屏，依次查找，如果找到就返回当前points的索引值，如果返回-1，说明都没有找到
@param points 数组类似这样 ["6|1|0x969696-0x000010,1|12|0x969696,-4|0|0x969696","6|1|0x969696"]
@param threshold 找色时颜色相似度取值为 0.0 ~ 1.0
@param x 区域的X起始坐标，默认填写0全屏查找
@param y 区域的Y起始坐标，默认填写0全屏查找
@param ex 终点X坐标，默认填写0全屏查找
@param ey 终点Y坐标，默认填写0全屏查找
@return 整型，如果找到就返回当前points的索引值，如果返回-1，说明都没有找到

function main() {
    let req = startEnv();
    if (!req) {
        logd("申请权限失败");
        return;
    }
    let points1 = "205|112230|0xff944b,211|1158|0xff8e42,191|1175|0xfcfbf7";
    let points2 = "205|113022|0xff944b,211|1158|0xff8e42,191|1175|0xfcfbf7";
    let points3 = "205|1130|0xff944b,211|1158|0xff8e42,191|1175|0xfcfbf7";
    let points = image.cmpMultiColorEx([points1, points2, points3], 0.9, 0, 0, 0, 0);
    logd("points " + points);
}

main();

找色

image.findColor 单点找色

在图片中找到颜色和color完全相等的某个点，并返回该点的坐标；如果没有找到，则返回null。
@param image 图片
@param color 要寻找的颜色类似， 0xCDD7E9-0x101010,0xCDD7E9-0x101010
@param threshold 找色时颜色相似度取值为 0.0 ~ 1.0
@param x 区域的X起始坐标
@param y 区域的Y起始坐标
@param ex 终点X坐标
@param ey 终点Y坐标
@param limit 限制个数
@param orz 方向，分别从1-8
@return 多个Point 坐标点数组或者null

function main() {
    let req = startEnv();
    if (!req) {
        logd("申请权限失败");
        return;
    }
    let aimage = image.captureFullScreen();
    if (aimage != null) {
        let points = image.findColor(aimage, "0xCDD7E9-0x101010,0xCDD7E9-0x101010", 0.9, 0, 0, 0, 0, 10, 1);
        logd("points " + JSON.stringify(points));
        //这玩意是个数组
        if (points) {
            for (let i = 0; i < points.length; i++) {
                logd(JSON.stringify(points[i]), points[i].x, points[i].y)
                //点击坐标
                clickPoint(points[i].x, points[i].y)
            }
        }
        //图片要回收
        image.recycle(aimage)
    }

}

main();

image.findColorJ 单点找色(JSON)

在图片中找到颜色和color完全相等的点，参数从JSON中获取如果没有找到，则返回null。
@param image 图片
@param jsonFileName 使用图色工具生成JSON文件,存储到res文件夹中,例如 a.json
@return {null|PointIndex[]} 坐标点数组或者null

function main() {
    let req = startEnv();
    if (!req) {
        logd("申请权限失败");
        return;
    }
    let aimage = image.captureFullScreen();
    if (aimage != null) {
        let points = image.findColorJ(aimage, "金币.json");
        logd("points " + JSON.stringify(points));
        //这玩意是个数组
        if (points && points.length > 0) {
            for (let i = 0; i < points.length; i++) {
                logd(JSON.stringify(points[i]), points[i].x, points[i].y)
                //点击坐标
                clickPoint(points[i].x, points[i].y)
            }
        }
        //图片要回收
        image.recycle(aimage)
    }

}

main();

image.findColorEx 自动截屏单点找色

在当前屏幕中找到颜色和color完全相等的点，并返回该点的坐标；如果没有找到，则返回null。
@param color 要寻找的颜色
@param threshold 找色时颜色相似度取值为 0.0 ~ 1.0
@param x 区域的X起始坐标
@param y 区域的Y起始坐标
@param ex 终点X坐标
@param ey 终点Y坐标
@param limit 限制个数
@param orz 方向，分别从1-8
@return 多个Point 坐标点数组或者null

function main() {
    let req = startEnv();
    if (!req) {
        logd("申请权限失败");
        return;
    }
    let points = image.findColorEx("0xCDD7E9-0x101010,0xCDD7E9-0x101010", 0.9, 0, 0, 0, 0, 10, 1);
    logd("points " + JSON.stringify(points));
    //这玩意是个数组
    if (points && points.length > 0) {
        for (let i = 0; i < points.length; i++) {
            logd(JSON.stringify(points[i]), points[i].x, points[i].y)
            //点击坐标
            clickPoint(points[i].x, points[i].y)
        }
    }

}

main();

image.findMultiColor 多点找色

多点找色，找到所有符合标准的点，类似于按键精灵的多点找色。
@param image 要找色的图片
@param firstColor 第一个点的颜色
@param threshold 找色时颜色相似度取值为 0.0 ~ 1.0
@param points 字符串类似这样 6|1|0x969696-0x000010,1|12|0x969696,-4|0|0x969696
@param x 区域的X起始坐标
@param y 区域的Y起始坐标
@param ex 终点X坐标
@param ey 终点Y坐标
@param limit 限制个数
@param orz 方向，分别从1-8
@return 多个Point 坐标点数组或者null

function main() {
    let req = startEnv();
    if (!req) {
        logd("申请权限失败");
        return;
    }

    let aimage = image.captureFullScreen();
    if (aimage != null) {
        let points = image.findMultiColor(aimage, "0xDD7A5F-0x101010", "29|25|0xBB454B-0x101010,58|44|0xA6363A-0x101010", 0.9, 0, 0, 0, 0, 10, 1);
        logd("points " + JSON.stringify(points));
        //这玩意是个数组
        if (points && points.length > 0) {
            for (let i = 0; i < points.length; i++) {
                logd(points[i], points[i].x, points[i].y)
                //点击坐标
                clickPoint(points[i].x, points[i].y)
            }
        }
        //图片要回收
        image.recycle(aimage)
    }

}

main();

image.findMultiColorJ 多点找色(JSON)

多点找色，找到所有符合标准的点，参数从JSON文件中读取，类似于按键精灵的多点找色
整张图片都找不到时返回null
@param image1 要找色的图片
@param jsonFileName 使用图色工具生成JSON文件,存储到res文件夹中,例如 a.json
@return {null|Point[]} 坐标点数组或者null

function main() {
    let req = startEnv();
    if (!req) {
        logd("申请权限失败");
        return;
    }

    let aimage = image.captureFullScreen();
    if (aimage != null) {
        let points = image.findMultiColorJ(aimage, "金币.json");
        logd("points " + JSON.stringify(points));
        //这玩意是个数组
        if (points && points.length > 0) {
            for (let i = 0; i < points.length; i++) {
                logd(points[i], points[i].x, points[i].y)
                //点击坐标
                clickPoint(points[i].x, points[i].y)
            }
        }
        //图片要回收
        image.recycle(aimage)
    }

}

main();

image.findMultiColorEx 自动截屏多点找色

多点找色，找到所有符合标准的点，类似于按键精灵的多点找色。
@param firstColor 第一个点的颜色
@param threshold 找色时颜色相似度取值为 0.0 ~ 1.0
@param points 字符串类似这样 6|1|0x969696-0x000010,1|12|0x969696,-4|0|0x969696
@param x 区域的X起始坐标
@param y 区域的Y起始坐标
@param ex 终点X坐标
@param ey 终点Y坐标
@param limit 限制个数
@param orz 方向，分别从1-8
@return 多个Point 坐标点数组或者null

function main() {
    let req = startEnv();
    if (!req) {
        logd("申请权限失败");
        return;
    }

    let points = image.findMultiColorEx("0xDD7A5F-0x101010", "29|25|0xBB454B-0x101010,58|44|0xA6363A-0x101010", 0.9, 0, 0, 0, 0, 10, 1);
    logd("points " + JSON.stringify(points));
    //这玩意是个数组
    if (points && points.length > 0) {
        for (let i = 0; i < points.length; i++) {
            logd(points[i], points[i].x, points[i].y)
            //点击坐标
            clickPoint(points[i].x, points[i].y)
        }
    }


}

main();

找非色

image.findNotColor 找非色

在图片中找到颜色和color完全不相等的点，如果没有找到，则返回null。
适配EC 脱机版本3.10.0+
@param image 图片
@param color 要寻找的颜色类似， 0xCDD7E9-0x101010,0xCDD7E9-0x101010,EC 工具生成
@param threshold 找色时颜色相似度取值为 0.0 ~ 1.0
@param x 区域的X起始坐标
@param y 区域的Y起始坐标
@param ex 终点X坐标
@param ey 终点Y坐标
@param limit 限制个数
@param orz 方向，分别从1-8
@return 多个 PointIndex 坐标点数组或者null

function main() {
    let req = startEnv();
    if (!req) {
        logd("申请权限失败");
        return;
    }

    let aimage = image.captureFullScreen();
    if (aimage != null) {
        let points = image.findNotColor(aimage, "0xCDD7E9-0x101010,0xCDD7E9-0x101010", 0.9, 0, 0, 0, 0, 10, 1);
        logd("points " + JSON.stringify(points));
        //这玩意是个数组
        if (points) {
            for (let i = 0; i < points.length; i++) {
                logd(JSON.stringify(points[i]), points[i].x, points[i].y)
                //点击坐标
                clickPoint(points[i].x, points[i].y)
            }
        }
        //图片要回收
        image.recycle(aimage)
    }

}

main();

image.findNotColorJ 找非色(JSON)

在图片中找到颜色和color完全不相等的点，如果没有找到，则返回null。
@param image1 图片
@param jsonFileName 使用图色工具生成JSON文件,存储到res文件夹中,例如 a.json
@return {null|PointIndex[]} 多个 PointIndex 坐标点数组或者null

function main() {
    let req = startEnv();
    if (!req) {
        logd("申请权限失败");
        return;
    }

    let aimage = image.captureFullScreen();
    if (aimage != null) {
        let points = image.findNotColorJ(aimage, "a.json");
        logd("points " + JSON.stringify(points));
        //这玩意是个数组
        if (points) {
            for (let i = 0; i < points.length; i++) {
                logd(JSON.stringify(points[i]), points[i].x, points[i].y)
                //点击坐标
                clickPoint(points[i].x, points[i].y)
            }
        }
        //图片要回收
        image.recycle(aimage)
    }

}

main();

找图

image.findImageByColor 透明找图

透明找图（这个函数不需要初始化Opencv）
@param image 大图片
@param template 小图片（模板）
@param x 找图区域 x 起始坐标
@param y 找图区域 y 起始坐标
@param ex 终点X坐标
@param ey 终点Y坐标
@param threshold 图片相似度。取值范围为0~1的浮点数。默认值为0.9。
@param limit 限制结果的数量，如果要找到1个，就填写1，如果是多个请填写多个
@return 多个Point 坐标点数组或者null

function main() {
    //从工程目录下res文件夹下读取sms.png文件
    let sms = readResAutoImage("sms.png");
    //抓取屏幕
    let aimage = image.captureFullScreen();
    logd("aimage " + aimage);
    if (aimage != null) {
        //在图片中查找
        let points = image.findImageByColor(aimage, sms, 0, 0, 0, 0, 0.8, 5);
        logd("points " + JSON.stringify(points));
        //这玩意是个数组
        if (points && points.length > 0) {
            for (let i = 0; i < points.length; i++) {
                logd(points[i])
                let x = points[i].x
                let y = points[i].y
                //点击坐标
                clickPoint(x, y)
            }
        }
        //图片要回收
        image.recycle(aimage)
    }
    //图片要回收
    image.recycle(sms)
}

main();

image.findImageByColorJ 透明找图(JSON)

通过颜色找图，支持透明图，这个不需要处理话opencv
整张图片都找不到时返回null
@param image1 大图片
@param jsonFileName 使用图色工具生成JSON文件,存储到res文件夹中,例如 a.json, 小图路径请到json文件配置
@return {null|Point[]} 坐标点数组或者null

function main() {
    //抓取屏幕
    let aimage = image.captureFullScreen();
    if (aimage != null) {
        //在图片中查找
        let points = image.findImageByColorJ(aimage, "a.json");
        logd("points " + JSON.stringify(points));
        //这玩意是个数组
        if (points && points.length > 0) {
            for (let i = 0; i < points.length; i++) {
                logd(points[i])
                let x = points[i].x
                let y = points[i].y
                //点击坐标
                clickPoint(x, y)
            }
        }
        image.recycle(aimage)
    }
}

main();

image.findImageByColorEx 透明找图扩展

通过颜色找图，支持透明图，这个不需要处理话opencv
整张图片都找不到时返回null
@param image1 大图片
@param template 小图片（模板）
@param x 找图区域 x 起始坐标
@param y 找图区域 y 起始坐标
@param ex 终点X坐标
@param ey 终点Y坐标
@param limit 限制结果的数量，如果要找到1个，就填写1，如果是多个请填写多个
@param extra 扩展函数，map结构例如

{"firstColorOffset":"#101010","firstColorThreshold":1.0,"otherColorOffset":"#101010","otherColorThreshold":0.9,"cmpColorSucThreshold":1.0}

firstColorOffset: 第一个匹配到的颜色偏色,例如 #101010
firstColorThreshold: 第一个匹配到的颜色偏色系数，例如 0.9
otherColorOffset: 剩下需要找的颜色偏色,例如 #101010
otherColorThreshold: 剩下需要找的颜色偏色系数，例如 0.9
cmpColorSucThreshold: 成功匹配多少个颜色系数就认为是成功的，例如 0.9 = 90%个点
startX: 第一个点从哪里开始找的X坐标
startY: 第一个点从哪里开始找的Y坐标
@return 多个Point 坐标点数组或者null

function main() {

    let d = startEnv();
    logd("启动服务--{}", d)
    let smallTmplate = readResAutoImage("tmp4.png");

    for (let i = 0; i < 100; i++) {
        sleep(1000)
        let img = image.captureFullScreen();
        logd("img = {}", img)
        if (img == null) {
            continue
        }
        console.time(1)
        let extra = {
            "firstColorOffset": "#202020",
            "otherColorOffset": "#000000",
            "cmpColorSucThreshold": 1,
            "firstColorThreshold": "1",
            "otherColorThreshold": "1",
            "startX": 0,
            "startY": 0
        }
        let points = image.findImageByColorEx(img, smallTmplate, 0, 0, 0, 0, 100, extra);
        logd("time-{}", console.timeEnd(1))
        //这玩意是个数组
        if (points) {
            logd("points " + JSON.stringify(points));
        }

        image.recycle(img)

    }

    image.recycle(smallTmplate)
}
main()

image.findImageByColorExJ 透明找图扩展(JSON)

通过颜色找图，支持透明图，这个不需要处理话opencv
整张图片都找不到时返回null
@param image1 大图片
@param jsonFileName 使用图色工具生成JSON文件,存储到res文件夹中,例如 a.json, 小图路径请到json文件配置
@return {null|Point[]} 坐标点数组或者null

function main() {
    //抓取屏幕
    let aimage = image.captureFullScreen();
    logd("aimage " + aimage);
    if (aimage != null) {
        //在图片中查找
        let points = image.findImageByColorExJ(aimage, "a.json");
        logd("points " + JSON.stringify(points));
        //这玩意是个数组
        if (points && points.length > 0) {
            for (let i = 0; i < points.length; i++) {
                logd(points[i])
                let x = points[i].x
                let y = points[i].y
                //点击坐标
                clickPoint(x, y)
            }
        }
        image.recycle(aimage)
    }
}

main();

image.findImage OpenCv找图

找图。在大图片image中查找小图片template的位置（模块匹配），找到时返回位置坐标区域(Rect)，找不到时返回null。
EC 脱机 4.5.0+
@param image1 大图片
@param template 小图片（模板）
@param x 找图区域 x 起始坐标
@param y 找图区域 y 起始坐标
@param ex 终点X坐标
@param ey 终点Y坐标
@param weakThreshold 图片相似度。取值范围为0~1的浮点数。默认值为0.9。
@param threshold 图片相似度。取值范围为0~1的浮点数。默认值为0.9。
@param limit 限制结果的数量，如果要找到1个，就填写1，如果是多个请填写多个
@param method 0: TM_SQDIFF平方差匹配法,1: TM_SQDIFF_NORMED归一化平方差匹配方法,2: TM_CCORR相关匹配法,3: TM_CCORR_NORMED归一化相关匹配法,4: TM_CCOEFF系数匹配法,5: TM_CCOEFF_NORMED归一化系数匹配法
@return Rect 区域坐标对象数组或者null

function main() {
    let req = startEnv();
    if (!req) {
        logd("申请权限失败");
        return;
    }
    //从工程目录下res文件夹下读取sms.png文件
    let sms = readResAutoImage("sms.png");
    //抓取屏幕
    let aimage = image.captureFullScreen();
    logd("aimage " + aimage);
    if (aimage != null) {
        //在图片中查找
        let points = image.findImage(aimage, sms, 0, 0, 0, 0, 0.7, 0.9, 1, 5);
        logd("points " + JSON.stringify(points));
        //这玩意是个数组
        if (points && points.length > 0) {
            for (let i = 0; i < points.length; i++) {
                logd(points[i])
                let x = parseInt((points[i].left + points[i].right) / 2)
                let y = parseInt((points[i].top + points[i].bottom) / 2)
                //点击坐标
                clickPoint(x, y)
            }
        }
        //图片要回收
        image.recycle(aimage)
    }
    //图片要回收
    image.recycle(sms)
}

main();

image.findImageJ 找图(JSON)

找图。在大图片image中查找小图片template的位置（模块匹配），找到时返回位置坐标区域(Rect)，找不到时返回null。
@param image1 大图片
@param jsonFileName 使用图色工具生成JSON文件,存储到res文件夹中,例如 a.json, 小图路径请到json文件配置
@return {null|Rect[]} 区域坐标对象数组或者null

function main() {
    let req = startEnv();
    if (!req) {
        logd("申请权限失败");
        return;
    }
    //抓取屏幕
    let aimage = image.captureFullScreen();
    logd("aimage " + aimage);
    if (aimage != null) {
        //在图片中查找
        let points = image.findImageJ(aimage, "a.json");
        logd("points " + JSON.stringify(points));
        //这玩意是个数组
        if (points && points.length > 0) {
            for (let i = 0; i < points.length; i++) {
                logd(points[i])
                logd("相似度: " + points[i]['similarity'])
                let x = parseInt((points[i].left + points[i].right) / 2)
                let y = parseInt((points[i].top + points[i].bottom) / 2)
                //点击坐标
                clickPoint(x, y)
            }
        }
        //图片要回收
        image.recycle(aimage)
    }
}

main();

image.findImageEx OpenCv自动截屏找图

找图。在当前屏幕中查找小图片template的位置（模块匹配），找到时返回位置坐标区域(Rect)，找不到时返回null。
EC 脱机 4.5.0+
@param template 小图片（模板）
@param x 找图区域 x 起始坐标
@param y 找图区域 y 起始坐标
@param ex 终点X坐标
@param ey 终点Y坐标
@param weakThreshold 图片相似度。取值范围为0~1的浮点数。默认值为0.9。
@param threshold 图片相似度。取值范围为0~1的浮点数。默认值为0.9。
@param limit 限制结果的数量，如果要找到1个，就填写1，如果是多个请填写多个
@param method 0: TM_SQDIFF平方差匹配法,1: TM_SQDIFF_NORMED归一化平方差匹配方法,2: TM_CCORR相关匹配法,3: TM_CCORR_NORMED归一化相关匹配法,4: TM_CCOEFF系数匹配法,5: TM_CCOEFF_NORMED归一化系数匹配法
@return Rect 区域坐标对象数组或者null

function main() {
    let req = startEnv();
    if (!req) {
        logd("申请权限失败");
        return;
    }
    //从工程目录下res文件夹下读取sms.png文件
    let sms = readResAutoImage("sms.png");
    //在当前屏幕中查找，并且限制只查找一个
    let points = image.findImageEx(sms, 0, 0, 0, 0, 0.7, 0.9, 1, 5);
    logd("points " + JSON.stringify(points));
    //这玩意是个数组
    if (points && points.length > 0) {
        for (let i = 0; i < points.length; i++) {
            logd(points[i])
            let x = parseInt((points[i].left + points[i].right) / 2)
            let y = parseInt((points[i].top + points[i].bottom) / 2)
            //点击坐标
            clickPoint(x, y)
        }
    }
    //图片要回收
    image.recycle(sms)
}

main();

image.matchTemplate OpenCV图片模板匹配

OpenCV模板匹配封装
EC 脱机 4.5.0+
@param image1 大图片
@param template 小图片（模板）
@param weakThreshold 图片相似度。取值范围为0~1的浮点数。默认值为0.9。
@param threshold 图片相似度。取值范围为0~1的浮点数。默认值为0.9。
@param rect 找图区域。参见findColor函数关于 rect 的说明
@param maxLevel 默认为-1，一般而言不必修改此参数。不加此参数时该参数会根据图片大小自动调整。找图算法是采用图像金字塔进行的, level参数表示金字塔的层次,
level越大可能带来越高的找图效率，但也可能造成找图失败（图片因过度缩小而无法分辨）或返回错误位置。因此，除非您清楚该参数的意义并需要进行性能调优，否则不需要用到该参数。
@param limit 限制结果的数量，如果要找到1个，就填写1，如果是多个请填写多个
@param method 0: TM_SQDIFF平方差匹配法,1: TM_SQDIFF_NORMED归一化平方差匹配方法,2: TM_CCORR相关匹配法,3: TM_CCORR_NORMED归一化相关匹配法,4: TM_CCOEFF系数匹配法,5: TM_CCOEFF_NORMED归一化系数匹配法
@return Match集合 匹配到的集合

function main() {
    let req = startEnv();
    if (!req) {
        logd("申请权限失败");
        return;
    }
    let aimage = image.captureFullScreen();
    if (aimage != null) {
        let temp = readResAutoImage("tmp.png");
        let rectp = new Rect();
        rectp.left = 0;
        rectp.top = 0;
        rectp.right = 0
        rectp.bottom = 0
        let matchs = image.matchTemplate(aimage, temp, 0.7, 0.9, rectp, -1, 10, 5);
        //这玩意是个数组
        logd(JSON.stringify(matchs));
        //这玩意是个数组
        if (matchs) {
            for (let i = 0; i < matchs.length; i++) {
                logd(JSON.stringify(matchs[i]));
            }
        }
        //图片要回收
        image.recycle(aimage)
        //图片要回收
        image.recycle(temp)
    }
}

main();

image.matchTemplateJ 图片模板匹配(JSON)

OpenCV模板匹配封装
@param image1 大图片
@param jsonFileName 使用图色工具生成JSON文件,存储到res文件夹中,例如 a.json, 小图路径请到json文件配置
@return {null|Match[]} 匹配到的集合

function main() {
    let aimage = image.captureFullScreen();
    if (aimage != null) {
        let matchs = image.matchTemplateJ(aimage, "a.json");
        //这玩意是个数组
        logd(JSON.stringify(matchs));
        //这玩意是个数组
        if (matchs && matchs.length > 0) {
            for (let i = 0; i < matchs.length; i++) {
                logd(JSON.stringify(matchs[i]));
                clickPoint(matchs[i].x, matchs[i].y)
            }
        }
        //图片要回收
        image.recycle(aimage)
    }
}

main();

image.matchTemplateEx OpenCV图片模板匹配

OpenCV 模板匹配封装，在当前屏幕截图中进行匹配
EC 脱机 4.5.0+
@param template 小图片（模板）
@param weakThreshold 图片相似度。取值范围为0~1的浮点数。默认值为0.9。
@param threshold 图片相似度。取值范围为0~1的浮点数。默认值为0.9。
@param rect 找图区域。参见findColor函数关于 rect 的说明
@param maxLevel 默认为-1，一般而言不必修改此参数。不加此参数时该参数会根据图片大小自动调整。找图算法是采用图像金字塔进行的, level参数表示金字塔的层次,
level越大可能带来越高的找图效率，但也可能造成找图失败（图片因过度缩小而无法分辨）或返回错误位置。因此，除非您清楚该参数的意义并需要进行性能调优，否则不需要用到该参数。
@param limit 限制结果的数量，如果要找到1个，就填写1，如果是多个请填写多个
@param method 0: TM_SQDIFF平方差匹配法,1: TM_SQDIFF_NORMED归一化平方差匹配方法,2: TM_CCORR相关匹配法,3: TM_CCORR_NORMED归一化相关匹配法,4: TM_CCOEFF系数匹配法,5: TM_CCOEFF_NORMED归一化系数匹配法
@return Match集合 匹配到的集合

function main() {
    let req = startEnv();
    if (!req) {
        logd("申请权限失败");
        return;
    }
    let temp = readResAutoImage("tmp.png");
    let rectp = new Rect();
    rectp.left = 0;
    rectp.top = 0;
    rectp.right = 0;
    rectp.bottom = 0;
    let matchs = image.matchTemplateEx(temp, 0.7, 0.9, rectp, -1, 1, 5);
    logd(JSON.stringify(matchs));
    //这玩意是个数组
    if (matchs) {
        for (let i = 0; i < matchs.length; i++) {
            logd(JSON.stringify(matchs[i]));
        }
    }
    //图片要回收
    image.recycle(aimage)
    //图片要回收
    image.recycle(temp)
}

main();

二值化

image.binaryzation 二值化Image

对AutoImage图片进行二值化
@param img AutoImage图片对象
@param threshold 二值化系数，0 ~ 255
@return AutoImage 对象或者null

function main() {
    let req = startEnv();
    if (!req) {
        logd("申请权限失败");
        return;
    }
    for (let i = 0; i < 1000; i++) {
        sleep(1000);
        let s = new Date().getTime();
        let d = image.captureFullScreen();
        if (d) {
            let s = new Date().getTime();
            let bd = image.binaryzation(d, 200);
            logd("time " + (new Date().getTime() - s))
            logd(bd.uuid);
            //图片要回收
            image.recycle(d)
        }
    }

}

main();

image.binaryzationEx 二值化Image

自适应二值化，使用了opencv的adaptiveThreshold函数实现
EC 脱机 4.5.0+
@param img AutoImage图片对象
@param map MAP 参数
- diameter : 去噪直径参考opencv的bilateralFilter函数
- adaptiveMethod：自适应二值化方式分别是0和1 ，ADAPTIVE_THRESH_MEAN_C=0，ADAPTIVE_THRESH_GAUSSIAN_C = 1
- blockSize：计算单位是像素的邻域块，邻域块取多大，就由这个值作决定，3，5，7这样的奇数
- c: 偏移值调整量，
- {"diameter":0,"adaptiveMethod":1,"c":0,"blockSize":5}
@return {null|AutoImage}

function main() {
    let req = startEnv();
    if (!req) {
        logd("申请权限失败");
        return;
    }
    for (let i = 0; i < 1; i++) {
        sleep(1000);
        let s = new Date().getTime();
        let d = image.captureFullScreenEx();
        if (d) {
            let p = file.getSandBoxFilePath("test1.png")
            let saved = image.saveTo(d, p);
            let s = new Date().getTime();
            let bd = image.binaryzationEx(d, {
                "diameter": 0,
                "adaptiveMethod": 1,
                "c": 10, "blockSize": 7
            });
            logd("time " + (new Date().getTime() - s))
            logd(bd.uuid);
            if (bd) {
                let p2 = file.getSandBoxFilePath("test2.png")
                let saved = image.saveTo(bd, p2);
                logd("saved " + saved)
                exit()
            }
            //图片要回收
            image.recycle(d)
        }
    }

}

main();

其他

image.rotateImage 旋转图像

旋转图片
支持EC 脱机版 1.6.0+
@param img 图片对象
@param degree 度数，0代表home键在下竖屏模式，-90代表逆时针旋转90度，home键在右，90度代表顺时针旋转90度，home键在左
@return {null|AutoImage}

function main() {
    let img = image.captureFullScreen()
    logd(" img width " + image.getWidth(img))
    let img2 = image.rotateImage(img, -90);
    image.recycle(img)
    logd(" img2 width " + image.getWidth(img2))
    image.recycle(img2)
}

main();

image.readImage 读取文件为Image

读取在路径path的图片文件并返回一个 {@link AutoImage} 对象。如果文件不存在或者文件无法解码则返回null。
@param path 图片路径
@return AutoImage 对象或者null

function main() {
    let path = file.getSandBoxFilePath("a.png")
    let autoimg = image.readImage(path);
    //图片要回收
    image.recycle(autoimg)
}

main();

image.argb 颜色转16进制字符串

将整型的颜色值转成16进制RGB字符串
@param color 整型值
@return {string} 颜色字符串

function main() {
    let req = startEnv();
    if (!req) {
        logd("申请权限失败");
        return;
    }
    let aimage = image.captureFullScreen();
    if (aimage != null) {
        let points3 = "765|22|0x1296DB";
        logd("==" + image.argb(image.pixel(aimage, 765, 22)));
        let points = image.cmpColor(aimage, points3, 0.5, 0, 0, 0, 0);
        logd("points " + points);
        //图片要回收
        image.recycle(aimage)
    }
}

main();

图片转换

image.saveTo 保存到文件

保存到文件中
@param img 图片对象
@param path 路径
@return bool true代表成功，false 代表失败

function main() {
    let req = startEnv();
    if (!req) {
        logd("申请权限失败");
        return;
    }

    let imageX = image.captureFullScreen();
    let path = file.getSandBoxFilePath("a.png")
    let r = image.saveTo(imageX, path);
    logd("result " + r);
    //图片要回收
    image.recycle(imageX)
}

main();

image.base64ToImage base64转Image

将base64的数据转换为AutoImage
@param base64data
@returns {AutoImage|null}

function main() {
  let data = "iVBORw0KGgoAAAANSUhEUgAAAAwAAAAMCAYAAABWdVznAAAAAXNSR0IArs4c6QAAATFJREFUKFOVUrFKA1EQnAn5CMFGW8HKykYMqI0I7z3RKlrYCkGLYKMo2sVK8wEWdkJu76Wz8sRK8A8k2PkXL2s23B0ELHSrhd2Z2RmW+GfR9p1zKyTPRGS/wnvv9wCcAlgVkeme1bTx3r8AWFfVVp7nhXNugeQXyZ6qLonIzgygVLkieWlsRjABv05ICiMiuQjg0Ga1VKlkZzxZX50RQtgAsK2qJ78BngFsATgSkYeSpAPgDsCuiGS1gnOuTfIWwLENStOmVjQaje5gMPioTVsTQvhMKbVjjO/VsoVA0vz08zw3pTolBbDcbDZHKaVNVY0kH1X1oAxBSXayLOvXsYpIy3vfBdBLKc0Ph8PvEMKNqp5XoNp0ecI9gLnxeLwWY3yrcnfOXZO8MC9GOhPrX77kB5AYkg38B4vzAAAAAElFTkSuQmCC"
  let img = image.base64ToImage(data)
  logd("img "+img+"  "+image.getHeight(img))
  let p = file.getSandBoxFilePath("test1.png")
  let saved = image.saveTo(img, p);
  logd("saved "+saved)
  image.recycle(img)
}

main();

image.toBase64Format Image转base64

转成base64的字符串, jpg格式较小，可以减少内存
@param img 图片对象
@param format 格式 jpg或者 png
@param q 质量 1-100，质量越大越清晰,png格式无效
@return 字符串

function main() {
    let req = startEnv();
    if (!req) {
        logd("申请权限失败");
        return;
    }
    let imageX = image.captureFullScreen();
    let r = image.toBase64Format(imageX, "jpg", 50);
    logd("result " + r);
    //图片要回收
    image.recycle(imageX)
}

main();

image.clip 剪切图片

剪切图片
@param img 图片对象
@param x x起始坐标
@param y y起始坐标
@param ex 终点X坐标
@param ey 终点Y坐标
@return AutoImage 对象或者null

function main() {
    let req = startEnv();
    if (!req) {
        logd("申请权限失败");
        return;
    }

    let imageX = image.captureFullScreen();
    let r = image.clip(imageX, 100, 100, 300, 400);
    logd("result " + r);
    //图片要回收
    image.recycle(imageX)
    image.recycle(r)
}

main();

image.pixel 图片某点颜色值

取得图片的某个点的颜色值
@param img 图片对象
@param x x坐标点
@param y y坐标点
@return int 颜色值

function main() {
    let req = startEnv();
    if (!req) {
        logd("申请权限失败");
        return;
    }
    let imageX = image.captureFullScreen();
    let r = image.pixel(imageX, 100, 100);
    logd("result " + r);
    //图片要回收
    image.recycle(imageX)
}

main();

image.isRecycled 图片回收判断

是否被回收了
@param img 图片对象
@return bool true代表已经被回收了

function main() {
    let imageX = image.captureFullScreen();
    let r = image.isRecycled(imageX);
    logd("result " + r);
    //图片要回收
    image.recycle(imageX)
}

main();

image.recycle 回收图片

回收图片
@param img 图片对象

function main() {
    let imageX = image.captureFullScreen();
    //图片要回收
    image.recycle(imageX)
}

main();

image.recycleAllImage 回收所有图像

回收所有图像
适配EC 脱机 4.8.0+
@return bool true代表成功

function main() {
    let imageX = image.captureFullScreen();
    image.recycleAllImage()
}

main();

image.autoImageToUIImage 转换为UIImage

转换为UIImage
适配EC 4.2.0+
@param img AutoImage
@return swift中的UIImage对象或者null

function main() {
    logd("isServiceOk " + isServiceOk());
    startEnv()
    logd("isServiceOk " + isServiceOk());
    setComputeMode(1)
    let img1 = image.captureFullScreen();
    logd(img1)

    // 测试1
    let uiimage = image.autoImageToUIImage(img1)
    logd("autoImageToUIImage uiimage " + uiimage)
    let x = pluginLoader.callMethodAny(name, clzName, "testMethod", uiimage)
    logd(x)
    image.recycle(img1)


    let img2 = image.captureFullScreenUIImage({})
    let xX = pluginLoader.callMethodAny(name, clzName, "testMethod", img2)
    logd(xX)


    let au = image.uiimageToAutoImage(uiimage)
    logd("au " + au)

    // 保存到文件中
    image.saveTo(au, file.getSandBoxFilePath("a.jpg"))
    image.recycle(au)
    image.recycle(img2)
}

main();

image.uiimageToAutoImage UIImage转换为AutoImage

UIImage转换为AutoImage
适配EC 4.2.0+
@param uiimage swift中的 UIImage 对象
@return null或者AutoImage对象

function main() {
    logd("isServiceOk " + isServiceOk());
    startEnv()
    logd("isServiceOk " + isServiceOk());
    setComputeMode(1)
    let img1 = image.captureFullScreen();
    logd(img1)

    // 测试1
    let uiimage = image.autoImageToUIImage(img1)
    logd("autoImageToUIImage uiimage " + uiimage)
    let x = pluginLoader.callMethodAny(name, clzName, "testMethod", uiimage)
    logd(x)
    image.recycle(img1)


    let img2 = image.captureFullScreenUIImage({})
    let xX = pluginLoader.callMethodAny(name, clzName, "testMethod", img2)
    logd(xX)


    let au = image.uiimageToAutoImage(uiimage)
    logd("au " + au)

    // 保存到文件中
    image.saveTo(au, file.getSandBoxFilePath("a.jpg"))
    image.recycle(au)
    image.recycle(img2)
}

main();

image.imageToMatFormat (UIImage的 AutoImage 转 Mat AutoImage)

转换Mat存储格式
适合EC iOS 4.6.0+
@param img {AutoImage} 图片对象
@return MAT存储格式的AutoImage 对象或者null

function main() {
    let req = startEnv();
    if (!req) {
        return;
    }
    image.useOpencvMat(0)
    for (let i = 0; i < 100; i++) {
        let d = image.captureFullScreen();
        logd(d)
        sleep(1000);
        if (d) {
            let ds = image.imageToMatFormat(d);
            logd(ds)
            image.recyle(d);
        }
    }
}

main();

image.matToImageFormat (Mat AutoImage 转 UIImage AutoImage)

转换普通image存储格式
适合EC iOS 4.6.0+
@param img {AutoImage} 图片对象
@return 普通存储格式的AutoImage对象或者null

function main() {
    let req = startEnv();
    if (!req) {
        return;
    }
    image.useOpencvMat(1)
    for (let i = 0; i < 100; i++) {
        let d = image.captureFullScreen();
        logd(d)
        sleep(1000);
        if (d) {
            let ds = image.matToImageFormat(d);
            logd(ds)
            image.recyle(d);
        }
    }
}

main();

设置​

image.setInitParam 初始化参数​

image.useOpencvMat 初始化参数​

普通截图 jpg​

image.captureFullScreenEx 截取全屏Image对象​

image.captureFullScreen 截取全屏Image对象​

image.captureFullScreenUIImage 截屏UIImage对象​

比色​

image.cmpColor 多点比色​

image.cmpColorJ 多点比色(JSON)​

image.cmpColorEx 多点比色扩展​

image.cmpMultiColor 多组比色​

image.cmpMultiColorJ 多组比色(JSON)​

image.cmpMultiColorEx 多组比色扩展​

找色​

image.findColor 单点找色​

image.findColorJ 单点找色(JSON)​

image.findColorEx 自动截屏单点找色​

image.findMultiColor 多点找色​

image.findMultiColorJ 多点找色(JSON)​

image.findMultiColorEx 自动截屏多点找色​

找非色​

image.findNotColor 找非色​

image.findNotColorJ 找非色(JSON)​

找图​

image.findImageByColor 透明找图​

image.findImageByColorJ 透明找图(JSON)​

image.findImageByColorEx 透明找图扩展​

image.findImageByColorExJ 透明找图扩展(JSON)​

image.findImage OpenCv找图​

image.findImageJ 找图(JSON)​

image.findImageEx OpenCv自动截屏找图​

image.matchTemplate OpenCV图片模板匹配​

image.matchTemplateJ 图片模板匹配(JSON)​

image.matchTemplateEx OpenCV图片模板匹配​

二值化​

image.binaryzation 二值化Image​

image.binaryzationEx 二值化Image​

其他​

image.rotateImage 旋转图像​

image.readImage 读取文件为Image​

image.argb 颜色转16进制字符串​

图片转换​

image.saveTo 保存到文件​

image.base64ToImage base64转Image​

image.toBase64Format Image转base64​

image.clip 剪切图片​

image.pixel 图片某点颜色值​

image.isRecycled 图片回收判断​

image.recycle 回收图片​

image.recycleAllImage 回收所有图像​

image.autoImageToUIImage 转换为UIImage​

image.uiimageToAutoImage UIImage转换为AutoImage​

image.imageToMatFormat (UIImage的 AutoImage 转 Mat AutoImage)​

image.matToImageFormat (Mat AutoImage 转 UIImage AutoImage)​

设置

image.setInitParam 初始化参数

image.useOpencvMat 初始化参数

普通截图 jpg

image.captureFullScreenEx 截取全屏Image对象

image.captureFullScreen 截取全屏Image对象

image.captureFullScreenUIImage 截屏UIImage对象

比色

image.cmpColor 多点比色

image.cmpColorJ 多点比色(JSON)

image.cmpColorEx 多点比色扩展

image.cmpMultiColor 多组比色

image.cmpMultiColorJ 多组比色(JSON)

image.cmpMultiColorEx 多组比色扩展

找色

image.findColor 单点找色

image.findColorJ 单点找色(JSON)

image.findColorEx 自动截屏单点找色

image.findMultiColor 多点找色

image.findMultiColorJ 多点找色(JSON)

image.findMultiColorEx 自动截屏多点找色

找非色

image.findNotColor 找非色

image.findNotColorJ 找非色(JSON)

找图

image.findImageByColor 透明找图

image.findImageByColorJ 透明找图(JSON)

image.findImageByColorEx 透明找图扩展

image.findImageByColorExJ 透明找图扩展(JSON)

image.findImage OpenCv找图

image.findImageJ 找图(JSON)

image.findImageEx OpenCv自动截屏找图

image.matchTemplate OpenCV图片模板匹配

image.matchTemplateJ 图片模板匹配(JSON)

image.matchTemplateEx OpenCV图片模板匹配

二值化

image.binaryzation 二值化Image

image.binaryzationEx 二值化Image

其他

image.rotateImage 旋转图像

image.readImage 读取文件为Image

image.argb 颜色转16进制字符串

图片转换

image.saveTo 保存到文件

image.base64ToImage base64转Image

image.toBase64Format Image转base64

image.clip 剪切图片

image.pixel 图片某点颜色值

image.isRecycled 图片回收判断

image.recycle 回收图片

image.recycleAllImage 回收所有图像

image.autoImageToUIImage 转换为UIImage

image.uiimageToAutoImage UIImage转换为AutoImage

image.imageToMatFormat (UIImage的 AutoImage 转 Mat AutoImage)

image.matToImageFormat (Mat AutoImage 转 UIImage AutoImage)