Referencia de la API

SDK 2.0.0. Namespace facebetter. Misma API C++ pública que Windows. Headers: facebetter/*.h. Enumeraciones: Enumeraciones de parámetros. Autenticación: Autenticación y licencia.

Notas de Linux

Distribuye libfacebetter.so. Configura LD_LIBRARY_PATH, rpath o ldconfig.
Compila el SDK con ./scripts/build_linux.sh (salida build/linux/release) o CMake.
resource_path debe ser el archivo resource.fbd.
Crea el motor y procesa en el hilo cuyo contexto GL es el actual. Las texturas de entrada y salida deben pertenecer a ese contexto. Los fotogramas de CPU no necesitan un contexto GL del llamador. La config no tiene un flag de contexto.

target_include_directories(app PRIVATE /path/to/sdk/include)
target_link_libraries(app PRIVATE /path/to/sdk/lib/libfacebetter.so GL)

Logging

enum class LogLevel { Trace = 0, Debug, Info, Warn, Error, Critical };

struct LogConfig {
  bool console_enabled = false;
  bool file_enabled = false;
  LogLevel level = LogLevel::Info;
  std::string file_name = "";
};

static int BeautyEffectEngine::SetLogConfig(const LogConfig& config);

Llama a SetLogConfig antes de Create.

Motor

`EngineConfig`

Campo	Descripción
`app_id` / `app_key`	Autenticación nativa v2 en línea
`resource_path`	Ruta a `resource.fbd` (archivo, no directorio)
`license_token`	token / JSON `{token}` / `.lic` — si no está vacío, tiene prioridad

struct EngineConfig {
  std::string app_id;
  std::string app_key;
  std::string resource_path;
  std::string license_token;
};

static std::shared_ptr<BeautyEffectEngine> BeautyEffectEngine::Create(
    const EngineConfig& config);

Piel

int SetSmoothing(float intensity);          // [0, 1]
int SetSmoothingStyle(SmoothingStyle style);
int SetWhitening(float intensity);
int SetWhiteningStyle(WhiteningStyle style);
int SetRosiness(float intensity);
int SetBrightness(float intensity);       // [-1, 1], 0 neutral
int SetContrast(float intensity);
int SetSaturation(float intensity);
int SetColorTemperature(float intensity);
int SetColorTint(float intensity);
int SetClarity(float intensity);          // [0, 1]
int SetBeautySkinOnly(bool enabled);

Remodelado

int SetReshape(Reshape param, float intensity);  // [-1, 1]

Lista completa de Reshape: Enumeraciones de parámetros.

Remodelado corporal

int SetBodyReshape(BodyReshape param, float intensity);  // [0, 1]

Lista completa de BodyReshape: Enumeraciones de parámetros. Requiere resource_body.fbd. Consulta Paquetes de recursos opcionales.

Maquillaje

int SetLipstick(float);        int SetLipstickColor(LipstickColor);
int SetBlush(float);           int SetBlushStyle(BlushStyle); int SetBlushColor(BlushColor);
int SetContour(float);         int SetContourStyle(ContourStyle);
int SetEyeShadow(float);       int SetEyeShadowStyle(...); int SetEyeShadowColor(...);
int SetEyeLiner(float);        int SetEyeLinerStyle(...);  int SetEyeLinerColor(...);
int SetEyebrow(float);         int SetEyebrowStyle(...);   int SetEyebrowColor(...);
int SetEyelash(float);         int SetEyelashStyle(...);   int SetEyelashColor(...);
int SetPupil(float);           int SetPupilColor(PupilColor);

El labial es solo Color; la pupila es solo Color; el contorno es solo Style. Valores: Enumeraciones de parámetros.

Croma y fondo virtual

int SetChromaKey(ChromaKeyColor color);  // Green, Blue, Red
int ClearChromaKey();
int SetChromaKeySimilarity(float);
int SetChromaKeySmoothness(float);
int SetChromaKeyDesaturation(float);

int SetVirtualBackgroundBlur(float level);  // [0, 1]; 0 clears fill
int SetVirtualBackground(const std::string& image_path);
int SetVirtualBackground(const std::vector<uint8_t>& image_data);
int ClearVirtualBackground();

Filtro y sticker

Ruta o bytes .fbd codificados. No hay API de registro / ID. Entra en vigor en el siguiente ProcessImage.

int SetFilter(const std::string& fbd_file_path);
int SetFilter(const std::vector<uint8_t>& fbd_data);
int ClearFilter();
int SetFilterIntensity(float intensity);

int SetSticker(const std::string& fbd_file_path);
int SetSticker(const std::vector<uint8_t>& fbd_data);
int ClearSticker();
int AddResourcePack(const std::string& fbd_file_path);
int AddResourcePack(const std::vector<uint8_t>& fbd_data);
int Set3DSticker(const std::string& resource);
int Set3DSticker(const std::vector<uint8_t>& fbd_data);
int Clear3DSticker();

Carga primero los paquetes opcionales (resource_3d.fbd para stickers 3D, resource_body.fbd para remodelado corporal). Consulta Paquetes de recursos opcionales.

Estadísticas, callbacks, proceso

EngineStats GetStats() const;
int SetCallbacks(const EngineCallbacks& callbacks);
const std::shared_ptr<ImageFrame> ProcessImage(
    const std::shared_ptr<ImageFrame> image_frame);

Configura frame->type a FrameType::Image o FrameType::Video.

struct EngineStats {
  double fps = 0.0;
  double avg_process_time_ms = 0.0;
  double session_time_s = 0.0;
  size_t gpu_live_textures = 0;
  size_t gpu_live_meshes = 0;
};

Eventos

Código	Significado
`0`	Licencia correcta
`1`	Licencia fallida
`100`	Init completo
`101`	Init fallido

struct EngineCallbacks {
  std::function<void(int code, const std::string& message)> on_engine_event;
};

Imagen

enum class Format { I420, NV12, NV21, BGRA, RGBA, BGR, RGB, Texture };
enum class Rotation { Rotation_0, Rotation_90, Rotation_180, Rotation_270 };
enum class FrameType { Image = 0, Video = 1 };

Factories: CreateWithFile, Create, CreateWithRGBA/BGRA/RGB/BGR, CreateWithI420/NV12/NV21, CreateWithTexture. Ops: Rotate, Mirror(MirrorMode::Horizontal|Vertical|Both), SetMirror, Convert, ToFile. Rotate, Mirror y SetMirror solo modifican fotogramas de píxeles en CPU (RGBA, RGB, YUV y archivos de imagen). No transforman una textura OpenGL. Entregue la textura ya en orientación correcta. Accesores: Width/Height/Stride/Size/GetFormat/Data, planos YUV, Texture(). Campo: FrameType type.

Códigos de error

Código	Significado
`0`	OK
`-1`	Argumento no válido
`-2`	No inicializado
`-3`	Licencia
`-4`	No admitido
`-5`	E/S
`-6`	Proceso
`-7`	Memoria insuficiente

Serializa ProcessImage en un solo hilo. Los punteros de píxel Data() son de solo lectura.

Introducción

Android

iOS

macOS

Windows

Linux

Web

Notas de Linux

Logging

Motor

`EngineConfig`

Piel

Remodelado

Remodelado corporal

Maquillaje

Croma y fondo virtual

Filtro y sticker

Estadísticas, callbacks, proceso

Eventos

Imagen

Códigos de error

​Notas de Linux

​Logging

​Motor

​EngineConfig

​Piel

​Remodelado

​Remodelado corporal

​Maquillaje

​Croma y fondo virtual

​Filtro y sticker

​Estadísticas, callbacks, proceso

​Eventos

​Imagen

​Códigos de error

Notas de Linux

Logging

Motor

`EngineConfig`

Piel

Remodelado

Remodelado corporal

Maquillaje

Croma y fondo virtual

Filtro y sticker

Estadísticas, callbacks, proceso

Eventos

Imagen

Códigos de error