![]() |
![]() |
![]() |
GStreamer Base Plugins 0.10 Library Reference Manual | ![]() |
---|---|---|---|---|
Top | Description |
gsttagvorbisgsttagvorbis — tag mappings and support functions for plugins dealing with vorbiscomments |
#include <gst/tag/tag.h> const gchar * gst_tag_from_vorbis_tag (const gchar *vorbis_tag
); const gchar * gst_tag_to_vorbis_tag (const gchar *gst_tag
); void gst_vorbis_tag_add (GstTagList *list
,const gchar *tag
,const gchar *value
); GList * gst_tag_to_vorbis_comments (const GstTagList *list
,const gchar *tag
); GstTagList * gst_tag_list_from_vorbiscomment_buffer (const GstBuffer *buffer
,const guint8 *id_data
,const guint id_data_length
,gchar **vendor_string
); GstBuffer * gst_tag_list_to_vorbiscomment_buffer (const GstTagList *list
,const guint8 *id_data
,const guint id_data_length
,const gchar *vendor_string
);
Contains various utility functions for plugins to parse or create vorbiscomments and map them to and from GstTagLists.
const gchar * gst_tag_from_vorbis_tag (const gchar *vorbis_tag
);
Looks up the GStreamer tag for a vorbiscomment tag.
|
vorbiscomment tag to convert to GStreamer tag |
Returns : |
The corresponding GStreamer tag or NULL if none exists. |
const gchar * gst_tag_to_vorbis_tag (const gchar *gst_tag
);
Looks up the vorbiscomment tag for a GStreamer tag.
|
GStreamer tag to convert to vorbiscomment tag |
Returns : |
The corresponding vorbiscomment tag or NULL if none exists. |
void gst_vorbis_tag_add (GstTagList *list
,const gchar *tag
,const gchar *value
);
Convenience function using gst_tag_from_vorbis_tag()
, parsing
a vorbis comment string into the right type and adding it to the
given taglist list
.
Unknown vorbiscomment tags will be added to the tag list in form of a GST_TAG_EXTENDED_COMMENT (since 0.10.10 at least).
|
a GstTagList |
|
a vorbiscomment tag string (key in key=value), must be valid UTF-8 |
|
a vorbiscomment value string (value in key=value), must be valid UTF-8 |
GList * gst_tag_to_vorbis_comments (const GstTagList *list
,const gchar *tag
);
Creates a new tag list that contains the information parsed out of a vorbiscomment packet.
|
a GstTagList |
|
a GStreamer tag identifier, such as GST_TAG_ARTIST |
Returns : |
A GList of newly-allowcated key=value strings. Free with g_list_foreach (list, (GFunc) g_free, NULL) plus g_list_free (list) |
GstTagList * gst_tag_list_from_vorbiscomment_buffer (const GstBuffer *buffer
,const guint8 *id_data
,const guint id_data_length
,gchar **vendor_string
);
Creates a new tag list that contains the information parsed out of a vorbiscomment packet.
|
buffer to convert |
|
identification data at start of stream |
|
length of identification data |
|
pointer to a string that should take the vendor string of this vorbis comment or NULL if you don't need it. |
Returns : |
A new GstTagList with all tags that could be extracted from the given vorbiscomment buffer or NULL on error. |
GstBuffer * gst_tag_list_to_vorbiscomment_buffer (const GstTagList *list
,const guint8 *id_data
,const guint id_data_length
,const gchar *vendor_string
);
Creates a new vorbiscomment buffer from a tag list.
|
tag list to convert |
|
identification data at start of stream |
|
length of identification data, may be 0 if id_data is NULL |
|
string that describes the vendor string or NULL |
Returns : |
A new GstBuffer containing a vorbiscomment buffer with all tags that could be converted from the given tag list. |