C_API.h

Go to the documentation of this file.

#ifndef EVO_C_API_H_
#define EVO_C_API_H_
 
#ifdef __cplusplus
#   define EVO_EXTERN_C     extern "C"
#else
#   define EVO_EXTERN_C
#endif
 
#if defined(_WIN64)
#   ifdef EVOCAPI_EXPORTS
#       define EVOCAPI_DECLSPEC     EVO_EXTERN_C __declspec(dllexport)
#   else
#       define EVOCAPI_DECLSPEC     EVO_EXTERN_C __declspec(dllimport)
#   endif
#else //__linux__
#   define EVOCAPI_DECLSPEC     EVO_EXTERN_C
#endif
 
#include "Basic.h"

typedef int EvoObjID;

#define EVO_INV_OBJ_ID  -1
 

EVOCAPI_DECLSPEC EvoRC Evo_Initialize(const char *dnnRunMode,
                                      const char *dataDir,
                                      EvoObjID *idDDI);

EVOCAPI_DECLSPEC EvoRC Evo_GetLastRC(void);
 
#ifdef _WIN64

EVOCAPI_DECLSPEC EvoRC Evo_CvtUTF8ToCP(const char *utf8, char *cpBuf, unsigned bufLen);
 
#endif

EVOCAPI_DECLSPEC void Evo_FreeObj(EvoObjID *idObj);
 
//*********************************************************
// 
// DDI related functions
//
//*********************************************************

EVOCAPI_DECLSPEC EvoRC EvoDDI_GetNumDev(EvoObjID idDDI, unsigned *num);

EVOCAPI_DECLSPEC EvoRC EvoDDI_SelectDev(EvoObjID idDDI, unsigned idx);

EVOCAPI_DECLSPEC EvoRC EvoDDI_GetSelDev(EvoObjID idDDI, unsigned *idx);

EVOCAPI_DECLSPEC EvoRC EvoDDI_GetDevID(EvoObjID idDDI, char *buf, unsigned len);

EVO_DEPRECATED EVOCAPI_DECLSPEC EvoRC EvoDDI_GetNumDMDF(EvoObjID idDDI, unsigned *num);

EVO_DEPRECATED EVOCAPI_DECLSPEC EvoRC EvoDDI_GetDMDF(EvoObjID idDDI, unsigned idx, char *buf, unsigned len);

EVOCAPI_DECLSPEC EvoRC EvoDDI_GetFullName(EvoObjID idDDI, char *buf, unsigned len);
 
//*********************************************************
// 
// LPI related functions
//
//*********************************************************

EVOCAPI_DECLSPEC EvoRC EvoLPI_GetNumLP(EvoObjID idLPI, unsigned *num);

EVOCAPI_DECLSPEC EvoRC EvoLPI_SelectLP(EvoObjID idLPI, unsigned idx);

EVOCAPI_DECLSPEC EvoRC EvoLPI_GetSelLP(EvoObjID idLPI, unsigned *idx);

EVOCAPI_DECLSPEC EvoRC EvoLPI_GetType(EvoObjID idLPI, EvoLPT *type, float *confidence);

EVOCAPI_DECLSPEC EvoRC EvoLPI_GetPos(EvoObjID idLPI, EvoRect *rect);

EVOCAPI_DECLSPEC EvoRC EvoLPI_GetStr(EvoObjID idLPI, char *buf, unsigned len);

EVOCAPI_DECLSPEC EvoRC EvoLPI_GetCharConf(EvoObjID idLPI, float *buf, unsigned *num);
 
//*********************************************************
// 
// Picture related functions
//
//*********************************************************

EVOCAPI_DECLSPEC EvoRC EvoPic_GetImage(EvoObjID idPic, EvoImage *img);

EVOCAPI_DECLSPEC EvoRC EvoPic_GetTime(EvoObjID idPic, int64_t *time, EvoTimeUnit unit);

EVOCAPI_DECLSPEC EvoRC EvoPic_SaveInJPEG(EvoObjID idPic, const char *path, int quality);

