|
Evo 7.12.0-TM26061101
Evo LPR Engine
|
C header file common to all type of engines and functionalities.
Go to the source code of this file.
Macros | |
| #define | EVO_INV_OBJ_ID -1 |
Typedefs | |
| typedef int | EvoObjID |
| #define EVO_INV_OBJ_ID -1 |
Invalid Object ID, which can be any negative number.
| typedef int EvoObjID |
Object ID for all kinds of objects
| EvoRC Evo_CvtUTF8ToCP | ( | const char * | utf8, |
| char * | cpBuf, | ||
| unsigned | bufLen ) |
Convert strings encoded in UTF-8 into one encoded in the current CodePage.
| [in] | utf8 | String encoded in UTF-8. |
| [out] | cpBuf | Buffer to store string encoded in the CodePage. |
| [in] | bufLen | Length of the buffer in bytes. |
| void Evo_FreeObj | ( | EvoObjID * | idObj | ) |
Release all kinds of objects.
| [in,out] | idObj | ID of object to be released. If normally released, return negative number. |
| EvoRC Evo_GetLastRC | ( | void | ) |
Initialize engine's entire environemnt.
| [in] | dnnRunMode | DNN Run Mode string. In case of NULL, 'latency' is is used by default. For details, refer to DRM. |
| [in] | dataDir | Path to the data directory in installed Evo SDK. In case of NULL, engines gain the path information from the environment variable EVOENG_DATA_DIR. If both aren't specified, error returns. Note the environment varaiable has precedence when both are specified. |
| [out] | idDDI | DDI object ID to be get. If not required, set to NULL. When no more used, must be released using Evo_FreeObj(). |
Change the current local length. This doesn't directly set the focal length but adds to or subtracts from the default one.
| [in] | idFisheye | Object ID of fisheye-lens camera operation model. |
| [in] | delta | Value which is added or subtraced. If set to zero, the current focal length is set to default value. |
| EvoObjID EvoCC_Fisheye_Create | ( | const char * | calibName | ) |
Create object of fisheye-lens camera operation model.
| [in] | calibName | Name of applied calibration data. |
Get the current focal length.
| [in] | idFisheye | Object ID of fisheye-lens camera operation model. |
| [out] | len | Current focal length |
Get current ouptput size of the rectitied image.
| [in] | idFisheye | Object ID of fisheye-lens camera operation model. |
| [out] | size | Current output size. |
Rectify the input image distorted by fisheye-lens.
| [in] | idFisheye | Object ID of fisheye-lens camera operation model. |
| [in] | encImg | Buffer for Encoded image such as jpg, png, bmp and so on. |
| [in] | len | Length of the buffer. |
Rectify the input image distorted by fisheye-lens.
| [in] | idFisheye | Object ID of fisheye-lens camera operation model. |
| [in] | data | Image data. |
Rectify the input image distorted by fisheye-lens.
| [in] | idFisheye | Object ID of fisheye-lens camera operation model. |
| [in] | imgPath | Path of the image file. |
Set ouptput size of the rectitied image. The absolute difference between the max resolution and new output size must be multiple of 2.
| [in] | idFisheye | Object ID of fisheye-lens camera operation model. |
| [out] | size | New output size. |
Get name of applied calibration data.
| [in] | idCamModel | Object ID of any camera operation model. |
| [out] | buf | Buffer to store name of calibration data |
| [in] | len | Length of the buffer in bytes. |
Get name of camera-body product.
| [in] | idCamModel | Object ID of any camera operation model. |
| [out] | buf | Buffer of the product name. |
| [in] | len | Length of the buffer in bytes. |
Get name of lens-module product.
| [in] | idCamModel | Object ID of any camera operation model. |
| [out] | buf | Buffer of the product name. |
| [in] | len | Length of the buffer in bytes. |
Get max resolution of the image sensor.
| [in] | idCamModel | Object ID of any camera operation model. |
| [out] | resol | Size of the max resolution. |
Get ID of the selected DNN device.
| [in] | idDDI | DDI object ID |
| [out] | buf | Buffer to store the device ID. |
| [in] | len | Length of the buffer in bytes. |
Get specific DMDF supported by the selected DNN device.
| [in] | idDDI | DDI object ID |
| [in] | idx | Index of the required DMDF. Its range is [0, Number of DMDFs). |
| [out] | buf | Buffer to store the DMDF. |
| [in] | len | Length of the buffer in bytes. |
EVO_ENABLE_DEPRECATION_WARNINGS rc = EvoDDI_GetDMDF(idDDI, idx, buf, len); EVO_DISABLE_DEPRECATION_WARNINGS
Get full name of the selected DNN device.
| [in] | idDDI | DDI object ID |
| [out] | buf | Buffer to store device's full name. |
| [in] | len | Length of the buffer in bytes. |
Get number of the available DNN devices. For deatils, refer to DNN Devices.
| [in] | idDDI | DDI object ID |
| [out] | num | Number of available devices |
Get number of DMDFs supported by the selected DNN device.
| [in] | idDDI | DDI object ID |
| [out] | num | Number of supported DMDFs |
EVO_ENABLE_DEPRECATION_WARNINGS rc = EvoDDI_GetNumDMDF(idDDI, &num); EVO_DISABLE_DEPRECATION_WARNINGS
Get index of the selected DNN device.
| [in] | idDDI | DDI object ID |
| [out] | idx | of the selected device. |
Select required DNN device for further process.
| [in] | idDDI | DDI object ID |
| [in] | idx | Index of the required device. |
| EvoRC EvoEng_GetParam_LPDJudgeCB | ( | EvoObjID | idEngine, |
| EvoLPDJudgeCB * | cbLPDJudge ) |
| EvoRC EvoEng_SetParam_LPDJudgeCB | ( | EvoObjID | idEngine, |
| EvoLPDJudgeCB | cbLPDJudge ) |
| void EvoFAVE_CloseLiveView | ( | EvoObjID | idFAVE | ) |
The same as EvoTSSE_CloseLiveView().
| EvoObjID EvoFAVE_Create | ( | void | ) |
Create a Fully Automatic Video Engine.
| void EvoFAVE_Deinit | ( | EvoObjID | idFAVE | ) |
Deinitialise Fully Automatic Video Engine to release all the resources in use. For further process, must be reinitialized.
| [in] | idFAVE | FAVEngine object ID. |
The same as Evo::FAVEngine::DrawSABL().
Get number of LPI data which exists in the output queued.
| [in] | idFAVE | FAVEngine object ID. |
| [out] | num | Number of queued LPI objects. |
| EvoRC EvoFAVE_Init_GIC | ( | EvoObjID | idFAVE, |
| const char * | ccode, | ||
| const char * | dnnDevDesc, | ||
| EvoObjID | idDev, | ||
| unsigned | idxDS ) |
Initialize Fully Automatic Video Engine for video streaming from GenICam-compatable device.
| [in] | idFAVE | FAVEngine object ID. |
| [in] | ccode | The same as EvoSSE_Init(). |
| [in] | dnnDevDesc | The same as EvoSSE_Init(). |
| [in] | idDev | The same as EvoTSSE_Init_GIC(). |
| [in] | idxDS | The same as EvoTSSE_Init_GIC(). |
| EvoRC EvoFAVE_Init_IPP | ( | EvoObjID | idFAVE, |
| const char * | ccode, | ||
| const char * | dnnDevDesc, | ||
| const char * | url ) |
Initialize Fully Automatic Video Engine for video streaming based on IP protocol.
| [in] | idFAVE | FAVEngine object ID. |
| [in] | ccode | The same as EvoSSE_Init(). |
| [in] | dnnDevDesc | The same as EvoSSE_Init(). |
| [in] | url | The same as EvoTSSE_Init(). |
The same as EvoTSSE_OpenLiveView().
Obtain LPIs and GOPs from output queue. If the queue is empty, this is blocked until there exist.
| [in] | idFAVE | FAVEngine object ID. |
| [out] | idGOP | GOP object ID related to the returned LPI object. When called, value of the object ID variable must be negative number. If no more used, must be released using Evo_FreeObj(). |
The same as Evo::FAVEngine::SetColorOfSABL().
The same as Evo::FAVEngine::SetDepthOfSABL().
| EvoObjID EvoGIC_Admin_Get | ( | void | ) |
Get GenICam administrator. When no more used, must be released using Evo_FreeObj().
Get ID of the selected GenICam device.
| [in] | idAdmin | Administrator object ID. |
| [out] | buf | Buffer to store the ID |
| [in] | len | Length of the buffer in bytes. |
Get interface type of the selected GenICam device.
| [in] | idAdmin | Administrator object ID. |
| [out] | buf | Buffer to store the interface type name |
| [in] | len | Length of the buffer in bytes. |
Get model name of the selected GenICam device.
| [in] | idAdmin | Administrator object ID. |
| [out] | buf | Buffer to store the model name |
| [in] | len | Length of the buffer in bytes. |
Get serial number of the selected GenICam device.
| [in] | idAdmin | Administrator object ID. |
| [out] | buf | Buffer to store the serial number |
| [in] | len | Length of the buffer in bytes. |
Get vendor of the selected GenICam device.
| [in] | idAdmin | Administrator object ID. |
| [out] | buf | Buffer to store the vendor name |
| [in] | len | Length of the buffer in bytes. |
Get number of all the supported GenICam devices.
| [in] | idAdmin | Administrator object ID. |
| [out] | num | Number of supported GenICam devices. |
Get the GenICam device which is currently selected.
| [in] | idAdmin | Administrator object ID. |
| [in] | idx | Index of the selected GenICam device |
Open the required GenICam device. When no more used, must be released using Evo_FreeObj().
| [in] | idAdmin | Administrator object ID. |
Select specific GenICam device.
| [in] | idAdmin | Administrator object ID. |
| [in] | idx | Index to required GenICam device. |
Find out all the GenICam devices connected through supported interfaces such as Ethernet, USB, FireWire and so on. This function could take several seconds dependinig on systems.
| [in] | idAdmin | Administrator object ID. |
Get GenICam device's ID.
| [in] | idDev | Device object ID |
| [out] | buf | Buffer to store the ID |
| [in] | len | Length of the buffer in bytes. |
Get GenICam device's interface type such as Ethernet, USB and so on.
| [in] | idDev | Device object ID |
| [out] | buf | Buffer to store the interface type name |
| [in] | len | Length of the buffer in bytes. |
Get GenICam device's model.
| [in] | idDev | Device object ID |
| [out] | buf | Buffer to store the model name |
| [in] | len | Length of the buffer in bytes. |
Get number of data streams which the GenICam device can provide.
| [in] | idDev | Device object ID |
| [out] | num | Number of data streams |
Get GenICam device's serial number.
| [in] | idDev | Device object ID |
| [out] | buf | Buffer to store the serial-number |
| [in] | len | Length of the buffer in bytes. |
Get GenICam device's vendor.
| [in] | idDev | Device object ID |
| [out] | buf | Buffer to store the vendor name |
| [in] | len | Length of the buffer in bytes. |
| EvoRC EvoGOP_GetHeadDir | ( | EvoObjID | idGOP, |
| EvoHeadDir * | heading ) |
Get automobile's heading direction all over the pictures. This is influenced by EvoEng_SetParam_Output().
| [in] | idGOP | GOP object ID |
| [out] | heading | Heading direction |
Get number of pictures which the GOP contains.
| [in] | idGOP | GOP object ID |
| [out] | num | Number of pictures |
Get image data of the selected picture.
| [in] | idGOP | GOP object ID |
| [out] | img | image data |
| EvoRC EvoGOP_GetPicTime | ( | EvoObjID | idGOP, |
| int64_t * | time, | ||
| EvoTimeUnit | unit ) |
Get time stamp when selected picture was captured. For details, refer to EvoPic_GetTime().
| [in] | idGOP | GOP object ID |
| [out] | time | The same as EvoPic_GetTime() |
| [in] | unit | The same as EvoPic_GetTime() |
Get position of the license plate in the selected picture.
| [in] | idGOP | GOP object ID |
| [out] | rect | Position of the license plate. |
Get the currently selected picture.
| idGOP | GOP object ID |
| idx | Index of the selected picture. |
Create TIFF file with all the pictures JPEG-compressed.
| [in] | idGOP | GOP object ID |
| [in] | path | The same as EvoPic_SaveInJPEG() |
| [in] | quality | The same as EvoPic_SaveInJPEG() |
Create JPEG file from the selected picture.
| [in] | idGOP | GOP object ID |
| [in] | path | The same as EvoPic_SaveInJPEG() |
| [in] | quality | The same as EvoPic_SaveInJPEG() |
Create PNG file of the selected picture.
| [in] | idGOP | GOP object ID |
| [in] | path | The same as EvoPic_SaveInPNG() |
| [in] | compression | The same as EvoPic_SaveInPNG() |
Select required picture.
| [in] | idGOP | GOP object ID |
| [in] | idx | Index of required picture |
Get confidence of each character to compose the string. The order of confidences are equal to one of characters to be returned on EvoLPI_GetStr().
| [in] | idLPI | LPI object ID |
| [out] | buf | Buffer to store the confidences |
| [in,out] | num | When called, it is max number of confidences which can be stored in the buffer. When return, it is number of condiences which are actually stored in the buffer. |
Get number of recognized license plates.
| [in] | idLPI | LPI object ID |
| [out] | num | Number of the license plates |
Get position of the selected license plate.
| [in] | idLPI | LPI object ID |
| [out] | rect | Position on input image |
Get the currently selected license plate.
| [in] | idLPI | LPI object ID |
| [out] | idx | Index of selected license plate. |
Get string of the selected license plate.
| [in] | idLPI | LPI object ID |
| [out] | buf | Buffer to store the string in UTF-8. |
| [in] | len | Length of the buffer in bytes. |
Get type of the selected license plate.
| [in] | idLPI | LPI object ID |
| [out] | type | Type of the license plate. For details, refer to License Plate Types. |
| [out] | confidence | Confidence of the type. Its range is [0, 100]. |
Select required license plate for further process.
| [in] | idLPI | LPI object ID |
| [in] | idx | Index of required license plate. |
Get image data of the picture.
| [in] | idPic | Picture object ID. |
| [out] | img | Image Data. |
| EvoRC EvoPic_GetTime | ( | EvoObjID | idPic, |
| int64_t * | time, | ||
| EvoTimeUnit | unit ) |
Get time stamp when the picture was captured.
| [in] | idPic | Picture object ID |
| [in] | unit | Precision of the time stamp |
| [out] | time | Time Stamp |
int64_t timeUTC;
if(EvoPic_GetTime(idPic, &timeUTC, EVOTU_MS) == EVORC_OK)
{
time_t timeRaw;
int64_t timeMS;
struct tm *timeInfo = NULL;
timeMS = timeUTC % 1000;
timeRaw = time_t(timeUTC / 1000);
timeInfo = localtime(&timeRaw);
cout << timeInfo->tm_year + 1900 << '-'
<< timeInfo->tm_mon + 1 << '-'
<< timeInfo->tm_mday << ' '
<< timeInfo->tm_hour << ':'
<< timeInfo->tm_min << ':'
<< timeInfo->tm_sec << '.'
<< timeMS << endl;
}
Create JPEG file of the picture.
| [in] | idPic | Picture object ID |
| [in] | path | Path to JPEG file, which must have eigher of the extension '.jpg' or '.jpeg'. |
| [in] | quality | Quality level of the compressed picture, which is the range [0, 100]. |
Create PNG file of the picture.
| [in] | idPic | Picture object ID |
| [in] | path | Path to PNG file, which must have the extension '.png'. |
| [in] | compression | Compression level of the picture, which is the range [0, 9]. |
| EvoObjID EvoSSE_Create | ( | void | ) |
Create a Snapshot Engine.
| void EvoSSE_Deinit | ( | EvoObjID | idSSE | ) |
Deinitialise Snapshot Engine to release all the resources in use. For further process, Must be reinitialized.
| [in] | idSSE | SSEngine object ID. |
Initialize Snapshot Engine
| [in] | idSSE | SSEngine object ID. |
| [in] | ccode | Required country-code which has been already registered. For details, refer to Evo_Initialize() and Country Codes. |
| [in] | dnnDevDesc | DNN Device Descriptor string. If NULL, the engine builds optimal descriptor automatically.For details, refer to DNN Device Descriptor. |
Detect and recognize all the license plates on single image.
| [in] | idSSE | SSEngine object ID. |
| [in] | encImg | Buffer to contain the image which is encoded in JPEG, PNG, BMP and so on. |
| [in] | len | Length of the buffer in bytes. |
Detect and recognize all the license plates on single image.
| [in] | idSSE | SSEngine object ID. |
| [in] | data | Image data |
Detect and recognize all the license plates on single image.
| [in] | idSSE | SSEngine object ID. |
| [in] | imgPath | Path to the image file. |
| void EvoTSSE_CloseLiveView | ( | EvoObjID | idTSSE | ) |
If live-view is opened, close it.
| [in] | idTSSE | TSSEngine object ID. |
| EvoObjID EvoTSSE_Create | ( | void | ) |
Create a Triggered Snapshot Engine.
| void EvoTSSE_Deinit | ( | EvoObjID | idTSSE | ) |
Deinitialise Triggered Snapshot Engine to release all the resources in use. For further process, must be reinitialized.
| [in] | idTSSE | TSSEngine object ID. |
| EvoRC EvoTSSE_Init_GIC | ( | EvoObjID | idTSSE, |
| const char * | ccode, | ||
| const char * | dnnDevDesc, | ||
| EvoObjID | idDev, | ||
| unsigned | idxDS ) |
Initialize the Triggered Snapshot Engine for video streaming from GenICam-compatable device.
| [in] | idTSSE | TSSEngine object ID. |
| [in] | ccode | The same as EvoSSE_Init(). |
| [in] | dnnDevDesc | The same as EvoSSE_Init(). If NULL, the engine builds optimal descriptor automatically. |
| [in] | idDev | Object ID of the opened GenICam device. For details, refer to EvoGIC_Admin_OpenDev(). |
| [in] | idxDS | Data-Stream index which corresponds to video stream from the GenICam device. |
| EvoRC EvoTSSE_Init_IPP | ( | EvoObjID | idTSSE, |
| const char * | ccode, | ||
| const char * | dnnDevDesc, | ||
| const char * | url ) |
Initialize the Triggered Snapshot Engine for video streaming based on IP protocol.
| [in] | idTSSE | TSSEngine object ID. |
| [in] | ccode | The same as EvoSSE_Init(). |
| [in] | dnnDevDesc | The same as EvoSSE_Init(). |
| [in] | url | URL of video streaming source. For example, 'rtsp://192.168.10.5/media'. |
Open video's live-view, which uses OpenGL to reduce latency and CPU load. So, it is recommended to install the last version of display driver. For details, refer to 'System Requirements' section.
| [in] | idTSSE | TSSEngine object ID. |
| [in] | win | Window handle or ID to be used as live view. On Linux platform, This is value of Xlib's 'Window' type and on Windows platform, this is value of Win32-API's 'HWND' type. |
| [in] | keepAR | Determine whether video's aspect-ratio is kept or not although the live-view window is resized. |
Get the last captured picture and find license plates on it.
| [in] | idTSSE | TSSEngine object ID. |
| [out] | idPic | Picture object ID. When called, value of the object ID variable must be negative number. If no more used, must be released using Evo_FreeObj(). |