将原 pycolmap 单文件验证程序重构为可部署 C++ 流式工程。
- 核心 pipeline 不依赖输入源。
- 部署时通过
config/config.yaml或命令行选择输入,不改 C++。 - 内置支持:
- 图片目录(测试/回放)
- 视频文件
- USB/V4L2 摄像头
- RTSP/HTTP/其他 OpenCV URI
- GStreamer pipeline
- 统一处理链:去畸变 -> ALIKED -> DB -> LightGlue -> 两视图几何 -> DB。
- Quadratic sequential offsets 默认
[1,2,4,8,16,32]。 - 历史特征缓存有固定上限,不随运行时间增长。
- 对外提供
StreamingPipeline::ProcessFrame(),以后接 ROS/厂商 SDK 时无需修改算法模块。
include/streaming_colmap/
core/ 配置和帧数据类型
io/ 输入流接口、目录源、OpenCV实时源、输入源工厂
vision/ 标定和去畸变
colmap/ ALIKED提取器、LightGlue匹配器、几何验证、数据库
pipeline/ 流式调度、缓存、统计
src/
config/
scripts/
./scripts/build.sh如果 COLMAP 安装目录无法自动找到:
./scripts/build.sh -Dcolmap_DIR=/usr/local/share/colmap只需要准备好 calib_front.json 并修改 config/config.yaml 中的输出路径。
./scripts/run_directory.sh /path/to/images./scripts/run_camera.sh 0也可以在 YAML 中设置:
source:
type: "camera"
camera_id: 0
backend: "v4l2"
width: 2560
height: 1440
fps: 10.0./scripts/run_rtsp.sh 'rtsp://user:pass@192.168.1.10/stream'在配置中:
source:
type: "gstreamer"
uri: "nvarguscamerasrc ! ... ! appsink drop=1 sync=false"程序入口保持不变:
./build/streaming_colmap --config config/config.yaml只要实地设备能通过 V4L2、RTSP、视频 URI 或 GStreamer 输出图像流,部署时只改配置/启动参数,不需要改算法代码。
如果某台工业相机只能使用厂商私有 SDK,那么任何程序都必须有一层 SDK 适配。该工程已把这层边界固定为 IFrameSource 或直接调用 StreamingPipeline::ProcessFrame(FramePacket);ALIKED、LightGlue、去畸变、几何验证和数据库代码仍然无需修改。
程序写出的 database.db 和 images_undistorted/ 可继续给 COLMAP mapper 使用:
colmap mapper \
--database_path /path/to/database.db \
--image_path /path/to/images_undistorted \
--output_path /path/to/sparse \
--Mapper.ba_refine_focal_length 0 \
--Mapper.ba_refine_principal_point 0 \
--Mapper.ba_refine_extra_params 0 \
--Mapper.ba_global_frames_ratio 1.2 \
--Mapper.ba_global_points_ratio 1.2 \
--Mapper.ba_use_gpu 1 \
--Mapper.ba_gpu_index 0camera / uri / gstreamer 默认启用独立采集线程。采集线程和 ALIKED/LightGlue 处理线程之间使用有界队列:
source:
async_capture: 1
queue_size: 2
drop_oldest: 1
buffer_size: 1当处理速度低于相机 FPS 时,默认丢弃队列中最旧的待处理帧,优先处理最新画面,避免延迟不断累积。对于 video 文件回放,程序自动使用同步读取,因此不会因为异步队列而跳过视频帧。
RTSP/USB 相机读取失败时可自动重连:
source:
reconnect_on_failure: 1
reconnect_delay_ms: 500
max_reconnect_attempts: -1-1 表示持续尝试重连。
程序处理 SIGINT 和 SIGTERM。本地运行可直接:
Ctrl+C作为 systemd 服务运行时,systemctl stop 发送的终止信号也会触发正常收尾:停止采集线程、关闭 COLMAP 数据库并输出最终统计。