2.2.11. 1:1認証、1:N認証

stid_facepro_feature_comparison_create_handle

機能：指定のモデルファイルをロードすることで、ハンドルを作成します。

定義：

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

引数：

• [in] model_filename：モデルファイルの所在パスを入力してください。

• [out] out_handle：初期化されたハンドルです。利用しない時、stid_face_feature_destroy_handleを呼び出してリソースを解放する必要があります。

返り値：

• [return]：正常の場合はSTID_OKが表示、エラーになった場合はエラーコードが表示されます。

stid_facepro_feature_comparison_destroy_handle

機能：ハンドルを解放できます。

定義：

STID_SDK_API
void
stid_facepro_feature_comparison_destroy_handle(
    stid_handle_t handle
);

引数：

• [in] handle：解放するハンドルを入力します。

返り値：ありません。

stid_facepro_feature_comparison_compare

機能：1つの顔特徴を比較し、類似度スコアを取得できます（1:1 比較API）

定義：

STID_SDK_API
stid_result_t
stid_facepro_feature_comparison_compare(
    stid_handle_t handle,
    const char *feature1,
    const char *feature2,
    float *out_score
);

引数：

• [in] handle：初期化されたハンドルを表示します。

• [in] feature1：1枚目画像中の顔特徴情報

• [in] feature2：2枚目画像中の顔特徴情報

• [out] out_score：2つの顔の類似度スコア（類似度はスコアと正比例します）。

返り値：

• [return]：正常の場合はSTID_OKが表示、エラーになった場合はエラーコードが表示されます。

stid_facepro_feature_comparison_search_from_list

機能：一組の特徴アレイから顔を検索できます（1:N検索API）

定義：

STID_SDK_API
stid_result_t
stid_facepro_feature_comparison_search_from_list(
    stid_handle_t handle,
    char *const *feature_list,
    int list_size,
    const char *query,
    unsigned int top_k,
    int *top_idxs,
    float *top_scores,
    int *result_length
);

引数：

• [in] handle：初期化されたハンドルを表示します。

• [in] feature_list：顔特徴情報のアレイ

• [in] list_size：顔特徴情報の数

• [in] query：検索する顔特徴の情報

• [in] top_k：検索できる顔の最大数

• [out] top_idxs：顔検索結果のインデックスのアレイ（ユーザーで割り当て及び解放を行う）

• [out] top_scores：顔類似度スコアアレイ（ユーザーにより割り当て及び解放を行う） スコア範囲：0～1、類似度はスコアに正比例します。

• [out] result_length：実際に検索された顔の数

返り値：

• [return]：正常の場合はSTID_OKが表示されます（エラーになった場合はエラーコードが表示されます）