pyautogui 文档（五）：截图及定位功能

截图函数

PyAutoGUI能够截取屏幕截图，将其保存到文件中，并在屏幕中查找图像。若是您有一个小图像，例如须要单击并但愿在屏幕上找到它的按钮，这将很是有用。这些功能由PyScreeze模块提供，该模块与PyAutoGUI一块儿安装。

屏幕截图功能须要Pillow模块。OS X使用操做系统screencapture附带的命令。Linux使用该scrot命令，能够经过运行来安装。sudo apt-get install scrot

截图（）函数

调用screenshot()将返回Image对象（有关详细信息，请参阅Pillow或PIL模块文档）。传递文件名字符串会将屏幕截图保存到文件中，并将其做为Image对象返回。

>>> import pyautogui >>> im1 = pyautogui.screenshot() >>> im2 = pyautogui.screenshot('my_screenshot.png')

在1920 x 1080的屏幕上，该screenshot()功能大约须要100毫秒 - 它并不快，但速度并不慢。

region若是您不想要整个屏幕的屏幕截图，还有一个可选的关键字参数。您能够传递区域左侧，顶部，宽度和高度的四个整数元组来捕获：

>>> import pyautogui >>> im = pyautogui.screenshot(region=(0,0, 300, 400))

定位函数

注意：从版本0.9.41开始，若是locate函数找不到提供的图像，它们将引起ImageNotFoundException而不是返回None。

若是您有图像文件，能够在屏幕上直观地找到某些内容。例如，假设计算器应用程序正在您的计算机上运行，​​看起来像这样：

若是您不知道计算器按钮的确切屏幕坐标，则没法调用moveTo()和click()函数。每次启动计算器时，计算器都会出现略微不一样的位置，致使您每次都从新找到坐标。可是，若是您有按钮的图像，例如7按钮的图像：

...你能够调用locateOnScreen('calc7key.png')函数来获取屏幕坐标。返回值是一个4整数元组:(左，顶，宽，高）。能够传递此元组center()以得到该区域中心的X和Y坐标。若是在屏幕上找不到图像，则locateOnScreen()加注ImageNotFoundException。

>>> import pyautogui >>> button7location = pyautogui.locateOnScreen('calc7key.png') >>> button7location Box(left=1416, top=562, width=50, height=41) >>> button7location[0] 1416
>>> button7location.left 1416
>>> button7point = pyautogui.center(button7location) >>> button7point Point(x=1441, y=582) >>> button7point[0] 1441
>>> button7point.x 1441
>>> button7x, button7y = button7point >>> pyautogui.click(button7x, button7y)  # clicks the center of where the 7 button was found
>>> pyautogui.click('calc7key.png') # a shortcut version to click on the center of where the 7 button was found

可选confidence关键字参数指定函数在屏幕上定位图像的准确性。若是函数因为可忽略的像素差别而没法定位图像，这将很是有用：

>>> import pyautogui >>> button7location = pyautogui.locateOnScreen('calc7key.png', confidence=0.9) >>> button7location Box(left=1416, top=562, width=50, height=41)

该locateCenterOnScreen()功能结合locateOnScreen()和center()：

>>> import pyautogui >>> x, y = pyautogui.locateCenterOnScreen('calc7key.png') >>> pyautogui.click(x, y)

在1920 x 1080屏幕上，定位功能调用大约须要1或2秒。这对于动做视频游戏来讲可能太慢，但适用于大多数目的和应用程序。

有几个“定位”功能。他们都开始查看屏幕的左上角（或图像）并向右看，而后向下看。参数能够是a

• locateOnScreen(image, grayscale=False)- 返回image屏幕上第一个找到的实例的（左，顶部，宽度，高度）坐标。ImageNotFoundException若是在屏幕上找不到则会引起。
• locateCenterOnScreen(image, grayscale=False)- 返回image屏幕上第一个找到的实例中心的（x，y）坐标。ImageNotFoundException若是在屏幕上找不到则会引起。
• locateAllOnScreen(image, grayscale=False) - 返回一个生成器，该生成器生成（左，顶部，宽度，高度）元组，用于在屏幕上找到图像的位置。
• locate(needleImage, haystackImage, grayscale=False)-返回（左，上，宽度，高度）的第一坐标发现的实例needleImage在haystackImage。ImageNotFoundException若是在屏幕上找不到则会引起。
• locateAll(needleImage, haystackImage, grayscale=False)- 返回一个生成器（生成（左，顶部，宽度，高度）元组的位置needleImage）haystackImage。

“locate all”函数可用于for循环或传递给list()：

>>> import pyautogui >>> for pos in pyautogui.locateAllOnScreen('someButton.png') ... print(pos) ... (1101, 252, 50, 50) (59, 481, 50, 50) (1395, 640, 50, 50) (1838, 676, 50, 50) >>> list(pyautogui.locateAllOnScreen('someButton.png')) [(1101, 252, 50, 50), (59, 481, 50, 50), (1395, 640, 50, 50), (1838, 676, 50, 50)]

这些“定位”功能至关昂贵; 他们能够花一整秒钟来跑步。加速它们的最好方法是传递一个region参数（4个整数元组（左，顶部，宽度，高度））来仅搜索屏幕的较小区域而不是全屏：

>>> import pyautogui >>> pyautogui.locateOnScreen('someButton.png', region=(0,0, 300, 400))

灰度匹配

或者，您能够传递grayscale=True给locate函数以提供轻微的加速（大约30％-ish）。这会使图像和屏幕截图中的颜色去饱和，从而加快定位速度，但可能致使误判。

>>> import pyautogui >>> button7location = pyautogui.locateOnScreen('calc7key.png', grayscale=True) >>> button7location (1416, 562, 50, 41)

像素匹配

要获取屏幕截图中像素的RGB颜色，请使用Image对象的getpixel()方法：

>>> import pyautogui >>> im = pyautogui.screenshot() >>> im.getpixel((100, 200)) (130, 135, 144)

或者做为单个函数，调用pixel()PyAutoGUI函数，它是之前调用的包装器：

>>> import pyautogui >>> pix = pyautogui.pixel(100, 200) >>> pix RGB(red=130, green=135, blue=144) >>> pix[0] 130
>>> pix.red 130

若是您只须要验证单个像素与给定像素匹配，请调用该pixelMatchesColor()函数，向其传递X坐标，Y坐标和它所表明颜色的RGB元组：

>>> import pyautogui >>> pyautogui.pixelMatchesColor(100, 200, (130, 135, 144)) True >>> pyautogui.pixelMatchesColor(100, 200, (0, 0, 0)) False

可选tolerance关键字参数指定在匹配时每一个红色，绿色和蓝色值能够变化的程度：

>>> import pyautogui >>> pyautogui.pixelMatchesColor(100, 200, (130, 135, 144)) True >>> pyautogui.pixelMatchesColor(100, 200, (140, 125, 134)) False >>> pyautogui.pixelMatchesColor(100, 200, (140, 125, 134), tolerance=10) True

来源：https://pyautogui.readthedocs.io/en/latest/screenshot.html#