dlib C++ 库

Dlib 是一个现代化的 C++ 工具包，包含机器学习算法以及用于在 C++ 中构建复杂软件以解决实际问题的工具。主项目文档和 API 参考请参阅 http://dlib.net。

编译 dlib C++ 示例程序

进入 examples 文件夹并输入以下命令：

mkdir build; cd build; cmake .. ; cmake --build .

这将编译所有示例程序。 如果你的 CPU 支持 AVX 指令集，可以通过以下方式启用它：

mkdir build; cd build; cmake .. -DUSE_AVX_INSTRUCTIONS=1; cmake --build .

这样做会使某些操作运行得更快。

最后，使用 Visual Studio 的用户通常应以 64 位模式进行编译。默认情况下，Visual Studio 的输出和自身执行都是 32 位的，因此需要显式指定使用 64 位。由于现在已不是 1990 年代，建议使用 64 位架构。可通过以下 cmake 命令实现：

cmake .. -G "Visual Studio 14 2015 Win64" -T host=x64

编译使用 dlib 的自定义 C++ 程序

examples 文件夹中包含一个 CMake 教程，其中详细说明了如何操作。此外，dlib 官网也提供了更多相关说明。

或者，如果你使用的是 vcpkg 依赖管理器，只需一条命令即可下载并安装集成有 CMake 的 dlib：

vcpkg install dlib

编译 dlib Python API

你可以从 PyPI 获取最新稳定版的 dlib 并直接安装：

pip install dlib

或者从 GitHub 获取最新版本并安装：

git clone https://github.com/davisking/dlib.git
cd dlib
pip install .

你还可以通过向 setup.py 传递参数或设置 DLIB_* 环境变量来更改构建设置。 例如，将环境变量 DLIB_NO_GUI_SUPPORT 设置为 ON 将会添加 cmake 选项 -DDLIB_NO_GUI_SUPPORT=ON。

运行单元测试套件

要编译并运行 dlib 单元测试套件，请输入以下命令：

cd dlib/test
mkdir build
cd build
cmake ..
cmake --build . --config Release
./dtest --runall

请注意，在 Windows 系统上，编译器可能会将测试可执行文件放置在名为 Release 的子文件夹中。如果是这种情况，则需要先进入该文件夹再运行测试。

本库采用 Boost 软件许可协议授权，许可协议全文可在 dlib/LICENSE.txt 中找到。简而言之，你可以根据自己的需求自由使用 dlib，甚至将其用于闭源商业软件中。

dlib 赞助方

本研究部分得到了美国国家情报总监办公室 (ODNI) 下属的情报高级研究计划局 (IARPA) 的支持，合同编号为 2014-14071600010。文中所表达的观点和结论仅属作者个人意见，不应被解释为 ODNI、IARPA 或美国政府的官方政策或明示或暗示的认可。

dlib 快速上手指南

环境准备

系统要求

• 支持 C++11 或更高版本的编译器
• 支持 Python 3.x（用于 Python API）

前置依赖

• CMake（版本 3.8 或以上）
• Python（可选，用于 Python API）
• 构建工具（如 make、ninja、Visual Studio 等）

安装步骤

编译 C++ 示例程序

进入 examples 文件夹并执行以下命令：

mkdir build; cd build; cmake .. ; cmake --build .

如果 CPU 支持 AVX 指令，可以启用以提高性能：

mkdir build; cd build; cmake .. -DUSE_AVX_INSTRUCTIONS=1; cmake --build .

对于 Visual Studio 用户，建议使用 64 位模式：

cmake .. -G "Visual Studio 14 2015 Win64" -T host=x64

编译自己的 C++ 程序

参考 CMakeLists.txt 文件配置。

也可以通过 vcpkg 安装 dlib：

vcpkg install dlib

编译 dlib Python API

从 PyPI 安装稳定版本：

pip install dlib

或从 GitHub 获取最新版本：

git clone https://github.com/davisking/dlib.git
cd dlib
pip install .

可通过设置环境变量或 setup.py 参数调整构建选项，例如：

export DLIB_NO_GUI_SUPPORT=ON

基本使用

以下是一个简单的 Python 示例，用于检测图像中的人脸：

import dlib
detector = dlib.get_frontal_face_detector()
img = dlib.load_image_array("test.jpg")
faces = detector(img)
print("检测到 {} 张人脸".format(len(faces)))

在 C++ 中，可以使用如下代码加载图像并检测人脸：

#include <dlib/image_processing.h>
#include <dlib/gui_widgets.h>

int main() {
    dlib::array2d<dlib::rgb_pixel> img;
    dlib::load_image(img, "test.jpg");
    dlib::frontal_face_detector detector = dlib::get_frontal_face_detector();
    auto faces = detector(img);
    std::cout << "检测到 " << faces.size() << " 张人脸" << std::endl;
    return 0;
}