FaceTracker 技术文档

本文档旨在帮助用户安装、使用 FaceTracker 库，并详细说明其 API 使用方法。

1. 安装指南

安装 OpenCV

首先，需要在您的系统上安装 OpenCV。以下是 macOS 和 Ubuntu 系统的安装方法。

• macOS:

  使用 Homebrew 安装：

  $ brew tap homebrew/science
  $ brew install opencv3
  

• Ubuntu:

  使用 apt-get 安装：

  $ sudo apt-get install libcv-dev libopencv-dev
  

  或者，您也可以从 GitHub 下载 OpenCV 源码并手动编译。

克隆 FaceTracker 仓库

安装完 OpenCV 后，使用 git 克隆 FaceTracker 仓库：

$ git clone git://github.com/kylemcdonald/FaceTracker.git

该仓库包含以下几个子目录：

• src：包含所有源代码。
• model：包含预训练的跟踪模型。
• bin：构建完成后将包含可执行文件。

修改 Makefile

确保您的 OpenCV 安装路径位于 /usr/local（如果您使用 apt-get 安装，则通常是这个路径）。如果不是，请修改 Makefile 中的 OPENCV_PATH。如果使用 Homebrew 安装，则应设置为 /usr/local/opt/opencv3。

可选地，您也可以在 CFLAGS 中添加 -fopenmp，在 LIBRARIES 中添加 -lgomp 来编译支持 OpenMP 的版本。

构建项目

从 FaceTracker 根目录，运行以下命令构建库和示例：

$ make

2. 项目使用说明

运行示例

构建完成后，进入 bin 目录，运行以下命令测试演示：

$ cd bin
$ ./face_tracker

如果您的摄像头默认分辨率为 1280x720，可以尝试运行以下命令来缩小图像，以获得更平滑的帧率：

$ ./face_tracker -s .25

使用参数

face_tracker 的使用参数如下：

Usage: face_tracker [options]
Options:
-m <string> : 跟踪模型路径 (默认: ../model/face2.tracker)
-c <string> : 连通性设置路径 (默认: ../model/face.con)
-t <string> : 三角剖分设置路径 (默认: ../model/face.tri)
-s <double> : 图像缩放比例 (默认: 1)
-d <int>    : 检测帧数 (默认: -1)
--check     : 检查失败
--help      : 打印帮助信息
-?          : 打印帮助信息

3. 项目 API 使用文档

FaceTracker 库的 API 使用方法将在后续版本的技术文档中详细说明。

4. 项目安装方式

请遵循本文档中的“安装指南”部分进行项目安装。