![]() |
![]() |
![]() |
GStreamer 0.10 Core Reference Manual | ![]() |
---|
GstTagListGstTagList — List of tags and values used to describe media metadata |
#include <gst/gst.h> typedef GstTagList; enum GstTagMergeMode; enum GstTagFlag; void (*GstTagForeachFunc) (const GstTagList *list, const gchar *tag, gpointer user_data); void (*GstTagMergeFunc) (GValue *dest, const GValue *src); #define GST_TAG_TITLE #define GST_TAG_ARTIST #define GST_TAG_ALBUM #define GST_TAG_DATE #define GST_TAG_GENRE #define GST_TAG_COMMENT #define GST_TAG_TRACK_NUMBER #define GST_TAG_TRACK_COUNT #define GST_TAG_ALBUM_VOLUME_NUMBER #define GST_TAG_ALBUM_VOLUME_COUNT #define GST_TAG_LOCATION #define GST_TAG_DESCRIPTION #define GST_TAG_VERSION #define GST_TAG_ISRC #define GST_TAG_ORGANIZATION #define GST_TAG_COPYRIGHT #define GST_TAG_CONTACT #define GST_TAG_LICENSE #define GST_TAG_PERFORMER #define GST_TAG_DURATION #define GST_TAG_CODEC #define GST_TAG_VIDEO_CODEC #define GST_TAG_AUDIO_CODEC #define GST_TAG_BITRATE #define GST_TAG_NOMINAL_BITRATE #define GST_TAG_MINIMUM_BITRATE #define GST_TAG_MAXIMUM_BITRATE #define GST_TAG_SERIAL #define GST_TAG_ENCODER #define GST_TAG_ENCODER_VERSION #define GST_TAG_TRACK_GAIN #define GST_TAG_TRACK_PEAK #define GST_TAG_ALBUM_GAIN #define GST_TAG_ALBUM_PEAK #define GST_TAG_LANGUAGE_CODE void gst_tag_register (const gchar *name, GstTagFlag flag, GType type, const gchar *nick, const gchar *blurb, GstTagMergeFunc func); void gst_tag_merge_use_first (GValue *dest, const GValue *src); void gst_tag_merge_strings_with_comma (GValue *dest, const GValue *src); gboolean gst_tag_exists (const gchar *tag); GType gst_tag_get_type (const gchar *tag); const gchar* gst_tag_get_nick (const gchar *tag); const gchar* gst_tag_get_description (const gchar *tag); GstTagFlag gst_tag_get_flag (const gchar *tag); gboolean gst_tag_is_fixed (const gchar *tag); GstTagList* gst_tag_list_new (void); gboolean gst_is_tag_list (gconstpointer p); GstTagList* gst_tag_list_copy (const GstTagList *list); void gst_tag_list_insert (GstTagList *into, const GstTagList *from, GstTagMergeMode mode); GstTagList* gst_tag_list_merge (const GstTagList *list1, const GstTagList *list2, GstTagMergeMode mode); void gst_tag_list_free (GstTagList *list); guint gst_tag_list_get_tag_size (const GstTagList *list, const gchar *tag); void gst_tag_list_add (GstTagList *list, GstTagMergeMode mode, const gchar *tag, ...); void gst_tag_list_add_values (GstTagList *list, GstTagMergeMode mode, const gchar *tag, ...); void gst_tag_list_add_valist (GstTagList *list, GstTagMergeMode mode, const gchar *tag, va_list var_args); void gst_tag_list_add_valist_values (GstTagList *list, GstTagMergeMode mode, const gchar *tag, va_list var_args); void gst_tag_list_remove_tag (GstTagList *list, const gchar *tag); void gst_tag_list_foreach (const GstTagList *list, GstTagForeachFunc func, gpointer user_data); const GValue* gst_tag_list_get_value_index (const GstTagList *list, const gchar *tag, guint index); gboolean gst_tag_list_copy_value (GValue *dest, const GstTagList *list, const gchar *tag); gboolean gst_tag_list_get_char (const GstTagList *list, const gchar *tag, gchar *value); gboolean gst_tag_list_get_char_index (const GstTagList *list, const gchar *tag, guint index, gchar *value); gboolean gst_tag_list_get_uchar (const GstTagList *list, const gchar *tag, guchar *value); gboolean gst_tag_list_get_uchar_index (const GstTagList *list, const gchar *tag, guint index, guchar *value); gboolean gst_tag_list_get_boolean (const GstTagList *list, const gchar *tag, gboolean *value); gboolean gst_tag_list_get_boolean_index (const GstTagList *list, const gchar *tag, guint index, gboolean *value); gboolean gst_tag_list_get_int (const GstTagList *list, const gchar *tag, gint *value); gboolean gst_tag_list_get_int_index (const GstTagList *list, const gchar *tag, guint index, gint *value); gboolean gst_tag_list_get_uint (const GstTagList *list, const gchar *tag, guint *value); gboolean gst_tag_list_get_uint_index (const GstTagList *list, const gchar *tag, guint index, guint *value); gboolean gst_tag_list_get_long (const GstTagList *list, const gchar *tag, glong *value); gboolean gst_tag_list_get_long_index (const GstTagList *list, const gchar *tag, guint index, glong *value); gboolean gst_tag_list_get_ulong (const GstTagList *list, const gchar *tag, gulong *value); gboolean gst_tag_list_get_ulong_index (const GstTagList *list, const gchar *tag, guint index, gulong *value); gboolean gst_tag_list_get_int64 (const GstTagList *list, const gchar *tag, gint64 *value); gboolean gst_tag_list_get_int64_index (const GstTagList *list, const gchar *tag, guint index, gint64 *value); gboolean gst_tag_list_get_uint64 (const GstTagList *list, const gchar *tag, guint64 *value); gboolean gst_tag_list_get_uint64_index (const GstTagList *list, const gchar *tag, guint index, guint64 *value); gboolean gst_tag_list_get_float (const GstTagList *list, const gchar *tag, gfloat *value); gboolean gst_tag_list_get_float_index (const GstTagList *list, const gchar *tag, guint index, gfloat *value); gboolean gst_tag_list_get_double (const GstTagList *list, const gchar *tag, gdouble *value); gboolean gst_tag_list_get_double_index (const GstTagList *list, const gchar *tag, guint index, gdouble *value); gboolean gst_tag_list_get_string (const GstTagList *list, const gchar *tag, gchar **value); gboolean gst_tag_list_get_string_index (const GstTagList *list, const gchar *tag, guint index, gchar **value); gboolean gst_tag_list_get_pointer (const GstTagList *list, const gchar *tag, gpointer *value); gboolean gst_tag_list_get_pointer_index (const GstTagList *list, const gchar *tag, guint index, gpointer *value); gboolean gst_tag_list_get_date (const GstTagList *list, const gchar *tag, GDate **value); gboolean gst_tag_list_get_date_index (const GstTagList *list, const gchar *tag, guint index, GDate **value);
List of tags and values used to describe media metadata.
Last reviewed on 2005-11-23 (0.9.5)
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;
The different tag merging modes.
GST_TAG_MERGE_UNDEFINED |
undefined merge mode |
GST_TAG_MERGE_REPLACE_ALL |
replace all tags |
GST_TAG_MERGE_REPLACE |
replace tags |
GST_TAG_MERGE_APPEND |
append tags |
GST_TAG_MERGE_PREPEND |
prepend tags |
GST_TAG_MERGE_KEEP |
keep existing tags |
GST_TAG_MERGE_KEEP_ALL |
keep all existing tags |
GST_TAG_MERGE_COUNT |
the number of merge modes |
typedef enum { GST_TAG_FLAG_UNDEFINED, GST_TAG_FLAG_META, GST_TAG_FLAG_ENCODED, GST_TAG_FLAG_DECODED, GST_TAG_FLAG_COUNT } GstTagFlag;
Extra tag flags used when registering tags.
GST_TAG_FLAG_UNDEFINED |
undefined flag |
GST_TAG_FLAG_META |
tag is meta data |
GST_TAG_FLAG_ENCODED |
tag is encoded |
GST_TAG_FLAG_DECODED |
tag is decoded |
GST_TAG_FLAG_COUNT |
number of tag flags |
void (*GstTagForeachFunc) (const GstTagList *list, const gchar *tag, gpointer user_data);
A function that will be called in gst_tag_list_foreach()
. The function may
not modify the tag list.
list : |
the GstTagList |
tag : |
a name of a tag in list
|
user_data : |
user data |
void (*GstTagMergeFunc) (GValue *dest, const GValue *src);
A function for merging multiple values of a tag used when registering tags.
dest : |
the destination GValue |
src : |
the source GValue |
#define GST_TAG_TRACK_COUNT "track-count"
count of tracks inside collection this track belongs to
#define GST_TAG_ALBUM_VOLUME_NUMBER "album-disc-number"
disc number inside a collection
#define GST_TAG_ALBUM_VOLUME_COUNT "album-disc-count"
count of discs inside collection this disc belongs to
#define GST_TAG_DESCRIPTION "description"
short text describing the content of the data
#define GST_TAG_ISRC "isrc"
International Standard Recording Code - see http://www.ifpi.org/isrc/
#define GST_TAG_ENCODER_VERSION "encoder-version"
version of the encoder used to encode this stream
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.
name : |
the name or identifier string |
flag : |
a flag describing the type of tag info |
type : |
the type this data is in |
nick : |
human-readable name |
blurb : |
a human-readable description about this tag |
func : |
function for merging multiple values of this tag |
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.
dest : |
uninitialized GValue to store result in |
src : |
GValue to copy from |
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.
dest : |
uninitialized GValue to store result in |
src : |
GValue to copy from |
gboolean gst_tag_exists (const gchar *tag);
Checks if the given type is already registered.
tag : |
name of the tag |
Returns : | TRUE if the type is already registered |
GType gst_tag_get_type (const gchar *tag);
Gets the GType used for this tag.
tag : |
the tag |
Returns : | the GType of this tag |
const gchar* gst_tag_get_nick (const gchar *tag);
Returns the human-readable name of this tag, You must not change or free this string.
tag : |
the tag |
Returns : | the human-readable name of this tag |
const gchar* gst_tag_get_description (const gchar *tag);
Returns the human-readable description of this tag, You must not change or free this string.
tag : |
the tag |
Returns : | the human-readable description of this tag |
GstTagFlag gst_tag_get_flag (const gchar *tag);
Gets the flag of tag
.
tag : |
the tag |
Returns : | the flag of this tag. |
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.
tag : |
tag to check |
Returns : | TRUE, if the given tag is fixed. |
GstTagList* gst_tag_list_new (void);
Creates a new empty GstTagList.
Returns : | An empty tag list |
gboolean gst_is_tag_list (gconstpointer p);
Checks if the given pointer is a taglist.
p : |
Object that might be a taglist |
Returns : | TRUE, if the given pointer is a taglist |
GstTagList* gst_tag_list_copy (const GstTagList *list);
Copies a given GstTagList.
list : |
list to copy |
Returns : | copy of the given list |
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.
into : |
list to merge into |
from : |
list to merge from |
mode : |
the mode to use |
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.
list1 : |
first list to merge |
list2 : |
second list to merge |
mode : |
the mode to use |
Returns : | the new list |
void gst_tag_list_free (GstTagList *list);
Frees the given list and all associated values.
list : |
the list to free |
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.
list : |
a taglist |
tag : |
the tag to query |
Returns : | The number of tags stored |
void gst_tag_list_add (GstTagList *list, GstTagMergeMode mode, const gchar *tag, ...);
Sets the values for the given tags using the specified mode.
list : |
list to set tags in |
mode : |
the mode to use |
tag : |
tag |
... : |
NULL-terminated list of values to set |
void gst_tag_list_add_values (GstTagList *list, GstTagMergeMode mode, const gchar *tag, ...);
Sets the GValues for the given tags using the specified mode.
list : |
list to set tags in |
mode : |
the mode to use |
tag : |
tag |
... : |
GValues to set |
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.
list : |
list to set tags in |
mode : |
the mode to use |
tag : |
tag |
var_args : |
tag / value pairs to set |
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.
list : |
list to set tags in |
mode : |
the mode to use |
tag : |
tag |
var_args : |
tag / GValue pairs to set |
void gst_tag_list_remove_tag (GstTagList *list, const gchar *tag);
Removes the goven tag from the taglist.
list : |
list to remove tag from |
tag : |
tag to remove |
void gst_tag_list_foreach (const 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.
list : |
list to iterate over |
func : |
function to be called for each tag |
user_data : |
user specified data |
const 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.
list : |
a GStTagList |
tag : |
tag to read out |
index : |
number of entry to read out |
Returns : | The GValue for the specified entry or NULL if the tag wasn't available or the tag doesn't have as many entries |
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.
dest : |
uninitialized GValue to copy into |
list : |
list to get the tag from |
tag : |
tag to read out |
Returns : | TRUE, if a value was copied, FALSE if the tag didn't exist in the given list. |
gboolean gst_tag_list_get_char (const GstTagList *list, const gchar *tag, gchar *value);
Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag.
list : |
a GStTagList to get the tag from |
tag : |
tag to read out |
value : |
location for the result |
Returns : | TRUE, if a value was copied, FALSE if the tag didn't exist in the given list. |
gboolean gst_tag_list_get_char_index (const GstTagList *list, const gchar *tag, guint index, gchar *value);
Gets the value that is at the given index for the given tag in the given list.
list : |
a GStTagList to get the tag from |
tag : |
tag to read out |
index : |
number of entry to read out |
value : |
location for the result |
Returns : | TRUE, if a value was copied, FALSE if the tag didn't exist in the given list. |
gboolean gst_tag_list_get_uchar (const GstTagList *list, const gchar *tag, guchar *value);
Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag.
list : |
a GStTagList to get the tag from |
tag : |
tag to read out |
value : |
location for the result |
Returns : | TRUE, if a value was copied, FALSE if the tag didn't exist in the given list. |
gboolean gst_tag_list_get_uchar_index (const GstTagList *list, const gchar *tag, guint index, guchar *value);
Gets the value that is at the given index for the given tag in the given list.
list : |
a GStTagList to get the tag from |
tag : |
tag to read out |
index : |
number of entry to read out |
value : |
location for the result |
Returns : | TRUE, if a value was copied, FALSE if the tag didn't exist in the given list. |
gboolean gst_tag_list_get_boolean (const GstTagList *list, const gchar *tag, gboolean *value);
Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag.
list : |
a GStTagList to get the tag from |
tag : |
tag to read out |
value : |
location for the result |
Returns : | TRUE, if a value was copied, FALSE if the tag didn't exist in the given list. |
gboolean gst_tag_list_get_boolean_index (const GstTagList *list, const gchar *tag, guint index, gboolean *value);
Gets the value that is at the given index for the given tag in the given list.
list : |
a GStTagList to get the tag from |
tag : |
tag to read out |
index : |
number of entry to read out |
value : |
location for the result |
Returns : | TRUE, if a value was copied, FALSE if the tag didn't exist in the given list. |
gboolean gst_tag_list_get_int (const GstTagList *list, const gchar *tag, gint *value);
Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag.
list : |
a GStTagList to get the tag from |
tag : |
tag to read out |
value : |
location for the result |
Returns : | TRUE, if a value was copied, FALSE if the tag didn't exist in the given list. |
gboolean gst_tag_list_get_int_index (const GstTagList *list, const gchar *tag, guint index, gint *value);
Gets the value that is at the given index for the given tag in the given list.
list : |
a GStTagList to get the tag from |
tag : |
tag to read out |
index : |
number of entry to read out |
value : |
location for the result |
Returns : | TRUE, if a value was copied, FALSE if the tag didn't exist in the given list. |
gboolean gst_tag_list_get_uint (const GstTagList *list, const gchar *tag, guint *value);
Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag.
list : |
a GStTagList to get the tag from |
tag : |
tag to read out |
value : |
location for the result |
Returns : | TRUE, if a value was copied, FALSE if the tag didn't exist in the given list. |
gboolean gst_tag_list_get_uint_index (const GstTagList *list, const gchar *tag, guint index, guint *value);
Gets the value that is at the given index for the given tag in the given list.
list : |
a GStTagList to get the tag from |
tag : |
tag to read out |
index : |
number of entry to read out |
value : |
location for the result |
Returns : | TRUE, if a value was copied, FALSE if the tag didn't exist in the given list. |
gboolean gst_tag_list_get_long (const GstTagList *list, const gchar *tag, glong *value);
Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag.
list : |
a GStTagList to get the tag from |
tag : |
tag to read out |
value : |
location for the result |
Returns : | TRUE, if a value was copied, FALSE if the tag didn't exist in the given list. |
gboolean gst_tag_list_get_long_index (const GstTagList *list, const gchar *tag, guint index, glong *value);
Gets the value that is at the given index for the given tag in the given list.
list : |
a GStTagList to get the tag from |
tag : |
tag to read out |
index : |
number of entry to read out |
value : |
location for the result |
Returns : | TRUE, if a value was copied, FALSE if the tag didn't exist in the given list. |
gboolean gst_tag_list_get_ulong (const GstTagList *list, const gchar *tag, gulong *value);
Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag.
list : |
a GStTagList to get the tag from |
tag : |
tag to read out |
value : |
location for the result |
Returns : | TRUE, if a value was copied, FALSE if the tag didn't exist in the given list. |
gboolean gst_tag_list_get_ulong_index (const GstTagList *list, const gchar *tag, guint index, gulong *value);
Gets the value that is at the given index for the given tag in the given list.
list : |
a GStTagList to get the tag from |
tag : |
tag to read out |
index : |
number of entry to read out |
value : |
location for the result |
Returns : | TRUE, if a value was copied, FALSE if the tag didn't exist in the given list. |
gboolean gst_tag_list_get_int64 (const GstTagList *list, const gchar *tag, gint64 *value);
Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag.
list : |
a GStTagList to get the tag from |
tag : |
tag to read out |
value : |
location for the result |
Returns : | TRUE, if a value was copied, FALSE if the tag didn't exist in the given list. |
gboolean gst_tag_list_get_int64_index (const GstTagList *list, const gchar *tag, guint index, gint64 *value);
Gets the value that is at the given index for the given tag in the given list.
list : |
a GStTagList to get the tag from |
tag : |
tag to read out |
index : |
number of entry to read out |
value : |
location for the result |
Returns : | TRUE, if a value was copied, FALSE if the tag didn't exist in the given list. |
gboolean gst_tag_list_get_uint64 (const GstTagList *list, const gchar *tag, guint64 *value);
Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag.
list : |
a GStTagList to get the tag from |
tag : |
tag to read out |
value : |
location for the result |
Returns : | TRUE, if a value was copied, FALSE if the tag didn't exist in the given list. |
gboolean gst_tag_list_get_uint64_index (const GstTagList *list, const gchar *tag, guint index, guint64 *value);
Gets the value that is at the given index for the given tag in the given list.
list : |
a GStTagList to get the tag from |
tag : |
tag to read out |
index : |
number of entry to read out |
value : |
location for the result |
Returns : | TRUE, if a value was copied, FALSE if the tag didn't exist in the given list. |
gboolean gst_tag_list_get_float (const GstTagList *list, const gchar *tag, gfloat *value);
Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag.
list : |
a GStTagList to get the tag from |
tag : |
tag to read out |
value : |
location for the result |
Returns : | TRUE, if a value was copied, FALSE if the tag didn't exist in the given list. |
gboolean gst_tag_list_get_float_index (const GstTagList *list, const gchar *tag, guint index, gfloat *value);
Gets the value that is at the given index for the given tag in the given list.
list : |
a GStTagList to get the tag from |
tag : |
tag to read out |
index : |
number of entry to read out |
value : |
location for the result |
Returns : | TRUE, if a value was copied, FALSE if the tag didn't exist in the given list. |
gboolean gst_tag_list_get_double (const GstTagList *list, const gchar *tag, gdouble *value);
Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag.
list : |
a GStTagList to get the tag from |
tag : |
tag to read out |
value : |
location for the result |
Returns : | TRUE, if a value was copied, FALSE if the tag didn't exist in the given list. |
gboolean gst_tag_list_get_double_index (const GstTagList *list, const gchar *tag, guint index, gdouble *value);
Gets the value that is at the given index for the given tag in the given list.
list : |
a GStTagList to get the tag from |
tag : |
tag to read out |
index : |
number of entry to read out |
value : |
location for the result |
Returns : | TRUE, if a value was copied, FALSE if the tag didn't exist in the given list. |
gboolean gst_tag_list_get_string (const GstTagList *list, const gchar *tag, gchar **value);
Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag.
list : |
a GStTagList to get the tag from |
tag : |
tag to read out |
value : |
location for the result |
Returns : | TRUE, if a value was copied, FALSE if the tag didn't exist in the given list. |
gboolean gst_tag_list_get_string_index (const GstTagList *list, const gchar *tag, guint index, gchar **value);
Gets the value that is at the given index for the given tag in the given list.
list : |
a GStTagList to get the tag from |
tag : |
tag to read out |
index : |
number of entry to read out |
value : |
location for the result |
Returns : | TRUE, if a value was copied, FALSE if the tag didn't exist in the given list. |
gboolean gst_tag_list_get_pointer (const GstTagList *list, const gchar *tag, gpointer *value);
Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag.
list : |
a GStTagList to get the tag from |
tag : |
tag to read out |
value : |
location for the result |
Returns : | TRUE, if a value was copied, FALSE if the tag didn't exist in the given list. |
gboolean gst_tag_list_get_pointer_index (const GstTagList *list, const gchar *tag, guint index, gpointer *value);
Gets the value that is at the given index for the given tag in the given list.
list : |
a GStTagList to get the tag from |
tag : |
tag to read out |
index : |
number of entry to read out |
value : |
location for the result |
Returns : | TRUE, if a value was copied, FALSE if the tag didn't exist in the given list. |
gboolean gst_tag_list_get_date (const GstTagList *list, const gchar *tag, GDate **value);
Copies the contents for the given tag into the value, merging multiple values into one if multiple values are associated with the tag.
list : |
a GStTagList to get the tag from |
tag : |
tag to read out |
value : |
location for the result |
Returns : | TRUE, if a value was copied, FALSE if the tag didn't exist in the given list or if it was NULL. |
gboolean gst_tag_list_get_date_index (const GstTagList *list, const gchar *tag, guint index, GDate **value);
Gets the value that is at the given index for the given tag in the given list.
list : |
a GStTagList to get the tag from |
tag : |
tag to read out |
index : |
number of entry to read out |
value : |
location for the result |
Returns : | TRUE, if a value was copied, FALSE if the tag didn't exist in the given list or if it was NULL. |
<< GstSystemClock | GstTagSetter >> |