53 lines
1.3 KiB
Markdown
53 lines
1.3 KiB
Markdown
# RTSP 单帧区域标定工具
|
|
|
|
这个工具用于从 RTSP 摄像头拉取一帧截图，然后在浏览器里标定展示柜格口和垃圾桶区域。
|
|
|
|
## 依赖
|
|
|
|
本机需要安装 `ffmpeg`，并且命令行可直接执行：
|
|
|
|
```bash
|
|
ffmpeg -version
|
|
```
|
|
|
|
## 启动
|
|
|
|
在项目根目录执行：
|
|
|
|
```bash
|
|
python3 tools/calibrator/server.py --host 127.0.0.1 --port 18090
|
|
```
|
|
|
|
然后打开：
|
|
|
|
```text
|
|
http://127.0.0.1:18090
|
|
```
|
|
|
|
## 使用步骤
|
|
|
|
1. 输入 RTSP 地址。
|
|
2. 点击“抓取一帧”。
|
|
3. 选择 `r1c1` 到 `r2c4` 中的一个区域。
|
|
4. 在截图上按顺时针或逆时针点击格口顶点。
|
|
5. 每个格口建议标 4 个点；如果透视明显，可以标更多点。
|
|
6. 标完 8 个格口后，选择 `trash` 并标定垃圾桶区域。
|
|
7. 复制右侧生成的 TOML 配置。
|
|
8. 把生成内容合入 `config/example.toml` 或实际部署配置。
|
|
|
|
## 坐标说明
|
|
|
|
导出的坐标是归一化坐标：
|
|
|
|
- 左上角是 `[0.0, 0.0]`
|
|
- 右下角是 `[1.0, 1.0]`
|
|
|
|
这样即使摄像头截图分辨率变化，标定结果也可以复用。
|
|
|
|
## 注意
|
|
|
|
- 标定截图应来自真实安装角度。
|
|
- 标定时展示柜门最好保持日常运行状态。
|
|
- 垃圾桶区域只框垃圾桶开口和投放可见区域，不要框太大。
|
|
- RTSP 密码只会发给本地标定服务，不会保存到项目文件。
|