按键精灵ios脚本开发重要的图色相关的命令

FindPic


命令名称

FindPic

命令功能

查找指定的图片，支持多图、偏色、相似度查找，支持查找透明图,只返回第一个找到的坐标

命令参数

x1:整数型,查找区域左上X坐标
y1:整数型,查找区域左上Y坐标
x2:整数型,查找区域右下X坐标
y2:整数型,查找区域右下Y坐标
pic_name:字符串,要找的图片名字,多个图片用“|”号分隔
delta_color:16进制字符串,偏色
sim:双精度浮点数,相似度,取值范围0-1
dir:整数型,查找方向:
0:表示从左上向右下查找;
1:表示从中心往四周查找;
2:表示从右下向左上查找;
3:表示从左下向右上查找;
4:表示从右上向左下查找;
intX:变参指针,返回找到的X坐标
intY:变参指针,返回找到的Y坐标

返回值

返回找到的图片的序号,从0开始索引.如果没找到返回-1


找图命令的准备工作:

1. 把目标图片截取下, 并且保存成PNG格式的图片文件

2. 把图片添加到助手附件中,或者是放在手机的路径中

  1. Dim intX, intY
  2. //当图片在附件当中时:
  3. FindPic 0, 0, 0, 0, "Attachment:PIC.png","000000",0, 0.8, intX, intY
  4. If intX >-1 then
  5. TracePrint "找到啦，坐标是"&intX&","&intY
  6. Else
  7. TracePrint "没找到"
  8. End If
  9. //当图片是在手机的SD卡路径中时
  10. FindPic 0, 0, 0, 0, "/sdcard/PIC.png","000000",0, 0.8, intX, intY
  11. If intX >-1 then
  12. TracePrint "找到啦，坐标是"&intX&","&intY
  13. Else
  14. TracePrint "没找到"
  15. End If

复制代码透明图:

在找图命令中有个透明图的概念. 它其实就是指对要找的图片进行了一些特殊处理.


当图片4个角的颜色颜色都相同时,按键会自动把图片中这种颜色当成透明色.




这个图片的四个角的颜色不一致,所以在找图的时候会当成普通的图片进行查找



这个图片中四个角的颜色都是黄色("FFE952") 所以按键在找图的时候会自动忽略掉这个黄色, 只对图片中的其他的颜色进行匹配.

透明图常常会被用于在一些背景会发生变化的场景中找特征.


SnapShot



命令名称

SnapShot

命令功能

截屏并保存为PNG文件

命令参数

file_name:字符型，文件名（即截取范围图片后，要保存的路径）
x1：整数型,区域左上角x坐标
y1：整数型,区域左上角y坐标
x2：整数型,区域右下角x坐标
y2：整数型,区域右下角y坐标

返回值

无


截图命令使用方法很简单, 可以截取整张屏幕保存成图片, 也可以支持截取部分屏幕保存成图片.

  1. //截图整个屏幕信息
  2. SnapShot "/sdcard/PIC.png"
  3. //截图部分屏幕
  4. SnapShot "/sdcard/PIC.png", 200, 300, 450, 600
  5. //连续截屏保存成不同的图片
  6. For i = 1 To 5
  7. SnapShot "/sdcard/PIC_" & i & ".png",200, 300, 450, 600
  8. Next

复制代码


KeepCapture\ReleaseCapture



命令名称

KeepCapture

命令功能

截取当前屏幕内容保留在内存,随后执行的图色函数均从内存中快速查找，直到用 ReleaseCapture 删除内存中的截图

命令参数

无

返回值

无



命令名称

ReleaseCapture

命令功能

释放(即删除)保留在内存中的屏幕内容截图

命令参数

无

返回值

无


这两个命令一般都是成对出现的. 利用好他们对于提升脚本找图找色的效率有很大的帮助

在按键机制中在运行到找图找色命令的时候就会自动截取屏幕的信息. 所以当你循环找多个特征的时候就会发现效率很慢.

我们可以通过一个简单的代码来测试下效率

  1. Dim intX,intY
  2. Dim t=TickCount()
  3. For 50
  4. FindMultiColor 349,705,488,836, "6363F1","-41|27|97E6F6,-72|-8|84D5BA,-40|-61|EFF3F2", 0, 0.9, intX, intY
  5. If intX > -1 And intY > -1 Then
  6. End If
  7. Next
  8. TracePrint TickCount()-t

复制代码通过运行上面代码我们可以得到在找色50次所花费的时间大概在1500ms左


右. 这单独看起来可能没什么. 但是放在实际的脚本中就会很影响比较的效率了.

我们再来看下使用了截图至内存命令之后的效率

  1. Dim intX,intY
  2. Dim t=TickCount()
  3. KeepCapture
  4. For 50
  5. FindMultiColor 349,705,488,836, "6363F1","-41|27|97E6F6,-72|-8|84D5BA,-40|-61|EFF3F2", 0, 0.9, intX, intY
  6. If intX > -1 And intY > -1 Then
  7. End If
  8. Next
  9. ReleaseCapture
  10. TracePrint TickCount()-t

复制代码最终输出的所花费的时间不到100ms. 这就是效率上的差距.


在没使用截图至内存的命令之前, 每次找色的时候都会自动截屏一次, 循环50次就相当于截屏了50次. 所以耗费时间就多. 当在循环开始前使用KeepCapture


命令, 就是把当前屏幕的像素信息先收集到内存中, 之后的找色命令全部由内存里取 不会再截取屏幕,所以找色就会快很多了.


注意: 截图至内存的命令其实是一把双刃剑, 用的好的话可以极大的提升效率. 但是如果用不好就会造成一些问题. 在使用了KeepCapture 命令之后 所有的找色命令使用的图色信息都会直接从内存中获取, 屏幕上的变化就不会影响到找色命令了, 所以如果需要在新的画面中进行找色的话一定要记得用ReleaseCapture 释放内存中的截图才行


探索按键精灵的多样自动化脚本选择，包括iOS越狱版和免越狱版，涵盖了iOS和安卓系统的各种脚本，正在适配最新的iOS 15和iOS 16系统版本。同时，鹰眼软件提供手机群控、微信群控、游戏群控、手机投屏、手机云控以及电脑远程控制手机功能，为您的操作体验增添更多的趣味与便利！