| GStreamer Base Plugins 0.10 Library Reference Manual | ||||
|---|---|---|---|---|
#include <gst/tag/tag.h> #define GST_TAG_MUSICBRAINZ_TRACKID #define GST_TAG_MUSICBRAINZ_ARTISTID #define GST_TAG_MUSICBRAINZ_ALBUMID #define GST_TAG_MUSICBRAINZ_ALBUMARTISTID #define GST_TAG_MUSICBRAINZ_TRMID #define GST_TAG_MUSICBRAINZ_SORTNAME #define GST_TAG_CDDA_CDDB_DISCID #define GST_TAG_CDDA_CDDB_DISCID_FULL #define GST_TAG_CDDA_MUSICBRAINZ_DISCID #define GST_TAG_CDDA_MUSICBRAINZ_DISCID_FULL #define GST_TAG_CMML_CLIP #define GST_TAG_CMML_HEAD #define GST_TAG_CMML_STREAM void gst_tag_register_musicbrainz_tags (void); gchar* gst_tag_freeform_string_to_utf8 (const gchar *data, gint size, const gchar **env_vars); gboolean gst_tag_parse_extended_comment (const gchar *ext_comment, gchar **key, gchar **lang, gchar **value, gboolean fail_if_no_key); enum GstTagImageType;
Contains additional standardized GStreamer tag definitions for plugins and applications, and functions to register them with the GStreamer tag system.
#define GST_TAG_MUSICBRAINZ_TRACKID "musicbrainz-trackid"
MusicBrainz track ID
#define GST_TAG_MUSICBRAINZ_ARTISTID "musicbrainz-artistid"
MusicBrainz artist ID
#define GST_TAG_MUSICBRAINZ_ALBUMID "musicbrainz-albumid"
MusicBrainz album ID
#define GST_TAG_MUSICBRAINZ_ALBUMARTISTID "musicbrainz-albumartistid"
MusicBrainz album artist ID
#define GST_TAG_MUSICBRAINZ_TRMID "musicbrainz-trmid"
MusicBrainz track TRM ID
#define GST_TAG_MUSICBRAINZ_SORTNAME "musicbrainz-sortname"
MusicBrainz artist sort name
#define GST_TAG_CDDA_CDDB_DISCID "discid"
CDDB disc id in its short form (e.g. 'aa063d0f')
#define GST_TAG_CDDA_CDDB_DISCID_FULL "discid-full"
CDDB disc id including all details
#define GST_TAG_CDDA_MUSICBRAINZ_DISCID "musicbrainz-discid"
Musicbrainz disc id (e.g. 'ahg7JUcfR3vCYBphSDIogOOWrr0-')
#define GST_TAG_CDDA_MUSICBRAINZ_DISCID_FULL "musicbrainz-discid-full"
Musicbrainz disc id details
void gst_tag_register_musicbrainz_tags (void);
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.
gchar* gst_tag_freeform_string_to_utf8 (const gchar *data,
gint size,
const gchar **env_vars);
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.
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,
ISO-8859-1 is assumed (which will almost always succeed).
data : |
string data |
size : |
length of string data, or -1 if the string is NUL-terminated |
env_vars : |
a NULL-terminated string array of environment variable names, or NULL |
| Returns : | a newly-allocated string in UTF-8 encoding, or NULL |
Since 0.10.13
gboolean gst_tag_parse_extended_comment (const gchar *ext_comment,
gchar **key,
gchar **lang,
gchar **value,
gboolean fail_if_no_key);
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.
ext_comment : |
an extended comment string, see GST_TAG_EXTENDED_COMMENT |
key : |
return location for the comment description key, or NULL |
lang : |
return location for the comment ISO-639 language code, or NULL |
value : |
return location for the actual comment string, or NULL |
fail_if_no_key : |
whether to fail if strings are not in key=value form |
| Returns : | TRUE if the string could be parsed, otherwise FALSE |
Since 0.10.10
typedef enum {
GST_TAG_IMAGE_TYPE_UNDEFINED,
GST_TAG_IMAGE_TYPE_FRONT_COVER,
GST_TAG_IMAGE_TYPE_BACK_COVER,
GST_TAG_IMAGE_TYPE_LEAFLET_PAGE,
GST_TAG_IMAGE_TYPE_MEDIUM,
GST_TAG_IMAGE_TYPE_LEAD_ARTIST,
GST_TAG_IMAGE_TYPE_ARTIST,
GST_TAG_IMAGE_TYPE_CONDUCTOR,
GST_TAG_IMAGE_TYPE_BAND_ORCHESTRA,
GST_TAG_IMAGE_TYPE_COMPOSER,
GST_TAG_IMAGE_TYPE_LYRICIST,
GST_TAG_IMAGE_TYPE_RECORDING_LOCATION,
GST_TAG_IMAGE_TYPE_DURING_RECORDING,
GST_TAG_IMAGE_TYPE_DURING_PERFORMANCE,
GST_TAG_IMAGE_TYPE_VIDEO_CAPTURE,
GST_TAG_IMAGE_TYPE_FISH,
GST_TAG_IMAGE_TYPE_ILLUSTRATION,
GST_TAG_IMAGE_TYPE_BAND_ARTIST_LOGO,
GST_TAG_IMAGE_TYPE_PUBLISHER_STUDIO_LOGO
} GstTagImageType;
Type of image contained in an image tag (specified as field in the image buffer's caps structure)
Since 0.10.9