GStreamer 0.8 Core Reference Manual |
---|
GstTagSetter — Element interface that allows setting and retrieval of media metadata
#include <gst/gst.h> struct GstTagSetter; struct GstTagSetterIFace; void gst_tag_setter_merge (GstTagSetter *setter, const GstTagList *list, GstTagMergeMode mode); void gst_tag_setter_add (GstTagSetter *setter, GstTagMergeMode mode, const gchar *tag, ...); void gst_tag_setter_add_values (GstTagSetter *setter, GstTagMergeMode mode, const gchar *tag, ...); void gst_tag_setter_add_valist (GstTagSetter *setter, GstTagMergeMode mode, const gchar *tag, va_list var_args); void gst_tag_setter_add_valist_values (GstTagSetter *setter, GstTagMergeMode mode, const gchar *tag, va_list var_args); G_CONST_RETURN GstTagList* gst_tag_setter_get_list (GstTagSetter *setter); void gst_tag_setter_set_merge_mode (GstTagSetter *setter, GstTagMergeMode mode); GstTagMergeMode gst_tag_setter_get_merge_mode (GstTagSetter *setter);
struct GstTagSetterIFace { GTypeInterface g_iface; /* signals */ /* virtual table */ };
void gst_tag_setter_merge (GstTagSetter *setter, const GstTagList *list, GstTagMergeMode mode);
Merges the given list into the setter's list using the given mode.
setter : | a GstTagSetter |
list : | a tag list to merge from |
mode : | the mode to merge with |
void gst_tag_setter_add (GstTagSetter *setter, GstTagMergeMode mode, const gchar *tag, ...);
Adds the given tag / value pairs on the setter using the given merge mode. The list must be terminated with GST_TAG_INVALID.
setter : | a GstTagSetter |
mode : | the mode to use |
tag : | tag to set |
... : | more tag / value pairs to set |
void gst_tag_setter_add_values (GstTagSetter *setter, GstTagMergeMode mode, const gchar *tag, ...);
Adds the given tag / GValue pairs on the setter using the given merge mode. The list must be terminated with GST_TAG_INVALID.
setter : | a GstTagSetter |
mode : | the mode to use |
tag : | tag to set |
... : | more tag / GValue pairs to set |
void gst_tag_setter_add_valist (GstTagSetter *setter, GstTagMergeMode mode, const gchar *tag, va_list var_args);
Adds the given tag / value pairs on the setter using the given merge mode. The list must be terminated with GST_TAG_INVALID.
setter : | a GstTagSetter |
mode : | the mode to use |
tag : | tag to set |
var_args : | tag / value pairs to set |
void gst_tag_setter_add_valist_values (GstTagSetter *setter, GstTagMergeMode mode, const gchar *tag, va_list var_args);
Adds the given tag / GValue pairs on the setter using the given merge mode. The list must be terminated with GST_TAG_INVALID.
setter : | a GstTagSetter |
mode : | the mode to use |
tag : | tag to set |
var_args : | tag / GValue pairs to set |
G_CONST_RETURN GstTagList* gst_tag_setter_get_list (GstTagSetter *setter);
Retrieves a copy of the current list of tags the setter uses. You need to gst_tag_list_free() the list after use.
setter : | a GstTagSetter |
Returns : | a current snapshot of the taglist used in the setter or NULL if none is used. |
void gst_tag_setter_set_merge_mode (GstTagSetter *setter, GstTagMergeMode mode);
Sets the given merge mode that is used for adding tags from events to tags specified by this interface. The default is GST_TAG_MERGE_KEEP, which keeps the tags by this interface and discards tags from events.
setter : | a GstTagSetter |
mode : | The mode with which tags are added |
GstTagMergeMode gst_tag_setter_get_merge_mode (GstTagSetter *setter);
Queries the mode by which tags inside the setter are overwritten by tags from events
setter : | a GstTagSetter |
Returns : | the merge mode used inside the element. |
<< GstTagList | GstThread >> |