GstTagList

typedef GstStructure GstTagList;

enum GstTagMergeMode

typedef enum {
  GST_TAG_MERGE_UNDEFINED,
  GST_TAG_MERGE_REPLACE_ALL,
  GST_TAG_MERGE_REPLACE,
  GST_TAG_MERGE_APPEND,
  GST_TAG_MERGE_PREPEND,
  GST_TAG_MERGE_KEEP,
  GST_TAG_MERGE_KEEP_ALL,
  /* add more */
  GST_TAG_MERGE_COUNT
} GstTagMergeMode;

enum GstTagFlag

typedef enum {
  GST_TAG_FLAG_UNDEFINED,
  GST_TAG_FLAG_META,
  GST_TAG_FLAG_ENCODED,
  GST_TAG_FLAG_DECODED,
  GST_TAG_FLAG_COUNT
} GstTagFlag;

GstTagForeachFunc ()

void        (*GstTagForeachFunc)            (const GstTagList *list,
                                             const gchar *tag,
                                             gpointer user_data);

GstTagMergeFunc ()

void        (*GstTagMergeFunc)              (GValue *dest,
                                             const GValue *src);

gst_tag_register ()

void        gst_tag_register                (const gchar *name,
                                             GstTagFlag flag,
                                             GType type,
                                             const gchar *nick,
                                             const gchar *blurb,
                                             GstTagMergeFunc func);

Registers a new tag type for the use with GStreamer's type system. If a type with that name is already registered, that one is used. The old registration may have used a different type however. So don't rely on your supplied values. This function takes ownership of all supplied variables.

gst_tag_merge_use_first ()

void        gst_tag_merge_use_first         (GValue *dest,
                                             const GValue *src);

This is a convenience function for the func argument of gst_tag_register(). It creates a copy of the first value from the list.

gst_tag_merge_strings_with_comma ()

void        gst_tag_merge_strings_with_comma
                                            (GValue *dest,
                                             const GValue *src);

This is a convenience function for the func argument of gst_tag_register(). It concatenates all given strings using a comma. The tag must be registered as a G_TYPE_STRING or this function will fail.

gst_tag_exists ()

gboolean    gst_tag_exists                  (const gchar *tag);

Checks if the given type is already registered.

gst_tag_get_type ()

GType       gst_tag_get_type                (const gchar *tag);

Gets the GType used for this tag.

gst_tag_get_nick ()

G_CONST_RETURN gchar* gst_tag_get_nick      (const gchar *tag);

Returns the human-readable name of this tag, You must not change or free this string.

gst_tag_get_description ()

G_CONST_RETURN gchar* gst_tag_get_description
                                            (const gchar *tag);

Returns the human-readable description of this tag, You must not change or free this string.

gst_tag_get_flag ()

GstTagFlag  gst_tag_get_flag                (const gchar *tag);

Gets the flag of tag.

gst_tag_is_fixed ()

gboolean    gst_tag_is_fixed                (const gchar *tag);

Checks if the given tag is fixed. A fixed tag can only contain one value. Unfixed tags can contain lists of values.

gst_tag_list_new ()

GstTagList* gst_tag_list_new                (void);

Creates a new empty GstTagList.

gst_is_tag_list ()

gboolean    gst_is_tag_list                 (gconstpointer p);

Checks if the given pointer is a taglist.

gst_tag_list_copy ()

GstTagList* gst_tag_list_copy               (const GstTagList *list);

Copies a given GstTagList.

gst_tag_list_insert ()

void        gst_tag_list_insert             (GstTagList *into,
                                             const GstTagList *from,
                                             GstTagMergeMode mode);

Inserts the tags of the second list into the first list using the given mode.

gst_tag_list_merge ()

GstTagList* gst_tag_list_merge              (const GstTagList *list1,
                                             const GstTagList *list2,
                                             GstTagMergeMode mode);

