|  |  |  | GStreamer Base Plugins 0.10 Library Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | ||||
| gsttagid3gsttagid3 — tag mappings and support functions for plugins dealing with ID3v1 and ID3v2 tags | 
#include <gst/tag/tag.h> guint gst_tag_id3_genre_count (void); const gchar * gst_tag_id3_genre_get (const guint id); GstTagList * gst_tag_list_new_from_id3v1 (const guint8 *data); const gchar * gst_tag_from_id3_tag (const gchar *id3_tag); const gchar * gst_tag_from_id3_user_tag (const gchar *type,const gchar *id3_user_tag); const gchar * gst_tag_to_id3_tag (const gchar *gst_tag); gboolean gst_tag_list_add_id3_image (GstTagList *tag_list,const guint8 *image_data,guint image_data_len,guint id3_picture_type);
guint               gst_tag_id3_genre_count             (void);
Gets the number of ID3v1 genres that can be identified. Winamp genres are included.
| Returns : | the number of ID3v1 genres that can be identified | 
const gchar *       gst_tag_id3_genre_get               (const guint id);
Gets the ID3v1 genre name for a given ID.
| 
 | ID of genre to query | 
| Returns : | the genre or NULL if no genre is associated with that ID. | 
GstTagList *        gst_tag_list_new_from_id3v1         (const guint8 *data);
Parses the data containing an ID3v1 tag and returns a GstTagList from the parsed data.
| 
 | 128 bytes of data containing the ID3v1 tag | 
| Returns : | A new tag list or NULL if the data was not an ID3v1 tag. | 
const gchar *       gst_tag_from_id3_tag                (const gchar *id3_tag);
Looks up the GStreamer tag for a ID3v2 tag.
| 
 | ID3v2 tag to convert to GStreamer tag | 
| Returns : | The corresponding GStreamer tag or NULL if none exists. | 
const gchar * gst_tag_from_id3_user_tag (const gchar *type,const gchar *id3_user_tag);
Looks up the GStreamer tag for an ID3v2 user tag (e.g. description in TXXX frame or owner in UFID frame).
| 
 | the type of ID3v2 user tag (e.g. "TXXX" or "UDIF") | 
| 
 | ID3v2 user tag to convert to GStreamer tag | 
| Returns : | The corresponding GStreamer tag or NULL if none exists. | 
const gchar *       gst_tag_to_id3_tag                  (const gchar *gst_tag);
Looks up the ID3v2 tag for a GStreamer tag.
| 
 | GStreamer tag to convert to vorbiscomment tag | 
| Returns : | The corresponding ID3v2 tag or NULL if none exists. | 
gboolean gst_tag_list_add_id3_image (GstTagList *tag_list,const guint8 *image_data,guint image_data_len,guint id3_picture_type);
Adds an image from an ID3 APIC frame (or similar, such as used in FLAC)
to the given tag list. Also see gst_tag_image_data_to_image_buffer() for
more information on image tags in GStreamer.
| 
 | a tag list | 
| 
 | the (encoded) image | 
| 
 | the length of the encoded image data at image_data | 
| 
 | picture type as per the ID3 (v2.4.0) specification for the APIC frame (0 = unknown/other) | 
| Returns : | TRUEif the image was processed, otherwiseFALSE | 
Since 0.10.20