1#
Gk.Full 件V3.21(新增对文字识别的支持)

  插件开发宗旨:本插件旨在将按键官方所有找图找色命令集成为一个统一的插件命令(GK.Full)去调用,并实现图色参数可选(官方是不可选的)和图色判断成立后自带点击的可选功能,以及体现各种找图找色技巧的插件扩展命令(扩展命令函数原型说明请见文章后半部分)。本插件可根据您输入的不同的图色参数数据来自动匹配应该调用哪一个官方图色命令(此实现有点像C++的函数重载)。插件主要包含两个实现方法,一个是常用的Full,另一个是它的增强版Full2,后者可实现返回一个数组变量,该变量携带了所有与之匹配的图色函数的相关信息,可通过访问数组下标对其进行索引,详情请见实例说明。

注:回复即可下载插件源码(在文章末尾处),
请将下载后的Gk.luae插件文件存放入按键精灵目录下的Plugin文件夹中即可调用该插件,调用插件时必须先在脚本开头用Import命令导入插件,导入方法见本文中的插件调用实例!


果壳万能图色插件基本命令函数原型说明:

一. 比色Ex 集成官方CmpColorEx命令 - 插件函数原型:Gk.Full(Color[, Sim][, Click]) 
函数作用:多个坐标点比对对应颜色序列

    
参数描述
Color
必选。字符串型,颜色字符序列
Sim可选。浮点型,颜色查找相似度,取值范围0.1-0.999,不填此参数默认为0.9
Click可选。布尔值,指明图色判断成立后是否需要执行点击操作,true表示执行点击,false表示不点击,不填此参数默认为true
插件命令判断成立/不成立返回值说明返回值(布尔型)
判断成立:对比颜色序列全匹配true
判断不成立:对比颜色序列并非完全匹配false

插件调用实例

Import "GK.luae"
If Gk.Full("378|583|0FBA06,373|611|292EDF,343|609|DA9D08") then
TracePrint "GOOD"
End If

Dim A=array("378|583|0FBA06,373|611|292EDF,343|609|DA9D08",false)
TracePrint Gk.Full(A)





