gsttag.global

Undocumented in source.

Members

Functions

tagCheckLanguageCode
bool tagCheckLanguageCode(string langCode)

Check if a given string contains a known ISO 639 language code.

tagFreeformStringToUtf8
string tagFreeformStringToUtf8(string data, string[] envVars)

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 env_vars) containing a list of character encodings to try/use. If none are specified, the current locale will be tried. If that also doesn't work, WINDOWS-1252/ISO-8859-1 is assumed (which will almost always succeed).

tagFromId3Tag
string tagFromId3Tag(string id3Tag)

Looks up the GStreamer tag for a ID3v2 tag.

tagFromId3UserTag
string tagFromId3UserTag(string type, string id3UserTag)

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

tagFromVorbisTag
string tagFromVorbisTag(string vorbisTag)

Looks up the GStreamer tag for a vorbiscomment tag.

tagGetId3v2TagSize
uint tagGetId3v2TagSize(gst.buffer.Buffer buffer)

Determines size of an ID3v2 tag on buffer containing at least ID3v2 header, i.e. at least #GST_TAG_ID3V2_HEADER_SIZE (10) bytes;

tagGetLanguageCodeIso6391
string tagGetLanguageCodeIso6391(string langCode)

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

tagGetLanguageCodeIso6392B
string tagGetLanguageCodeIso6392B(string langCode)

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

tagGetLanguageCodeIso6392T
string tagGetLanguageCodeIso6392T(string langCode)

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

tagGetLanguageCodes
string[] tagGetLanguageCodes()

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

tagGetLanguageName
string tagGetLanguageName(string languageCode)

Returns the name of the language given an ISO-639 language code as found in a GST_TAG_LANGUAGE_CODE 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).

tagGetLicenseDescription
string tagGetLicenseDescription(string licenseRef)

Get the description of a license, which is a translated description of the license's main features.

tagGetLicenseFlags
gsttag.types.TagLicenseFlags tagGetLicenseFlags(string licenseRef)

Get the flags of a license, which describe most of the features of a license in their most general form.

tagGetLicenseJurisdiction
string tagGetLicenseJurisdiction(string licenseRef)

Get the jurisdiction code of a license. This is usually a two-letter ISO 3166-1 alpha-2 code, but there is also the special case of Scotland, for which no code exists and which is thus represented as "scotland".

tagGetLicenseNick
string tagGetLicenseNick(string licenseRef)

Get the nick name of a license, which is a short (untranslated) string such as e.g. "CC BY-NC-ND 2.0 UK".

tagGetLicenseTitle
string tagGetLicenseTitle(string licenseRef)

Get the title of a license, which is a short translated description of the license's features (generally not very pretty though).

tagGetLicenseVersion
string tagGetLicenseVersion(string licenseRef)

Get the version of a license.

tagGetLicenses
string[] tagGetLicenses()

Returns a list of known license references (in form of URIs). This is useful for UIs to build a list of available licenses for tagging purposes (e.g. to tag an audio track appropriately in a video or audio editor, or an image in a camera application).

tagId3GenreCount
uint tagId3GenreCount()

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

tagId3GenreGet
string tagId3GenreGet(uint id)

Gets the ID3v1 genre name for a given ID.

tagImageDataToImageSample
gst.sample.Sample tagImageDataToImageSample(ubyte[] imageData, gsttag.types.TagImageType imageType)

Helper function for tag-reading plugins to create a #GstSample 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.

tagListAddId3Image
bool tagListAddId3Image(gst.tag_list.TagList tagList, ubyte[] imageData, uint id3PictureType)

Adds an image from an ID3 APIC frame (or similar, such as used in FLAC) to the given tag list. Also see gsttag.global.tagImageDataToImageSample for more information on image tags in GStreamer.

tagListFromExifBuffer
gst.tag_list.TagList tagListFromExifBuffer(gst.buffer.Buffer buffer, int byteOrder, uint baseOffset)

Parses the IFD and IFD tags data contained in the buffer and puts it on a taglist. The base_offset is used to subtract from the offset in the tag entries and be able to get the offset relative to the buffer start

tagListFromExifBufferWithTiffHeader
gst.tag_list.TagList tagListFromExifBufferWithTiffHeader(gst.buffer.Buffer buffer)

Parses the exif tags starting with a tiff header structure.

tagListFromId3v2Tag
gst.tag_list.TagList tagListFromId3v2Tag(gst.buffer.Buffer buffer)

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

tagListFromVorbiscomment
gst.tag_list.TagList tagListFromVorbiscomment(ubyte[] data, ubyte[] idData, string vendorString)

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

tagListFromVorbiscommentBuffer
gst.tag_list.TagList tagListFromVorbiscommentBuffer(gst.buffer.Buffer buffer, ubyte[] idData, string vendorString)

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

tagListFromXmpBuffer
gst.tag_list.TagList tagListFromXmpBuffer(gst.buffer.Buffer buffer)

Parse a xmp packet into a taglist.

tagListNewFromId3v1
gst.tag_list.TagList tagListNewFromId3v1(ubyte[] data)

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

tagListToExifBuffer
gst.buffer.Buffer tagListToExifBuffer(gst.tag_list.TagList taglist, int byteOrder, uint baseOffset)

Formats the tags in taglist on exif format. The resulting buffer contains the tags IFD and is followed by the data pointed by the tag entries.

tagListToExifBufferWithTiffHeader
gst.buffer.Buffer tagListToExifBufferWithTiffHeader(gst.tag_list.TagList taglist)

Formats the tags in taglist into exif structure, a tiff header is put in the beginning of the buffer.

tagListToVorbiscommentBuffer
gst.buffer.Buffer tagListToVorbiscommentBuffer(gst.tag_list.TagList list, ubyte[] idData, string vendorString)

Creates a new vorbiscomment buffer from a tag list.

tagListToXmpBuffer
gst.buffer.Buffer tagListToXmpBuffer(gst.tag_list.TagList list, bool readOnly, string[] schemas)

Formats a taglist as a xmp packet using only the selected schemas. An empty list (null) means that all schemas should be used

tagParseExtendedComment
bool tagParseExtendedComment(string extComment, string key, string lang, string value, bool failIfNoKey)

Convenience function to parse a GST_TAG_EXTENDED_COMMENT string and separate it into its components.

tagRegisterMusicbrainzTags
void tagRegisterMusicbrainzTags()

Registers additional musicbrainz-specific tags with the GStreamer tag system. Plugins and applications that use these tags should call this function before using them. Can be called multiple times.

tagToId3Tag
string tagToId3Tag(string gstTag)

Looks up the ID3v2 tag for a GStreamer tag.

tagToVorbisComments
string[] tagToVorbisComments(gst.tag_list.TagList list, string tag)

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

tagToVorbisTag
string tagToVorbisTag(string gstTag)

Looks up the vorbiscomment tag for a GStreamer tag.

tagXmpListSchemas
string[] tagXmpListSchemas()

Gets the list of supported schemas in the xmp lib

vorbisTagAdd
void vorbisTagAdd(gst.tag_list.TagList list, string tag, string value)

Convenience function using gsttag.global.tagFromVorbisTag, parsing a vorbis comment string into the right type and adding it to the given taglist list.