GstMeta

GstCustomMeta

gst_custom_meta_get_structure

GstStructure *
gst_custom_meta_get_structure (GstCustomMeta * meta)

Retrieve the GstStructure backing a custom meta, the structure's mutability is conditioned to the writability of the GstBuffer meta is attached to.

Since : 1.20

gst_custom_meta_has_name

gboolean
gst_custom_meta_has_name (GstCustomMeta * meta,
                          const gchar * name)

Checks whether the name of the custom meta is name

Since : 1.20

GstMeta

gst_meta_compare_seqnum

gint
gst_meta_compare_seqnum (const GstMeta * meta1,
                         const GstMeta * meta2)

Meta sequence number compare function. Can be used as GCompareFunc or a GCompareDataFunc.

Since : 1.16

gst_meta_get_seqnum

guint64
gst_meta_get_seqnum (const GstMeta * meta)

Gets seqnum for this meta.

Since : 1.16

gst_meta_api_type_get_tags

const gchar*const **
gst_meta_api_type_get_tags (GType api)

Since : 1.2

gst_meta_api_type_has_tag

gboolean
gst_meta_api_type_has_tag (GType api,
                           GQuark tag)

Check if api was registered with tag.

gst_meta_api_type_register

GType
gst_meta_api_type_register (const gchar * api,
                            const gchar ** tags)

Register and return a GType for the api and associate it with tags.

gst_meta_get_info

const GstMetaInfo *
gst_meta_get_info (const gchar * impl)

Lookup a previously registered meta info structure by its implementation name impl.

gst_meta_register

const GstMetaInfo *
gst_meta_register (GType api,
                   const gchar * impl,
                   gsize size,
                   GstMetaInitFunction init_func,
                   GstMetaFreeFunction free_func,
                   GstMetaTransformFunction transform_func)

Register a new GstMeta implementation.

The same info can be retrieved later with gst_meta_get_info by using impl as the key.

gst_meta_register_custom

const GstMetaInfo *
gst_meta_register_custom (const gchar * name,
                          const gchar ** tags,
                          GstCustomMetaTransformFunction transform_func,
                          gpointer user_data,
                          GDestroyNotify destroy_data)

Register a new custom GstMeta implementation, backed by an opaque structure holding a GstStructure.

The registered info can be retrieved later with gst_meta_get_info by using name as the key.

The backing GstStructure can be retrieved with gst_custom_meta_get_structure, its mutability is conditioned by the writability of the buffer the meta is attached to.

When transform_func is NULL, the meta and its backing GstStructure will always be copied when the transform operation is copy, other operations are discarded, copy regions are ignored.

Since : 1.20

GstMetaInfo

gst_meta_info_is_custom

gboolean
gst_meta_info_is_custom (const GstMetaInfo * info)

Since : 1.20

GstMetaTransformCopy

GST_META_CAST

#define GST_META_CAST(meta)   ((GstMeta *)(meta))

GST_META_FLAGS

#define GST_META_FLAGS(meta)  (GST_META_CAST (meta)->flags)

A flags word containing GstMetaFlags flags set on meta

GST_META_FLAG_IS_SET

#define GST_META_FLAG_IS_SET(meta,flag)        !!(GST_META_FLAGS (meta) & (flag))

Gives the status of a specific flag on a metadata.

GST_META_FLAG_SET

#define GST_META_FLAG_SET(meta,flag)           (GST_META_FLAGS (meta) |= (flag))

Sets a metadata flag on a metadata.

GST_META_FLAG_UNSET

#define GST_META_FLAG_UNSET(meta,flag)         (GST_META_FLAGS (meta) &= ~(flag))

Clears a metadata flag.

GST_META_TRANSFORM_IS_COPY

#define GST_META_TRANSFORM_IS_COPY(type) ((type) == _gst_meta_transform_copy)

Check if the transform type is a copy transform

GstMetaFlags

Extra metadata flags.

GST_META_TAG_MEMORY

#define GST_META_TAG_MEMORY (_gst_meta_tag_memory)

Metadata tagged with this tag depends on the particular memory or buffer that it is on.

GST_META_TAG_MEMORY_REFERENCE_STR

#define GST_META_TAG_MEMORY_REFERENCE_STR "memory-reference"

This metadata stays relevant until a deep copy is made.

GST_META_TAG_MEMORY_STR

#define GST_META_TAG_MEMORY_STR "memory"

This metadata stays relevant as long as memory layout is unchanged. In hindsight, this tag should have been called "memory-layout".

GstCustomMetaTransformFunction

gboolean
(*GstCustomMetaTransformFunction) (GstBuffer * transbuf,
                                   GstCustomMeta * meta,
                                   GstBuffer * buffer,
                                   GQuark type,
                                   gpointer data,
                                   gpointer user_data)

Function called for each meta in buffer as a result of performing a transformation that yields transbuf. Additional type specific transform data is passed to the function as data.

Implementations should check the type of the transform and parse additional type specific fields in data that should be used to update the metadata on transbuf.

Since : 1.20

GstMetaFreeFunction

(*GstMetaFreeFunction) (GstMeta * meta,
                        GstBuffer * buffer)

Function called when meta is freed in buffer.

GstMetaInitFunction

gboolean
(*GstMetaInitFunction) (GstMeta * meta,
                        gpointer params,
                        GstBuffer * buffer)

Function called when meta is initialized in buffer.

GstMetaTransformFunction

gboolean
(*GstMetaTransformFunction) (GstBuffer * transbuf,
                             GstMeta * meta,
                             GstBuffer * buffer,
                             GQuark type,
                             gpointer data)

Function called for each meta in buffer as a result of performing a transformation on transbuf. Additional type specific transform data is passed to the function as data.

Implementations should check the type of the transform and parse additional type specific fields in data that should be used to update the metadata on transbuf.