回顶部

AIS(指端精灵)开发工具文档

fincpic -找图
函数名:
fincpic
找图
函数描述: 屏幕找图,目前仅支持24位的BMP格式图片(需要root权限)
函数原型:
fincpic(x1,y1,x2,y2,path,picname,delta_color,sim,scantype)
找图(x1,y1,x2,y2,图片路径,图片名,偏色,相似度,方向,返回x坐标,返回y坐标)
函数参数: x1:左上角坐标x
y1:左上角坐标y
x2:右下角坐标x
y2:右下角坐标y
path: 图片路径,支持多图片用|符号分开,暂时需要写绝对路径
picname:要找图的图片名,不要带路径,如:“宠物.bmp|技能.bmp”
delta_color: 颜色色偏 比如"203040" 表示rgb的色偏分别是20 30 40 (这里是16进制表示)
sim: 颜色的相似度(取值范围0.5~1.0)
scantype: 扫描方式,0: 从左到右,从上到下 1: 从左到右,从下到上 2: 从右到左,从上到下 3: 从右到左,从下到上
rx: 返回的x坐标
ry: 返回的y坐标
返回值: rx,ry,ret返回找到的图片起点坐标和序号,从0开始索引.如果没找到返回-1,-1,-1
脚本示例:

local x=0,y=0
x,y,ret=findpic(0,0,500,500,getrcpath(“rc:”),"1.bmp|2.bmp","111111",0.8,0)
if ret==0 then
   messagebox("x:"..x.." y:"..y)
end

findcolor -找色
函数名:
findcolor
找色
函数描述: 屏幕找色(需要root权限)
函数原型:
findcolor(x1,y1,x2,y2,color,sim,scantype)
找色(x1,y1,x2,y2,颜色值,相似度,方向)
函数参数: x1:左上角坐标x
y1:左上角坐标y
x2:右下角坐标x
y2:右下角坐标y
color:要查找的颜色 颜色格式为"RRGGBB-DRDGDB|RRGGBB-DRDGDB|…………",颜色排列为RGB格式
sim: 相似度,取值范围0.1-1.0
scantype: 扫描方式,0: 从左上到右下 1: 从中间到四周 2: 从右下到左上
返回值: 返回x,y,ret 找到的坐标及参数对应的索引,没找到返回-1,-1,-1
脚本示例:

local x,y,ret = -1,-1,-1
x,y,ret=findcolor(0,0,2000,2000,"B8DD53-000000",1.0,0)
if ret~= -1 then
   messagebox("x:"..x.." y:"..y)
end

findmulticolor -多点找色
函数名:
findmulticolor
多点找色
函数描述: 通过多个颜色点,确定一个点的坐标(需要root权限)
函数原型:
findmulticolor(x1,y1,x2,y2,color,OffsetPos,sim,dir)
多点找色(x1,y1,x2,y2,起点颜色值,颜色组,相似度,方面,返回x坐标,返回y坐标)
函数参数: x1:左上角坐标x
y1:左上角坐标y
x2:右下角坐标x
y2:右下角坐标y
color:起点颜色值,颜色格式为"RRGGBB-DRDGDB|RRGGBB-DRDGDB|…………",颜色排列为RGB格式
OffsetPos:色点组(格式为"x1|y1|RRGGBB-DRDGDB|RRGGBB-DRDGDB……,……xn|yn|RRGGBB-DRDGDB|RRGGBB-DRDGDB……")
sim: 相似度,取值范围0.1-1.0
scantype: 扫描方式,0: 从左上到右下 1: 从中间到四周 2: 从右下到左上
返回值: 返回x,y,ret 找到的坐标及起点颜色的索引值,没找到则返回-1,-1,-1
脚本示例:

local x,y,ret = -1,-1,-1
x,y,ret=findmulticolor(0,0,2000,2000,"9fc53b-000000","-2|4|91b434,5|7|ffffff",1.0,0)
if ret ~= -1 then
 messagebox("x:"..x.." y:"..y)
