> ## Documentation Index
> Fetch the complete documentation index at: https://docs.facebetter.net/llms.txt
> Use this file to discover all available pages before exploring further.

# 快速开始

> 在 Windows 上构建并运行 Facebetter C++ 桌面示例（GLFW + ImGui）

本文介绍如何在 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。

## 第一步：获取示例源码

```bash theme={null}
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 下载地址请前往 [下载页面](https://facebetter.net/zh/download) 或登录控制台查看。
</Tip>

## 第三步：构建

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

```bat theme={null}
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 帧地对该图片应用美颜效果，并在窗口左侧实时显示结果。

## 第五步：运行

```bat theme={null}
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`）。