Merges the two given lists into a new list. If one of the lists is NULL, a copy of the other is returned. If both lists are NULL, NULL is returned.

gst_tag_list_free ()

void        gst_tag_list_free               (GstTagList *list);

Frees the given list and all associated values.

gst_tag_list_get_tag_size ()

guint       gst_tag_list_get_tag_size       (const GstTagList *list,
                                             const gchar *tag);

Checks how many value are stored in this tag list for the given tag.

gst_tag_list_add ()

void        gst_tag_list_add                (GstTagList *list,
                                             GstTagMergeMode mode,
                                             const gchar *tag,
                                             ...);

Sets the values for the given tags using the specified mode.

gst_tag_list_add_values ()

void        gst_tag_list_add_values         (GstTagList *list,
                                             GstTagMergeMode mode,
                                             const gchar *tag,
                                             ...);

Sets the GValues for the given tags using the specified mode.

gst_tag_list_add_valist ()

void        gst_tag_list_add_valist         (GstTagList *list,
                                             GstTagMergeMode mode,
                                             const gchar *tag,
                                             va_list var_args);

Sets the values for the given tags using the specified mode.

gst_tag_list_add_valist_values ()

void        gst_tag_list_add_valist_values  (GstTagList *list,
                                             GstTagMergeMode mode,
                                             const gchar *tag,
                                             va_list var_args);

Sets the GValues for the given tags using the specified mode.

gst_tag_list_remove_tag ()

void        gst_tag_list_remove_tag         (GstTagList *list,
                                             const gchar *tag);

Removes the goven tag from the taglist.

gst_tag_list_foreach ()

void        gst_tag_list_foreach            (GstTagList *list,
                                             GstTagForeachFunc func,
                                             gpointer user_data);

Calls the given function for each tag inside the tag list. Note that if there is no tag, the function won't be called at all.

gst_tag_list_get_value_index ()

G_CONST_RETURN GValue* gst_tag_list_get_value_index
                                            (const GstTagList *list,
                                             const gchar *tag,
                                             guint index);

Gets the value that is at the given index for the given tag in the given list.

gst_tag_list_copy_value ()

gboolean    gst_tag_list_copy_value         (GValue *dest,
                                             const GstTagList *list,
                                             const gchar *tag);

Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag. You must g_value_unset() the value after use.

gst_tag_list_get_char ()

gboolean    gst_tag_list_get_char           (const GstTagList *list,
                                             const gchar *tag,
                                             gchar *value);

gst_tag_list_get_char_index ()

gboolean    gst_tag_list_get_char_index     (const GstTagList *list,
                                             const gchar *tag,
                                             guint index,
                                             gchar *value);

gst_tag_list_get_uchar ()

gboolean    gst_tag_list_get_uchar          (const GstTagList *list,
                                             const gchar *tag,
                                             guchar *value);

gst_tag_list_get_uchar_index ()

gboolean    gst_tag_list_get_uchar_index    (const GstTagList *list,
                                             const gchar *tag,
                                             guint index,
                                             guchar *value);

gst_tag_list_get_boolean ()

gboolean    gst_tag_list_get_boolean        (const GstTagList *list,
                                             const gchar *tag,
                                             gboolean *value);

gst_tag_list_get_boolean_index ()

gboolean    gst_tag_list_get_boolean_index  (const GstTagList *list,
                                             const gchar *tag,
                                             guint index,
                                             gboolean *value);

gst_tag_list_get_int ()

gboolean    gst_tag_list_get_int            (const GstTagList *list,
                                             const gchar *tag,
                                             gint *value);

gst_tag_list_get_int_index ()

gboolean    gst_tag_list_get_int_index      (const GstTagList *list,
                                             const gchar *tag,
                                             guint index,
                                             gint *value);

gst_tag_list_get_uint ()

gboolean    gst_tag_list_get_uint           (const GstTagList *list,
                                             const gchar *tag,
                                             guint *value);

