Skip to main content
Esta página corresponde al SDK 2.0.0. Windows y Linux comparten la misma API C++ en el namespace facebetter (facebetter/*.h).
Esta guía compila el demo de escritorio C++ de Facebetter en Windows. El demo usa GLFW + Dear ImGui + OpenGL 3: vista previa en directo a la izquierda, controles de belleza a la derecha.

​
Requisitos

MinGW-w64 también funciona, pero se recomienda MSVC.

​
Paso 1: Clonar el repositorio

​
Paso 2: Colocar los archivos del SDK

Descomprime el paquete del SDK de Windows y coloca los archivos en demo/cpp/sdk/:
En escritorio, EngineConfig::resource_path debe apuntar al archivo resource.fbd, no a un directorio. Ejemplo: demo/cpp/sdk/resource/resource.fbd.
Los paquetes del SDK están en la página de Descargas y en la Consola.

​
Paso 3: Configurar la licencia

Establece app_id / app_key (autenticación v2 en línea) o license_token en el demo antes de ejecutarlo. Si license_token no está vacío, tiene prioridad (cadena del token de licencia, JSON {token} o contenido de .lic sin conexión). Detalles: Autenticación y licencia.

​
Paso 4: Compilar

Abre un Developer Command Prompt for VS (o PowerShell con el entorno MSVC cargado):
Tras la compilación, CMake normalmente:
  • Copia facebetter.dll junto al ejecutable en build/
  • Copia resource/resource.fbd a build/resource/resource.fbd
  • Copia demo.png (si existe) a build/resource/demo.png

​
Paso 5: Preparar una imagen de vista previa (opcional)

Coloca una foto de un rostro llamada demo.png en demo/cpp/:

​
Paso 6: Ejecutar

La ventana muestra:
  • Panel izquierdo — vista previa en directo con belleza aplicada
  • Panel derecho — Beauty Control Panel:
    • Belleza básica: suavizado / blanqueamiento / rubor / nitidez
    • Remodelado facial: 26 parámetros de remodelado (rango [-1.0, 1.0])
    • Remodelado corporal: 7 parámetros (rango [0.0, 1.0]; necesita resource_body.fbd)
    • Maquillaje: labial / rubor / sombra de ojos / delineador / cejas / pestañas / pupila / contorno
    • Filtro / sticker / fondo virtual
Haz clic en Reset All para poner las intensidades a cero.

​
Solución de problemas

Q: “facebetter.dll was not found” al iniciar
A: Confirma que existe demo/cpp/sdk/lib/facebetter.dll y vuelve a ejecutar cmake --build build para que CMake copie la DLL junto al ejecutable. Q: La creación del motor devuelve nullptr / licencia fallida
A: Apunta resource_path a resource.fbd y configura license_token o un app_id + app_key válidos. Consulta Autenticación y licencia. Q: CMake no encuentra Ninja
A: Ejecuta winget install Ninja-build.Ninja, o usa -G "Visual Studio 17 2022" y --config Release.

​
Siguientes pasos

Implementar belleza

Crea el motor, configura efectos y procesa fotogramas.

Referencia de la API

API C++ completa para Windows y Linux.