Files
2026-04-27 11:12:00 +08:00

1.3 KiB

RTSP 单帧区域标定工具

这个工具用于从 RTSP 摄像头拉取一帧截图,然后在浏览器里标定展示柜格口和垃圾桶区域。

依赖

本机需要安装 ffmpeg,并且命令行可直接执行:

ffmpeg -version

启动

在项目根目录执行:

python3 tools/calibrator/server.py --host 127.0.0.1 --port 18090

然后打开:

http://127.0.0.1:18090

使用步骤

  1. 输入 RTSP 地址。
  2. 点击“抓取一帧”。
  3. 选择 r1c1r2c4 中的一个区域。
  4. 在截图上按顺时针或逆时针点击格口顶点。
  5. 每个格口建议标 4 个点;如果透视明显,可以标更多点。
  6. 标完 8 个格口后,选择 trash 并标定垃圾桶区域。
  7. 复制右侧生成的 TOML 配置。
  8. 把生成内容合入 config/example.toml 或实际部署配置。

坐标说明

导出的坐标是归一化坐标:

  • 左上角是 [0.0, 0.0]
  • 右下角是 [1.0, 1.0]

这样即使摄像头截图分辨率变化,标定结果也可以复用。

注意

  • 标定截图应来自真实安装角度。
  • 标定时展示柜门最好保持日常运行状态。
  • 垃圾桶区域只框垃圾桶开口和投放可见区域,不要框太大。
  • RTSP 密码只会发给本地标定服务,不会保存到项目文件。