二. 比色Ex2集成官方CmpColorEx命令 - 插件函数原型(增强版):Gk.Full2(Color[, Sim][, Click])
函数作用:多个坐标点比对对应颜色序列
注:参数描述同上(比Ex
  
插件命令判断成立/不成立返回值说明
返回值(数组型)
判断成立说明1:成功匹配指定颜色对象
true。由数组成员array(0)接收该返回值
判断成立说明2:成功匹配指定颜色对象 颜色对象X坐标值。由数组成员array(1)接收该返回值
判断成立说明3:成功匹配指定颜色对象
颜色对象Y坐标值。由数组成员array(2)接收该返回值
判断不成立说明1:未匹配到指定颜色对象
false。由数组成员array(0)接收该返回值
判断不成立说明2:未匹配到指定颜色对象
-1。由数组成员array(1)接收该返回值
判断不成立说明3:未匹配到指定颜色对象
-1。由数组成员array(2)接收该返回值

插件
调用实例

Import "GK.luae"
dim a= Gk.Full2("378|583|0FBA06,373|611|292EDF,343|609|DA9D08")
TracePrint a(0),a(1),a(2)

Dim B=array("378|583|0FBA06,373|611|292EDF,343|609|DA9D08",false)
Dim arr=Gk.Full2(B)
TracePrint arr(0),arr(1),arr(2)




三. 找色 集成官方FindMultiColor命令 - 插件函数原型:Gk.Full([X1, Y1, X2, Y2, ]Color, offset[, Dir][, Sim][, Click]) 
函数作用:在一定范围内查找匹配指定颜色序列
  
参数
描述
X1
Y1
X2
Y2
可选整数型,分别用4个整型参数(X1,Y1,X2,Y2)表示查找颜色对象的坐标范围如果参数X1、Y1、X2、Y2皆未填写则表示采用全屏查找
Color
必选字符串型,欲搜索对象的颜色字符序列
offset
必选字符串型,与要搜索的颜色对象进行坐标偏移比对的颜色字符序列。
Dir 可选整数型,查找方向,如不填写则默认查找方向为0(具体参数值请见按键官方命令说明)。注:Dir参数位置顺序可与Sim参数位置顺序相互置换
Sim
可选。浮点型,颜色查找相似度,取值范围0.1-0.999,不填此参数默认为0.9。注:Sim的参数位置顺序可与Dir的参数位置顺序相互置换
Click
可选。布尔值,指明图色判断成立后是否需要执行点击操作,true表示执行点击,false表示不点击,不填此参数默认为true
插件命令判断成立/不成立返回值说明
返回值(布尔型)
判断成立:成功匹配指定颜色对象true
判断不成立:未匹配到指定颜色对象false

插件
调用实例

Import "GK.luae"
If Gk.Full(311,489,409,580,"0FBA06","-5|28|292EDF,-35|26|DA9D08") then
TracePrint "GOOD"
End If

Dim A=array("0FBA06","-5|28|292EDF,-35|26|DA9D08",0.8,false)
TracePrint Gk.Full(A)




四. 找色2集成官方FindMultiColor命令 - 插件函数原型(增强版):Gk.Full2([X1, Y1, X2, Y2, ]Color, offset[, Dir][, Sim][, Click])
函数作用:在一定范围内查找匹配指定颜色序列
注:参数描述同上(找色
  
插件命令判断成立/不成立返回值说明
返回值(数组型)
判断成立说明1:成功匹配指定颜色对象
true。由数组成员array(0)接收该返回值
判断成立说明2:成功匹配指定颜色对象 颜色对象X坐标值。由数组成员array(1)接收该返回值
判断成立说明3:成功匹配指定颜色对象
颜色对象Y坐标值。由数组成员array(2)接收该返回值
判断不成立说明1:未匹配到指定颜色对象
false。由数组成员array(0)接收该返回值
判断不成立说明2:未匹配到指定颜色对象
-1。由数组成员array(1)接收该返回值
判断不成立说明3:未匹配到指定颜色对象
-1。由数组成员array(2)接收该返回值

插件
调用实例

Import "GK.luae"
dim a= Gk.Full2(311,489,409,580,"0FBA06","-5|28|292EDF,-35|26|DA9D08")
TracePrint a(0),a(1),a(2)

Dim B=array("0FBA06","-5|28|292EDF,-35|26|DA9D08",false)
Dim arr=Gk.Full2(B)
TracePrint arr(0),arr(1),arr(2)




五. 找图 集成官方FindPic命令 - 插件函数原型:Gk.Full[X1, Y1, X2, Y2, ]Picture[, Delta][, Dir][, Sim][, Click])
函数作用:在一定范围内查找指定图片
   
参数

描述

X1

Y1

X2

Y2

可选整数型,分别用4个整型参数(X1,Y1,X2,Y2)表示查找图片对象的坐标范围如果参数X1、Y1、X2、Y2皆未填写则表示采用全屏查找

Picture

必选字符串型,图片名字(填写格式见下例)。支持查找多张图片(详情见官方命令说明)

Delta

可选。字符串型,找图偏色值,如不填写该参数则默认为"000000"

Dir

可选整数型,查找方向,如不填写则默认查找方向为0(具体参数值请见按键官方命令说明)。注Dir的参数位置顺序可与Sim参数位置顺序相互置换

Sim

可选。浮点型,找图相似度,取值范围0.1-0.999,不填此参数默认为0.9。注:Sim的参数位置顺序可与Dir参数位置顺序相互置换

Click

可选。布尔值,指明图色判断成立后是否需要执行点击操作true表示执行点击,false表示不点击,不填此参数则默认为true

插件命令判断成立/不成立返回值说明
返回值(布尔型)
判断成立:成功查找到对应图片true
判断不成立:未查找到对应图片false

插件
调用实例

Import "GK.luae"
If Gk.Full(311,489,409,580,"Attachment:图片.png",false) then
TracePrint "GOOD"
End If

Dim A=array("Attachment:图片1.png|Attachment:图片2.png","303030",1,0.8)
TracePrint Gk.Full(A)





六. 找图2 集成官方FindPic命令 - 插件函数原型(增强版)Gk.Full2[X1, Y1, X2, Y2, ]Picture[, Delta][, Dir][, Sim][, Click])
函数作用:在一定范围内查找指定图片
注:参数描述同上(找图
  
插件命令判断成立/不成立返回值说明
返回值(数组型)
判断成立说明1:成功查找对应图片
图片序号(0开始索引)。由数组成员array(0)接收该返回值
判断成立说明2成功查找到对应图片
图片X坐标值。由数组成员array(1)接收该返回值
判断成立说明3成功查找到对应图片
图片Y坐标值。由数组成员array(2)接收该返回值
判断不成立说明1:未查找到对应图片
-1。由数组成员array(0)接收该返回值
判断不成立说明2查找到对应图片
-1。由数组成员array(1)接收该返回值
判断不成立说明3查找到对应图片 -1。由数组成员array(2)接收该返回值

插件
调用实例

Import "GK.luae"
Dim a= Gk.Full2(311,489,409,580,"Attachment:图片.png")
TracePrint a(0),a(1),a(2)

Dim B=array("Attachment:图片1.png|Attachment:图片2.png")
Dim arr=Gk.Full2(B)
TracePrint arr(0),arr(1),arr(2)





七. 找色素 集成官方FindColor命令 - 插件函数原型:Gk.Full[X1, Y1, X2, Y2, ]Color[, Dir][, Sim][, Click])
函数作用:在一定范围内查找指定颜色值
   
