NVIDIA DeepStream SDK API Reference

8.0 Release
sources/includes/nvds_tracker_meta.h
Go to the documentation of this file.
1 /*
2  * SPDX-FileCopyrightText: Copyright (c) 2020-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
3  * SPDX-License-Identifier: LicenseRef-NvidiaProprietary
4  *
5  * NVIDIA CORPORATION, its affiliates and licensors retain all intellectual
6  * property and proprietary rights in and to this material, related
7  * documentation and any modifications thereto. Any use, reproduction,
8  * disclosure or distribution of this material and related documentation
9  * without an express license agreement from NVIDIA CORPORATION or
10  * its affiliates is strictly prohibited.
11  */
24 #ifndef _NVDS_TRACKER_META_H_
25 #define _NVDS_TRACKER_META_H_
26 
27 #include <stdint.h>
28 #include "nvll_osd_struct.h"
29 
30 #define MAX_LABEL_SIZE 128
31 
32 #ifdef __cplusplus
33 extern "C"
34 {
35 #endif
36 typedef enum { EMPTY = 0,
37  ACTIVE = 1,
38  INACTIVE = 2,
39  TENTATIVE = 3,
40  PROJECTED = 4,
43 
47  typedef struct _NvDsTargetMiscDataFrame
48 {
50  uint32_t frameNum;
54  float confidence;
56  uint32_t age;
60  float visibility;
62  float ptWorldFeet[2];
63 
65 
66 
71 {
75  uint32_t numObj;
77  uint32_t numAllocated;
79  uint64_t uniqueId;
81  uint16_t classId;
84 
86 
91 {
95  uint32_t streamID;
97  uint64_t surfaceStreamID;
99  uint32_t numAllocated;
101  uint32_t numFilled;
103 
108 {
112  uint32_t numAllocated;
114  uint32_t numFilled;
116  void* priv_data;
118 
122 typedef struct _NvDsReidTensorBatch
123 {
125  uint32_t featureSize;
127  uint32_t numFilled;
129  float* ptr_host;
131  float* ptr_dev;
133  void* priv_data;
135 
136 
141 
145 typedef struct _NvDsObjConvexHull
146 {
148  int* list;
152  uint32_t numPoints;
154 
158 typedef struct _NvDsObjReid
159 {
161  uint32_t featureSize;
163  float* ptr_host;
165  float* ptr_dev;
166 } NvDsObjReid;
167 
171 typedef struct _NvDsObj3DBbox
172 {
174  float xCentre;
175  float yCentre;
176  float zCentre;
177  /* 3D bbox dimensions */
178  float xLen;
179  float yLen;
180  float zLen;
181  /* 3D bbox rotation */
182  float xRot;
183  float yRot;
184  float zRot;
185  /* 3D bbox velocity */
186  float xVel;
187  float yVel;
188  float zVel;
189 } NvDsObj3DBbox;
190 
191 #ifdef __cplusplus
192 }
193 #endif
194 
195 #endif
196 
_NvDsTargetMiscDataObject::numObj
uint32_t numObj
Number of frames this target appreared in the past.
Definition: sources/includes/nvds_tracker_meta.h:75
_NvOSD_RectParams
Holds the box parameters of the box to be overlayed.
Definition: sources/includes/nvll_osd_struct.h:140
_NvDsObj3DBbox::xLen
float xLen
Definition: sources/includes/nvds_tracker_meta.h:178
_NvDsObj3DBbox::zVel
float zVel
Definition: sources/includes/nvds_tracker_meta.h:188
_NvDsObjConvexHull::numPoints
uint32_t numPoints
Holds the number of points in the list.
Definition: sources/includes/nvds_tracker_meta.h:152
nvll_osd_struct.h
TENTATIVE
@ TENTATIVE
\ tracking is not confirmed or w/ low confidence, so not reporting the outputs, but keep tracking (i....
Definition: sources/includes/nvds_tracker_meta.h:39
_NvDsTargetMiscDataStream
All misc targets data for a given stream.
Definition: sources/includes/nvds_tracker_meta.h:90
_NvDsTargetMiscDataBatch::list
NvDsTargetMiscDataStream * list
Pointer to array of stream lists.
Definition: sources/includes/nvds_tracker_meta.h:110
_NvDsObjReid::ptr_dev
float * ptr_dev
ReID vector pointer on GPU.
Definition: sources/includes/nvds_tracker_meta.h:165
NvDsReidTensorBatch
struct _NvDsReidTensorBatch NvDsReidTensorBatch
ReID tensor of the batch.
_NvDsTargetMiscDataStream::streamID
uint32_t streamID
Stream id the same as frame_meta->pad_index.
Definition: sources/includes/nvds_tracker_meta.h:95
_NvDsTargetMiscDataStream::surfaceStreamID
uint64_t surfaceStreamID
Stream id used inside tracker plugin.
Definition: sources/includes/nvds_tracker_meta.h:97
_NvDsObjConvexHull::list
int * list
Holds a pointer to a list or array of object information blocks.
Definition: sources/includes/nvds_tracker_meta.h:148
_NvDsObjReid::featureSize
uint32_t featureSize
ReID vector length.
Definition: sources/includes/nvds_tracker_meta.h:161
_NvDsReidTensorBatch::ptr_dev
float * ptr_dev
ReID vector on GPU.
Definition: sources/includes/nvds_tracker_meta.h:131
_NvDsObj3DBbox::xCentre
float xCentre
Centroid of the 3D bbox.
Definition: sources/includes/nvds_tracker_meta.h:174
_NvDsReidTensorBatch::featureSize
uint32_t featureSize
Each target's ReID vector length.
Definition: sources/includes/nvds_tracker_meta.h:125
_NvDsTargetMiscDataFrame::tBbox
NvOSD_RectParams tBbox
Bounding box.
Definition: sources/includes/nvds_tracker_meta.h:52
_NvDsTargetMiscDataStream::list
NvDsTargetMiscDataObject * list
Pointer to targets inside this stream.
Definition: sources/includes/nvds_tracker_meta.h:93
_NvDsTargetMiscDataObject::objLabel
char objLabel[MAX_LABEL_SIZE]
An array of the string describing the target class.
Definition: sources/includes/nvds_tracker_meta.h:83
NvDsTargetMiscDataObject
struct _NvDsTargetMiscDataObject NvDsTargetMiscDataObject
All misc data output for a single target.
_NvDsObjReid
Holds Reid Vector information for an object.
Definition: sources/includes/nvds_tracker_meta.h:158
_NvDsTargetMiscDataFrame::trackerState
TRACKER_STATE trackerState
Curret Tracker State.
Definition: sources/includes/nvds_tracker_meta.h:58
_NvDsTargetMiscDataFrame::confidence
float confidence
Tracking confidence.
Definition: sources/includes/nvds_tracker_meta.h:54
NvDsTargetMiscDataStream
struct _NvDsTargetMiscDataStream NvDsTargetMiscDataStream
All misc targets data for a given stream.
_NvDsObj3DBbox::yRot
float yRot
Definition: sources/includes/nvds_tracker_meta.h:183
QUASIACTIVE
@ QUASIACTIVE
\ tracking is completed, the tracklet is about to be archived, and some projected points are appended...
Definition: sources/includes/nvds_tracker_meta.h:41
NvDsTargetMiscDataBatch
struct _NvDsTargetMiscDataBatch NvDsTargetMiscDataBatch
Batch of all streams of a given target misc output.
_NvDsTargetMiscDataObject::uniqueId
uint64_t uniqueId
Target tracking id.
Definition: sources/includes/nvds_tracker_meta.h:79
NvDsObj3DBbox
struct _NvDsObj3DBbox NvDsObj3DBbox
Holds 3D bbox information for an object.
_NvDsTargetMiscDataFrame::age
uint32_t age
Tracking age.
Definition: sources/includes/nvds_tracker_meta.h:56
NvDsTrajectoryBatch
NvDsTargetMiscDataBatch NvDsTrajectoryBatch
Batch of trajectory data in all streams.
Definition: sources/includes/nvds_tracker_meta.h:140
_NvDsObj3DBbox::zLen
float zLen
Definition: sources/includes/nvds_tracker_meta.h:180
_NvDsObj3DBbox::yVel
float yVel
Definition: sources/includes/nvds_tracker_meta.h:187
NvDsObjReid
struct _NvDsObjReid NvDsObjReid
Holds Reid Vector information for an object.
_NvDsTargetMiscDataStream::numAllocated
uint32_t numAllocated
Maximum number of objects allocated.
Definition: sources/includes/nvds_tracker_meta.h:99
_NvDsObj3DBbox::xRot
float xRot
Definition: sources/includes/nvds_tracker_meta.h:182
_NvDsReidTensorBatch::priv_data
void * priv_data
Pointer to internal buffer pool needed by gst pipelines to return buffers.
Definition: sources/includes/nvds_tracker_meta.h:133
NvDsObjConvexHull
struct _NvDsObjConvexHull NvDsObjConvexHull
Holds convex hull information.
_NvDsObjConvexHull
Holds convex hull information.
Definition: sources/includes/nvds_tracker_meta.h:145
_NvDsTargetMiscDataObject::classId
uint16_t classId
Target class id.
Definition: sources/includes/nvds_tracker_meta.h:81
_NvDsTargetMiscDataStream::numFilled
uint32_t numFilled
Number of objects in this frame.
Definition: sources/includes/nvds_tracker_meta.h:101
_NvDsTargetMiscDataBatch::priv_data
void * priv_data
Pointer to internal buffer pool needed by gst pipelines to return buffers.
Definition: sources/includes/nvds_tracker_meta.h:116
_NvDsTargetMiscDataObject::numAllocated
uint32_t numAllocated
Maximum number of frames allocated.
Definition: sources/includes/nvds_tracker_meta.h:77
_NvDsTargetMiscDataFrame::frameNum
uint32_t frameNum
Frame number.
Definition: sources/includes/nvds_tracker_meta.h:50
_NvDsTargetMiscDataFrame
A single frame of misc data for a given Target.
Definition: sources/includes/nvds_tracker_meta.h:47
_NvDsReidTensorBatch::ptr_host
float * ptr_host
ReID vector on CPU.
Definition: sources/includes/nvds_tracker_meta.h:129
_NvDsTargetMiscDataFrame::ptWorldFeet
float ptWorldFeet[2]
Feet location of the object on the world ground.
Definition: sources/includes/nvds_tracker_meta.h:62
NvDsTargetMiscDataFrame
struct _NvDsTargetMiscDataFrame NvDsTargetMiscDataFrame
A single frame of misc data for a given Target.
INACTIVE
@ INACTIVE
\ tracking is being confirmed by detectors and actively reporting outputs
Definition: sources/includes/nvds_tracker_meta.h:38
_NvDsTargetMiscDataFrame::visibility
float visibility
bbox visibility with respect to the image border
Definition: sources/includes/nvds_tracker_meta.h:60
_NvDsTargetMiscDataObject::list
NvDsTargetMiscDataFrame * list
Pointer to a list per-frame information of the target.
Definition: sources/includes/nvds_tracker_meta.h:73
_NvDsObjConvexHull::numPointsAllocated
uint32_t numPointsAllocated
Holds the number of blocks allocated for the list.
Definition: sources/includes/nvds_tracker_meta.h:150
_NvDsObjReid::ptr_host
float * ptr_host
ReID vector pointer on CPU.
Definition: sources/includes/nvds_tracker_meta.h:163
_NvDsReidTensorBatch::numFilled
uint32_t numFilled
Number of reid vectors in the batch.
Definition: sources/includes/nvds_tracker_meta.h:127
MAX_LABEL_SIZE
#define MAX_LABEL_SIZE
Definition: sources/includes/nvds_tracker_meta.h:30
_NvDsTargetMiscDataBatch
Batch of all streams of a given target misc output.
Definition: sources/includes/nvds_tracker_meta.h:107
_NvDsObj3DBbox
Holds 3D bbox information for an object.
Definition: sources/includes/nvds_tracker_meta.h:171
_NvDsObj3DBbox::zCentre
float zCentre
Definition: sources/includes/nvds_tracker_meta.h:176
_NvDsObj3DBbox::yLen
float yLen
Definition: sources/includes/nvds_tracker_meta.h:179
_NvDsTargetMiscDataBatch::numAllocated
uint32_t numAllocated
Number of blocks allocated for the list.
Definition: sources/includes/nvds_tracker_meta.h:112
_NvDsObj3DBbox::xVel
float xVel
Definition: sources/includes/nvds_tracker_meta.h:186
EMPTY
@ EMPTY
Definition: sources/includes/nvds_tracker_meta.h:36
TRACKER_STATE
TRACKER_STATE
Definition: sources/includes/nvds_tracker_meta.h:36
_NvDsObj3DBbox::zRot
float zRot
Definition: sources/includes/nvds_tracker_meta.h:184
PROJECTED
@ PROJECTED
\ tracking is just started and in a probational period. Waiting to become ACTIVE
Definition: sources/includes/nvds_tracker_meta.h:40
_NvDsTargetMiscDataBatch::numFilled
uint32_t numFilled
Number of filled blocks in the list.
Definition: sources/includes/nvds_tracker_meta.h:114
ACTIVE
@ ACTIVE
\ The corresponding tracker is no longer is in use
Definition: sources/includes/nvds_tracker_meta.h:37
_NvDsReidTensorBatch
ReID tensor of the batch.
Definition: sources/includes/nvds_tracker_meta.h:122
_NvDsTargetMiscDataObject
All misc data output for a single target.
Definition: sources/includes/nvds_tracker_meta.h:70
_NvDsObj3DBbox::yCentre
float yCentre
Definition: sources/includes/nvds_tracker_meta.h:175