zm.FindMultiColorTap 超级多点找色点击

🎯功能

与zm.FindMultiColor 超级多点找色类似, 区别在于本命令内置找到后点击. 由于查找与点击是两个动作组成, 为方便代码阅读理解, 故新增本命令

危险

本命令的方向参数是字符串型, 例如"左上"之类, 而按键自带命令的方向是数值型, 例如0之类, 如果直接复制按键命令的参数, 一定要记得修改方向参数!

📜语法

序号坐标颜色 = zm.FindMultiColorTap([对象,][x1,y1,x2,y2,][第一点颜色,偏移颜色组][,方向][,相似度[,智能相似度[,相似度步长]]][,超时时间][,点击坐标][,显示日志][,输出行号][,备注][,等待消失][,消失超时][,参数返回值])

📥参数

参数	数据类型	解释
对象	表	可选, 把所有参数放入一个table中传入, 若后面跟有其他参数, 则会对应覆盖对象数据
x1	数值型	可选, 查找范围的左上角x坐标, 省略默认为0
y1	数值型	可选, 查找范围的左上角y坐标, 省略默认为0
x2	数值型	可选, 查找范围的右下角x坐标, 省略默认为0
y2	数值型	可选, 查找范围的右下角y坐标, 省略默认为0
第一点颜色	字符串	可选, 要查找的16进制颜色，格式为“BBGGRR”，多个颜色用“|”隔开，偏色使用“-”隔开，比如"FFFFFF-101010|123456", 后面必须跟偏移颜色组, 支持多参数, 详见示例
偏移颜色组	字符串	可选, 相对与第一个颜色坐标点的偏移颜色组，推荐用抓抓工具快速生成, 前面必须是第一点颜色，支持多参数, 详见示例
方向	字符串	可选, 从指定方向开始查找, 省略默认为"左上", 支持["左上","中心","右上","左下","右下","上左","上右","下左","下右"]这几个值
相似度	数值型	可选, 对比查找的相似度小数, 省略默认为0.9, 取值范围[0, 1.0], 越高越相似
智能相似度	数值型	可选, 与相似度组成组成智能相似计算范围, 适合图色变化大的情况, 省略默认取值与相似度相同, 取值范围[0, 1.0], 越高越相似
相似度步长	数值型	可选, 智能相似度调节变化间隔, 必须写在相似度后面, 省略默认为0.05, 取值范围[0, 1.0]
超时时间	数值型	可选, 最大查找耗时, 单位毫秒, 如果一次找不到, 可以限时循环查找, 省略默认为1
点击坐标	字符串	可选, 点击修改后的坐标, 格式"±x,±y,t", 省略为点击找到坐标, t是可选的, 表示点击后延时毫秒, 例如"100,100"表示固定点击坐标100,100, "+10,-10"表示偏移点击找到的x+10,y-10位置, "10,10,2000"表示点击10,10坐标后延时2000毫秒, 该参数会受zm.SetTap 设置超级点击影响
显示日志	字符串	可选, 输出调试日志信息, 省略默认为"隐藏", 支持 ["显示","显示找到", "显示没找到","隐藏","show", "showfind", "shownofind","hide"] 这几个值
输出行号	字符串	可选, 格式为"_"开头后跟行号, 比如"_10"表示第10行代码, 输出调试信息窗口显示第几行代码, 需开启显示日志才有效
备注	字符串	可选, 格式为"@"开头后跟内容, 比如"@拾取屠龙刀", 输出调试信息窗口就会增加这条内容, 若连续两个"@@"则表示在浮窗中显示信息, 需要开启显示日志才有效
等待消失	数值型	可选, 填写-1禁用或-2启用, -2表示找到后或点击后继续查找, 直到找不到或消失超时, 省略默认为-1, 启用后返回值将有miss键名, 值为true时表示成功消失, 值为false表示未消失
消失超时	数值型	可选, 填写负数, 表示等待消失的超时时间, 单位毫秒, 注意必须填写负数, 不可填-1和-2, 省略默认为-2000
参数返回值	表	可选, 只能传入数组变量名, 用于保存查找结果, 格式与命令返回值相同

📤返回

表 , 找到返回结果保存到表中, 格式为{id, x, y, name, "id":id, "x":x, "y":y, "name":name, "miss":miss}, 没找到或出错返回null, 使用方法请看示例

💡示例

Import "zm.luae" //导入插件,只需执行一次
zm.Init  //初始化插件,只需执行一次

//本命令内置找到后点击, 其他用法例子与zm.FindMultiColor()相同
Dim ret
ret = zm.FindMultiColorTap("BDBDBD", "56|33|614B6B", "242424", "-10|2|ABC54A,9|4|12DC67")
If ret Then
    TracePrint "颜色找到并执行了点击"
Else
    TracePrint "没有找到颜色, 不执行点击"
End If

📘备注

• 内置找到后点击坐标, 无法取消, 建议需要点击操作的超级图色使用本命令, 方便代码阅读理解
• 该命令用法灵活多变, 更多用法请大家自行摸索, 灵活使用输出日志可以事半功倍
• 多点找色数据请通过抓抓进行获取
• 偏色是微调，指对RBG三色分别确定取色范围。相似度是粗调，指对颜色整体做百分比判断。
• 偏移颜色组是指相对于第一个点的偏移坐标与颜色，比如第一个点颜色123456在100,120坐标，第二个点颜色abcdef在150,180坐标，那么点2相对于点1的偏移坐标就是150-100,180-120，偏移颜色组为“50|60|abcdef”。
• V1.1820: 加入命令
• V2.1826
  • 为智能相似度增加另一种方便的写法, 旧语法依旧有效
• V3.1852:
  • 偏移颜色组参数支持带小数点坐标
  • 启用检测是否消失功能后, 返回最后一次出现的坐标与序号, 保存在键名missx, missy, missid中
• V4.2039: 加入颜色描述数组数据支持
• V4.2042: 日志参数 showlog 加入 ["显示找到","显示没找到","showfind","shownofind"] 选项