EVOCAPI_DECLSPEC EvoRC EvoPic_SaveInPNG(EvoObjID idPic, const char *path, int compression);
 
//*********************************************************
// 
// GOP related functions
//
//*********************************************************

EVOCAPI_DECLSPEC EvoRC EvoGOP_GetNumPic(EvoObjID idGOP, unsigned *num);

EVOCAPI_DECLSPEC EvoRC EvoGOP_SelectPic(EvoObjID idGOP, unsigned idx);

EVOCAPI_DECLSPEC EvoRC EvoGOP_GetSelPic(EvoObjID idGOP, unsigned *idx);

EVOCAPI_DECLSPEC EvoRC EvoGOP_GetPicImg(EvoObjID idGOP, EvoImage *img);

EVOCAPI_DECLSPEC EvoRC EvoGOP_GetPicTime(EvoObjID idGOP, int64_t *time, EvoTimeUnit unit);

EVOCAPI_DECLSPEC EvoRC EvoGOP_GetPosInPic(EvoObjID idGOP, EvoRect *rect);

EVOCAPI_DECLSPEC EvoRC EvoGOP_GetHeadDir(EvoObjID idGOP, EvoHeadDir *heading);

EVOCAPI_DECLSPEC EvoRC EvoGOP_SavePicInJPEG(EvoObjID idGOP, const char *path, int quality);

EVOCAPI_DECLSPEC EvoRC EvoGOP_SavePicInPNG(EvoObjID idGOP, const char *path, int compression);

EVOCAPI_DECLSPEC EvoRC EvoGOP_SaveAllInTIFF(EvoObjID idGOP, const char *path, int quality);
 
//*********************************************************
// 
// GenICam Administrator related functions
// 
//*********************************************************

EVOCAPI_DECLSPEC EvoObjID EvoGIC_Admin_Get(void);

EVOCAPI_DECLSPEC EvoRC EvoGIC_Admin_UpdateDevList(EvoObjID idAdmin);

EVOCAPI_DECLSPEC EvoRC EvoGIC_Admin_GetNumDev(EvoObjID idAdmin, unsigned *num);

EVOCAPI_DECLSPEC EvoRC EvoGIC_Admin_SelectDev(EvoObjID idAdmin, unsigned idx);

EVOCAPI_DECLSPEC EvoRC EvoGIC_Admin_GetSelDev(EvoObjID idAdmin, unsigned *idx);

EVOCAPI_DECLSPEC EvoRC EvoGIC_Admin_GetDevIfc(EvoObjID idAdmin, char *buf, unsigned len);

EVOCAPI_DECLSPEC EvoRC EvoGIC_Admin_GetDevVendor(EvoObjID idAdmin, char *buf, unsigned len);

EVOCAPI_DECLSPEC EvoRC EvoGIC_Admin_GetDevModel(EvoObjID idAdmin, char *buf, unsigned len);

EVOCAPI_DECLSPEC EvoRC EvoGIC_Admin_GetDevSerialNo(EvoObjID idAdmin, char *buf, unsigned len);

EVOCAPI_DECLSPEC EvoRC EvoGIC_Admin_GetDevID(EvoObjID idAdmin, char *buf, unsigned len);

EVOCAPI_DECLSPEC EvoObjID EvoGIC_Admin_OpenDev(EvoObjID idAdmin);
 
//*********************************************************
// 
// GenICam Device related functions
//
//*********************************************************

EVOCAPI_DECLSPEC EvoRC EvoGIC_Dev_GetInterface(EvoObjID idDev, char *buf, unsigned len);

EVOCAPI_DECLSPEC EvoRC EvoGIC_Dev_GetVendor(EvoObjID idDev, char *buf, unsigned len);

EVOCAPI_DECLSPEC EvoRC EvoGIC_Dev_GetModel(EvoObjID idDev, char *buf, unsigned len);

EVOCAPI_DECLSPEC EvoRC EvoGIC_Dev_GetSerialNo(EvoObjID idDev, char *buf, unsigned len);

