PyScreeze 1.0.1

PyScreeze

PyScreeze是Python 3的一个简单、跨平台的截图模块。

关于Ubuntu的特别说明

如果您的Ubuntu系统使用较旧的X11窗口系统，您必须通过运行sudo apt install python3-xlib来安装Xlib。这需要您的计算机管理员密码。

截图() 函数

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

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

在 1920 x 1080 的屏幕上，screenshot() 函数大约需要 100 毫秒 - 它既不快也不慢。

还有一个可选的 region 关键字参数，如果您不想截图整个屏幕。您可以传递一个包含区域的左、上、宽和高的四个整数的元组来捕获

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

定位函数

如果您有一个图像文件，您可以可视化地定位屏幕上的某个东西。您可以通过调用 locateOnScreen('calc7key.png') 函数来获取计算器应用中 7 按钮的屏幕坐标。返回值是一个 4 个整数的元组：(left, top, width, height)。这个元组可以传递给 center() 来获取这个区域的中心 X 和 Y 坐标。如果图像在屏幕上找不到，locateOnScreen() 返回 None。（PyAutoGUI 是一个模拟鼠标点击的模块。）

>>> import pyscreeze, pyautogui
>>> button7location = pyscreeze.locateOnScreen('calc7key.png')
>>> button7location
(1416, 562, 50, 41)
>>> button7x, button7y = pyscreeze.center(button7location)
>>> button7x, button7y
(1441, 582)
>>> pyautogui.click(button7x, button7y)  # clicks the center of where the 7 button was found

您可能最常使用的函数是 locateCenterOnScreen()

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

在 1920 x 1080 的屏幕上，定位函数调用大约需要 1 或 2 秒。这可能对于动作视频游戏来说太慢了，但对于大多数用途和应用程序来说都适用。

如果速度很重要，请安装可选的 opencv 库（pip install cv2）。如果可用，locateAll 计算将使用它，并在全屏搜索中找到所有匹配项时用时不到 1 毫秒。（这不包括捕获截图所需的时间。）

有几个“定位”函数。它们都是从屏幕（或图像）的左上角开始查找，然后向左再向下查找。参数可以是

• locateOnScreen(image, grayscale=False) - 返回屏幕上找到的第一个 image 实例的 (left, top, width, height) 坐标。如果未在屏幕上找到，则返回 None。

• locateCenterOnScreen(image, grayscale=False) - 返回屏幕上找到的第一个 image 实例的中心 (x, y) 坐标。如果未在屏幕上找到，则返回 None。

• locateAllOnScreen(image, grayscale=False) - 返回一个生成器，它产生屏幕上找到图像的位置的 (left, top, width, height) 元组。

• locate(needleImage, haystackImage, grayscale=False) - 返回 needleImage 在 haystackImage 中的第一个找到实例的 (left, top, width, height) 坐标。如果未在屏幕上找到，则返回 None。

• locateAll(needleImage, haystackImage, grayscale=False) - 返回一个生成器，它产生 needleImage 在 haystackImage 中找到的位置的 (left, top, width, height) 元组。

“定位所有”函数可以用在 for 循环中，或者传递给 list()

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