跑通 Windows 示例程序

本文介绍如何在 Windows 上构建并运行 Facebetter C++ 桌面 Demo。Demo 使用 GLFW + Dear ImGui + OpenGL 3 渲染，左侧实时预览美颜效果，右侧通过滑块控制各项参数。

环境要求

工具	版本要求
Visual Studio / MSVC	2019 或更高（含 C++17 支持）
CMake	3.16+
Ninja	任意最新版本（winget install Ninja-build.Ninja）
Windows SDK	10.0+

也可以使用 MinGW-w64，但推荐 MSVC。

第一步：获取示例源码

git clone https://github.com/pixpark/facebetter-sdk.git
cd facebetter-sdk

第二步：放置 SDK 文件

将 Windows SDK 压缩包解压后，按以下结构放入 demo/cpp/sdk/ 目录：

demo/cpp/sdk/
├── include/
│   └── facebetter/
│       ├── beauty_effect_engine.h
│       ├── beauty_params.h
│       ├── image_frame.h
│       └── type_defines.h
├── lib/
│   ├── facebetter.lib      ← 导入库
│   └── facebetter.dll      ← 运行时动态库
└── resource/
    └── resource.fbd        ← 模型与资源包

TIP

SDK 下载地址请前往 下载页面 或登录控制台查看。

第三步：构建

打开 Developer Command Prompt for VS（或 PowerShell 加载了 MSVC 环境），然后执行：

cd demo\cpp
cmake -B build -G "Ninja" -DCMAKE_BUILD_TYPE=Release
cmake --build build

CMake 在构建完成后会自动：

• 将 facebetter.dll 复制到 build/ 目录旁边
• 将 resource/resource.fbd 复制到 build/resource/resource.fbd
• 将 demo.png（如果存在）复制到 build/resource/demo.png

第四步：准备预览图（可选）

将任意一张人脸图片命名为 demo.png，放到 demo/cpp/ 目录下：

demo/cpp/demo.png

引擎会每秒约 30 帧地对该图片应用美颜效果，并在窗口左侧实时显示结果。

第五步：运行

cd demo\cpp\build
.\facebetter_demo.exe

程序运行后，窗口左侧为预览区，右侧为美颜控制面板：

• Basic Beauty：磨皮 / 美白 / 红润 / 锐化
• Face Reshape：瘦脸 / V脸 / 窄脸 / 短脸 / 颧骨 / 下颌 / 下巴 / 鼻梁 / 大眼 / 眼距
• Makeup：口红 / 腮红
• Sticker：贴纸选择（Off / rabbit）

点击 Reset All 可一键恢复所有参数为默认值。

常见问题

Q：提示找不到 facebetter.dll
A：确认 demo/cpp/sdk/lib/facebetter.dll 存在，重新执行 cmake --build build 即可重新复制。

Q：窗口显示 "Put demo.png …"
A：在 demo/cpp/ 目录下放置名为 demo.png 的人脸图片，然后重新运行。

Q：CMake 提示找不到 Ninja
A：执行 winget install Ninja-build.Ninja 安装，或将 -G "Ninja" 替换为 -G "Visual Studio 17 2022" 并去掉 -DCMAKE_BUILD_TYPE=Release（改为 --config Release）。