![]() |
![]() |
![]() |
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); 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.
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
:ext_comment
an extended comment string, see GST_TAG_EXTENDED_COMMENT
an extended comment string, see GST_TAG_EXTENDED_COMMENT
GST_TAG_EXTENDED_COMMENTGST_TAG_EXTENDED_COMMENTkey
:key
return location for the comment description key, or NULL
return location for the comment description key, or NULL
lang
:lang
return location for the comment ISO-639 language code, or NULL
return location for the comment ISO-639 language code, or NULL
value
:value
return location for the actual comment string, or NULL
return location for the actual comment string, or NULL
fail_if_no_key
:fail_if_no_key
whether to fail if strings are not in key=value form
whether to fail if strings are not in key=value form
Returns :Returns TRUE if the string could be parsed, otherwise FALSE
TRUE if the string could be parsed, otherwise FALSE
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)
GST_TAG_IMAGE_TYPE_UNDEFINED
GST_TAG_IMAGE_TYPE_UNDEFINED
Undefined/other image type
Undefined/other image type
GST_TAG_IMAGE_TYPE_FRONT_COVER
GST_TAG_IMAGE_TYPE_FRONT_COVER
Cover (front)
Cover (front)
GST_TAG_IMAGE_TYPE_BACK_COVER
GST_TAG_IMAGE_TYPE_BACK_COVER
Cover (back)
Cover (back)
GST_TAG_IMAGE_TYPE_LEAFLET_PAGE
GST_TAG_IMAGE_TYPE_LEAFLET_PAGE
Leaflet page
Leaflet page
GST_TAG_IMAGE_TYPE_MEDIUM
GST_TAG_IMAGE_TYPE_MEDIUM
Medium (e.g. label side of CD)
Medium (e.g. label side of CD)
GST_TAG_IMAGE_TYPE_LEAD_ARTIST
GST_TAG_IMAGE_TYPE_LEAD_ARTIST
Lead artist/lead performer/soloist
Lead artist/lead performer/soloist
GST_TAG_IMAGE_TYPE_ARTIST
GST_TAG_IMAGE_TYPE_ARTIST
Artist/performer
Artist/performer
GST_TAG_IMAGE_TYPE_CONDUCTOR
GST_TAG_IMAGE_TYPE_CONDUCTOR
Conductor
Conductor
GST_TAG_IMAGE_TYPE_BAND_ORCHESTRA
GST_TAG_IMAGE_TYPE_BAND_ORCHESTRA
Band/orchestra
Band/orchestra
GST_TAG_IMAGE_TYPE_COMPOSER
GST_TAG_IMAGE_TYPE_COMPOSER
Composer
Composer
GST_TAG_IMAGE_TYPE_LYRICIST
GST_TAG_IMAGE_TYPE_LYRICIST
Lyricist/text writer
Lyricist/text writer
GST_TAG_IMAGE_TYPE_RECORDING_LOCATION
GST_TAG_IMAGE_TYPE_RECORDING_LOCATION
Recording location
Recording location
GST_TAG_IMAGE_TYPE_DURING_RECORDING
GST_TAG_IMAGE_TYPE_DURING_RECORDING
During recording
During recording
GST_TAG_IMAGE_TYPE_DURING_PERFORMANCE
GST_TAG_IMAGE_TYPE_DURING_PERFORMANCE
During performance
During performance
GST_TAG_IMAGE_TYPE_VIDEO_CAPTURE
GST_TAG_IMAGE_TYPE_VIDEO_CAPTURE
Movie/video screen capture
Movie/video screen capture
GST_TAG_IMAGE_TYPE_FISH
GST_TAG_IMAGE_TYPE_FISH
A fish as funny as the ID3v2 spec
A fish as funny as the ID3v2 spec
GST_TAG_IMAGE_TYPE_ILLUSTRATION
GST_TAG_IMAGE_TYPE_ILLUSTRATION
Illustration
Illustration
GST_TAG_IMAGE_TYPE_BAND_ARTIST_LOGO
GST_TAG_IMAGE_TYPE_BAND_ARTIST_LOGO
Band/artist logotype
Band/artist logotype
GST_TAG_IMAGE_TYPE_PUBLISHER_STUDIO_LOGO
GST_TAG_IMAGE_TYPE_PUBLISHER_STUDIO_LOGO
Publisher/studio logotype
Publisher/studio logotype
Since 0.10.9