# VCLOpenMocap

**Repository Path**: seuvcl/vclopenmocap

## Basic Information

- **Project Name**: VCLOpenMocap
- **Description**: No description available
- **Primary Language**: C++
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 2
- **Created**: 2023-03-27
- **Last Updated**: 2024-04-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<!--
 * @Author: zhipeng Yu,  yuzhipeng1999@163.com
 * @Date: 2023-03-27 10:52:29
 * @LastEditors: zhipeng Yu,  yuzhipeng1999@163.com
 * @LastEditTime: 2023-03-28 16:04:20
 * 
 * Copyright (c) 2023 by zhipeng Yu, All Rights Reserved. 
-->
<p align="center">

  <h1 align="center">VCLOpenMocap</h1>
  <p align="center">
    <a href="https://gitee.com/zhipengyu"><strong>ZhiPeng Yu</strong></a>, <a href="https://gitee.com/rui-zhheng"><strong>Zhengheng Rui</strong></a>, <a href="https://gitee.com/seuvcl"><strong>YangangWang</strong></a>
  </p>
  <div align="center">
    <img src="./fig/teasor.jpg" alt="Logo" width="100%">
  </div>
</p>
<br />

## 介绍
VCLOpenMocap是用来驱动VCL多相机动捕系统的平台，当前支持人体、手部捕捉和重建。

## 软件架构
>vclopenmocap--+--3rdParty\
>&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;+--yingqi_studio\
>&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;+--code（解决方案下的项目YingQi是主机的代码，项目YingQi_client是从机的代码，通过修改additional_body_detect.hpp下的bool body_detect::my_detect()函数实现新的2D姿态检测算法，对应的输入和输出已经在源码中给出）

## 部署教程
此教程用于开发人员的代码部署，如果只是需要使用而非参与开发，请参照安装教程进行安装配置。

>1.  安装VS2019或VS2022。
>2.  安装QT5.9.9， 并在VS2019/2022中安装QT插件。（参考https://blog.csdn.net/c_general/article/details/120385519）
>3.  安装相机SDK（所需文件：SpinnakerSDK，Galaxy_Windows）
>4.  将依赖库3rdParty放置在根目录下（所需文件：3rdParty.zip.001和3rdParty.zip.002）。
>5.  将工作环境放置在根目录下，并将项目的输出路径和工作路径指向工作环境(所需文件：yingqi_studio.zip)

（所需文件百度网盘链接为：链接：链接: https://pan.baidu.com/s/1r0EFKJ4bwfF3mLEQOnSLPQ?pwd=vclm 提取码: vclm）

## 安装教程

如果仅应用项目而非参与开发，请参照以下步骤进行可执行程序的安装。

### 1、计算机--局域网配置

需要借助路由器实现多机的相互协作。

>1.  将每台PC的网口与路由器的LAN口进行直连，并将路由器上电。
>2.  浏览器中输入路由器背面所记录的IP地址进入管理界面。
>3.  将所有的PC连接到路由器对应的wifi下，并未每台PC机器绑定不同的IP地址。（注意记录主机的IP地址）
>4.  此时打开所有PC的“远程桌面连接”，使得在windows系统中能够实现PC之间的”远程桌面“进行互联。

### 2、软件配置

将SDK和软件配置到所有的PC机器上。

>1.  安装相机SDK（所需文件：SpinnakerSDK，Galaxy_Windows）
>2.  在主机和客户端上放置VCLstudio(所需文件：VCLstudio.zip)
>3.  为BodyStudio_GUI.exe和运行BodyStudio_client.exe创建快捷方式。

## 使用说明

如果只是使用已经安装好的项目而非从零开始安装项目，请参照以下的使用说明。

### 1、打开服务器端

>1.  打开BodyStudio_GUI.exe，此时会打开UI界面。在UI界面的左上角，可以实现单视角与多视角间的切换。在UI界面的右侧，包含了关于相机参数的设置，保存路径的修改，采集的帧数等。
>2.  先点击UI界面中的init the server，这一步操作是为了确保主机可以被从机绑定，从而使主机具备控制从机的能力。

<div align="center">
  <img src="./fig/GUI.jpg" alt="Logo" width="80%">
</div>

### 2、打开客户端

>1.  先打开BodyStudio_client_page.txt，将IP地址改为主机的IP，保证从机可以根据IP与主机进行连接；主机IP默认为192.168.31.2。也可以通过UI界面中的IP获得主机的当前IP，如下图所示。
>2.  打开从机中的BodyStudio_client.exe，只要命令窗口没出现报错或者闪退的情况就是OK的。

<div align="center">
  <img src="./fig/IP.jpg" alt="Logo" width="80%">
</div>

### 3、GUI控制
<div align="center">
  <img src="./fig/control.jpg" alt="Logo" width="80%">
</div>

### 4、数据的采集

>1.  对触发方式（Hardware trigger）以及相机属性进行调整，确保没问题后，按下GUI中的set all camera to the above parameters。
>2.  浏点击主机GUI中的start cap the video，此时从机做好接收数据的准备。
>3.  调节主板的参数，按实际需求调节帧率和帧数，并按下“确认”键，使单片机运行。单片机开始工作后，相机开始捕捉数据，并将数据采集到从机上，数据将保存在UI指定的路径下，默认D:\video；也可以修改到其他路径下。
>4.  数据采集完后，点击UI中的quit all the client即可退出系统。

### 注意事项：

* 运行BodyStudio_client.exe时会打印检测的到的相机数量，请检查是否和实际链接的相机数量一致。
* 初次运行BodyStudio_client.exe时会进行权重文件的转换，此时服务器会有一段时间的黑屏。
* 主机IP尽可能使用固定的IP：192.168.1.1的，但必须确保前三组网段是192.168.1.，从机可以直接修改Pico_client_page.txt.

## 参与贡献

若要参与贡献，请遵循拉取、合并、测试、推送的流程，请勿强制推送！

>1.  Fork 本仓库
>2.  新建 Feat_xxx 分支
>3.  提交代码
>4.  新建 Pull Request