Basic.h

Go to the documentation of this file.

#ifndef EVO_BASIC_HPP_
#define EVO_BASIC_HPP_
 
//
// Check platforms and compilers are valid.
//
#if defined(_WIN64)
#   if !defined(_MSC_VER) || (_MSC_VER < 1900)
#       error This compiler not tested.
#   endif
#   if !defined(_M_AMD64)
#       error Not supported CPU architecture
#   endif
#elif defined(__linux__)
#   if !defined(__GNUC__) || (__GNUC__ < 7) || (__GNUC_MINOR__ < 3)
#       error This compiler not tested.
#   endif
#   if !defined(__x86_64__) && !defined(__aarch64__)
#       error Not supported CPU architecture
#   endif
#else
#   error Target platform not supported.
#endif
 
#ifndef __cplusplus
#   include <stdint.h>
#   include <stddef.h>
#else
#   include <cstdint>
#   include <cstddef>
#endif
 
 
#ifdef __cplusplus
#   define EVO_RMV_COPY_CONST(CLASS_NAME)           CLASS_NAME(const CLASS_NAME&) = delete
#   define EVO_RMV_COPY_ASSIGNMENT(CLASS_NAME)      CLASS_NAME& operator=(const CLASS_NAME&) = delete
#   define EVO_RMV_SPECIAL_METHODS(CLASS_NAME)      EVO_RMV_COPY_CONST(CLASS_NAME); EVO_RMV_COPY_ASSIGNMENT(CLASS_NAME);
#endif
 
#ifdef _WIN64
#   define EVO_DEPRECATED   __declspec(deprecated("Don't use any more because it's deprecated."))
 
#   define EVO_ENABLE_DEPRECATION_WARNINGS      __pragma(warning(push)) __pragma(warning(1:4996))
#   define EVO_DISABLE_DEPRECATION_WARNINGS     __pragma(warning(pop))
#else // __linux__
#   define EVO_DEPRECATED   __attribute__((deprecated))
 
#   define EVO_ENABLE_DEPRECATION_WARNINGS
#   define EVO_DISABLE_DEPRECATION_WARNINGS
#endif
 

enum EvoRC
{
    // Success Code
    EVORC_OK,
 
    // Generic Errors
    EVORC_INV_ARG = 50,      
    EVORC_NOT_INIT,          
    EVORC_DISABLED,          
    EVORC_NOT_FOUND,         
    EVORC_ALREADY_DONE,      
    EVORC_NOT_IMPLEMENTED,   
    EVORC_NOT_SUPPORTED,     
    EVORC_TOO_SMALL_BUF,     
    EVORC_RESOURCE_IN_USE,   
    EVORC_INTERNAL_DATA_ERR,  
    EVORC_NO_MORE_DATA,      
    EVORC_TIMEOUT,           
    EVORC_IN_PROGRESS,       
    EVORC_OUT_OF_RANGE,      
    EVORC_OPER_CANCELED,     
    EVORC_UNKNOWN_VALUES,    
    EVORC_RETRY,             
 
    // License related errors
    EVORC_LIC_UNKNOWN_ERR = 100,
    EVORC_LIC_NO_DEV,           
    EVORC_LIC_MULTI_USBDEV,
    EVORC_LIC_MISMATCH,         
    EVORC_LIC_INV_FILE,         
    EVORC_LIC_INV_CONTEXT,
    EVORC_LIC_TRIAL_EXPIRED,    
    EVORC_LIC_SUPPORT_EXPIRED,  
 
    // File reltaed errors
    EVORC_FILE_UNKNOWN_ERR = 150,
    EVORC_FILE_NOT_EXIST,       
    EVORC_FILE_ALREADY_EXIST,   
    EVORC_FILE_PERM_ERR,        
    EVORC_FILE_IO_ERR,          
    EVORC_FILE_TOO_LONG_PATH,   
 
    // DNN related errors
    EVORC_DNN_UNKNOWN_ERR = 200,
    EVORC_DNN_NO_DEV,
    EVORC_DNN_INV_MODEL,        
    EVORC_DNN_INV_INPUT,        
    EVORC_DNN_INV_DEV_DESC,     
    EVORC_DNN_UNSUPPORTED_DEV,  
    EVORC_DNN_UNSUPPORTED_FMT,  
    EVORC_DNN_OV_ERR,           
    EVORC_DNN_IO_ERR,           
 
