# vcl-mvcap

**Repository Path**: seuvcl/vcl-mvcap

## Basic Information

- **Project Name**: vcl-mvcap
- **Description**: 这里是东南大学视觉认知实验室multiview capture官方使用仓库，如有疑问，可提交issue
- **Primary Language**: C++
- **License**: LGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-24
- **Last Updated**: 2025-08-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# vcl-mvcap

#### 介绍
这里是东南大学视觉认知实验室 **Multiview Capture** 官方使用仓库。  
本软件主要用于 **多视角数据采集、相机标定、同步视频拍摄**。  
采用 **Server-Client 架构**，通过局域网 socket 通信实现多机协同。  

如有疑问，可提交 issue。  

---

#### 软件架构
- **Server（mvcap_server.exe）**  
  - 负责统一控制，命令下发，文件读取与离线处理  
  - 需支持蓝牙连接与千兆网口  

- **Client（mvcap_client.exe）**  
  - 负责与相机及硬件同步器交互，执行图像采集  
  - 支持多相机并行同步采集  

- **通信方式**：Socket（默认端口 6000）  
- **数据存储**：客户端默认本地保存至 `D:/capture_out/`  

---

#### 安装教程

1. 准备硬件环境：  
   - **客户端**：  
     - 内存 ≥ 16GB  
     - NVMe SSD ≥ 1TB（写入 ≥ 3000MB/s）  
     - Intel i5-12 代或更高  
     - PCIe ×4 转 USB3.0 采集卡  
   - **服务端**：  
     - 内存 ≥ 16GB  
     - Intel i5-12 代或更高  
     - 千兆网口  
     - 蓝牙设备（USB 或主板集成）  

2. 分别运行服务端 `mvcap_server.exe` 与客户端 `mvcap_client.exe`  

---

#### 使用说明

1. **初始化主从机**  
   - 服务端运行 Multiview Capture，点击 `Init the server`  
   - 启动客户端，建立通信  

2. **相机标定**  
   - 打开 `Tools → Calibration`  
   - 设置棋盘格参数 → 内参标定 → 外参标定  
   - 设置基准平面高度  
   - 使用 `Save / Load` 保存或导入相机参数  

3. **同步视频拍摄**  
   - 在 Multiview 窗口查看多相机预览  
   - 设置相机参数（曝光 / 翻转 / 触发模式）  
   - 硬件触发同步采集，默认保存到 `D:/capture_out/`  

4. **视频格式转换**  
   - 使用 `File → Convert` 将 `.rby` 转换为 `.mp4` 或 `.jpg` 序列