zm.SetFindMultiColor 设置FindMultiColor默认参数
🎯功能
修改 zm.FindMultiColor 超级多点找色 的默认参数值。
📜语法
默认值 = zm.SetFindMultiColor(属性表)
📥参数
参数 | 数据类型 | 解释 |
---|---|---|
属性表 | 表 | 按照指定格式对表中的键值对进行赋值, 例如 {"sim":0.8, "showlog":"显示"} 表示修改相似度默认为0.8, 日志输出默认为显示, 更多属性见下面表格 |
属性 | 默认值 | 数据类型 | 解释 |
---|---|---|---|
x1 | 0 | 数值型 | 查找范围左上角x坐标 |
y1 | 0 | 数值型 | 查找范围左上角y坐标 |
x2 | 0 | 数值型 | 查找范围右下角x坐标 |
y2 | 0 | 数值型 | 查找范围右下角y坐标 |
dir | "左上" | 字符串 | 默认从左上开始查找, 可选"左上" ,"中心" ,"右上" ,"左下" ,"右下" 这几个值 |
sim | 0.9 | 数值型 | 默认相似度, 取值范围[0, 1.0], 越高越相似 |
autosim | "" | 字符串 | 默认智能相似度, 格式为"最低相似度-最高相似度-相似度步长" |
timeout | 1 | 数值型 | 默认超时时间, 默认1毫秒 |
delaytime | 10 | 数值型 | 循环查找间隔时间, 开启超时时间参数后, 如果发现设备出现卡顿, 可加大delaytime |
delaytap | 0 | 数值型 | 找到后如果要点击, 则延时一段时间再点击 |
tap | false | 布尔型 | 找到后是否点击, 默认不点击 |
offsetxy | 0 | 数值型 | 对颜色偏移组的坐标实现再次偏移功能 |
showlog | "隐藏" | 字符串 | 日志输出显示, 可选 "显示" ,"显示找到" ,"显示没找到" ,"隐藏" ,"show" , "showfind" , "shownofind" ,"hide" 这几个值 |
ret | null | 数组型 | 参数返回值, 只能写数组变量名, 设置后, 若命令不带参数返回值, 则默认返回到此变量中 |
📤返回
表
, 返回所有默认属性值, 可使用 For Each
遍历查看
💡示例
Import "zm.luae" //导入插件,只需执行一次
zm.Init //初始化插件,只需执行一次
Dim IXYs() //预定义默认参数返回数组
//设置默认参数返回值IXYs, 若多点找色命令不填写参数返回值, 则默认保存在该变量中
//设置默认日志输出为显示状态, 后面所有 超级多点找色 都默认输出调试信息
zm.SetFindMultiColor {"ret":IXYs, "showlog":"显示"}
If zm.FindMultiColor("00AAFF", "1|4|1432AB") Then
TracePrint "可以用以下3种格式获取返回值"
TracePrint "找到颜色序号" & IXYs(0), "x=" & IXYs(1), "y=" & IXYs(2)
TracePrint "找到颜色序号" & IXYs[1], "x=" & IXYs[2], "y=" & IXYs[3]
TracePrint "找到颜色序号" & IXYs["id"], "x=" & IXYs["x"], "y=" & IXYs["y"]
End If
//默认值改动后, 效果会一直存在, 并且可以随时增加新的变化
//此处改动相似度默认为0.8, 超时时间为5000毫秒, 并将日志改为隐藏, 找到后自动点击一次
Dim t = {"sim":0.8, "timeout":5000, "tap":true, "showlog":"hide"}
Dim ret = zm.SetFindMultiColor(t)
//可以通过For Each查看 目前所有默认属性值, 参数列表中未出现的属性不建议修改
TracePrint "属性名:属性值"
For Each k , v In ret
TracePrint k, ":", v
Next
📘备注
- 请严格按照参数列表的属性名与数据类型进行赋值改动
- V1.1741: 加入命令
- V1.1745: 查找次数参数修改为超时参数, 加入自定义日志备注与行号, 其中设置相关的属性也有所变动
- V3.1835: 加入循环查找间隔时间
- V3.1849:
- 加入延时点击属性
delaytap
- 修改循环间隔时间默认为10毫秒
- 加入延时点击属性
- v3.1852
- 偏移颜色组参数可以通过 zm.SetFindMultiColor 设置FindMultiColor默认参数 设置
"offsetxy":1
属性或其他数字, 实现偏移坐标再次变动功能, 该属性不支持 zm.FindMultiColorEx 超级多点找色返回所有坐标
- 偏移颜色组参数可以通过 zm.SetFindMultiColor 设置FindMultiColor默认参数 设置
- V4.2042: 日志参数
showlog
加入["显示找到","显示没找到","showfind","shownofind"]
选项