zm.SetCmpColorEx 设置CmpColorEx默认参数

文章目录

1. 1. 功能
2. 2. 语法
3. 3. 参数
4. 4. 返回值
5. 5. 示例
6. 6. 备注

功能

修改 zm.CmpColorEx 超级多点比色 的默认参数值。

语法

默认值 = zm.SetCmpColorEx(属性表)

参数

参数	数据类型	解释
属性表	表	按照指定格式对表中的键值对进行赋值, 例如{“sim”:0.8, “showlog”:”显示”}表示修改相似度默认为0.8, 日志输出默认为显示, 更多属性见下面表格

属性	默认值	数据类型	解释
sim	0.9	数值型	默认颜色相似度, 取值范围[0, 1.0], 越高越相似
autosim	“”	字符串	默认智能相似度, 格式为”最低相似度-最高相似度-相似度步长”
numsim	“1.0”	字符串	默认数量相似度, 取值范围[0, 1.0], 越高越相似
timeout	1	数值型	默认超时时间, 默认1毫秒
delaytime	10	数值型	循环对比间隔时间, 开启超时时间参数后, 如果发现设备出现卡顿, 可加大delaytime
delaytap	0	数值型	对比成功后如果要点击, 则延时一段时间再点击
tap	false	布尔型	找到后是否点击, 默认不点击
showlog	“隐藏”	字符串	日志输出显示, 可选 ["显示","显示找到","显示没找到","隐藏","show", "showfind", "shownofind","hide"] 这几个值
ret	null	数组型	参数返回值, 只能写数组变量名, 设置后, 若命令不带参数返回值, 则默认返回到此变量中

返回值

表 , 返回所有默认属性值, 可使用 For Each 遍历查看

示例

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

Dim IXYs() //预定义默认参数返回数组
//设置默认参数返回值IXYs, 若找色命令不填写参数返回值, 则默认保存在该变量中
//设置默认日志输出为显示状态, 后面所有 超级多点比色 都默认输出调试信息
zm.SetCmpColorEx {"ret":IXYs, "showlog":"显示"}
If zm.CmpColorEx("51|66|00AAFF") 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.SetCmpColorEx(t)
//可以通过For Each查看目前所有默认属性值, 参数列表中未出现的属性不建议修改
TracePrint "属性名:属性值"
For Each k , v In ret
    TracePrint k, ":", v
Next

备注

• 请严格按照参数列表的属性名与数据类型进行赋值改动
• V3.1830: 加入命令
• V3.1835: 加入循环对比间隔时间
• V3.1849:
  • 加入延时点击属性delaytap
  • 修改循环间隔时间默认为10毫秒
• V4.2042: 日志参数 showlog 加入 ["显示找到","显示没找到","showfind","shownofind"] 选项