参数 描述
X1
Y1
X2
Y2
可选整数型,分别用4个整型参数(X1,Y1,X2,Y2)表示查找颜色对象的坐标范围如果参数X1、Y1、X2、Y2皆未填写则表示采用全屏查找
Color

必选字符串型,欲查找的颜色字符序列(支持查找多个颜色对象,详情见官方命令说明)

Dir
可选整数型,查找方向,如不填写则默认查找方向为0(具体参数值请见按键官方命令说明)。注:Dir的参数位置顺序可与Sim参数位置顺序相互置换
Sim
可选。浮点型,颜色查找相似度,取值范围0.1-0.999,不填此参数默认为0.9。注:Sim的参数位置顺序可与Dir的参数位置顺序相互置换
Click
可选。布尔值,指明图色判断成立后是否需要执行点击操作true表示执行点击,false表示不点击,不填此参数默认为true
插件命令判断成立/不成立返回值说明
返回值(布尔型)
判断成立:成功查找到指定颜色对象true
判断不成立:未查找到指定颜色对象false

插件
调用实例

Import "GK.luae"
If Gk.Full(311,489,409,580,"0FBA06",0.999) then
TracePrint "GOOD"
End If

Dim A=array("0FBA06|845C1B",0.999,false)
TracePrint Gk.Full(A)





