Metadata
&GStreamer; makes a clear distinction between two types of metadata, and
has support for both types. The first is stream tags, which describe the
content of a stream in a non-technical way. Examples include the author
of a song, the title of that very same song or the album it is a part of.
The other type of metadata is stream-info, which is a somewhat technical
description of the properties of a stream. This can include video size,
audio samplerate, codecs used and so on. Tags are handled using the
&GStreamer; tagging system. Stream-info can be retrieved from a
GstPad.
Metadata reading
Stream information can most easily be read by reading them from a
GstPad. This has already been discussed before
in . Therefore, we will skip
it here. Note that this requires access to all pads of which you
want stream information.
Tag reading is done through a bus in &GStreamer;, which has been
discussed previously in . You can
listen for GST_MESSAGE_TAG messages and handle
them as you wish.
Note, however, that the GST_MESSAGE_TAG
message may be fired multiple times in the pipeline. It is the
application's responsibility to put all those tags together and
display them to the user in a nice, coherent way. Usually, using
gst_tag_list_merge () is a good enough way
of doing this; make sure to empty the cache when loading a new song,
or after every few minutes when listening to internet radio. Also,
make sure you use GST_TAG_MERGE_PREPEND as
merging mode, so that a new title (which came in later) has a
preference over the old one for display.
Tag writing
Tag writing is done using the GstTagSetter
interface. All that's required is a tag-set-supporting element in
your pipeline. In order to see if any of the elements in your
pipeline supports tag writing, you can use the function
gst_bin_iterate_all_by_interface (pipeline,
GST_TYPE_TAG_SETTER). On the resulting element, usually
an encoder or muxer, you can use gst_tag_setter_merge
() (with a taglist) or gst_tag_setter_add
() (with individual tags) to set tags on it.
A nice extra feature in &GStreamer; tag support is that tags are
preserved in pipelines. This means that if you transcode one file
containing tags into another media type, and that new media type
supports tags too, then the tags will be handled as part of the
data stream and be merged into the newly written media file, too.