end

screencap - 截图
函数名:
screencap
截图
函数描述: 根据指定范围截图(需要root权限)
函数原型:
screencap(x1,y1,x2,y2,pic_path)
截图(x1,y1,x2,y2,路径)
函数参数: x1:区域的左上X坐标
y1:区域的左上Y坐标
x2:区域的右下X坐标
y2:区域的右下Y坐标
pic_path:图片保存的路径
返回值: 成功返回真,失败返回假
脚本示例:

local ret=screencap(0,0,500,500,"/sdcard/t.bmp")
if ret == true then
  messagebox("截图成功")
else
  messagebox("截图失败")
end

getcolor -取色
函数名:
getcolor
取色
函数描述: 获取指定点的颜色值(需要root权限)
函数原型:
getcolor(x,y,mode=0)
取色(x,y,mode=0)
函数参数: x:屏幕绝对坐标x
y:屏幕绝对坐标y
mode:整型值模式值,0为返回十进制(RGB)颜色值,1为返回十六进制颜色字符串,默认为0
返回值: 返回十六进制字符串颜色值,取色失败,返回-1
脚本示例:

local color=getcolor(12,50)
messagebox(color)

getcolornum -获取颜色数量
函数名:
getcolornum
获取颜色数量
函数描述: 获取指定范围颜色数量(需要root权限)
函数原型:
getcolornum(x1,y1,x2,y2,color,sim)
获取颜色数量(x1,y1,x2,y2,color,sim)
函数参数: x1:左上角坐标x
y1:左上角坐标y
x2:右下角坐标x
y2:右下角坐标y
color:颜色值,颜色格式为"RRGGBB-DRDGDB|RRGGBB-DRDGDB|…………",颜色排列为RGB格式
sim:相似度0.1-0.9
返回值: 返回颜色点数量
脚本示例:

local ret = 0
ret = getcolornum(0,0,500,500,"000000-000000|ff00ff-000000",1.0)
messagebox(ret)

cmpcolor -颜色匹配
函数名:
cmpcolor
颜色匹配
函数描述: 比较指定坐标点(x,y)的颜色 (需要root权限)
函数原型:
cmpcolor(x1,y1,color,sim)
颜色匹配(x1,y1,颜色值,相似度)
函数参数: x1:坐标x
y1:坐标y
color: 颜色字符串,可以支持偏色,多色,例如 "ffffff-202020|000000-000000"
sim: 颜色的相似度(取值范围0.1~1.0)
返回值: 返回找到颜色值索引,没有找到则返回-1
脚本示例:

local ret=cmpcolor(200,200,"23456-25500f",0.8)
if ret>-1 then
   messagebox("颜色相同")
end

keepcapture -缓存图像
函数名:
keepcapture
缓存图像
函数描述: 让屏幕数据暂时停止刷新,适当的使用此函数,可以提高运行效率,可以使用releasecapture来释放,让屏幕数据继续刷新(需要root权限)
函数原型:
keepcapture(type=0)
缓存图像(类型=0)
函数参数: type:0、暂停图色屏幕数据刷新,1、暂停识字屏幕数据刷新
返回值:
脚本示例:

keepcapture() //暂停数据刷新
messagebox(getcolor(200,200))
screencap(200,500,300,600,"/sdcard/test.bmp")
releasecapture() //释放数据刷新
end

releasecapture --释放图像
函数名:
releasecapture
释放图像
函数描述: 释放屏幕数据,让数据继续刷新,一般与keepcapture函数配对出现(需要root权限)
函数原型:
releasecapture(type)
释放图像(类型)
函数参数: type:0、释放图色屏幕数据刷新,1、释放识字屏幕数据刷新
返回值:
脚本示例:

keepcapture() //暂停数据刷新
messagebox(getcolor(200,200))
screencap(200,500,300,600,"/sdcard/test.bmp")
releasecapture() //释放数据刷新