mirror of
https://github.com/MaaAssistantArknights/MaaAssistantArknights.git
synced 2026-07-16 09:50:40 +08:00
636ffff7b3
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>
39 lines
1.7 KiB
Markdown
39 lines
1.7 KiB
Markdown
# 截图工具
|
||
|
||
本工具可以对 **预先准备好的截图** 或 **通过 ADB 连接设备**，进行 ROI 区域的截取、保存、取色操作。
|
||
|
||
## 环境
|
||
|
||
> 如果虚拟环境路径 venv/ 存在，start.bat 优先使用虚拟环境。
|
||
|
||
需要 `python` 环境，推荐版本为 `3.11` ，最低版本为 `3.9` 以上。
|
||
|
||
## 依赖
|
||
|
||
> [!TIP]
|
||
> windows 用户推荐直接运行 install.bat 和 start.bat
|
||
|
||
```shell
|
||
python -m pip install -r requirements.txt
|
||
```
|
||
|
||
## 使用
|
||
|
||
0. (非必要) 根据 `set_screenshot_target_long/short_side` 的使用情况，调整脚本中的 `截图参数` 和 `初始窗口大小`
|
||
1. 如果有预先准备好的截图，需保存到 `./src/` 路径下
|
||
2. 运行 `start.bat` 或 `python main.py [device serial]` ，设备地址为可选
|
||
- 根据提示 `Please select the device (ENTER to pass):` ，选择 adb 已连接设备（按 ENTER 跳过选择）
|
||
- 如果没有该提示，请使用 `python main.py [device serial]` 连接设备
|
||
3. 在弹窗中左键选择目标区域，滚轮缩放图片，右键移动图片
|
||
4. 使用快捷键操作：
|
||
- 按 <kbd>S</kbd> <kbd>ENTER</kbd> 保存目标区域
|
||
- 按 <kbd>F</kbd> 保存全屏标准化截图
|
||
- 按 <kbd>R</kbd> 不保存，只输出 ROI 范围
|
||
- 按 <kbd>C</kbd> 不保存，输出 ROI 范围和 ColorMatch 的所需字段，大写将使用 connected 字段
|
||
- 按 <kbd>Z</kbd> <kbd>DELETE</kbd> <kbd>BACKSPACE</kbd> 撤销
|
||
- 按 <kbd>0</kbd> ~ <kbd>9</kbd> 缩放窗口
|
||
- 按 <kbd>Q</kbd> <kbd>ESC</kbd> 退出
|
||
- 按 <kbd>任意键</kbd> 跳过 / 刷新当前截图
|
||
|
||
5. 目标区域截图保存在 `./dst/` 路径下，文件名为 `src` 中的文件名 / 截图的时间 + ROI + 放大后的 ROI
|