sources/includes/nvdsmotmetafusion.h

Go to the documentation of this file.

/*
 * SPDX-FileCopyrightText: Copyright (c) 2025-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
 * SPDX-License-Identifier: Apache-2.0
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
 
#ifndef _NVMOTRACKERMETAFUSER_H_
#define _NVMOTRACKERMETAFUSER_H_
 
#include <stdint.h>
#include <time.h>
 
#include "nvbufsurface.h"
#include "nvds_tracker_meta.h"
#include <vector>
 
#ifdef __cplusplus
extern "C"
{
#endif
 
 
typedef uint64_t NvMOTObjectId;
typedef uint32_t NvMOTFrameNum;
// <object id, <frame_num, offset in reid array>>
typedef std::map<NvMOTObjectId, std::map<NvMOTFrameNum, uint32_t>> NvMOTReidEmbeddingsList;
typedef std::map<NvMOTObjectId, NvMOTObjectId> NvMOTMFObjectIdMap;
 
typedef struct _NvMOTMFConfig
{
    uint32_t frameWidth;
    uint32_t frameHeight;
    uint32_t maxVideoChunkLength;
    uint16_t customConfigFilePathSize;
    char* customConfigFilePath;
} NvMOTMFConfig;
 
typedef enum
{
    NvMOTMFConfigStatus_OK,
    NvMOTMFConfigStatus_Error,
    NvMOTMFConfigStatus_Invalid,
    NvMOTMFConfigStatus_Unsupported
} NvMOTMFConfigStatus;
 
typedef struct _NvMOTMFConfigResponse
{
    NvMOTMFConfigStatus summaryStatus;
    NvMOTMFConfigStatus computeStatus;
    NvMOTMFConfigStatus transformBatchStatus;
    NvMOTMFConfigStatus miscConfigStatus;
    NvMOTMFConfigStatus customConfigStatus;
} NvMOTMFConfigResponse;
 
 
typedef enum
{
    NvMOTMFStatus_OK,
    NvMOTMFStatus_Error,
    NvMOTMFStatus_Invalid_Path
} NvMOTMFStatus;
 
typedef struct _NvMOTMFTrackerFusedData
{
    NvDsTargetMiscDataStream *pFusedTracksStream;
} NvMOTMFTrackerFusedData;
 
typedef struct _NvMOTMFTrackedObjMeta
{
    uint32_t startFrameNumber;
    uint32_t chunkDuration;
    NvDsTargetMiscDataStream *tracklets;
    NvDsReidTensorBatch reidTensorChunk;
    NvMOTReidEmbeddingsList reidEmbeddingsList;
} NvMOTMFTrackedObjMeta;
 
 
struct NvMOTMFContext;
typedef struct NvMOTMFContext* NvMOTMFContextHandle;
 
typedef struct _NvMOTMFQuery
{
    uint32_t maxTargetsPerStream;
    uint32_t reidFeatureSize;
    uint32_t reidHistorySize;
    NvMOTMFContextHandle contextHandle;
} NvMOTMFQuery;
 
NvMOTMFStatus NvMOTMF_Init(NvMOTMFConfig *pConfigIn,
                       NvMOTMFContextHandle *pContextHandle,
                       NvMOTMFConfigResponse *pConfigResponse);
 
void NvMOTMF_DeInit(NvMOTMFContextHandle contextHandle);
 
NvMOTMFStatus NvMOTMF_Process(NvMOTMFContextHandle contextHandle,
                          NvMOTMFTrackedObjMeta *pVideoChunk,
                          NvMOTMFObjectIdMap &ipOpObjectIdMap);
 
NvMOTMFStatus NvMOTMF_RetrieveFusedData(NvMOTMFContextHandle contextHandle,
                          NvMOTMFTrackerFusedData *pTrackerMiscData, bool eos);
 
NvMOTMFStatus NvMOTMF_Query(NvMOTMFQuery *pQuery);
 
 // end of API group
 
#ifdef __cplusplus
}
#endif
 
#endif