EVOCAPI_DECLSPEC EvoRC EvoGIC_Dev_GetID(EvoObjID idDev, char *buf, unsigned len);

EVOCAPI_DECLSPEC EvoRC EvoGIC_Dev_GetNumDataStreams(EvoObjID idDev, unsigned *num);
 
//*********************************************************
// 
// Camera Calibration related functions
//
//*********************************************************

EVOCAPI_DECLSPEC EvoRC EvoCC_GetCalibName(EvoObjID idCamModel, char *buf, unsigned len);

EVOCAPI_DECLSPEC EvoRC EvoCC_GetCamProd(EvoObjID idCamModel, char *buf, unsigned len);

EVOCAPI_DECLSPEC EvoRC EvoCC_GetLensProd(EvoObjID idCamModel, char *buf, unsigned len);

EVOCAPI_DECLSPEC EvoRC EvoCC_GetMaxResol(EvoObjID idCamModel, EvoSize *resol);
 
//*********************************************************
// 
// Fisheye Camera Model related functions
//
//*********************************************************

EVOCAPI_DECLSPEC EvoObjID EvoCC_Fisheye_Create(const char *calibName);

EVOCAPI_DECLSPEC EvoRC EvoCC_Fisheye_GetFocalLen(EvoObjID idFisheye, double *len);

EVOCAPI_DECLSPEC EvoRC EvoCC_Fisheye_ChangeFocalLen(EvoObjID idFisheye, double delta);

EVOCAPI_DECLSPEC EvoRC EvoCC_Fisheye_GetOutputSize(EvoObjID idFisheye, EvoSize *size);

EVOCAPI_DECLSPEC EvoRC EvoCC_Fisheye_SetOutputSize(EvoObjID idFisheye, EvoSize *size);

EVOCAPI_DECLSPEC EvoObjID EvoCC_Fisheye_Rectify_ImgFile(EvoObjID idFisheye, const char *imgPath);

EVOCAPI_DECLSPEC EvoObjID EvoCC_Fisheye_Rectify_ImgData(EvoObjID idFisheye, const EvoImage *data);

EVOCAPI_DECLSPEC EvoObjID EvoCC_Fisheye_Rectify_EncImg(EvoObjID idFisheye, const void *encImg, unsigned len);
 
//*********************************************************
// 
// Engine Parameters related functions
//
//*********************************************************

EVOCAPI_DECLSPEC EvoRC EvoEng_SetParam_Output(EvoObjID idEngine, const EvoOutput *output);

EVOCAPI_DECLSPEC EvoRC EvoEng_SetParam_LPDJudgeCB(EvoObjID idEngine, EvoLPDJudgeCB cbLPDJudge);

EVOCAPI_DECLSPEC EvoRC EvoEng_SetParam_SearchRect(EvoObjID idEngine, const EvoRect *rect);

EVOCAPI_DECLSPEC EvoRC EvoEng_SetParam_GOPSize(EvoObjID idEngine, int size);

EVOCAPI_DECLSPEC EvoRC EvoEng_SetParam_StayTimeout(EvoObjID idEngine, int timeout);

EVOCAPI_DECLSPEC EvoRC EvoEng_SetParam_MinSearch(EvoObjID idEngine, EvoBool enable);

EVOCAPI_DECLSPEC EvoRC EvoEng_GetParam_Output(EvoObjID idEngine, EvoOutput *output);

EVOCAPI_DECLSPEC EvoRC EvoEng_GetParam_LPDJudgeCB(EvoObjID idEngine, EvoLPDJudgeCB *cbLPDJudge);

EVOCAPI_DECLSPEC EvoRC EvoEng_GetParam_SearchRect(EvoObjID idEngine, EvoRect *rect);

EVOCAPI_DECLSPEC EvoRC EvoEng_GetParam_GOPSize(EvoObjID idEngine, int *size);

EVOCAPI_DECLSPEC EvoRC EvoEng_GetParam_StayTimeout(EvoObjID idEngine, int *timeout);

