ailia_tracker.h File Reference

#include "ailia.h"
#include "ailia_detector.h"

Include dependency graph for ailia_tracker.h:

Go to the source code of this file.

Classes
struct	_AILIATrackerObject
struct	_AILIATrackerSettings

Macros
#define	AILIA_API   __stdcall
#define	AILIA_TRACKER_ALGORITHM_BYTE_TRACK   (0)
	ByteTrack. More...
#define	AILIA_TRACKER_OBJECT_VERSION   (1)
#define	AILIA_TRACKER_SETTINGS_VERSION   (1)
#define	AILIA_TRACKER_FLAG_NONE   (0)
	Default flag. More...
#define	AILIA_TRACKER_FLAG_ALLOW_WIDE_ASPECT_RATIO   (1)
	By default, targets with an aspect ratio (width / height) greater than 1.6 are ignored in person tracking. Enabling this flag disables that restriction, making it suitable for tracking wide objects such as cars. More...

Typedefs
typedef struct _AILIATrackerObject	AILIATrackerObject
typedef struct _AILIATrackerSettings	AILIATrackerSettings

Functions
int AILIA_API	ailiaTrackerCreate (struct AILIATracker **tracker, int algorithm, const AILIATrackerSettings *settings, int version, int flags)
	Creates a AILIATracker instance. More...
int AILIA_API	ailiaTrackerAddTarget (struct AILIATracker *tracker, const AILIADetectorObject *detector_object, int version)
	Set tracking target. More...
int AILIA_API	ailiaTrackerCompute (struct AILIATracker *tracker)
	Perform tracking. More...
int AILIA_API	ailiaTrackerGetObjectCount (struct AILIATracker *tracker, unsigned int *obj_count)
	Gets the number of detection results. More...
int AILIA_API	ailiaTrackerGetObject (struct AILIATracker *tracker, AILIATrackerObject *obj, unsigned int index, unsigned int version)
	Gets the detection results. More...
int AILIA_API	ailiaTrackerDestroy (struct AILIATracker *tracker)
	It destroys the AILIATracker instance. More...
const char *AILIA_API	ailiaTrackerGetErrorDetail (struct AILIATracker *tracker)
	Returns the details of errors. More...

Macro Definition Documentation

AILIA_API

#define AILIA_API   __stdcall

AILIA_TRACKER_ALGORITHM_BYTE_TRACK

#define AILIA_TRACKER_ALGORITHM_BYTE_TRACK   (0)

ByteTrack.

AILIA_TRACKER_FLAG_ALLOW_WIDE_ASPECT_RATIO

#define AILIA_TRACKER_FLAG_ALLOW_WIDE_ASPECT_RATIO   (1)

By default, targets with an aspect ratio (width / height) greater than 1.6 are ignored in person tracking. Enabling this flag disables that restriction, making it suitable for tracking wide objects such as cars.

AILIA_TRACKER_FLAG_NONE

#define AILIA_TRACKER_FLAG_NONE   (0)

Default flag.

AILIA_TRACKER_OBJECT_VERSION

#define AILIA_TRACKER_OBJECT_VERSION   (1)

AILIA_TRACKER_SETTINGS_VERSION

#define AILIA_TRACKER_SETTINGS_VERSION   (1)

Typedef Documentation

AILIATrackerObject

typedef struct _AILIATrackerObject AILIATrackerObject

AILIATrackerSettings

typedef struct _AILIATrackerSettings AILIATrackerSettings

Function Documentation

ailiaTrackerAddTarget()

int AILIA_API ailiaTrackerAddTarget	(	struct AILIATracker *	tracker,
		const AILIADetectorObject *	detector_object,
		int	version
	)

Set tracking target.

Parameters

tracker	An AILIATracker instance pointer
detector_object	A pointer to the tracking target
version	AILIA_DETECTOR_OBJECT_VERSION

Returns

If this function is successful, it returns AILIA_STATUS_SUCCESS , or an error code otherwise.

ailiaTrackerCompute()

int AILIA_API ailiaTrackerCompute

(

struct AILIATracker *

tracker

)

Perform tracking.

Parameters

tracker

An AILIATracker instance pointer

Returns

If this function is successful, it returns AILIA_STATUS_SUCCESS , or an error code otherwise.

Get the recognition result with ailiaTrackerGetObject API.

ailiaTrackerCreate()

int AILIA_API ailiaTrackerCreate	(	struct AILIATracker **	tracker,
		int	algorithm,
		const AILIATrackerSettings *	settings,
		int	version,
		int	flags
	)

Creates a AILIATracker instance.

Parameters

tracker	A pointer to the AILIATracker instance pointer
algorithm	AILIA_TRACKER_ALGORITHM_*
settings	A pointer to the AILIATrackerSettings
version	AILIA_TRACKER_SETTINGS_VERSION
flags	Logical OR of AILIA_TRACKER_FLAG_*

Returns

If this function is successful, it returns AILIA_STATUS_SUCCESS , or an error code otherwise.

Creates a AILIATracker instance.

ailiaTrackerDestroy()

int AILIA_API ailiaTrackerDestroy

(

struct AILIATracker *

tracker

)

It destroys the AILIATracker instance.

Parameters

tracker

An AILIATracker instance pointer

Returns

If this function is successful, it returns AILIA_STATUS_SUCCESS , or an error code otherwise.

ailiaTrackerGetErrorDetail()

const char* AILIA_API ailiaTrackerGetErrorDetail

(

struct AILIATracker *

tracker

)

Returns the details of errors.

Parameters

tracker

The AILIATracker instance pointer

Returns

Error details

The return value does not have to be released. The string is valid until the next ailiaTracker API function is called.

ailiaTrackerGetObject()

int AILIA_API ailiaTrackerGetObject	(	struct AILIATracker *	tracker,
		AILIATrackerObject *	obj,
		unsigned int	index,
		unsigned int	version
	)

Gets the detection results.

Parameters

tracker	A AILIATracker instance pointer
obj	Object information
index	Object index
version	AILIA_TRACKER_OBJECT_VERSION

Returns

If this function is successful, it returns AILIA_STATUS_SUCCESS , or an error code otherwise.

If ailiaTrackerCompute() is not run at all, the function returns AILIA_STATUS_INVALID_STATE . The detection results are sorted in the order of estimated probability.

ailiaTrackerGetObjectCount()

int AILIA_API ailiaTrackerGetObjectCount	(	struct AILIATracker *	tracker,
		unsigned int *	obj_count
	)

Gets the number of detection results.

Parameters

tracker	An AILIATracker instance pointer
obj_count	The number of objects

Returns

If this function is successful, it returns AILIA_STATUS_SUCCESS , or an error code otherwise.