PyScreeze 技术文档

PyScreeze 技术文档

pyscreeze PyScreeze is a simple, cross-platform screenshot module for Python 2 and 3. 项目地址: https://gitcode.com/gh_mirrors/py/pyscreeze

1. 安装指南

1.1 系统要求

• Python 2 或 Python 3
• Pillow 模块（建议使用 8.3.2 及以上版本）
• 对于 Linux 系统，需要安装 scrot 命令

1.2 安装步骤

1. 安装 Pillow

   pip install Pillow
   

2. 安装 PyScreeze

   pip install PyScreeze
   

3. Linux 系统额外步骤 如果使用的是 Linux 系统，需要安装 scrot 命令：

   sudo apt-get install scrot
   

2. 项目使用说明

2.1 截图功能

PyScreeze 可以拍摄截图并保存到文件中。以下是基本用法：

import pyscreeze

# 获取截图并保存到文件
im1 = pyscreeze.screenshot()
im2 = pyscreeze.screenshot('my_screenshot.png')

2.2 区域截图

你可以指定截图的区域：

import pyscreeze

# 指定区域截图
im = pyscreeze.screenshot(region=(0, 0, 300, 400))

2.3 图像定位

PyScreeze 可以在屏幕上定位图像：

import pyscreeze

# 定位图像并点击
button7location = pyscreeze.locateOnScreen('calc7key.png')
button7x, button7y = pyscreeze.center(button7location)
pyscreeze.click(button7x, button7y)

3. 项目 API 使用文档

3.1 screenshot()

• 功能: 拍摄截图并返回 Image 对象。
• 参数:
  • region: 可选，指定截图区域。
• 返回值: Image 对象。

3.2 locateOnScreen(image, grayscale=False)

• 功能: 在屏幕上定位图像。
• 参数:
  • image: 要定位的图像文件路径。
  • grayscale: 可选，是否使用灰度匹配。
• 返回值: 图像在屏幕上的坐标 (left, top, width, height)。

3.3 locateCenterOnScreen(image, grayscale=False)

• 功能: 在屏幕上定位图像并返回中心坐标。
• 参数:
  • image: 要定位的图像文件路径。
  • grayscale: 可选，是否使用灰度匹配。
• 返回值: 图像中心坐标 (x, y)。

3.4 locateAllOnScreen(image, grayscale=False)

• 功能: 在屏幕上定位所有匹配的图像。
• 参数:
  • image: 要定位的图像文件路径。
  • grayscale: 可选，是否使用灰度匹配。
• 返回值: 生成器，返回所有匹配图像的坐标 (left, top, width, height)。

3.5 pixelMatchesColor(x, y, expectedRGB, tolerance=0)

• 功能: 检查指定像素是否匹配给定的颜色。
• 参数:
  • x: 像素的 X 坐标。
  • y: 像素的 Y 坐标。
  • expectedRGB: 期望的颜色值 (R, G, B)。
  • tolerance: 可选，颜色容差。
• 返回值: 布尔值，是否匹配。

4. 项目安装方式

4.1 使用 pip 安装

pip install PyScreeze

4.2 手动安装

1. 下载项目源码。
2. 解压并进入项目目录。
3. 运行安装命令：

   python setup.py install
   

通过以上步骤，你可以顺利安装并使用 PyScreeze 进行截图和图像定位操作。

pyscreeze PyScreeze is a simple, cross-platform screenshot module for Python 2 and 3. 项目地址: https://gitcode.com/gh_mirrors/py/pyscreeze