Files
MaaAssistantArknights/tools/ImageCropper/README.md
MistEO 456b9adcd2 refactor: CropRoi -> ImageCropper (#14379) (#14647)
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: SherkeyXD <57581480+SherkeyXD@users.noreply.github.com>
Co-authored-by: Lucien Shaw <myxlc55@outlook.com>
Co-authored-by: MistEO <18511905+MistEO@users.noreply.github.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: 不留 <weinibuliu@outlook.com>
Co-authored-by: Copilot <198982749+Copilot@users.noreply.github.com>
2025-11-06 15:32:35 +08:00

1.7 KiB
Raw Blame History

截图工具

本工具可以对 预先准备好的截图通过 ADB 连接设备,进行 ROI 区域的截取、保存、取色操作。

环境

如果虚拟环境路径 venv/ 存在start.bat 优先使用虚拟环境。

需要 python 环境,推荐版本为 3.11 ,最低版本为 3.9 以上。

依赖

Tip

windows 用户推荐直接运行 install.bat 和 start.bat

python -m pip install -r requirements.txt

使用

  1. (非必要) 根据 set_screenshot_target_long/short_side 的使用情况,调整脚本中的 截图参数初始窗口大小

  2. 如果有预先准备好的截图,需保存到 ./src/ 路径下

  3. 运行 start.batpython main.py [device serial] ,设备地址为可选

    • 根据提示 Please select the device (ENTER to pass): ,选择 adb 已连接设备(按 ENTER 跳过选择)
    • 如果没有该提示,请使用 python main.py [device serial] 连接设备
  4. 在弹窗中左键选择目标区域,滚轮缩放图片,右键移动图片

  5. 使用快捷键操作:

    • S ENTER 保存目标区域
    • F 保存全屏标准化截图
    • R 不保存,只输出 ROI 范围
    • C 不保存,输出 ROI 范围和 ColorMatch 的所需字段,大写将使用 connected 字段
    • Z DELETE BACKSPACE 撤销
    • 0 ~ 9 缩放窗口
    • Q ESC 退出
    • 任意键 跳过 / 刷新当前截图
  6. 目标区域截图保存在 ./dst/ 路径下,文件名为 src 中的文件名 / 截图的时间 + ROI + 放大后的 ROI