Basic.h File Reference

C/C++ header file common to all type of engines and functionalities.

Go to the source code of this file.

Classes
struct	EvoOutput
	Engine's Output Configurations. More...
struct	EvoSize
	Size Descriptor. More...
struct	EvoRect
	Rectangle Descriptor. More...
struct	EvoColor
	Color Value of 32bit RGBA. More...
struct	EvoImage
	Image Descriptor. More...

Typedefs
typedef int	EvoLPT
	License Plate Type.
typedef void(*	EvoLPDJudgeCB) (const EvoRect *szImage, const EvoRect rects[], const float confidences[], const int num, int results[])
	Callback for License Plate Detection Judgement.

Enumerations
enum	EvoRC
	Return Codes. More...
enum	EvoParam {   EVOPARAM_OUTPUT , EVOPARAM_LPD_JUDGE_CB , EVOPARAM_SEARCH_RECT , EVOPARAM_SEARCH_POLY ,   EVOPARAM_GOP_SIZE , EVOPARAM_STAY_TIMEOUT , EVOPARAM_MIN_SEARCH }
	Engine's Realtime Parameters More...
enum	EvoHeadDir {   EVOHD_UNK = -1 , EVOHD_E , EVOHD_NE , EVOHD_N ,   EVOHD_NW , EVOHD_W , EVOHD_SW , EVOHD_S ,   EVOHD_SE , EVOHD_NUM , EVOHD_INVALID = EVOHD_NUM }
	Automobile's Heading Directions. More...
enum	EvoPixFmt { }
	Pixel Formats. More...
enum	EvoTimeUnit { EVOTU_SEC , EVOTU_MS }
	Time Precision. More...

Typedef Documentation

EvoLPDJudgeCB

typedef void(* EvoLPDJudgeCB) (const EvoRect *szImage, const EvoRect rects[], const float confidences[], const int num, int results[])

Callback function for applications to judge whether or not detected areas are correct. The areas which are judged incorrect by applications are ignored and dropped before further recognition process.

Note

This callback function must be thread-safe.

Parameters

[in]	szImage	Image size
[in]	rects	Detected areas
[in]	confidences	Confidences of detected areas
[in]	num	Number of detected areas
[out]	results	Judgement results (0: incorrect, Others: correct). By default, all the element of 'results' is filled with 0s.

Example

void JudgeLPDs(const EvoRect *szImage, 
               const EvoRect rects[], 
               const float confidences[], 
               const int num, 
               int results[])
{
    float maxConf = 0;
    int maxIdx = -1;
 
    for (int i = 0; i < num; i++)
    {
        if (confidences[i] > maxConf)
        {
            maxConf = confidences[i];
            maxIdx = i;
        }
    }
 
    results[maxIdx] = 1;
}

EvoLPT

typedef int EvoLPT

For details, refer to License Plate Types.

Enumeration Type Documentation

EvoHeadDir

enum EvoHeadDir

Enumerator
EVOHD_UNK	Unknown.
EVOHD_E	To East.
EVOHD_NE	To Northeast.
EVOHD_N	To North.
EVOHD_NW	To Northwest.
EVOHD_W	To West.
EVOHD_SW	To Southwest.
EVOHD_S	To South.
EVOHD_SE	To Southeast.

EvoParam

enum EvoParam

The realtime parameters affect engine operation while its running. Value of each parameter has its inherent data type.

Enumerator
EVOPARAM_OUTPUT	Influence engine's final output. Available kinds are different depending on engine type. For details, refer to EvoOutput. By default, all the outputs are disabled.
EVOPARAM_LPD_JUDGE_CB	Set the callback function for assisting license plate detection. This parameter doesn't influence Fully Automatic Video Engine. For details, refer to EvoLPDJudgeCB. Default is NULL.
EVOPARAM_SEARCH_RECT	Set bounding rectangle to search input image for license plates. All the detected one outside of this region will be excluded for further process. If width and height of rectangle are all zeros, cover entire image. Default is entire image area. Note In case of the Fully Automatic Video Engine, this parameter has different meaning depending on whether 'EVOPARAM_MIN_SEARCH' is set or not. For details, refer to the param 'EVOPARAM_MIN_SEARCH'.
EVOPARAM_SEARCH_POLY	Set bounding polygon for searching input image for license plates. All the detected one outside of this pologon is excluded for further process. If the polygon has no point, cover entire image by default. Note In case of the Fully Automatic Video Engine, this parameter has different meaning depending on whether 'EVOPARAM_MIN_SEARCH' is set or not. For details, refer to the param 'EVOPARAM_MIN_SEARCH'. This parameter is not supported yet.
EVOPARAM_GOP_SIZE	Set number of pictures in GOP to be output by the engine. This parameter influences only Fully Automatic Video Engine. Default value is 1. Note This parameter can be supported only in the Fully Automatic Video Engine.
EVOPARAM_STAY_TIMEOUT	Set time-out period for Fully Automatic Video Engine to return recognition result although the license plate still stays inside the search area. Time unit is seconds and the value '0' means the result is not returned until the license plate disappears out of the area. Default value is 0. Note This parameter can be supported only in the Fully Automatic Video Engine.
EVOPARAM_MIN_SEARCH	Limit the search area only to the specified one. If this param is turned on, literally only the specified region will be searched for license plates. Otherwise, the engine will try to search entire image area for them putting top priority on the specified area. Default value is 'false'. Note This parameter can be supported only in the Fully Automatic Video Engine.

EvoPixFmt

enum EvoPixFmt

Define pixel formats in raw image data.

Enumerator
EVOPF_GRAY	Grayscale format with 1 byte per pixel
EVOPF_YUY2	YCbCr 4:2:2 packed format with 2 bytes per pixel. Each component is arranged by the order of Y, Cb, Y, Cr.
EVOPF_UYVY	YCbCr 4:2:2 packed format with 2 bytes per pixel. Each component is arranged by the order of Cb, Y, Cr, Y.
EVOPF_NV12	YCbCr 4:2:0 planar format with 12 bits per pixel. Y planar is put at first and followed immediately by a planar of combined Cb/Cr.
EVOPF_NV21	YCbCr 4:2:0 planar format with 12 bits per pixel. Y planar is put at first and followed immediately by a planar of combined Cr/Cb.
EVOPF_I420	YCbCr 4:2:0 planar format with 12 bits per pixel. Y planar is put at first and followed immediately by Cb planar. At last, Cb planar is followed immediately by Cr planar.
EVOPF_YV12	YCbCr 4:2:0 planar format with 12 bits per pixel. Y planar is put at first and followed immediately by Cr planar. At last, Cr planar is followed immediately by Cb planar.
EVOPF_BGR24	RGB packed format with 3 bytes per pixel Each component is arranged by the order of blue, green, red.
EVOPF_RGB24	RGB packed format with 3 bytes per pixel Each component is arranged by the order of red, green, blue.
EVOPF_BGRA	RGB packed format with 4 bytes per pixel Each component is arranged by the order of blue, green, red, alpha.
EVOPF_RGBA	RGB packed format with 4 bytes per pixel Each component is arranged by the order of red, green, blue, alpha.

EvoRC

enum EvoRC

Define return codes of API functions.

EvoTimeUnit

enum EvoTimeUnit

On functions to output time information, determine its precision.

Enumerator
EVOTU_SEC	Second Unit
EVOTU_MS	Millisecond Unit