face_landmarks_c_api.h File Reference

#include "api_types.h"

Go to the source code of this file.

Functions
void *	rf_face_landmarks_init (const char *landmarks_path, rf_error_type *error)
void	rf_face_landmarks_close (void *face_landmarks_handle, rf_error_type *error)
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)
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)

Function Documentation

rf_face_landmarks_align_face()

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

rf_face_landmarks_close()

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

rf_face_landmarks_get()

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

rf_face_landmarks_init()

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

Initializes face landmarks detector.

Parameters

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

Returns

face landmarks detector handle