#ifndef THFEATURE_I_H
#define THFEATURE_I_H

#include "THFaceImage_i.h"

/*
* ============================================================================
*  Name     : THFeature_i.h
*  Part of  : Face Feature (THFeature) SDK
*  Created  : 10.18.2016 by xxx
*  Description:
*     THFeature_i.h -  Face Feature(THFeature) SDK header file
*  Version  : 5.0.0
*  Copyright: All Rights Reserved by XXX
*  Revision:
* ============================================================================
*/

#define THFEATURE_API extern "C" __attribute__((visibility ("default")))

struct TH_Image_Data
{
	BYTE* bgr;//MUST BE bgr format buffer,the size is width*height*3 bytes
	int width;//image width
	int height;//image height
};

//////API define//////
THFEATURE_API void EF_SetDir(const char* modelDir, const char* tmpDir);
/*
 The EF_SetDir function will set face feature environment directory,it must be called before EF_Init
 Parameters:
	modelDir[input],´æ·Å libTHFeature_db20a.soÎļþµÄĿ¼£¬Èç¹ûmodelDirΪNULL£¬ÔòʹÓÃĬÈÏ·¾¶¡°/mnt/sdcard/SysConfig/model/¡±
	tmpDir[input],ÁÙʱ¶ÁдĿ¼£¬¹©Ëã·¨³õʼ»¯Ê¹Óã¬Ëã·¨±ØÐë¾ßÓÐÁÙʱĿ¼ÏµĶÁдȨÏÞ,Èç¹ûtmpDirΪNULL£¬ÔòʹÓÃĬÈÏ·¾¶¡°"/mnt/sdcard/SysConfig/tmp/"¡±			
 Return Values:
	No return value.
 Remarks£º         
	It must be called before EF_Init.
*/

THFEATURE_API short EF_Init(int nChannelNum);
/*
The EF_Init function will initialize the Face Feature(THFeature) algorithm module

Parameters:
	nChannelNum,the channel number,support for muti-thread,one channel stand for one thread.max value is 32.
Return Values:
	If the function succeeds, the return value is valid channel number.
	If the function fails, the return value is 0 or nagative;
error code:
	-99,invalid license.
	-1,open file "feadb.db*" error
	-2,check  file "feadb.db*" error
	-3,read  file "feadb.db*" error
Remarks:
	This function can be called one time at program initialization.
*/

THFEATURE_API int EF_Size();
/*
The EF_Size function will return face feature size.

Parameters:
	No parameter.
Return Values:
	If the function succeeds, the return value is face feature size.
	If the function fails, the return value is 0 or nagative;
error code:
	-99,invalid license.
Remarks:
	No remark.
*/

THFEATURE_API int EF_Extract(short nChannelID, BYTE* pBuf, int nWidth, int nHeight, int nChannel, THFI_FacePos* ptfp, BYTE* pFeature);
/*
The EF_Extract function execute face feature extraction from one photo

Parameters:
	nChannelID[input],channel ID(from 0 to nChannelNum-1)
	pBuf[input],point to an image buffer,BGR format.
	nWidth[input],the image width.
	nHeight[input],the image height.
	nChannel[input],image buffer channel,must be 3
	ptfp[input],the facial data of a face.
	pFeature[output],the face feature buffer
Return Values:
	If the function succeeds, the return value is 1.
	If the function fails, the return value is nagative.
error code:
	-99,invalid license.
	-1,pBuf,ptfp,pFeature is NULL
	-2,nChannelID is invalid or SDK is not initialized
Remarks:
	No remark.
*/

THFEATURE_API int EF_Extract_M(short nChannelID, BYTE* pBuf, int nWidth, int nHeight, int nChannel, THFI_FacePos* ptfps, BYTE* pFeatures, int nFaceNum);
/*
The EF_Extract_M function execute face feature extraction for muti-faces from one photo

Parameters:
	nChannelID[input],channel ID(from 0 to nChannelNum-1)
	pBuf[input],point to an image buffer,BGR format.
	nWidth[input],the image width.
	nHeight[input],the image height.
	nChannel[input],image buffer channel,must be 3
	ptfps[input],the facial data of muti-faces
	pFeatures[output],the face feature buffer for muti-faces
	nFaceNum[input],the face number
Return Values:
	If the function succeeds, the return value is 1.
	If the function fails, the return value is 0 or nagative.
error code:
	-99,invalid license.
	-1,pBuf,ptfps,pFeatures is NULL
	-2,nChannelID is invalid or SDK is not initialized
Remarks:
	No remark.
*/

THFEATURE_API int EF_Extracts(short nChannelID, TH_Image_Data* ptids, THFI_FacePos* ptfps, BYTE* pFeatures, int nNum);
/*
The EF_Extracts function execute face feature extraction for muti-faces from muti-photos

Parameters:
	nChannelID[input],channel ID(from 0 to nChannelNum-1)
	ptids[input],the image data list of muti-photos
	ptfps[input],the facial data list of muti-photos(one image data-one facial data)
	pFeatures[output],the face feature buffer for muti-faces
	nNum[input],the image data number
Return Values:
	If the function succeeds, the return value is 1.
	If the function fails, the return value is 0 or nagative.
error code:
	-99,invalid license.
	-1,ptids,ptfp,pFeature is NULL
	-2,nChannelID is invalid or SDK is not initialized
Remarks:
	No remark.
*/

THFEATURE_API float EF_Compare(BYTE* pFeature1, BYTE* pFeature2);
/*
The EF_Compare function execute two face features compare.

Parameters:
	pFeature1[input],point to one face feature buffer.
	pFeature2[input],point to another face feature buffer.
Return Values:
	the return value is the two face features's similarity.
Remarks:
	No remark.
*/

THFEATURE_API void EF_Release();
/*
The EF_Release function will release the Face Feature (THFeature) algorithm module

Parameters:
	No parameter.
Return Values:
	No return value.
Remarks:
	This function can be called one time at program Un-Initialization.
*/

THFEATURE_API short EF_Init_Ex(int nChannelNum, int omp_thread_num=2);
/*
The EF_Init_Ex function will initialize the Face Feature(THFeature) algorithm module with openmp thread num

Parameters:
	nChannelNum,the channel number,support for muti-thread,one channel stand for one thread.max value is 32.
	omp_thread_num[input],thread num for openmp
Return Values:
	If the function succeeds, the return value is valid channel number.
	If the function fails, the return value is 0 or nagative;
error code:
	-99,invalid license.
	-1,open file "feadb.db*" error
	-2,check  file "feadb.db*" error
	-3,read  file "feadb.db*" error
Remarks:
	This function can be called one time at program initialization.
*/

#endif