    // Input-Image related errors
    EVORC_IMG_UNKNOWN_ERR = 250,
    EVORC_IMG_DEC_ERR,          
    EVORC_IMG_INV_SIZE,         
    EVORC_IMG_INV_SEARCH_AREA,  
 
    // Trained Model Data related errors
    EVORC_TMD_UNKNOWN_ERR = 300,
    EVORC_TMD_CONF_NOT_FOUND,   
    EVORC_TMD_NOT_COMPATABLE,   
 
    // Multi-Country related errors
    EVORC_MC_UNKNOWN_ERR = 350,
    EVORC_MC_NOT_SUPPORTED,    
    EVORC_MC_NOT_REGISTERED,    
    EVORC_MC_NO_CCODE,          
 
    // Video Input Output related errors
    EVORC_VIO_UNKNOWN_ERR = 400,
    EVORC_VIO_AV_ERR,           
    EVORC_VIO_LV_MOD_ERR,       
    EVORC_VIO_STREAM_CLOSED,    
 
    // IP Protocol Streaming relateed errors
    EVORC_IPPS_UNKNOWN_ERR = 450,
    EVORC_IPPS_CONN_ERR,        
    EVORC_IPPS_HW_CODEC_ERR,    
    EVORC_IPPS_UNSUPPORTED_CODEC,
    EVORC_IPPS_INV_VIDEO_FMT,
 
    // Live View related errors
    EVORC_LV_UNKNOWN_ERR = 500,
    EVORC_LV_WIN_ERR,
    EVORC_LV_OGL_ERR,
    EVORC_LV_FORMAT_ERR,
    EVORC_LV_SA_NOT_SET,
    EVORC_LV_WIN_NOT_OPEN,
 
    // Library Module related errors
    EVORC_MOD_UNKNOWN_ERR = 550,
    EVORC_MOD_NOT_LOADED,       
    EVORC_MOD_NOT_FOUND,        
    EVORC_MOD_INV_FUNC_NAME,    
 
    // GenICam related errors
    EVORC_GIC_UNKNOWN_ERR = 600,
    EVORC_GIC_TL_INIT_ERR,      
    EVORC_GIC_TL_ADDR_BIND_ERR, 
    EVORC_GIC_SYS_MOD_ERR,      
    EVORC_GIC_IFC_MOD_ERR,      
    EVORC_GIC_DEV_MOD_ERR,      
    EVORC_GIC_DS_MOD_ERR,       
    EVORC_GIC_BUF_ERR,          
    EVORC_GIC_EVT_ERR,          
    EVORC_GIC_PORT_ERR,         
    EVORC_GIC_DEV_ERR,          
    EVORC_GIC_SFNC_ERR,         
    EVORC_GIC_INV_ENV_VAR,      
    EVORC_GIC_DEV_NOT_SEL,      
    EVORC_GIC_NO_READY_DS,      
    EVORC_GIC_LESS_NUM_BUF,     
 
    // All Other Errors
    EVORC_UNKNOWN_ERR = 1000,
};
 
#ifndef __cplusplus
typedef enum EvoRC EvoRC;
#endif
 
//
// Protable Boolean Data Type
//
typedef int EvoBool;
 
//
// Available values of the type 'EvoBool'.
//
#define EVO_TRUE    1
#define EVO_FALSE   0

enum EvoParam
{
    EVOPARAM_OUTPUT,

    EVOPARAM_LPD_JUDGE_CB,

    EVOPARAM_SEARCH_RECT,

    EVOPARAM_SEARCH_POLY,

    EVOPARAM_GOP_SIZE,

    EVOPARAM_STAY_TIMEOUT,

    EVOPARAM_MIN_SEARCH,
};
 
#ifndef __cplusplus
typedef enum EvoParam EvoParam;
#endif

enum EvoHeadDir
{
    EVOHD_UNK = -1, 
    EVOHD_E,  
    EVOHD_NE, 
    EVOHD_N,  
    EVOHD_NW, 
    EVOHD_W,  
    EVOHD_SW, 
    EVOHD_S,  
    EVOHD_SE, 
 
    // These are not heading directions.
    EVOHD_NUM, 
    EVOHD_INVALID = EVOHD_NUM,
};
 
#ifndef __cplusplus
typedef enum EvoHeadDir EvoHeadDir;
#endif

struct EvoOutput
{
    EvoBool headDir;
 
#ifdef __cplusplus
    EvoOutput(void) : headDir(EVO_FALSE) {}
#endif
};
 
