RadarTrackHistory.h File Reference

Go to the source code of this file.

Data Structures
struct	dwRadarTrackHistory
	Radar track history table. More...

Typedefs
typedef struct dwRadarTrackHistoryObject *	dwRadarTrackHistoryHandle_t

Functions
DW_API_PUBLIC dwStatus	dwRadarTrackHistory_addTracks (const dwRadarTrack radarTracks[], uint32_t radarTracksCount, dwTime_t timestamp, dwRadarTrackHistoryHandle_t obj)
	Add list of radar tracks into radar track history. More...
DW_API_PUBLIC dwStatus	dwRadarTrackHistory_getRadarTrackHistory (dwRadarTrackHistory *radarTrackHistory, dwRadarTrackHistoryHandle_t obj)
	Get radar track history. More...
DW_API_PUBLIC dwStatus	dwRadarTrackHistory_initialize (dwRadarTrackHistoryHandle_t *obj, uint32_t maxObjectCount, uint32_t historyCapacity, dwContextHandle_t ctx)
	Creates and initialize a radar track history. More...
DW_API_PUBLIC dwStatus	dwRadarTrackHistory_release (dwRadarTrackHistoryHandle_t *obj)
	Releases the radar track history. More...

---

Data Structure Documentation

dwRadarTrackHistory

struct dwRadarTrackHistory

Data Fields
uint32_t *	ages	the column index of current time in the table
uint32_t	currentTimeIdx	actual number of tracked objects
dwRadarTrack *	data	the timestamp of each frame in the history, its size is historyCapacity
uint32_t	historyCapacity	the maximum number of tracked objects
uint32_t	maxObjectCount
uint32_t	objectCount	capacity of history circular buffer
dwTime_t *	timestamps	the age of each tracked object, its size is maxObjectCount

Typedef Documentation

dwRadarTrackHistoryHandle_t

typedef struct dwRadarTrackHistoryObject* dwRadarTrackHistoryHandle_t

Definition at line 41 of file RadarTrackHistory.h.

Function Documentation

dwRadarTrackHistory_addTracks()

DW_API_PUBLIC dwStatus dwRadarTrackHistory_addTracks	(	const dwRadarTrack	radarTracks[],
		uint32_t	radarTracksCount,
		dwTime_t	timestamp,
		dwRadarTrackHistoryHandle_t	obj
	)

Add list of radar tracks into radar track history.

This function maintains track history based on the track ID.

• if track ID is already in the track history: update history of the track and increase age of the track
• if there is no matching track ID in the track history: add new track in the history

Parameters

[in]	radarTracks	Array of radar objects tracked in the current frame.
[in]	radarTracksCount	Size of radarTracks.
[in]	timestamp	timestamp of the tracks.
[in]	obj	Specifies radar track history handle.

Returns

DW_INVALID_ARGUMENT if radar track history handle is NULL.
DW_SUCCESS otherwise.

dwRadarTrackHistory_getRadarTrackHistory()

DW_API_PUBLIC dwStatus dwRadarTrackHistory_getRadarTrackHistory	(	dwRadarTrackHistory *	radarTrackHistory,
		dwRadarTrackHistoryHandle_t	obj
	)

Get radar track history.

Parameters

[out]	radarTrackHistory	Current radar track history
[in]	obj	Specifies radar track history handle.

Returns

DW_INVALID_ARGUMENT if radar track history handle or radarTrackHistory is NULL.
DW_SUCCESS otherwise.

dwRadarTrackHistory_initialize()

DW_API_PUBLIC dwStatus dwRadarTrackHistory_initialize	(	dwRadarTrackHistoryHandle_t *	obj,
		uint32_t	maxObjectCount,
		uint32_t	historyCapacity,
		dwContextHandle_t	ctx
	)

Creates and initialize a radar track history.

Parameters

[out]	obj	A pointer to the radar track history handle is returned here.
[in]	maxObjectCount	Specifies the maxinum number of objects that the history can have.
[in]	historyCapacity	Specifies the capacity of object history circular buffer.
[in]	ctx	Specifies the handle to the dw context.

Returns

DW_INVALID_ARGUMENT if obj is NULL.
DW_SUCCESS otherwise.

dwRadarTrackHistory_release()

DW_API_PUBLIC dwStatus dwRadarTrackHistory_release

(

dwRadarTrackHistoryHandle_t *

obj

)

Releases the radar track history.

This method releases all resources associated with a radar track history.

Note

This method renders the handle unusable.

Parameters

[in]

obj

A pointer to the object handle to be released.

Returns

DW_INVALID_ARGUMENT if radar track history handle is NULL.
DW_SUCCESS otherwise.