feat: add rtsp snapshot calibrator
This commit is contained in:
52
tools/calibrator/README_zh.md
Normal file
52
tools/calibrator/README_zh.md
Normal file
@@ -0,0 +1,52 @@
|
||||
# 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 密码只会发给本地标定服务,不会保存到项目文件。
|
||||
Reference in New Issue
Block a user