LiveFaceReco_RaspberryPi 项目使用教程

1. 项目目录结构及介绍

LiveFaceReco_RaspberryPi/
├── cmake/
├── demo/
├── img/
├── include/
├── models/
├── src/
├── tests/
│   └── ParallelVideoCapture/
├── .gitignore
├── CMakeLists.txt
├── LICENSE.txt
└── README.md

目录结构介绍

• cmake/: 包含项目的 CMake 配置文件。
• demo/: 包含项目的演示代码。
• img/: 存放人脸图像数据集的文件夹。
• include/: 包含项目所需的头文件。
• models/: 存放神经网络模型的文件夹。
• src/: 包含项目的源代码。
• tests/: 包含项目的测试代码，其中 ParallelVideoCapture/ 是一个子模块。
• .gitignore: Git 忽略文件配置。
• CMakeLists.txt: CMake 构建配置文件。
• LICENSE.txt: 项目许可证文件。
• README.md: 项目说明文档。

2. 项目启动文件介绍

项目的启动文件位于 src/ 目录下，主要包含以下文件：

• main.cpp: 主程序入口文件，负责初始化系统并启动人脸识别和活体检测功能。
• livefacereco.cpp: 实现人脸识别和活体检测的核心逻辑。
• ParallelVideoCapture.cpp: 实现并行视频捕获功能，提高视频处理效率。

启动流程

1. main.cpp: 初始化系统配置，加载人脸数据集和模型。
2. livefacereco.cpp: 调用人脸识别和活体检测算法，处理视频流。
3. ParallelVideoCapture.cpp: 并行捕获视频帧，提高处理速度。

3. 项目配置文件介绍

项目的配置文件主要包括 CMakeLists.txt 和 livefacereco.hpp。

CMakeLists.txt

CMakeLists.txt 是 CMake 构建系统的配置文件，定义了项目的构建规则和依赖项。主要配置项包括：

• 项目名称: 定义项目名称。
• 源文件: 指定需要编译的源文件。
• 依赖库: 指定项目依赖的库，如 OpenCV、ncnn 等。
• 编译选项: 设置编译选项和优化参数。

livefacereco.hpp

livefacereco.hpp 是项目的主要配置文件，包含以下关键配置项：

• project_path: 设置项目路径，指向人脸数据集的目录。
• record_face: 是否记录新的人脸到数据集。
• largest_face_only: 是否只检测最大的脸。
• distance_threshold: 人脸识别的距离阈值。
• face_thre: 人脸识别的置信度阈值。
• true_thre: 活体检测的置信度阈值。
• input_width/input_height: 输入视频的宽度和高度。
• output_width/output_height: 输出视频的宽度和高度。

通过调整这些配置项，可以优化项目的性能和功能。

---

以上是 LiveFaceReco_RaspberryPi 项目的目录结构、启动文件和配置文件的详细介绍。希望这份教程能帮助你更好地理解和使用该项目。