gst_tag_list_get_uint_index ()

gboolean    gst_tag_list_get_uint_index     (const GstTagList *list,
                                             const gchar *tag,
                                             guint index,
                                             guint *value);

gst_tag_list_get_long ()

gboolean    gst_tag_list_get_long           (const GstTagList *list,
                                             const gchar *tag,
                                             glong *value);

gst_tag_list_get_long_index ()

gboolean    gst_tag_list_get_long_index     (const GstTagList *list,
                                             const gchar *tag,
                                             guint index,
                                             glong *value);

gst_tag_list_get_ulong ()

gboolean    gst_tag_list_get_ulong          (const GstTagList *list,
                                             const gchar *tag,
                                             gulong *value);

gst_tag_list_get_ulong_index ()

gboolean    gst_tag_list_get_ulong_index    (const GstTagList *list,
                                             const gchar *tag,
                                             guint index,
                                             gulong *value);

gst_tag_list_get_int64 ()

gboolean    gst_tag_list_get_int64          (const GstTagList *list,
                                             const gchar *tag,
                                             gint64 *value);

gst_tag_list_get_int64_index ()

gboolean    gst_tag_list_get_int64_index    (const GstTagList *list,
                                             const gchar *tag,
                                             guint index,
                                             gint64 *value);

gst_tag_list_get_uint64 ()

gboolean    gst_tag_list_get_uint64         (const GstTagList *list,
                                             const gchar *tag,
                                             guint64 *value);

gst_tag_list_get_uint64_index ()

gboolean    gst_tag_list_get_uint64_index   (const GstTagList *list,
                                             const gchar *tag,
                                             guint index,
                                             guint64 *value);

gst_tag_list_get_float ()

gboolean    gst_tag_list_get_float          (const GstTagList *list,
                                             const gchar *tag,
                                             gfloat *value);

gst_tag_list_get_float_index ()

gboolean    gst_tag_list_get_float_index    (const GstTagList *list,
                                             const gchar *tag,
                                             guint index,
                                             gfloat *value);

gst_tag_list_get_double ()

gboolean    gst_tag_list_get_double         (const GstTagList *list,
                                             const gchar *tag,
                                             gdouble *value);

gst_tag_list_get_double_index ()

gboolean    gst_tag_list_get_double_index   (const GstTagList *list,
                                             const gchar *tag,
                                             guint index,
                                             gdouble *value);

gst_tag_list_get_string ()

gboolean    gst_tag_list_get_string         (const GstTagList *list,
                                             const gchar *tag,
                                             gchar **value);

gst_tag_list_get_string_index ()

gboolean    gst_tag_list_get_string_index   (const GstTagList *list,
                                             const gchar *tag,
                                             guint index,
                                             gchar **value);

gst_tag_list_get_pointer ()

gboolean    gst_tag_list_get_pointer        (const GstTagList *list,
                                             const gchar *tag,
                                             gpointer *value);

gst_tag_list_get_pointer_index ()

gboolean    gst_tag_list_get_pointer_index  (const GstTagList *list,
                                             const gchar *tag,
                                             guint index,
                                             gpointer *value);

gst_event_new_tag ()

GstEvent*   gst_event_new_tag               (GstTagList *list);

Creates a new tag event with the given list and takes ownership of it.

gst_event_tag_get_list ()

GstTagList* gst_event_tag_get_list          (GstEvent *tag_event);

Gets the taglist from a given tagging event.

GST_TAG_TITLE

#define GST_TAG_TITLE			"title"

commonly used title

GST_TAG_ARTIST

#define GST_TAG_ARTIST			"artist"

person(s) responsible for the recording

GST_TAG_ALBUM

#define GST_TAG_ALBUM			"album"

album containing this data

GST_TAG_DATE

#define GST_TAG_DATE			"date"

date the data was created (in Julian calendar days)

