Evo::TSSEngine Class Reference

Triggered Snapshot Engine class. More...

#include <TSSEngine.hpp>

Inheritance diagram for Evo::TSSEngine:

Public Member Functions
virtual EvoRC	Init (const char *ccode, const char *dnnDevDesc, const char *url)=0
virtual EvoRC	Init (const char *ccode, const char *dnnDevDesc, GIC::Dev::Ptr dev, uint32_t idxDS=0)=0
virtual void	Deinit (void)=0
virtual LPI::Ptr	Trigger (Picture::Ptr &pic, EvoMS *mstg=NULL)=0
virtual EvoRC	OpenLiveView (uintptr_t win, bool keepAR)=0
virtual void	CloseLiveView (void)=0
Public Member Functions inherited from Evo::Engine
virtual EvoRC	SetParam (EvoParam param, const void *value)=0
virtual EvoRC	GetParam (EvoParam param, void *value) const =0

Static Public Member Functions
static EVOTSSE_DECLSPEC Ptr	Create (void)

Detailed Description

TSSEngine class provides funcionalities to detect and recognize all the license plates on the pictures captured from video streaming whenever trigger events occur. This class uses H/W CODEC to reduce latency and CPU load decoding the compressed video stream. So, it is recommended to install the last display driver. For details, refer to 'System Requirements' section.

Member Function Documentation

CloseLiveView()

virtual void Evo::TSSEngine::CloseLiveView ( void )

pure virtual

Close the opened live view.

This method must be explicitly called before any of following cases occur.

1. Deinit() is called.
2. The window for live-view is destroyed.
3. The window for live-view is changed to a different one.

Create()

EVOTSSE_DECLSPEC Ptr Evo::TSSEngine::Create ( void )

static

Create a engine instance.

Returns

Created engine instance. If fail, NULL returns. In that case, the error code can be obtained using GetLastRC().

Deinit()

virtual void Evo::TSSEngine::Deinit ( void )

pure virtual

Release all the resources in use. For further process, must be reinitialized.

Init() [1/2]

virtual EvoRC Evo::TSSEngine::Init ( const char * ccode, const char * dnnDevDesc, const char * url )

pure virtual

Initialize the engine for video streaming based on IP protocol.

Parameters

[in]	ccode	The same as SSEngine::Init().
[in]	dnnDevDesc	The same as SSEngine::Init().
[in]	url	URL of video streaming source based on IP protocol. For example, 'rtsp://192.168.10.5/media'.

Returns

EvoRC code

Note

Don't use any white space in DNN Device Descriptor argument.

Init() [2/2]

virtual EvoRC Evo::TSSEngine::Init ( const char * ccode, const char * dnnDevDesc, GIC::Dev::Ptr dev, uint32_t idxDS = 0 )

pure virtual

Initialize the engine for video streaming from GenICam-compatable device.

Parameters

[in]	ccode	The same as SSEngine::Init().
[in]	dnnDevDesc	The same as SSEngine::Init().
[in]	dev	The GenICam device from GIC::Admin::OpenDev().
[in]	idxDS	Data-Stream index which corresponds to video stream of the GenICam device.

Returns

EvoRC code

Note

Don't use any white space in DNN Device Descriptor argument.

OpenLiveView()

virtual EvoRC Evo::TSSEngine::OpenLiveView ( uintptr_t win, bool keepAR )

pure virtual

Open input-video's live-view. It uses OpenGL to reduce latency and CPU load. So, it is recommended to install the lastest version of display driver. For details, refer to 'System Requirements' section in the document

Parameters

[in]	win	Window handle or ID to be used as live view. On Linux platform, This is Xlib's 'Window' type and on Windows platform, this is Win32-API's 'HWND' type.
[in]	keepAR	Determine whether video's aspect-ratio is kept or not although the live-view window is resized.

Returns

EvoRC code

Trigger()

virtual LPI::Ptr Evo::TSSEngine::Trigger ( Picture::Ptr & pic, EvoMS * mstg = NULL )

pure virtual

Get the last captured picture and found license plates on it.

Parameters

[out]	pic	The latest picture. Before called, must be set to NULL.
[out]	mstg	For the usage of debuging.

Returns

LPI object. If no one was found, it is NULL.

Note

When error has occured, both of LPI and Picture are NULL and the error code can be obtained using GetLastRC(). For example, if the video stream has been closed, GetLastRC() return 'EVORC_NO_MORE_DATA'.