AcoustID Identifier
Direction of contrast processing applied when capturing an image. (string)
The allowed values are: "normal" "soft" "hard"
Digital zoom ratio used when capturing an image. (double)
Exposure compensation using when capturing an image in EV. (double)
Exposure mode used when capturing an image. (string)
The allowed values are: "auto-exposure" "manual-exposure" "auto-bracket"
Type of exposure control used when capturing an image. (string)
The allowed values are: "undefined" "manual" "normal" - automatically controlled "aperture-priority" - user selects aperture value "shutter-priority" - user selects shutter speed "creative" - biased towards depth of field "action" - biased towards fast shutter speed "portrait" - closeup, leaving background out of focus "landscape" - landscape photos, background in focus
If flash was fired during the capture of an image. (boolean)
Note that if this tag isn't present, it should not be assumed that the flash did not fire. It should be treated as unknown.
The flash mode selected during the capture of an image. (string)
The allowed values are: "auto" "always" "never"
Focal length used when capturing an image, in mm. (double)
35 mm equivalent focal length used when capturing an image, in mm. (double)
Focal ratio (f-number) used when capturing an image. (double)
The value stored is the denominator of the focal ratio (f-number). For example, if this tag value is 2, the focal ratio is f/2.
Gain adjustment applied to an image. (string)
The allowed values are: "none" "low-gain-up" "high-gain-up" "low-gain-down" "high-gain-down"
ISO speed used when capturing an image. (integer)
Defines the way a camera determines the exposure. (string)
The allowed values are: "unknown" "average" "center-weighted-average" "spot" "multi-spot" "pattern" "partial" "other"
Direction of saturation processing applied when capturing an image. (string)
The allowed values are: "normal" "low-saturation" "high-saturation"
Scene mode used when capturing an image. (string)
The allowed values are: "standard" "landscape" "portrait" "night-scene"
Direction of sharpness processing applied when capturing an image. (string)
The allowed values are: "normal" "soft" "hard"
Shutter speed used when capturing an image, in seconds. (fraction)
Indicates the source of capture. The device/medium used to do the capture. (string)
Allowed values are: "dsc" (= digital still camera) "transparent-scanner" "reflex-scanner" "other"
White balance mode used when capturing an image. (string)
The allowed values are: "auto" "manual" "daylight" "cloudy" "tungsten" "fluorescent" "fluorescent h" (newer daylight-calibrated fluorescents) "flash"
CDDB disc id in its short form (e.g. 'aa063d0f')
CDDB disc id including all details
Musicbrainz disc id (e.g. 'ahg7JUcfR3vCYBphSDIogOOWrr0-')
Musicbrainz disc id details
Annodex CMML clip element tag
Annodex CMML head element tag
Annodex CMML stream element tag
ID3V2 header size considered minimum input for some functions such as gst_tag_list_from_id3v2_tag() and gst_tag_get_id3v2_tag_size() for example.
Media (image/video) intended horizontal pixel density in ppi. (double)
Media (image/video) intended vertical pixel density in ppi. (double)
Musical key in which the sound starts. It is represented as a string with a maximum length of three characters. The ground keys are represented with "A","B","C","D","E", "F" and "G" and halfkeys represented with "b" and "#". Minor is represented as "m" (e.g. "Dbm"). Off key is represented with an "o" only. This notation might be extended in the future to support non-minor/major keys.
MusicBrainz album artist ID
MusicBrainz album ID
MusicBrainz artist ID
MusicBrainz Release Group ID
MusicBrainz Release Track ID
MusicBrainz track ID
MusicBrainz track TRM ID
Check if a given string contains a known ISO 639 language code.
This is useful in situations where it's not clear whether a given string is a language code (which should be put into a #GST_TAG_LANGUAGE_CODE tag) or a free-form language name descriptor (which should be put into a #GST_TAG_LANGUAGE_NAME tag instead).
ISO-639 language code (e.g. "deu" or "ger" or "de")
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).
string data
a NULL-terminated string array of environment variable names, or NULL
Looks up the GStreamer tag for a ID3v2 tag.
ID3v2 tag to convert to GStreamer 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
Looks up the GStreamer tag for a vorbiscomment tag.
vorbiscomment tag to convert to GStreamer tag
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.
ISO-639 language code (e.g. "deu" or "ger" or "de")
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 preferred.
Language codes are case-sensitive and expected to be lower case.
ISO-639 language code (e.g. "deu" or "ger" or "de")
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 preferred over the "bibliographic" ones.
Language codes are case-sensitive and expected to be lower case.
ISO-639 language code (e.g. "deu" or "ger" or "de")
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 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).
Language codes are case-sensitive and expected to be lower case.
two or three-letter ISO-639 language code
Get the description of a license, which is a translated description of the license's main features.
a license reference string in form of a URI, e.g. "http://creativecommons.org/licenses/by-nc-nd/2.0/"
Get the flags of a license, which describe most of the features of a license in their most general form.
a license reference string in form of a URI, e.g. "http://creativecommons.org/licenses/by-nc-nd/2.0/"
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".
Known jurisdictions: ar, at, au, be, bg, br, ca, ch, cl, cn, co, de, dk, es, fi, fr, hr, hu, il, in, it, jp, kr, mk, mt, mx, my, nl, pe, pl, pt, scotland, se, si, tw, uk, us, za.
a license reference string in form of a URI, e.g. "http://creativecommons.org/licenses/by-nc-nd/2.0/"
Get the nick name of a license, which is a short (untranslated) string such as e.g. "CC BY-NC-ND 2.0 UK".
a license reference string in form of a URI, e.g. "http://creativecommons.org/licenses/by-nc-nd/2.0/"
Get the title of a license, which is a short translated description of the license's features (generally not very pretty though).
a license reference string in form of a URI, e.g. "http://creativecommons.org/licenses/by-nc-nd/2.0/"
Get the version of a license.
a license reference string in form of a URI, e.g. "http://creativecommons.org/licenses/by-nc-nd/2.0/"
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).
Gets the number of ID3v1 genres that can be identified. Winamp genres are included.
Gets the ID3v1 genre name for a given ID.
ID of genre to query
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.
Background: cover art and other images in tags are usually stored as a 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 #GstSamples containing the raw image data, with the sample caps describing the content type of the image (e.g. image/jpeg, image/png, text/uri-list). The sample info may contain an additional 'image-type' field of #GstTagImageType 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).
the (encoded) image
type of the image, or #GST_TAG_IMAGE_TYPE_UNDEFINED. Pass #GST_TAG_IMAGE_TYPE_NONE if no image type should be set at all (e.g. for preview images)
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_sample() for more information on image tags in GStreamer.
a tag list
the (encoded) image
picture type as per the ID3 (v2.4.0) specification for the APIC frame (0 = unknown/other)
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
The exif buffer
byte order of the data
Offset from the tiff header to this buffer
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.
The taglist
byte order used in writing (G_LITTLE_ENDIAN or G_BIG_ENDIAN)
Offset from the tiff header first byte
Formats a taglist as a xmp packet using only the selected schemas. An empty list (%NULL) means that all schemas should be used
tags
does the container forbid inplace editing
%NULL terminated array of schemas to be used on serialization
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.
an extended comment string, see #GST_TAG_EXTENDED_COMMENT
whether to fail if strings are not in key=value form
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.
Looks up the ID3v2 tag for a GStreamer tag.
GStreamer tag to convert to vorbiscomment tag
Looks up the vorbiscomment tag for a GStreamer tag.
GStreamer tag to convert to vorbiscomment tag
Gets the list of supported schemas in the xmp lib
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.
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
AcoustID Fingerprint (Chromaprint)