GST_TAG_GENRE

#define GST_TAG_GENRE			"genre"

genre this data belongs to

GST_TAG_COMMENT

#define GST_TAG_COMMENT			"comment"

free text commenting the data

GST_TAG_TRACK_NUMBER

#define GST_TAG_TRACK_NUMBER		"track-number"

track number inside a collection

GST_TAG_TRACK_COUNT

#define GST_TAG_TRACK_COUNT		"track-count"

count of tracks inside collection this track belongs to

GST_TAG_ALBUM_VOLUME_NUMBER

#define GST_TAG_ALBUM_VOLUME_NUMBER	"album-disc-number"

disc number inside a collection

GST_TAG_ALBUM_VOLUME_COUNT

#define GST_TAG_ALBUM_VOLUME_COUNT	"album-disc-count"

count of discs inside collection this disc belongs to

GST_TAG_LOCATION

#define GST_TAG_LOCATION		"location"

original location of file as a URI

GST_TAG_DESCRIPTION

#define GST_TAG_DESCRIPTION		"description"

short text describing the content of the data

GST_TAG_VERSION

#define GST_TAG_VERSION			"version"

version of this data

GST_TAG_ISRC

#define GST_TAG_ISRC			"isrc"

International Standard Recording Code - see http://www.ifpi.org/isrc/

GST_TAG_ORGANIZATION

#define GST_TAG_ORGANIZATION		"organization"

organization

GST_TAG_COPYRIGHT

#define GST_TAG_COPYRIGHT		"copyright"

copyright notice of the data

GST_TAG_CONTACT

#define GST_TAG_CONTACT			"contact"

contact information

GST_TAG_LICENSE

#define GST_TAG_LICENSE			"license"

license of data

GST_TAG_PERFORMER

#define GST_TAG_PERFORMER		"performer"

person(s) performing

GST_TAG_DURATION

#define GST_TAG_DURATION		"duration"

length in GStreamer time units (nanoseconds)

GST_TAG_CODEC

#define GST_TAG_CODEC			"codec"

codec the data is stored in

GST_TAG_VIDEO_CODEC

#define GST_TAG_VIDEO_CODEC		"video-codec"

codec the video data is stored in

GST_TAG_AUDIO_CODEC

#define GST_TAG_AUDIO_CODEC		"audio-codec"

codec the audio data is stored in

GST_TAG_BITRATE

#define GST_TAG_BITRATE			"bitrate"

exact or average bitrate in bits/s

GST_TAG_NOMINAL_BITRATE

#define GST_TAG_NOMINAL_BITRATE		"nominal-bitrate"

nominal bitrate in bits/s

GST_TAG_MINIMUM_BITRATE

#define GST_TAG_MINIMUM_BITRATE		"minimum-bitrate"

minimum bitrate in bits/s

GST_TAG_MAXIMUM_BITRATE

#define GST_TAG_MAXIMUM_BITRATE		"maximum-bitrate"

maximum bitrate in bits/s

GST_TAG_SERIAL

#define GST_TAG_SERIAL			"serial"

serial number of track

GST_TAG_ENCODER

#define GST_TAG_ENCODER			"encoder"

encoder used to encode this stream

GST_TAG_ENCODER_VERSION

#define GST_TAG_ENCODER_VERSION		"encoder-version"

version of the encoder used to encode this stream

GST_TAG_TRACK_GAIN

#define GST_TAG_TRACK_GAIN		"replaygain-track-gain"

track gain in db

GST_TAG_TRACK_PEAK

#define GST_TAG_TRACK_PEAK		"replaygain-track-peak"

peak of the track

GST_TAG_ALBUM_GAIN

#define GST_TAG_ALBUM_GAIN  		"replaygain-album-gain"

album gain in db

GST_TAG_ALBUM_PEAK

#define GST_TAG_ALBUM_PEAK		"replaygain-album-peak"

peak of the album