屏幕找图/找色/找字
在屏幕或窗口上查找指定图片、颜色或文字,返回匹配点坐标。常用来定位按钮、菜单后再点。
当前模块定义
sys:searchBmp输入 16 · 输出 4 · 枚举 3
输入参数
- 类型
typeEnum必填操作类型
4 个选项查找图片(文件、查找图片(变量、查找颜色
查找图片(文件默认locateByBitmapFile查找图片(变量locateByBitmapVar查找颜色locateByColor查找文字locateByText - 位图路径
bmpText必填需要在屏幕中查找的位图路径。位图必须和屏幕图像完全匹配,不能压缩。此时X、Y的值为相对于搜索位图的左上角的偏移。
- 位图变量
bmpVarImage必填需要在屏幕中查找的位图。位图必须和屏幕图像完全匹配,不能压缩。此时X、Y的值为相对于搜索位图的左上角的偏移。
- 颜色
colorText必填要查找的颜色,如#FF0000
- 文字
searchTextText可选要查找的文字。可使用多行指定多组可选文字,找到任意一组即可。
- 查找范围
bmpTargetTypeEnum可选位图查找范围
4 个选项主屏幕、当前窗口、坐标范围
主屏幕默认MainScreen当前窗口CurrentWindow坐标范围Rect所有屏幕AllScreens - 查找坐标范围
searchRectText可选可选。当"查找范围"为"坐标范围"时有效,格式为:left,top,right,bottom
- 定位位置
bmpPositionEnum可选定位点相对位图的位置
5 个选项位图中间、左上角、右上角
位图中间默认Center左上角TopLeft右上角TopRight左下角BottomLeft右下角BottomRight - X偏移
xInteger必填定位点水平坐标偏移量(正值向右)
- Y偏移
yInteger必填定位点垂直坐标偏移量(正值向下)
- 颜色容差
bmpColorErrorInteger可选匹配像素时允许每个颜色通道的偏差值0-100,0表示精确匹配,速度最快。
- 最大匹配
maxFindCountInteger可选找图的最大匹配数量。将对每个查找到的目标执行附加动作。
- 重试次数
retryCountInteger可选未找到位图时的重试次数。每次重试间隔300ms。
- 跳过WindowsOCR引擎
ignoreWindowsOcrBoolean可选 - 忽略背景色
ignoreBgColorBoolean可选如果查找图片的4个顶点颜色一致,则认为是背景色,找图时忽略此颜色。
- 失败后中止动作
stopIfFailBoolean可选获取位置失败后,是否停止后续动作的执行。
输出参数
- 是否成功
isSuccessBoolean操作是否成功
- 第一个匹配点
firstPointText第一个匹配点坐标,格式为:x坐标,y坐标
- 匹配序号
imgIndexInteger从多个图片或多组文字中查找时,返回匹配到的图片或文字组序号,从0开始。
- 所有匹配点
allPointsList所有的匹配点列表
概述
例如要点一个按钮:先把按钮截成 png,再用本模块在屏幕上搜,得到坐标。鼠标输入 里也有「移动到位图位置」,找到后会直接点,但不返回坐标。本模块只回报位置,不点击。
屏幕找图/找色/找字
参数说明
类型:
- 查找图片(文件)
- 查找图片(变量)
- 查找颜色
- 查找文字
位图路径:仅查找图片(文件)。完整路径。可多行,按顺序试,命中一个就停。截图请存 png / bmp,不要用 jpg(有损压缩对不上)。截的时候别把鼠标停在目标上,避免悬浮变色。
位图变量:仅查找图片(变量)。事先用截图或读文件加载。
颜色:仅查找颜色。如 #FF0000。
文字:仅查找文字。可多行写多组,命中任意一组即可。
查找范围:主屏幕、当前窗口、坐标范围、所有屏幕。旧稿未写「所有屏幕」。
查找坐标范围:查找范围为「坐标范围」时填写,格式 left,top,right,bottom,例如 0,0,800,600。
定位位置:仅找图。返回点相对位图的位置(下图红点):位图中间、左上角、右上角、左下角、右下角。

X偏移 / Y偏移:在定位点上再平移。正值向右、向下。
颜色容差:仅找图、找色。每个颜色通道允许的偏差 0–100。0 是精确匹配,也最快。默认 10。
屏幕找图/找色/找字
最大匹配:仅找图。最多找几个匹配。默认 1。
重试次数:找不到时再试几次,每次间隔 300ms。
跳过WindowsOCR引擎:仅找字。旧稿未写。
忽略背景色:仅找图。查找图四个顶点颜色一样时,把这种颜色当背景忽略。默认开启。旧稿未写。
失败后中止动作:找不到是否停止后续步骤。默认开启。
输出
- 是否成功:是否至少找到一处。
- 第一个匹配点:从左上往右、往下的第一处,格式
x,y。 - 匹配序号:从多张图或多组文字里查找时,命中的是第几组,从
0起。仅找图(文件)、找字。旧稿未写。 - 所有匹配点:全部匹配点列表。找色没有这项。
找图失败时
截图和屏幕不一致:
- 截的时候鼠标造成了悬浮态。先把鼠标移开,开始截图后再框目标。
- 分辨率、软件版本或界面变了。保持环境一致,关掉会动态改色的工具。
- 窗口没对齐到整像素,边缘会有轻微差。
- 存成了 jpg。改存 png。
目标图尽量小,只要能认出特征:
还不稳就加大颜色容差,或改成整个屏幕再搜。目标还没出现时,前面加等待,或加大重试、放进循环。
社区增强版子程序(容错更高):
屏幕找色
在屏幕或窗口里找指定颜色第一次出现的位置。
屏幕找图/找色/找字
把「第一个匹配点」交给鼠标输入,移动并点击:

鼠标输入
屏幕找字
按从上到下、从左到右,找指定文字第一次出现的位置。引擎是 Windows 内置 OCR + 基础OCR。面向专业版;免费版能用,但半速。
使用条件:
- Windows OCR 需要 Windows 10 / 11,并在系统设置里至少装中、英两种语言包。

- 离线 OCR 只要 64 位系统,CPU 支持 AVX。
注意:目标区域里不要有多处相近文字,必要时用坐标范围收窄;少用标点、空格,OCR 容易认错;找字本身有一定失败率。
屏幕找图/找色/找字
示例动作
相关链接
更新历史
- 1.1.4:增加此模块。
- 1.23.4:增加找色。
- 1.38.1:增加找字。
更新于