Skip to main content
SDK 2.0.0. Auth: Auth & License.

Return values

Create() returns nullptr on failure. ProcessImage may return nullptr.

Engine events


Common failures

1. Create returns nullptr

  • resource_path is not the resource.fbd file
  • Invalid license_token or app_id + app_key
  • Online auth cannot reach /facebetter/v2/auth
  • libfacebetter.so version mismatch

2. libfacebetter.so not found

You can also set RPATH at link time (-Wl,-rpath,/path/to/sdk/lib).

3. ProcessImage returns nullptr


4. Effects look unchanged

No SetBeautyTypeEnabled in 2.0. Set intensities > 0. Reshape / makeup need a face.

5. GLFW cannot open the display

SSH needs X11 forwarding (ssh -X) or a local compositor.

6. OpenGL init fails

Need OpenGL 3.0+. Headless servers can use OSMesa (libosmesa6-dev) with external_context set for your offscreen context.

Debug logs