#ifndef __cplusplus
typedef struct EvoOutput EvoOutput;
#endif
 
// Miss-Stages for Debugging
enum EvoMS
{
    EVOMS_NONE  = 0,
    EVOMS_LPD   = (1 << 0),
    EVOMS_LPBQD = (1 << 1),
    EVOMS_LPR   = (1 << 2),
};

enum EvoPixFmt
{
    EVOPF_INVALID = -1,

    EVOPF_GRAY = 0,

    EVOPF_YUY2 = 10,
    
    EVOPF_UYVY,

    EVOPF_NV12,

    EVOPF_NV21,

    EVOPF_I420,

    EVOPF_YV12,

    EVOPF_BGR24 = 20,

    EVOPF_RGB24,

    EVOPF_BGRA,

    EVOPF_RGBA,
};
 
#ifndef __cplusplus
typedef enum EvoPixFmt EvoPixFmt;
#endif

enum EvoTimeUnit
{
    EVOTU_SEC,

    EVOTU_MS,
};
 
#ifndef __cplusplus
typedef enum EvoTimeUnit EvoTimeUnit;
#endif

struct EvoSize
{
    int width;  
    int height; 
 
#ifdef __cplusplus
    EvoSize(void) : width(0), height(0) {}
    EvoSize(int _width, int _height) : width(_width), height(_height) {}
 
    inline bool IsEmpty(void) const;
    inline bool IsValid(void) const;
#endif
};
 
#ifndef __cplusplus
typedef struct EvoSize EvoSize;
#endif

struct EvoRect
{
    int x;      
    int y;      
    int width;  
    int height; 
 
#ifdef __cplusplus
    EvoRect(void) : x(0), y(0), width(0), height(0) {}
    EvoRect(int _x, int _y, int _width, int _height)
      : x(_x), y(_y), width(_width), height(_height) {}
 
    inline bool IsEmpty(void) const;
    inline bool IsValid(void) const;
#endif
};
 
#ifndef __cplusplus
typedef struct EvoRect EvoRect;
#endif

struct EvoColor
{
    uint8_t r; 
    uint8_t g; 
    uint8_t b; 
    uint8_t a; 
 
#ifdef __cplusplus
    EvoColor(void) : r(0), g(0), b(0), a(0) {}
    EvoColor(uint8_t red, uint8_t green, uint8_t blue, uint8_t alpha)
      : r(red), g(green), b(blue), a(alpha) {}
#endif
};
 
#ifndef __cplusplus
typedef struct EvoColor EvoColor;
#endif

struct EvoImage
{
#define EVO_MAX_IMG_PLANES  4

    const uint8_t *planes[EVO_MAX_IMG_PLANES];

    int width;

    int height;

    EvoPixFmt pf;

    int strides[EVO_MAX_IMG_PLANES];
 
#ifdef __cplusplus
    EvoImage(void)
      : planes{ NULL },
        width(0),
        height(0),
        pf(EVOPF_INVALID),
        strides{ 0 }
    { 
    }
 
    EvoImage(int _width, 
             int _height, 
             EvoPixFmt _pf)
      : planes{ NULL }, 
        width(_width), 
        height(_height), 
        pf(_pf), 
        strides{ 0 }
    {
    }
 
    EvoImage(const uint8_t *_plane,
             int _width, 
             int _height, 
             EvoPixFmt _pf, 
             int _stride)
      : planes{ _plane }, 
        width(_width), 
        height(_height), 
        pf(_pf), 
        strides{ _stride }
    {
    }
 
    EvoImage(const uint8_t *_planes[],
             int _width, 
             int _height, 
             EvoPixFmt _pf, 
             const int _strides[])
      : width(_width), height(_height), pf(_pf)
    {
        for (int i = 0; i < EVO_MAX_IMG_PLANES; i++)
        {
            planes[i]  = _planes[i];
            strides[i] = _strides[i];
        }
    }
 
    inline void ResetStrides(void);
    inline void Reset(void);
    inline int GetMinStride(void) const;
    inline bool IsValid(void) const;
    inline operator bool() const;
#endif
};
 
#ifndef __cplusplus
typedef struct EvoImage EvoImage;
#endif

typedef int EvoLPT;

typedef void (*EvoLPDJudgeCB)(const EvoRect *szImage,
                              const EvoRect rects[],
                              const float confidences[],
                              const int num,
                              int results[]);
 
#endif // EVO_BASIC_HPP_