回顶部

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

setdict - 字库设置
函数名:
setdict
字库设置
函数描述: 设置字库文件,(字库中包含中文的话,务必要确定文件编码为utf-8格式,否则会出现乱码)(需要root权限)
函数原型:
setdict(file,index)
字库设置(字库名,序号)
函数参数: file:字库文件名
index:字库的序号,取值为0-19,目前最多支持20个字库
返回值: 成功返回真,失败返回假
脚本示例:

local path = getrcpath("rc:".."font.txt")
setdict(path,0)

usedict -字库切换
函数名:
usedict
字库切换
函数描述: 切换可以使用的设置,切换的新字库必须是已经设置过的(需要root权限)
函数原型:
usedict(index)
字库切换(序号)
函数参数: index:字库的序号,取值为0-19,目前最多支持20个字库
返回值: 成功返回真,失败返回假
脚本示例:

local path = getrcpath("rc:".."font.txt")
setdict(path,3)
usedict(3)

deletedict -字库删除
函数名:
deletedict
字库删除
函数描述: 删除内存中字库,不会影响的文件中的字库内容(需要root权限)
函数原型:
deletedict(index)
字库删除(序号)
函数参数: index:字库的序号,取值为0-19,目前最多支持20个字库
返回值: 成功返回真,失败返回假
脚本示例:

local path = getrcpath("rc:".."font.txt")
setdict(path,3)
deletedict(3)

ocr -识字
函数名:
ocr
识字
函数描述: 识别屏幕范围(x1,y1,x2,y2)内符合color_format的字符串,并且相似度为sim,sim取值范围(0.1-1.0),这个值越大越精确,越大速度越快,越小速度越慢,请斟酌使用 (需要root权限)
函数原型:
ocr(x1,y1,x2,y2,color_format,sim)
识字(x1,y1,x2,y2,偏色,相似度)
函数参数: x1:区域的左上X坐标
y1:区域的左上Y坐标
x2:区域的右下X坐标
y2:区域的右下Y坐标
color_format:颜色格式串"ffffff-202020|000000-000000"
sim: 颜色的相似度(取值范围0.1~1.0)
返回值: 返回识别到的字符串,字符长度不会超过1024
脚本示例:

local ret=ocr(0,0,500,100,"f3f3f3-404040",0.9)
messagebox(ret)

findtext -找字
函数名:
findtext
找字
函数描述: 在屏幕范围(x1,y1,x2,y2)内,查找string(可以是任意个字符串的组合),并返回符合color_format的坐标位置,相似度sim同Ocr接口描述. (需要root权限)
函数原型:
findtext(x1,y1,x2,y2,string,color_format,sim)
找字(x1,y1,x2,y2,字符串,偏色,相似度)
函数参数: x1:区域的左上X坐标
y1:区域的左上Y坐标
x2:区域的右下X坐标
y2:区域的右下Y坐标
string:待查找的字符串,可以是字符串组合,比如"长安|洛阳|大雁塔",中间用"|"来分割字符串
color_format:颜色格式串,"f3f3f3-404040|00ff00-ddff00"
sim:相似度,取值范围0.1-1.0
返回值: 返回找到的X,Y坐标和字符串的索引, 没找到返回-1,-1,-1, 比如"长安|洛阳",若找到长安,则返回x,y,0
脚本示例:

local ret,x,y
x,y,ret=findtext(0,0,250,200,"p|a","f3f3f3-404040",0.9)
if ret>=0 then
   messagebox("findtext:"..ret..","..x..","..y)
end