DeepStream Metadata Extension

Detailed Description

Defines an API for managing GStreamer DeepStream metadata.

DeepStream Metadata is attached to a buffer with gst_buffer_add_nvds_meta(). Its metadata type is set to NVDS_BATCH_GST_META.

Multiple groups of metadata may be attached by different elements. gst_buffer_get_nvds_meta() gets the last added NvDsMeta.

The NvDsMeta::meta_data structure member must be cast to a meaningful structure pointer based on the meta_type. For example, for meta_type = NVDS_BATCH_GST_META, meta_data must be cast as (NvDsBatchMeta *).

Data Structures
struct	_NvDsMeta
	Holds DeepSteam metadata. More...

Macros
#define	NVDS_META_API_TYPE   (nvds_meta_api_get_type())
#define	NVDS_META_INFO   (nvds_meta_get_info())
#define	NVDS_META_STRING   "nvdsmeta"

Typedefs
typedef struct _NvDsMeta	NvDsMeta
	Holds DeepSteam metadata. More...

Enumerations
enum	GstNvDsMetaType {   NVDS_GST_INVALID_META =-1,   NVDS_BATCH_GST_META = NVDS_GST_CUSTOM_META + 1,   NVDS_DECODER_GST_META,   NVDS_DEWARPER_GST_META,   NVDS_RESERVED_GST_META = NVDS_GST_CUSTOM_META + 4096,   NVDS_GST_META_FORCE32 = 0x7FFFFFFF }
	Defines the type of metadata. More...

Functions
GType	nvds_meta_api_get_type (void)
const GstMetaInfo *	nvds_meta_get_info (void)
NvDsMeta *	gst_buffer_add_nvds_meta (GstBuffer *buffer, gpointer meta_data, gpointer user_data, NvDsMetaCopyFunc copy_func, NvDsMetaReleaseFunc release_func)
	Adds GstMeta of type NvDsMeta to the GstBuffer and sets the meta_data member of NvDsMeta. More...
NvDsMeta *	gst_buffer_get_nvds_meta (GstBuffer *buffer)
	Gets the NvDsMeta last added to a GstBuffer. More...
NvDsBatchMeta *	gst_buffer_get_nvds_batch_meta (GstBuffer *buffer)
	Gets the NvDsBatchMeta added to a GstBuffer. More...

Macro Definition Documentation

#define NVDS_META_API_TYPE   (nvds_meta_api_get_type())

Definition at line 54 of file gstnvdsmeta.h.

#define NVDS_META_INFO   (nvds_meta_get_info())

Definition at line 58 of file gstnvdsmeta.h.

#define NVDS_META_STRING   "nvdsmeta"

Definition at line 60 of file gstnvdsmeta.h.

Typedef Documentation

typedef struct _NvDsMeta NvDsMeta

Holds DeepSteam metadata.

Enumeration Type Documentation

enum GstNvDsMetaType

Defines the type of metadata.

NVIDIA-defined GstNvDsMetaType values are in the range from NVDS_BATCH_GST_META to NVDS_START_USER_META.

Enumerator
NVDS_GST_INVALID_META
NVDS_BATCH_GST_META
NVDS_DECODER_GST_META
NVDS_DEWARPER_GST_META
NVDS_RESERVED_GST_META
NVDS_GST_META_FORCE32

Definition at line 66 of file gstnvdsmeta.h.

Function Documentation

NvDsMeta* gst_buffer_add_nvds_meta	(	GstBuffer *	buffer,
		gpointer	meta_data,
		gpointer	user_data,
		NvDsMetaCopyFunc	copy_func,
		NvDsMetaReleaseFunc	release_func
	)

Adds GstMeta of type NvDsMeta to the GstBuffer and sets the meta_data member of NvDsMeta.

Parameters

[in]	buffer	A pointer to a GstBuffer to which the function adds metadata.
[in]	meta_data	A pointer at which the function sets the meta_data member of NvDsMeta.
[in]	user_data	A pointer to the user-specific data.
[in]	copy_func	The callback to be called when NvDsMeta is to be copied. The function is called with meta_data and user_data as parameters.
[in]	release_func	The callback to be called when NvDsMeta is to be destroyed. The function is called with meta_data and user_data as parameters.

Returns

A pointer to the attached NvDsMeta structure if successful, or NULL otherwise.

NvDsBatchMeta* gst_buffer_get_nvds_batch_meta

(

GstBuffer *

buffer

)

Gets the NvDsBatchMeta added to a GstBuffer.

Parameters

[in]

buffer

A pointer to the GstBuffer.

Returns

A pointer to the NvDsBatchMeta structure, or NULL if no NvDsMeta was attached.

NvDsMeta* gst_buffer_get_nvds_meta

(

GstBuffer *

buffer

)

Gets the NvDsMeta last added to a GstBuffer.

Parameters

[in]

buffer

A pointer to the GstBuffer.

Returns

A pointer to the last added NvDsMeta structure, or NULL if no NvDsMeta was attached.

GType nvds_meta_api_get_type

(

void

)

const GstMetaInfo* nvds_meta_get_info

(

void

)