Skip to main content
Esta página corresponde ao SDK 2.0.0. Linux e Windows compartilham a mesma API C++ no namespace facebetter (facebetter/*.h).
Este guia compila o demo desktop C++ do Facebetter no Linux. O demo usa GLFW + Dear ImGui + OpenGL 3: prévia ao vivo à esquerda, controles de beleza à direita.

Requisitos

Ubuntu / Debian

Fedora / RHEL

Passo 1: Clonar o repositório

Passo 2: Colocar os arquivos do SDK

Coloque o SDK Linux em demo/cpp/sdk/:
No desktop, EngineConfig::resource_path precisa apontar para o arquivo resource.fbd, não para um diretório. Exemplo: demo/cpp/sdk/resource/resource.fbd.
Os pacotes do SDK estão na página de Downloads e no Console.
Para compilar o SDK a partir do código-fonte em vez de um pacote pré-compilado:
A saída instala em build/linux/release. Você pode copiar include/, lib/libfacebetter.so e resource.fbd para demo/cpp/sdk/ como acima.

Passo 3: Configurar a licença

Defina app_id / app_key (autenticação online v2) ou license_token antes de executar. Se license_token não estiver vazio, ele tem prioridade (string do token de licença, JSON {token} ou conteúdo de .lic offline). Detalhes: Autenticação e licença.

Passo 4: Compilar o demo

O CMake normalmente copia resource/resource.fbd (e demo.png se presente) para build/resource/.

Passo 5: Preparar uma imagem de prévia (opcional)

Passo 6: Executar

A janela mostra uma prévia ao vivo e um painel de controle (pele, 26 parâmetros de remodelagem facial, 7 de remodelagem corporal, maquiagem, filtro, adesivo, fundo virtual). Clique em Reset All para zerar as intensidades.

Solução de problemas

Q: libfacebetter.so: cannot open shared object file
A: Use LD_LIBRARY_PATH=../sdk/lib ./facebetter_demo, copie o .so para ao lado do binário, ou adicione o caminho com ldconfig.
Q: A criação do mecanismo retorna nullptr / licença falhou
A: Aponte resource_path para resource.fbd e defina license_token ou app_id + app_key válidos. Veja Autenticação e licença.
Q: O CMake não encontra o OpenGL
A: Instale libgl1-mesa-dev (Ubuntu) ou mesa-libGL-devel (Fedora) e, em seguida, execute o CMake de novo.
Q: GLFW: X11: Display variable not set
A: Execute dentro de uma sessão gráfica, ou defina DISPLAY (X11) / WAYLAND_DISPLAY (Wayland).

Próximos passos

Implementar beleza

Crie o mecanismo, defina efeitos e processe quadros.

Referência da API

API C++ completa (igual à do Windows) mais notas do Linux.