Skip to main content
The Linux C++ SDK API is identical to the Windows API. Please refer to: 👉 Windows C++ API Reference The sections below cover Linux-specific notes only.

Linux-Specific Notes

Shared Library Loading

The SDK ships as a shared library libfacebetter.so. At runtime the OS must be able to locate it:

CMake Linkage

OpenGL Environment

A valid OpenGL context is required. Install the necessary graphics libraries first:
For headless servers (no display), use Mesa’s off-screen rendering:

external_context Field

If your application already manages an OpenGL context (e.g. via GLFW), set:
When true, the SDK does not create an internal GL context; all GPU calls run on the calling thread’s active context.

SetRenderView Not Available

This method exists only on iOS and macOS. Do not call it on Linux.

DISPLAY Environment Variable

When using a windowed GLFW display, an X11 or Wayland server must be present:
For remote SSH sessions, enable X11 forwarding:

Full API Documentation

For the complete reference covering all methods, enumerations, and data structures, see the Windows C++ API Reference — it applies equally to Linux.