EVOCAPI_DECLSPEC EvoRC EvoEng_GetParam_MinSearch(EvoObjID idEngine, EvoBool *enabled);
 
//*********************************************************
// 
// Snapshot Engine related functions
//
//*********************************************************

EVOCAPI_DECLSPEC EvoObjID EvoSSE_Create(void);

EVOCAPI_DECLSPEC EvoRC EvoSSE_Init(EvoObjID idSSE, const char *ccode, const char *dnnDevDesc);

EVOCAPI_DECLSPEC void EvoSSE_Deinit(EvoObjID idSSE);

EVOCAPI_DECLSPEC EvoObjID EvoSSE_Run_ImgFile(EvoObjID idSSE, const char *imgPath);

EVOCAPI_DECLSPEC EvoObjID EvoSSE_Run_ImgData(EvoObjID idSSE, const EvoImage *data);

EVOCAPI_DECLSPEC EvoObjID EvoSSE_Run_EncImg(EvoObjID idSSE, const void *encImg, unsigned len);
 
//*********************************************************
// 
// Triggered Snapshot Engine related functions
//
//*********************************************************

EVOCAPI_DECLSPEC EvoObjID EvoTSSE_Create(void);

EVOCAPI_DECLSPEC EvoRC EvoTSSE_Init_IPP(EvoObjID idTSSE, const char *ccode, const char *dnnDevDesc, const char *url);

EVOCAPI_DECLSPEC EvoRC EvoTSSE_Init_GIC(EvoObjID idTSSE, 
                                        const char *ccode, 
                                        const char *dnnDevDesc, 
                                        EvoObjID idDev,
                                        unsigned idxDS);

EVOCAPI_DECLSPEC void EvoTSSE_Deinit(EvoObjID idTSSE);

EVOCAPI_DECLSPEC EvoObjID EvoTSSE_Trigger(EvoObjID idTSSE, EvoObjID *idPic);

EVOCAPI_DECLSPEC EvoRC EvoTSSE_OpenLiveView(EvoObjID idTSSE, uintptr_t win, EvoBool keepAR);

EVOCAPI_DECLSPEC void EvoTSSE_CloseLiveView(EvoObjID idTSSE);
 
//*********************************************************
// 
// Fully Automatic Video Engine related functions
//
//*********************************************************

EVOCAPI_DECLSPEC EvoObjID EvoFAVE_Create(void);

EVOCAPI_DECLSPEC EvoRC EvoFAVE_Init_IPP(EvoObjID idFAVE, const char *ccode, const char *dnnDevDesc, const char *url);

EVOCAPI_DECLSPEC EvoRC EvoFAVE_Init_GIC(EvoObjID idFAVE, const char *ccode, const char *dnnDevDesc, EvoObjID idDev, unsigned idxDS);

EVOCAPI_DECLSPEC void EvoFAVE_Deinit(EvoObjID idFAVE);

EVOCAPI_DECLSPEC EvoObjID EvoFAVE_PopLPI(EvoObjID idFAVE, EvoObjID *idGOP);

EVOCAPI_DECLSPEC EvoRC EvoFAVE_GetNumLPI(EvoObjID idFAVE, unsigned *num);

EVOCAPI_DECLSPEC EvoRC EvoFAVE_OpenLiveView(EvoObjID idFAVE, uintptr_t win, EvoBool keepAR);

EVOCAPI_DECLSPEC void EvoFAVE_CloseLiveView(EvoObjID idFAVE);

EVOCAPI_DECLSPEC EvoRC EvoFAVE_SetColorOfSABL(EvoObjID idFAVE, const EvoColor *color);

EVOCAPI_DECLSPEC EvoRC EvoFAVE_SetDepthOfSABL(EvoObjID idFAVE, float depth);

EVOCAPI_DECLSPEC EvoRC EvoFAVE_DrawSABL(EvoObjID idFAVE, EvoBool enable);
 
#endif // EVO_C_API_H_