Facial Attribute (wearing mask) Detection

Facial attribute (wearing mask) detection

Windows interface specifications are detailed below,

The SDK currently only supports the detection of whether a person is wearing a mask or not

stid_facepro_attribute_create_handle

Function: creates a handle by loading the model file

Note:

  1. Since the handle of the current SDK does not support multi-threaded calls for the time being, if multi-threaded multiple calls are needed, multiple handles need to be created with each thread in a separate handle

  2. The initialization function only needs to be called once in a thread. You can call the face detection function multiple times later without creating a handle repeatedly

Statement:

STID_SDK_API
stid_result_t
stid_facepro_attribute_create_handle(
        stid_handle_t* out_handle,
        const char *model_filename
);

Parameters:

  • [out] out_handle returns the initialized handle. When such a handle is not in use, you need to call stid_facepro_attribute_destroy_handle to release resources

    Returns the initialized handle. When such a handle is not in use, you need to call destroy_handle to release resources

  • [in] model_filename passes in the path of attributes determination model file

Return:

  • [return] Successfully returns STID_OK, otherwise, it will return an error code

stid_facepro_attribute_destroy_handle

Function: releases the handle

Statement:

STID_SDK_API
void
stid_facepro_attribute_destroy_handle(
        stid_handlet handle
);

Parameters:

  • [in] handle handle to be released

Return:

None

stid_facepro_attribute_recognition

Function: Recognition of facial attributes. The SDK currently only supports the recognition of whether a person is wearing a mask or not

Statement:

STID_SDK_API
stid_result_t
stid_facepro_attribute_recognition(
        stid_handle_t handle,
        const stid_image_t* input_image,
        const stid_landmarks_t* input_landmarks,
        int face_count,
        stid_attribute_list_t **result
);

Parameters:

  • [in] handle handle initialized

  • [in] input_image face image

  • [in] input_landmarks array of landmarks of the faces to be detected

  • [in] face_count number of faces to be detected

  • [out] result array of attribute results

Return:

  • [return] Successfully returns STID_OK, otherwise, it will return an error code

stid_facepro_attribute_release_result

Function: Release attribute results

Statement:

STID_SDK_API
void
stid_facepro_attribute_release_result(
        const stid_attribute_list_t *attribute_result,
        int face_count
);

Statement:

  • [in] attribute_result array of attribute results

  • [in] face_count number of faces

Return:

None

Last updated