Face Landmarks¶

Face Landmarks description

Functions

void *rf_face_landmarks_init(const char *landmarks_path, rf_error_type *error)¶

Initializes face landmarks detector.

Return

face landmarks detector handle

Parameters

landmarks_path: path to the landmarks model
error: output parameter to return an error details

void rf_face_landmarks_close(void *face_landmarks_handle, rf_error_type *error)¶

Deletes face landmarks detector.

Parameters

face_landmarks_handle: face landmarks handle
error: output parameter to return an error details

void rf_face_landmarks_get(void *face_landmarks_handle, void *image_handle, int ymin, int xmin, int ymax, int xmax, rf_int_vector_type *out_landmarks, rf_error_type *error)¶

Detects face landmarks for a face within bounding box.

Parameters

face_landmarks_handle: face landmarks handle
image_handle: full image handle (use image API to create)
ymin: the top y position of the bounding box where the face is located
xmin: the left x position of the bounding box where the face is located
ymax: the bottom y position of the bounding box where the face is located
xmax: the right x position of the bounding box where the face is located
out_landmarks: returns flattened array of 68 face landmarks points which are represented as 136 coordinates (y1, x1, y2, x2, …)
error: output parameter to return an error details

void rf_face_landmarks_align_face(rf_int_vector_type landmarks, void *image_handle, int ymin, int xmin, int ymax, int xmax, void **out_align_face, rf_error_type *error)¶

Alignes face based on supplied landmarks.

Parameters

landmarks: flattened array of 68 face landmarks (use rf_face_landmarks_get)
image_handle: image handle (use image API to create)
ymin: the top y position of the bounding box where the face is located
xmin: the left x position of the bounding box where the face is located
ymax: the bottom y position of the bounding box where the face is located
xmax: the right x position of the bounding box where the face is located
out_align_face: output parameter returns a handle of the aligned face
error: output parameter to return an error details