Convenience function to read a string with unknown character encoding. If the string is already in UTF-8 encoding, it will be returned right away. If not it tries to detect byte-order-mark for UTF-16/32 cases and use that. Otherwise, the environment will be searched for a number of environment variables (whose names are specified in the NULL-terminated string array are specified, the current locale will be tried. If that also doesn't work, ISO-8859-1 is assumed (which will almost always succeed).

Parameters:

String data Required (not null)

Number size Required (not null)

Array env_vars Required (not null)

or NULL

Returns:

String

Looks up the GStreamer tag for a ID3v2 tag.

Parameters:

String id3_tag Required (not null)

Returns:

String

Looks up the GStreamer tag for an ID3v2 user tag (e.g. description in TXXX frame or owner in UFID frame).

Parameters:

String type Required (not null)

String id3_user_tag Required (not null)

Returns:

String

Looks up the GStreamer tag for a vorbiscomment tag.

Parameters:

String vorbis_tag Required (not null)

Returns:

String

Returns two-letter ISO-639-1 language code given a three-letter ISO-639-2 language code or two-letter ISO-639-1 language code (both are accepted for convenience). Language codes are case-sensitive and expected to be lower case.

Parameters:

String lang_code Required (not null)

Returns:

String or NULL if no mapping is known. The returned string must not be modified or freed.

Returns three-letter ISO-639-2 "bibliographic" language code given a two-letter ISO-639-1 language code or a three-letter ISO-639-2 language code (both are accepted for convenience). The "bibliographic" code is derived from the English name of the language (e.g. "ger" for German instead of "de" or "deu"). In most scenarios, the "terminological" codes are prefered. Language codes are case-sensitive and expected to be lower case.

Parameters:

String lang_code Required (not null)

Returns:

String or NULL if no mapping is known. The returned string must not be modified or freed.

Returns three-letter ISO-639-2 "terminological" language code given a two-letter ISO-639-1 language code or a three-letter ISO-639-2 language code (both are accepted for convenience). The "terminological" code is derived from the local name of the language (e.g. "deu" for German instead of "ger"). In most scenarios, the "terminological" codes are prefered over the "bibliographic" ones. Language codes are case-sensitive and expected to be lower case.

Parameters:

String lang_code Required (not null)

Returns:

String or NULL if no mapping is known. The returned string must not be modified or freed.

Returns a list of known language codes (in form of two-letter ISO-639-1 codes). This is useful for UIs to build a list of available languages for tagging purposes (e.g. to tag an audio track appropriately in a video or audio editor).

Returns:

Array with g_strfreev() when no longer needed.

Returns the name of the language given an ISO-639 language code, such as often found in a GST_TAG_LANGUAGE tag. The name will be translated according to the current locale (if the library was built against the iso-codes package, otherwise the English name will be returned). Language codes are case-sensitive and expected to be lower case.

Parameters:

String language_code Required (not null)

Returns:

String not be mapped to a language name. The returned string must not be modified and does not need to freed; it will stay valid until the application is terminated.

Gets the number of ID3v1 genres that can be identified. Winamp genres are included.

Returns:

Number

Gets the ID3v1 genre name for a given ID.

Parameters:

Number id Required (not null)

Returns:

String

Helper function for tag-reading plugins to create a GstBuffer suitable to add to a GstTagList as an image tag (such as GST_TAG_IMAGE or GST_TAG_PREVIEW_IMAGE) from the encoded image data and an (optional) image type. blob of binary image data, often accompanied by a MIME type or some other content type string (e.g. 'png', 'jpeg', 'jpg'). Sometimes there is also an 'image type' to indicate what kind of image this is (e.g. front cover, back cover, artist, etc.). The image data may also be an URI to the image rather than the image itself. In GStreamer, image tags are GstBuffers containing the raw image data, with the buffer caps describing the content type of the image (e.g. image/jpeg, image/png, text/uri-list). The buffer caps may contain an additional 'image-type' field of GST_TYPE_TAG_IMAGE_TYPE to describe the type of image (front cover, back cover etc.). GST_TAG_PREVIEW_IMAGE tags should not carry an image type, their type is already indicated via the special tag name. This function will do various checks and typefind the encoded image data (we can't trust the declared mime type).

Parameters:

String image_data Required (not null)

image

Number image_data_len Required (not null)

GstTag.TagImageType image_type Required (not null)

GST_TAG_IMAGE_TYPE_NONE if no image type should be set at all (e.g. for preview images)

Returns:

Gst.Buffer

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.

Parameters:

Gst.TagList tag_list Required (not null)

String image_data Required (not null)

image

Number image_data_len Required (not null)

Number id3_picture_type Required (not null)

specification for the APIC frame (0 = unknown/other)

Returns:

Boolean

Creates a new tag list that contains the information parsed out of a vorbiscomment packet.

Parameters:

Gst.Buffer buffer Required (not null)

String id_data Required (not null)

Number id_data_length Required (not null)

Array vendor_string Required (not null)

of this vorbis comment or NULL if you don't need it.

Returns:

Gst.TagList given vorbiscomment buffer or NULL on error.

Parse a xmp packet into a taglist.

Parameters:

Gst.Buffer buffer Required (not null)

Returns:

Gst.TagList

Parses the data containing an ID3v1 tag and returns a GstTagList from the parsed data.

Parameters:

String data Required (not null)

Returns:

Gst.TagList

Creates a new vorbiscomment buffer from a tag list.

Parameters:

Gst.TagList list Required (not null)

String id_data Required (not null)

Number id_data_length Required (not null)

String vendor_string Required (not null)

Returns:

Gst.Buffer that could be converted from the given tag list.

Formats a taglist as a xmp packet.

Parameters:

Gst.TagList list Required (not null)

Boolean read_only Required (not null)

Returns:

Gst.Buffer

Convenience function to parse a GST_TAG_EXTENDED_COMMENT string and separate it into its components. If successful, key, lang and/or value will be set to newly allocated strings that you need to free with g_free() when done. key and lang may also be set to NULL by this function if there is no key or no language code in the extended comment string.

Parameters:

String ext_comment Required (not null)

Array key Required (not null)

Array lang Required (not null)

Array value Required (not null)

Boolean fail_if_no_key Required (not null)

Returns:

Boolean

Returns:

none

Looks up the ID3v2 tag for a GStreamer tag.

Parameters:

String gst_tag Required (not null)

Returns:

String

Creates a new tag list that contains the information parsed out of a vorbiscomment packet.

Parameters:

Gst.TagList list Required (not null)

String tag Required (not null)

Returns:

Array g_list_foreach (list, (GFunc) g_free, NULL) plus g_list_free (list)

Looks up the vorbiscomment tag for a GStreamer tag.

Parameters:

String gst_tag Required (not null)

Returns:

String

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

Parameters:

Gst.TagList list Required (not null)

String tag Required (not null)

must be valid UTF-8

String value Required (not null)

must be valid UTF-8

Returns:

none