AutoIt ImageSearch透明图像搜索参数失效的实现方案求助

核心失效原因 #

• 原有函数调用的参数逻辑完全和类库的设计规则相悖：
  • 传入的第9个参数2，对应类库的规则是“将指定色值作为核心匹配目标”，而非“将色值作为需要忽略的透明背景”
  • 传入的第10个参数0x000000是固定纯黑色值，既没有触发透明识别的分支开关，也没有起到跳过背景的作用
• 常规BMP格式本身不支持存储Alpha透明通道信息，如果检索目标图是无通道信息的普通位图，无论怎么调整参数都无法实现透明背景识别

可落地的实现步骤 #

适配现有类库的透明识别逻辑 #

• 确认类库的参数触发规则：对应版本的ImageSearch，仅当透明匹配参数传入-1时，才会启动Alpha通道解析逻辑，自动跳过透明像素只匹配图像有效前景内容
• 调整目标检索图的存储格式：将带透明通道的目标图保存为标准32位PNG格式，不要使用无通道信息的BMP格式做检索源文件
• 替换原有函数调用的错误参数，修正后的写法如下：

$array = _ImageSearchArea("bul.png", 1, 0, 0, @DesktopWidth/2, @DesktopHeight/2, $x, $y, 1, -1)

• 参数对应说明：
  • 第9个匹配模式参数设为1：开启像素级匹配逻辑
  • 第10个透明参数设为-1：替换原有的固定黑值配置，触发Alpha通道读取分支

兼容兜底方案 #

如果类库版本不支持自动读取PNG的Alpha通道，可以改用固定色忽略模式实现近似透明识别：

• 提前采集目标图对应场景的典型背景色，将该色值作为需要跳过的参数传入，类库会自动忽略所有匹配该色值的像素，仅识别图像前景内容
• 匹配容差建议调整为0.8~1.2区间，避免屏幕渲染色差导致匹配失效

常见避坑提示 #

• 不要使用24位及以下位深的图像作为检索目标：这类文件本身不存储透明通道数据，无法触发透明识别逻辑
• 固定色忽略模式下，要确保设置的忽略色值不会和目标图的前景有效色彩重复，否则会导致类库跳过有效识别内容
• 原脚本的无限空循环需要补充基础延时，否则会占满CPU资源，导致热键响应延迟、屏幕截图卡顿，写法参考：

While 1
    Sleep(100)
WEnd

内容的提问来源于stack exchange，提问作者Burhan Taşkesen