# 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 密码只会发给本地标定服务，不会保存到项目文件。