## gsttagid3 gsttagid3 — tag mappings and support functions for plugins dealing with ID3v1 and ID3v2 tags |

## Synopsis

    #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);

## Description

Contains various utility functions for plugins to parse or create ID3 tags and map ID3v2 identifiers to and from GStreamer identifiers.

## Details

### gst_tag_id3_genre_count ()

    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

### gst_tag_id3_genre_get ()

    const gchar *       gst_tag_id3_genre_get               (const guint id);

Gets the ID3v1 genre name for a given ID.

`id` : | ID of genre to query
Returns : | the genre or NULL if no genre is associated with that ID.

### gst_tag_list_new_from_id3v1 ()

    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.

`data` : | 128 bytes of data containing the ID3v1 tag
Returns : | A new tag list or NULL if the data was not an ID3v1 tag.

### gst_tag_from_id3_tag ()

    const gchar *       gst_tag_from_id3_tag                (const gchar *id3_tag);

Looks up the GStreamer tag for a ID3v2 tag.

`id3_tag` : | ID3v2 tag to convert to GStreamer tag
Returns : | The corresponding GStreamer tag or NULL if none exists.

### gst_tag_from_id3_user_tag ()

    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).

`type` : | the type of ID3v2 user tag (e.g. "TXXX" or "UDIF")
`id3_user_tag` : | ID3v2 user tag to convert to GStreamer tag
Returns : | The corresponding GStreamer tag or NULL if none exists.

### gst_tag_to_id3_tag ()

    const gchar *       gst_tag_to_id3_tag                  (const gchar *gst_tag);

Looks up the ID3v2 tag for a GStreamer tag.

`gst_tag` : | GStreamer tag to convert to vorbiscomment tag
Returns : | The corresponding ID3v2 tag or NULL if none exists.

## See Also

#GstTagList