AHK 区域找图功能的使用和实例子

ImageSearch

在屏幕的某个区域中搜索图像.

ImageSearch, OutputVarX, OutputVarY, X1, Y1, X2, Y2, ImageFile

选择

参数

OutputVarX/Y

用来保存在屏幕上找到的图像的左上角像素的 X 和 Y 坐标的变量名 (如果没有找到匹配, 则这两个变量被置空). 坐标相对于活动窗口, 除非曾使用 CoordMode 改变了这个设置.

其中一个或两个参数都可以留空, 此时可以使用 ErrorLevel (请参阅下面) 来判断是否找到了匹配.

X1,Y1

要搜索的矩形区域的左上角的 X 和 Y 坐标, 可以为 表达式. 坐标相对于活动窗口, 除非曾使用 CoordMode 改变了这个设置.

X2,Y2

要搜索的矩形区域的右下角的 X 和 Y 坐标, 可以为 表达式. 坐标相对于活动窗口, 除非曾使用 CoordMode 改变了这个设置.

ImageFile

图像文件名, 如果未指定绝对路径则假定在 %A_WorkingDir% 中. 在所有的操作系统中都支持 GIF, JPG, BMP, ICO, CUR 和 ANI 图像 (BMP 图像必须为 16 位或更高). 图标的其他来源包含下列类型的文件: EXE, DLL, CPL, SCR 以及包含图标资源的其他类型. 在 Windows XP 或更高版本中, 还支持其他图像格式, 例如PNG, TIF, Exif, WMF 和 EMF. 比 XP 早的操作系统可以通过复制微软免费的 GDI+ DLL 到 AutoHotkey.exe 文件夹中来提供支持 (但如果是 已编译脚本, 则复制此 DLL 到脚本的文件夹). 要下载这个 DLL, 请在 www.microsoft.com 搜索下列短语: gdi redistributable

选项: 在文件名前面可以直接添加零个或多个下列字符串. 在选项间使用单个空格或 tab 分隔. 例如:*2 *w100 *h-1 C:\Main Logo.bmp.

*IconN:要使用文件中的图标组而不是首个图标,请指定 *Icon 后紧跟着图标组编号.例如,*Icon2 将加载第二个图标组中的默认图标.

*n (渐变值): 指定 n 为介于 0 和 255 (包含的) 之间的数字, 用于表示每个像素颜色红/绿/蓝通道强度在每个方向上允许的渐变值. 例如,*2 将允许二的渐变值.此参数可用于图像的颜色轻微变化或 ImageFile 使用的格式(例如 GIF 或 JPG)不能准确表示屏幕上的图像的时候.如果指定 255 为浮动的渐变值, 则匹配所有颜色. 默认渐变值为 0.

*TransN: 此选项通过指定图像内的某种颜色能匹配屏幕上的任何颜色, 使得更容易找到匹配. 它常用于寻找含有透明区域的 PNG, GIF 和 TIF 文件 (然而, 对于图标则不需要此选项, 因为它们的透明度是自动支持的). 对于 GIF 文件,*TransWhite 很可能会有用.对于 PNG 和 TIF 文件,*TransBlack 可能是最佳的.否则,指定 N 为其他颜色名称或 RGB 值(请参阅颜色图表进行了解或使用 PixelGetColor 的 RGB 模式).例如:*TransBlack,*TransFFFFAA,*Trans0xFFFFAA.

*wn 和 *hn:用于缩放图像尺寸的目标宽度和高度(此宽度和高度也决定了从多图标的 .ICO 文件中加载哪个图标).如果同时省略这两个选项,则把从 ICO,DLL 或 EXE 文件中加载的图标调整到系统默认的小图标大小,通常为 16 X16(通过指定 *w0 *h0 您可以强制使用实际/内部的大小).图标外的其他图像以它们的实际大小加载. 要保持高宽比来缩放图像, 请在其中一个尺寸中指定 -1 而在另一个中指定正数. 例如,指定 *w200 *h-1 将缩放图像到 200 像素的宽度同时自动设置其高度.

[v1.1.23+]: bitmap (位图) 或 icon (图标) handle (句柄) 可用于替代文件名. 例如, HBITMAP:*%handle%.

ErrorLevel

[v1.1.04+] 此命令在搜索遇到问题时会抛出异常. 想了解更多信息, 请参阅 运行时错误.

如果在指定的区域找到指定的图像, 则 ErrorLevel 被设置为 0, 没有找到则为 1, 而如果在命令执行过程中遇到问题使搜索无法进行 (例如打开图像文件失败或糟糕的格式选项) 则为 2.