八. 找色素2 集成官方FindColor命令 - 插件函数原型(增强版):Gk.Full2[X1, Y1, X2, Y2, ]Color[, Dir][, Sim][, Click])
函数作用:在一定范围内查找指定颜色值
注:参数描述同上(找色素
  
插件命令判断成立/不成立返回值说明 返回值(数组型)
判断成立说明1:成功查找对应的颜色对象
颜色对象的序号(0开始索引)。由数组成员array(0)接收该返回值
判断成立说明2成功查找到对应颜色对象
颜色对象X坐标值。由数组成员array(1)接收该返回值
判断成立说明3成功查找到对应颜色对象
颜色对象Y坐标值。由数组成员array(2)接收该返回值
判断不成立说明1:未查找到对应颜色对象 -1。由数组成员array(0)接收该返回值
判断不成立说明2查找到对应颜色对象
-1。由数组成员array(1)接收该返回值
判断不成立说明3查找到对应颜色对象
-1。由数组成员array(2)接收该返回值

插件
调用实例

Import "GK.luae"
Dim a= Gk.Full2(311,489,409,580,"0FBA06|292EDF|DA9D08",0.999)
TracePrint a(0),a(1),a(2)

Dim B=array("0FBA06|292EDF|DA9D08",0.999,2,false)
Dim arr=Gk.Full2(B)
TracePrint arr(0),arr(1),arr(2)





九. 对比颜色 集成官方CmpColor命令 - 插件函数原型:Gk.Full(X1, Y1, Color[, Sim][, Click]
函数作用:在指定坐标处比对指定颜色值
  
参数
描述
X1
必选。整数型,X坐标
Y1 必选。整数型,Y坐标
Color
必选。字符串型,欲查找的颜色字符序列
Sim
可选。浮点型,颜色查找相似度,取值范围0.1-0.999,不填此参数默认为0.9
Click
可选。布尔值,指明图色判断成立后是否需要执行点击操作,true表示执行点击,false表示不点击,不填此参数默认为true
插件命令判断成立/不成立返回值说明返回值(布尔型)
判断成立:成功找到指定颜色值true
判断不成立:未能找到指定颜色值false

插件调用实例
Import "GK.luae"
If Gk.Full(378,583,"0FBA06",0.999) then
TracePrint "GOOD"
End If

Dim A=array(378,583,"0FBA06|845C1B",0.999)
TracePrint Gk.Full(A)





十. 对比颜色2 集成官方CmpColor命令 - 插件函数原型(增强版):Gk.Full2(X1, Y1, Color[, Sim][, Click]
函数作用:在指定坐标处比对指定颜色值
注:参数描述同上(比色
  
插件命令判断成立/不成立返回值说明返回值(整数型)
判断成立:成功找到指定颜色值颜色对象序号(从0索引)
判断不成立:未能找到指定颜色值-1

插件
调用实例

Import "GK.luae"
Dim a= Gk.Full2(378,583,"0FBA06",0.999)
TracePrint a

Dim B=array(378,583,"0FBA06|845C1B",0.999)
TracePrint Gk.Full2(B)





十一. 取色 集成官方GetPixelColor命令 - 插件函数原型:Gk.Full(X1, Y1
函数作用:在指定坐标处获取颜色值
   
参数描述
X1
必选。整数型,X坐标
Y1必选。整数型,Y坐标
插件命令判断成立/不成立返回值说明返回值(字符型)
判断成立:在指定坐标处取得对应颜色值16进制颜色值

插件
调用实例

Import "GK.luae"
TracePrint Gk.Full(378,583)

Dim A=array(378,583)
TracePrint Gk.Full(A)







果壳万能图色插件扩展命令函数原型说明:

扩展命令


函数作用



函数原型/调用例子



FullUBFullUB2



遍历对象,即查找对象以数组方式进行遍历查找,找到其中一个数组成员则返回真,返回假的条件:所有数组成员都未能找到。


函数原型:

Gk.FullUBData[, Click]

Gk.FullUB2Data[, Click]
    

参数描述:

Data 数组型(必选参数)图色数据GK.Full命令支持的所有图色数据

Click 布尔型(可选参数)是否点击找到对象后是否执行点击操作

注:不填Click参数默认值为true

   

返回值:

FullUB 返回布尔值

FullUB2 返回数组变量

注:

数组变量(0)=布尔值(表示是否找到对象)

数组变量(1)=整数型(表示对象intX坐标)

数组变量(2)=整数型(表示对象intY坐标) 

调用实例:

Dim A()

A(0)=array("221|461|FFFFFF,237|454|27BA00,210|444|2CCEEB,197|477|D49A00")

A(1)=array(174,418,265,513,"2F3BED","-4|-8|D2E6FE,18|-32|1B1F32")

TracePrint GK.FullUB(A,false)
 

Dim arr=GK.FullUB2(A)

TracePrint arr(0),arr(1),arr(2)


FullTMFullTM2



等待对象出现,即在指定时间内查找对象(等待对象出现),找到返回真。返回假的条件:查找超时。


函数原型:

Gk.FullTMData[, TM]

Gk.FullTM2Data[, TM]

    

参数描述:

Data 数组型/非数组型(必选参数)图色数据,GK.Full命令支持的所有图色数据

TM 整数型(可选参数)等待出现时间(单位:秒)等待对象出现的时间上限

注:不填TM参数默认值为5

   

返回值:

FullTM 返回布尔值

FullTM2 返回数组变量

注:

数组变量(0)=布尔值(表示是否找到对象)

数组变量(1)=整数型(表示对象intX坐标)

数组变量(2)=整数型(表示对象intY坐标) 

  

调用实例: