Video Core Feature Interface Reference Manual  jpl-r3.17.10
vftr_td.h File Reference

Core feature-lib for tamper detection. More...

Data Structures

struct  VFTR_TD_PARAM_S
 Structure for the parameters of tamper detection. More...
 
struct  VFTR_TD_STATUS_S
 Structure for the result of tamper detection. More...
 
struct  VFTR_TD_MPI_INPUT_S
 Structure for the inputs of tamper detection within Region of interest. More...
 
struct  VFTR_TD_INSTANCE_S
 Structure for the tamper detection object. More...
 

Macros

#define VFTR_TD_SENSITIVITY_MIN   0
 
#define VFTR_TD_SENSITIVITY_MAX   255
 
#define VFTR_TD_ENDURANCE_MIN   0
 
#define VFTR_TD_ENDURANCE_MAX   255
 
#define VFTR_TD_REDIRECT_SENSITIVITY_MIN   0
 
#define VFTR_TD_REDIRECT_SENSITIVITY_MAX   255
 
#define VFTR_TD_REDIRECT_GLOBAL_CHANGE_MIN   0
 
#define VFTR_TD_REDIRECT_GLOBAL_CHANGE_MAX   255
 
#define VFTR_TD_REDIRECT_TRIGGER_DELAY_MIN   0
 
#define VFTR_TD_REDIRECT_TRIGGER_DELAY_MAX   3600
 

Typedefs

typedef struct vftr_td_algo_status_s VFTR_TD_ALGO_STATUS_S
 

Enumerations

enum  VFTR_TD_ALARM_E { VFTR_TD_ALARM_BLOCK, VFTR_TD_ALARM_REDIRECT, VFTR_TD_ALARM_NUM }
 Enumeration of tamper alarm. More...
 

Functions

VFTR_TD_INSTANCE_SVFTR_TD_newInstance ()
 Create tamper detection instance. More...
 
INT32 VFTR_TD_deleteInstance (VFTR_TD_INSTANCE_S **instance)
 Delete tamper detection instance. More...
 
INT32 VFTR_TD_setParam (VFTR_TD_INSTANCE_S *instance, const VFTR_TD_PARAM_S *param)
 Set tamper detection parameters. More...
 
INT32 VFTR_TD_checkParam (const VFTR_TD_PARAM_S *param)
 check tamper detection parameters. More...
 
INT32 VFTR_TD_getParam (const VFTR_TD_INSTANCE_S *instance, VFTR_TD_PARAM_S *param)
 Get tamper detection parameters. More...
 
INT32 _VFTR_TD_dump (VFTR_TD_INSTANCE_S *instance, const VFTR_TD_MPI_INPUT_S *mpi_input, VFTR_TD_STATUS_S *status)
 Dump TD debuging info. More...
 
INT32 _VFTR_TD_detect (VFTR_TD_INSTANCE_S *instance, const VFTR_TD_MPI_INPUT_S *mpi_input, VFTR_TD_STATUS_S *status)
 Detect tamper. More...
 
INT32 VFTR_TD_getStat (const VFTR_TD_INSTANCE_S *instance, VFTR_TD_STATUS_S *stat)
 Get tamper detection status. More...
 
INT32 VFTR_TD_init (VFTR_TD_INSTANCE_S *instance, const MPI_RECT_S *roi, const int fps)
 Initialize tamper detect instance value. More...
 
FORCE_INLINE INT32 VFTR_TD_detect (VFTR_TD_INSTANCE_S *instance, const VFTR_TD_MPI_INPUT_S *mpi_input, VFTR_TD_STATUS_S *status)
 An inline function. If variable vftr_dump_en is true, then call dump function for debugging. More...
 

Detailed Description

Core feature-lib for tamper detection.

Macro Definition Documentation

#define VFTR_TD_ENDURANCE_MAX   255

maximal endurance.

#define VFTR_TD_ENDURANCE_MIN   0

minimal endurance.

#define VFTR_TD_REDIRECT_GLOBAL_CHANGE_MAX   255

maximal global change.

#define VFTR_TD_REDIRECT_GLOBAL_CHANGE_MIN   0

minimal global change.

#define VFTR_TD_REDIRECT_SENSITIVITY_MAX   255

maximal redirect sensitivity.

#define VFTR_TD_REDIRECT_SENSITIVITY_MIN   0

minimal redirect sensitivity.

#define VFTR_TD_REDIRECT_TRIGGER_DELAY_MAX   3600

maximal trigger delay.

#define VFTR_TD_REDIRECT_TRIGGER_DELAY_MIN   0

minimal trigger delay.

#define VFTR_TD_SENSITIVITY_MAX   255

maximal sensitivity.

#define VFTR_TD_SENSITIVITY_MIN   0

minimal sensitivity.

Enumeration Type Documentation

Enumeration of tamper alarm.

Enumerator
VFTR_TD_ALARM_BLOCK 

Block tamper type detects.

VFTR_TD_ALARM_REDIRECT 

redirect tamper type detects.

VFTR_TD_ALARM_NUM 

The number of the tamper type.

Function Documentation

INT32 _VFTR_TD_detect ( VFTR_TD_INSTANCE_S instance,
const VFTR_TD_MPI_INPUT_S mpi_input,
VFTR_TD_STATUS_S status 
)

Detect tamper.

Parameters
[in,out]instanceTamper detection instance.
[in]mpi_inputTamper detection input.
[out]statusTamper detection output result.
Returns
The execution result
Return values
0Success.
EFAULTParameters are NULL.
See also
VFTR_TD_getParam() VFTR_TD_checkParam()
INT32 _VFTR_TD_dump ( VFTR_TD_INSTANCE_S instance,
const VFTR_TD_MPI_INPUT_S mpi_input,
VFTR_TD_STATUS_S status 
)

Dump TD debuging info.

Parameters
[in]instancePointer to TD instance.
[in]mpi_inputPointer to TD mpi input.
[out]statusPointer to TD result.
Returns
The execution result.
Return values
0success.
-EFAULTinput pointer is NULL.
See also
none
INT32 VFTR_TD_checkParam ( const VFTR_TD_PARAM_S param)

check tamper detection parameters.

Parameters
[in]paramTamper detection parameters.
Return values
0Success.
EFAULTInput pointer is NULL.
EINVALTamper detection parameters are invalid.
See also
VFTR_TD_getParam() VFTR_TD_checkParam()
INT32 VFTR_TD_deleteInstance ( VFTR_TD_INSTANCE_S **  instance)

Delete tamper detection instance.

Parameters
[in,out]instanceTamper detection instance.
Returns
The execution result.
Return values
0success.
EFAULTinput pointer is NULL.
See also
VFTR_TD_newInstance()

TD_DUMP

FORCE_INLINE INT32 VFTR_TD_detect ( VFTR_TD_INSTANCE_S instance,
const VFTR_TD_MPI_INPUT_S mpi_input,
VFTR_TD_STATUS_S status 
)

An inline function. If variable vftr_dump_en is true, then call dump function for debugging.

See also
_VFTR_TD_dump()
_VFTR_TD_detect()
INT32 VFTR_TD_getParam ( const VFTR_TD_INSTANCE_S instance,
VFTR_TD_PARAM_S param 
)

Get tamper detection parameters.

Parameters
[in]instanceTD instance.
[out]paramTD parameters.
Return values
0Success.
EFAULTInput pointer is NULL.
See also
VFTR_TD_setParam()
INT32 VFTR_TD_getStat ( const VFTR_TD_INSTANCE_S instance,
VFTR_TD_STATUS_S status 
)

Get tamper detection status.

Parameters
[in]instanceTamper detection instance.
[out]statusDetected result.
Return values
0Success.
EFAULTInput pointer is NULL
See also
VFTR_TD_detect()
INT32 VFTR_TD_init ( VFTR_TD_INSTANCE_S instance,
const MPI_RECT_S roi,
const int  fps 
)

Initialize tamper detect instance value.

Parameters
[in,out]instanceTamper detection instance.
[in]roiRegion of interest to be detected
Returns
The execution result.
Return values
0Success.
See also
VFTR_TD_newInstance()
VFTR_TD_INSTANCE_S* VFTR_TD_newInstance ( )

Create tamper detection instance.

Returns
The pointer of tamper detection instance.
Return values
Not NULLsuccess to create instance.
NULLfail to create instance.
See also
VFTR_TD_deleteInstance()

TD_DUMP

INT32 VFTR_TD_setParam ( VFTR_TD_INSTANCE_S instance,
const VFTR_TD_PARAM_S param 
)

Set tamper detection parameters.

Parameters
[in,out]instancetamper detection instance.
[in]paramtamper detection parameters.
Return values
0success.
EFAULTinput pointer is NULL.
See also
VFTR_TD_getParam() VFTR_TD_checkParam()