Screen Picker

一个基于 Python 和 OpenCV 的轻量级交互式屏幕选区工具。它可以帮助开发者通过鼠标拖拽，快速获取屏幕特定区域的坐标信息（top, left, width, height）。

📌 项目背景

本项目最初是作为 @lol-aram-mayhem-hextech-helper 项目的辅助开发工具而创建的。

其核心用途是：帮助开发者快速、精确地划定游戏画面中 OCR（文字识别）的抓取范围。通过该工具获取的坐标，可以直接用于优化海克斯强化选项等文本的识别精度，显著降低调试坐标参数的时间成本。

🚀 功能特性

• 交互式选区：直接在屏幕截图上通过鼠标框选目标区域。
• 高兼容性：输出格式完美适配 mss 截图库和 pyautogui 的区域参数。
• 命令行支持：支持通过参数自定义截图前的延迟时间，方便切换窗口。
• 模块化设计：封装为 ScreenPicker 类，可轻松集成到其他自动化脚本或 AI 视觉项目中。

📦 安装步骤

1. 克隆仓库 (或直接下载脚本):

   git clone https://github.com/your-username/screen-picker.git
   cd screen-picker

2. 安装依赖:

   pip install -r requirements.txt

🛠 使用说明

1. 作为独立工具运行

直接运行脚本，可以通过 -d 或 --delay 设置延迟秒数：

# 默认 3 秒后截图
python screen_picker.py

# 设置 5 秒延迟，以便你有足够时间切换到游戏或特定应用窗口
python screen_picker.py --delay 5

2. 作为模块导入

在你的其他 Python 项目中调用：

from screen_picker import ScreenPicker

picker = ScreenPicker()
# 返回一个包含 top, left, width, height 的字典
coords = picker.pick_area(delay=3)

if coords:
    print(f"选定的区域坐标为: {coords}")

⌨️ 交互快捷键

• 鼠标左键拖拽：框选目标矩形区域。
• 回车 (Enter) / 空格 (Space)：确认当前选区并退出。
• C 键：取消当前选区并重新选择。
• ESC 键：退出程序。

📄 开源协议

MIT License