blob: 9ea1d58ebb75b463d73a8694e986e7c11f62057d [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GstTagList: GStreamer 1.0 Core Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
<link rel="home" href="index.html" title="GStreamer 1.0 Core Reference Manual">
<link rel="up" href="libgstreamer.html" title="GStreamer Core Library">
<link rel="prev" href="GstSystemClock.html" title="GstSystemClock">
<link rel="next" href="GstTagSetter.html" title="GstTagSetter">
<meta name="generator" content="GTK-Doc V1.24 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
<a href="#GstTagList.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
<a href="#GstTagList.object-hierarchy" class="shortcut">Object Hierarchy</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="libgstreamer.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="GstSystemClock.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="GstTagSetter.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="GstTagList"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GstTagList.top_of_page"></a>GstTagList</span></h2>
<p>GstTagList — List of tags and values used to describe media metadata</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="GstTagList.functions"></a><h2>Functions</h2>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="functions_return">
<col class="functions_name">
</colgroup>
<tbody>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<span class="c_punctuation">(</span><a class="link" href="GstTagList.html#GstTagForeachFunc" title="GstTagForeachFunc ()">*GstTagForeachFunc</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<span class="c_punctuation">(</span><a class="link" href="GstTagList.html#GstTagMergeFunc" title="GstTagMergeFunc ()">*GstTagMergeFunc</a><span class="c_punctuation">)</span> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-register" title="gst_tag_register ()">gst_tag_register</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-register-static" title="gst_tag_register_static ()">gst_tag_register_static</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-merge-use-first" title="gst_tag_merge_use_first ()">gst_tag_merge_use_first</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-merge-strings-with-comma" title="gst_tag_merge_strings_with_comma ()">gst_tag_merge_strings_with_comma</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-exists" title="gst_tag_exists ()">gst_tag_exists</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-get-type" title="gst_tag_get_type ()">gst_tag_get_type</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-get-nick" title="gst_tag_get_nick ()">gst_tag_get_nick</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-get-description" title="gst_tag_get_description ()">gst_tag_get_description</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GstTagList.html#GstTagFlag" title="enum GstTagFlag"><span class="returnvalue">GstTagFlag</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-get-flag" title="gst_tag_get_flag ()">gst_tag_get_flag</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-is-fixed" title="gst_tag_is_fixed ()">gst_tag_is_fixed</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GstTagList.html" title="GstTagList"><span class="returnvalue">GstTagList</span></a> *
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-new" title="gst_tag_list_new ()">gst_tag_list_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GstTagList.html" title="GstTagList"><span class="returnvalue">GstTagList</span></a> *
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-new-empty" title="gst_tag_list_new_empty ()">gst_tag_list_new_empty</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GstTagList.html" title="GstTagList"><span class="returnvalue">GstTagList</span></a> *
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-new-valist" title="gst_tag_list_new_valist ()">gst_tag_list_new_valist</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GstTagList.html" title="GstTagList"><span class="returnvalue">GstTagList</span></a> *
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-new-from-string" title="gst_tag_list_new_from_string ()">gst_tag_list_new_from_string</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-free" title="gst_tag_list_free()">gst_tag_list_free</a><span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GstTagList.html#GstTagScope" title="enum GstTagScope"><span class="returnvalue">GstTagScope</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-get-scope" title="gst_tag_list_get_scope ()">gst_tag_list_get_scope</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-set-scope" title="gst_tag_list_set_scope ()">gst_tag_list_set_scope</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-to-string" title="gst_tag_list_to_string ()">gst_tag_list_to_string</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-is-empty" title="gst_tag_list_is_empty ()">gst_tag_list_is_empty</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-is-equal" title="gst_tag_list_is_equal ()">gst_tag_list_is_equal</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GstTagList.html" title="GstTagList"><span class="returnvalue">GstTagList</span></a> *
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-copy" title="gst_tag_list_copy ()">gst_tag_list_copy</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GstTagList.html" title="GstTagList"><span class="returnvalue">GstTagList</span></a> *
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-ref" title="gst_tag_list_ref ()">gst_tag_list_ref</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-unref" title="gst_tag_list_unref ()">gst_tag_list_unref</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-is-writable" title="gst_tag_list_is_writable()">gst_tag_list_is_writable</a><span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-make-writable" title="gst_tag_list_make_writable()">gst_tag_list_make_writable</a><span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-insert" title="gst_tag_list_insert ()">gst_tag_list_insert</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GstTagList.html" title="GstTagList"><span class="returnvalue">GstTagList</span></a> *
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-merge" title="gst_tag_list_merge ()">gst_tag_list_merge</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-get-tag-size" title="gst_tag_list_get_tag_size ()">gst_tag_list_get_tag_size</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-n-tags" title="gst_tag_list_n_tags ()">gst_tag_list_n_tags</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-nth-tag-name" title="gst_tag_list_nth_tag_name ()">gst_tag_list_nth_tag_name</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-add" title="gst_tag_list_add ()">gst_tag_list_add</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-add-value" title="gst_tag_list_add_value ()">gst_tag_list_add_value</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-add-values" title="gst_tag_list_add_values ()">gst_tag_list_add_values</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-add-valist" title="gst_tag_list_add_valist ()">gst_tag_list_add_valist</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-add-valist-values" title="gst_tag_list_add_valist_values ()">gst_tag_list_add_valist_values</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-remove-tag" title="gst_tag_list_remove_tag ()">gst_tag_list_remove_tag</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-foreach" title="gst_tag_list_foreach ()">gst_tag_list_foreach</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <a href="https://developer.gnome.org/gobject/unstable/gobject-Generic-values.html#GValue"><span class="returnvalue">GValue</span></a> *
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-get-value-index" title="gst_tag_list_get_value_index ()">gst_tag_list_get_value_index</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-copy-value" title="gst_tag_list_copy_value ()">gst_tag_list_copy_value</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-get-boolean" title="gst_tag_list_get_boolean ()">gst_tag_list_get_boolean</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-get-boolean-index" title="gst_tag_list_get_boolean_index ()">gst_tag_list_get_boolean_index</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-get-int" title="gst_tag_list_get_int ()">gst_tag_list_get_int</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-get-int-index" title="gst_tag_list_get_int_index ()">gst_tag_list_get_int_index</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-get-uint" title="gst_tag_list_get_uint ()">gst_tag_list_get_uint</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-get-uint-index" title="gst_tag_list_get_uint_index ()">gst_tag_list_get_uint_index</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-get-int64" title="gst_tag_list_get_int64 ()">gst_tag_list_get_int64</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-get-int64-index" title="gst_tag_list_get_int64_index ()">gst_tag_list_get_int64_index</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-get-uint64" title="gst_tag_list_get_uint64 ()">gst_tag_list_get_uint64</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-get-uint64-index" title="gst_tag_list_get_uint64_index ()">gst_tag_list_get_uint64_index</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-get-float" title="gst_tag_list_get_float ()">gst_tag_list_get_float</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-get-float-index" title="gst_tag_list_get_float_index ()">gst_tag_list_get_float_index</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-get-double" title="gst_tag_list_get_double ()">gst_tag_list_get_double</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-get-double-index" title="gst_tag_list_get_double_index ()">gst_tag_list_get_double_index</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-get-string" title="gst_tag_list_get_string ()">gst_tag_list_get_string</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-get-string-index" title="gst_tag_list_get_string_index ()">gst_tag_list_get_string_index</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-peek-string-index" title="gst_tag_list_peek_string_index ()">gst_tag_list_peek_string_index</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-get-pointer" title="gst_tag_list_get_pointer ()">gst_tag_list_get_pointer</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-get-pointer-index" title="gst_tag_list_get_pointer_index ()">gst_tag_list_get_pointer_index</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-get-date" title="gst_tag_list_get_date ()">gst_tag_list_get_date</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-get-date-index" title="gst_tag_list_get_date_index ()">gst_tag_list_get_date_index</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-get-date-time" title="gst_tag_list_get_date_time ()">gst_tag_list_get_date_time</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-get-date-time-index" title="gst_tag_list_get_date_time_index ()">gst_tag_list_get_date_time_index</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-get-sample" title="gst_tag_list_get_sample ()">gst_tag_list_get_sample</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
</td>
<td class="function_name">
<a class="link" href="GstTagList.html#gst-tag-list-get-sample-index" title="gst_tag_list_get_sample_index ()">gst_tag_list_get_sample_index</a> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GstTagList.other"></a><h2>Types and Values</h2>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="name">
<col class="description">
</colgroup>
<tbody>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="GstTagList.html#GstTagList-struct" title="struct GstTagList">GstTagList</a></td>
</tr>
<tr>
<td class="datatype_keyword">enum</td>
<td class="function_name"><a class="link" href="GstTagList.html#GstTagMergeMode" title="enum GstTagMergeMode">GstTagMergeMode</a></td>
</tr>
<tr>
<td class="datatype_keyword">enum</td>
<td class="function_name"><a class="link" href="GstTagList.html#GstTagFlag" title="enum GstTagFlag">GstTagFlag</a></td>
</tr>
<tr>
<td class="datatype_keyword">enum</td>
<td class="function_name"><a class="link" href="GstTagList.html#GstTagScope" title="enum GstTagScope">GstTagScope</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-TITLE:CAPS" title="GST_TAG_TITLE">GST_TAG_TITLE</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-TITLE-SORTNAME:CAPS" title="GST_TAG_TITLE_SORTNAME">GST_TAG_TITLE_SORTNAME</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-ARTIST:CAPS" title="GST_TAG_ARTIST">GST_TAG_ARTIST</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-ARTIST-SORTNAME:CAPS" title="GST_TAG_ARTIST_SORTNAME">GST_TAG_ARTIST_SORTNAME</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-ALBUM:CAPS" title="GST_TAG_ALBUM">GST_TAG_ALBUM</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-ALBUM-SORTNAME:CAPS" title="GST_TAG_ALBUM_SORTNAME">GST_TAG_ALBUM_SORTNAME</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-ALBUM-ARTIST:CAPS" title="GST_TAG_ALBUM_ARTIST">GST_TAG_ALBUM_ARTIST</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-ALBUM-ARTIST-SORTNAME:CAPS" title="GST_TAG_ALBUM_ARTIST_SORTNAME">GST_TAG_ALBUM_ARTIST_SORTNAME</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-DATE:CAPS" title="GST_TAG_DATE">GST_TAG_DATE</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-DATE-TIME:CAPS" title="GST_TAG_DATE_TIME">GST_TAG_DATE_TIME</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-GENRE:CAPS" title="GST_TAG_GENRE">GST_TAG_GENRE</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-COMMENT:CAPS" title="GST_TAG_COMMENT">GST_TAG_COMMENT</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-EXTENDED-COMMENT:CAPS" title="GST_TAG_EXTENDED_COMMENT">GST_TAG_EXTENDED_COMMENT</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-TRACK-NUMBER:CAPS" title="GST_TAG_TRACK_NUMBER">GST_TAG_TRACK_NUMBER</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-TRACK-COUNT:CAPS" title="GST_TAG_TRACK_COUNT">GST_TAG_TRACK_COUNT</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-ALBUM-VOLUME-NUMBER:CAPS" title="GST_TAG_ALBUM_VOLUME_NUMBER">GST_TAG_ALBUM_VOLUME_NUMBER</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-ALBUM-VOLUME-COUNT:CAPS" title="GST_TAG_ALBUM_VOLUME_COUNT">GST_TAG_ALBUM_VOLUME_COUNT</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-LOCATION:CAPS" title="GST_TAG_LOCATION">GST_TAG_LOCATION</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-HOMEPAGE:CAPS" title="GST_TAG_HOMEPAGE">GST_TAG_HOMEPAGE</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-DESCRIPTION:CAPS" title="GST_TAG_DESCRIPTION">GST_TAG_DESCRIPTION</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-VERSION:CAPS" title="GST_TAG_VERSION">GST_TAG_VERSION</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-ISRC:CAPS" title="GST_TAG_ISRC">GST_TAG_ISRC</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-ORGANIZATION:CAPS" title="GST_TAG_ORGANIZATION">GST_TAG_ORGANIZATION</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-COPYRIGHT:CAPS" title="GST_TAG_COPYRIGHT">GST_TAG_COPYRIGHT</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-COPYRIGHT-URI:CAPS" title="GST_TAG_COPYRIGHT_URI">GST_TAG_COPYRIGHT_URI</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-ENCODED-BY:CAPS" title="GST_TAG_ENCODED_BY">GST_TAG_ENCODED_BY</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-COMPOSER:CAPS" title="GST_TAG_COMPOSER">GST_TAG_COMPOSER</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-CONTACT:CAPS" title="GST_TAG_CONTACT">GST_TAG_CONTACT</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-LICENSE:CAPS" title="GST_TAG_LICENSE">GST_TAG_LICENSE</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-LICENSE-URI:CAPS" title="GST_TAG_LICENSE_URI">GST_TAG_LICENSE_URI</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-PERFORMER:CAPS" title="GST_TAG_PERFORMER">GST_TAG_PERFORMER</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-DURATION:CAPS" title="GST_TAG_DURATION">GST_TAG_DURATION</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-CODEC:CAPS" title="GST_TAG_CODEC">GST_TAG_CODEC</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-VIDEO-CODEC:CAPS" title="GST_TAG_VIDEO_CODEC">GST_TAG_VIDEO_CODEC</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-AUDIO-CODEC:CAPS" title="GST_TAG_AUDIO_CODEC">GST_TAG_AUDIO_CODEC</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-SUBTITLE-CODEC:CAPS" title="GST_TAG_SUBTITLE_CODEC">GST_TAG_SUBTITLE_CODEC</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-CONTAINER-FORMAT:CAPS" title="GST_TAG_CONTAINER_FORMAT">GST_TAG_CONTAINER_FORMAT</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-BITRATE:CAPS" title="GST_TAG_BITRATE">GST_TAG_BITRATE</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-NOMINAL-BITRATE:CAPS" title="GST_TAG_NOMINAL_BITRATE">GST_TAG_NOMINAL_BITRATE</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-MINIMUM-BITRATE:CAPS" title="GST_TAG_MINIMUM_BITRATE">GST_TAG_MINIMUM_BITRATE</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-MAXIMUM-BITRATE:CAPS" title="GST_TAG_MAXIMUM_BITRATE">GST_TAG_MAXIMUM_BITRATE</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-SERIAL:CAPS" title="GST_TAG_SERIAL">GST_TAG_SERIAL</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-ENCODER:CAPS" title="GST_TAG_ENCODER">GST_TAG_ENCODER</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-ENCODER-VERSION:CAPS" title="GST_TAG_ENCODER_VERSION">GST_TAG_ENCODER_VERSION</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-TRACK-GAIN:CAPS" title="GST_TAG_TRACK_GAIN">GST_TAG_TRACK_GAIN</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-TRACK-PEAK:CAPS" title="GST_TAG_TRACK_PEAK">GST_TAG_TRACK_PEAK</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-ALBUM-GAIN:CAPS" title="GST_TAG_ALBUM_GAIN">GST_TAG_ALBUM_GAIN</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-ALBUM-PEAK:CAPS" title="GST_TAG_ALBUM_PEAK">GST_TAG_ALBUM_PEAK</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-REFERENCE-LEVEL:CAPS" title="GST_TAG_REFERENCE_LEVEL">GST_TAG_REFERENCE_LEVEL</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-LANGUAGE-CODE:CAPS" title="GST_TAG_LANGUAGE_CODE">GST_TAG_LANGUAGE_CODE</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-LANGUAGE-NAME:CAPS" title="GST_TAG_LANGUAGE_NAME">GST_TAG_LANGUAGE_NAME</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-IMAGE:CAPS" title="GST_TAG_IMAGE">GST_TAG_IMAGE</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-PREVIEW-IMAGE:CAPS" title="GST_TAG_PREVIEW_IMAGE">GST_TAG_PREVIEW_IMAGE</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-ATTACHMENT:CAPS" title="GST_TAG_ATTACHMENT">GST_TAG_ATTACHMENT</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-BEATS-PER-MINUTE:CAPS" title="GST_TAG_BEATS_PER_MINUTE">GST_TAG_BEATS_PER_MINUTE</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-KEYWORDS:CAPS" title="GST_TAG_KEYWORDS">GST_TAG_KEYWORDS</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-GEO-LOCATION-NAME:CAPS" title="GST_TAG_GEO_LOCATION_NAME">GST_TAG_GEO_LOCATION_NAME</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-GEO-LOCATION-LATITUDE:CAPS" title="GST_TAG_GEO_LOCATION_LATITUDE">GST_TAG_GEO_LOCATION_LATITUDE</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-GEO-LOCATION-LONGITUDE:CAPS" title="GST_TAG_GEO_LOCATION_LONGITUDE">GST_TAG_GEO_LOCATION_LONGITUDE</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-GEO-LOCATION-ELEVATION:CAPS" title="GST_TAG_GEO_LOCATION_ELEVATION">GST_TAG_GEO_LOCATION_ELEVATION</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-GEO-LOCATION-CITY:CAPS" title="GST_TAG_GEO_LOCATION_CITY">GST_TAG_GEO_LOCATION_CITY</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-GEO-LOCATION-COUNTRY:CAPS" title="GST_TAG_GEO_LOCATION_COUNTRY">GST_TAG_GEO_LOCATION_COUNTRY</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-GEO-LOCATION-SUBLOCATION:CAPS" title="GST_TAG_GEO_LOCATION_SUBLOCATION">GST_TAG_GEO_LOCATION_SUBLOCATION</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-GEO-LOCATION-HORIZONTAL-ERROR:CAPS" title="GST_TAG_GEO_LOCATION_HORIZONTAL_ERROR">GST_TAG_GEO_LOCATION_HORIZONTAL_ERROR</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-GEO-LOCATION-MOVEMENT-DIRECTION:CAPS" title="GST_TAG_GEO_LOCATION_MOVEMENT_DIRECTION">GST_TAG_GEO_LOCATION_MOVEMENT_DIRECTION</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-GEO-LOCATION-MOVEMENT-SPEED:CAPS" title="GST_TAG_GEO_LOCATION_MOVEMENT_SPEED">GST_TAG_GEO_LOCATION_MOVEMENT_SPEED</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-GEO-LOCATION-CAPTURE-DIRECTION:CAPS" title="GST_TAG_GEO_LOCATION_CAPTURE_DIRECTION">GST_TAG_GEO_LOCATION_CAPTURE_DIRECTION</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-SHOW-NAME:CAPS" title="GST_TAG_SHOW_NAME">GST_TAG_SHOW_NAME</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-SHOW-SORTNAME:CAPS" title="GST_TAG_SHOW_SORTNAME">GST_TAG_SHOW_SORTNAME</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-SHOW-EPISODE-NUMBER:CAPS" title="GST_TAG_SHOW_EPISODE_NUMBER">GST_TAG_SHOW_EPISODE_NUMBER</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-SHOW-SEASON-NUMBER:CAPS" title="GST_TAG_SHOW_SEASON_NUMBER">GST_TAG_SHOW_SEASON_NUMBER</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-LYRICS:CAPS" title="GST_TAG_LYRICS">GST_TAG_LYRICS</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-COMPOSER-SORTNAME:CAPS" title="GST_TAG_COMPOSER_SORTNAME">GST_TAG_COMPOSER_SORTNAME</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-GROUPING:CAPS" title="GST_TAG_GROUPING">GST_TAG_GROUPING</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-USER-RATING:CAPS" title="GST_TAG_USER_RATING">GST_TAG_USER_RATING</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-DEVICE-MANUFACTURER:CAPS" title="GST_TAG_DEVICE_MANUFACTURER">GST_TAG_DEVICE_MANUFACTURER</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-DEVICE-MODEL:CAPS" title="GST_TAG_DEVICE_MODEL">GST_TAG_DEVICE_MODEL</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-APPLICATION-NAME:CAPS" title="GST_TAG_APPLICATION_NAME">GST_TAG_APPLICATION_NAME</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-APPLICATION-DATA:CAPS" title="GST_TAG_APPLICATION_DATA">GST_TAG_APPLICATION_DATA</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-IMAGE-ORIENTATION:CAPS" title="GST_TAG_IMAGE_ORIENTATION">GST_TAG_IMAGE_ORIENTATION</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-PUBLISHER:CAPS" title="GST_TAG_PUBLISHER">GST_TAG_PUBLISHER</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-INTERPRETED-BY:CAPS" title="GST_TAG_INTERPRETED_BY">GST_TAG_INTERPRETED_BY</a></td>
</tr>
<tr>
<td class="define_keyword">#define</td>
<td class="function_name"><a class="link" href="GstTagList.html#GST-TAG-MIDI-BASE-NOTE:CAPS" title="GST_TAG_MIDI_BASE_NOTE">GST_TAG_MIDI_BASE_NOTE</a></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GstTagList.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen"> <a href="https://developer.gnome.org/gobject/unstable/gobject-Boxed-Types.html">GBoxed</a>
<span class="lineart">╰──</span> GstTagList
</pre>
</div>
<div class="refsect1">
<a name="GstTagList.includes"></a><h2>Includes</h2>
<pre class="synopsis">#include &lt;gst/gst.h&gt;
</pre>
</div>
<div class="refsect1">
<a name="GstTagList.description"></a><h2>Description</h2>
<p>List of tags and values used to describe media metadata.</p>
<p>Strings in structures must be ASCII or UTF-8 encoded. Other encodings are
not allowed. Strings must not be empty or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
</div>
<div class="refsect1">
<a name="GstTagList.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="GstTagForeachFunc"></a><h3>GstTagForeachFunc ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
<span class="c_punctuation">(</span>*GstTagForeachFunc<span class="c_punctuation">)</span> (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
<p>A function that will be called in <a class="link" href="GstTagList.html#gst-tag-list-foreach" title="gst_tag_list_foreach ()"><code class="function">gst_tag_list_foreach()</code></a>. The function may
not modify the tag list.</p>
<div class="refsect3">
<a name="id-1.3.48.8.2.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>the <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>a name of a tag in <em class="parameter"><code>list</code></em>
</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="GstTagMergeFunc"></a><h3>GstTagMergeFunc ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
<span class="c_punctuation">(</span>*GstTagMergeFunc<span class="c_punctuation">)</span> (<em class="parameter"><code><a href="https://developer.gnome.org/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *src</code></em>);</pre>
<p>A function for merging multiple values of a tag used when registering
tags.</p>
<div class="refsect3">
<a name="id-1.3.48.8.3.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>dest</p></td>
<td class="parameter_description"><p>the destination <a href="https://developer.gnome.org/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>src</p></td>
<td class="parameter_description"><p>the source <a href="https://developer.gnome.org/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-register"></a><h3>gst_tag_register ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gst_tag_register (<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
<em class="parameter"><code><a class="link" href="GstTagList.html#GstTagFlag" title="enum GstTagFlag"><span class="type">GstTagFlag</span></a> flag</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *nick</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *blurb</code></em>,
<em class="parameter"><code><a class="link" href="GstTagList.html#GstTagMergeFunc" title="GstTagMergeFunc ()"><span class="type">GstTagMergeFunc</span></a> func</code></em>);</pre>
<p>Registers a new tag type for the use with GStreamer's type system. If a type
with that name is already registered, that one is used.
The old registration may have used a different type however. So don't rely
on your supplied values.</p>
<p>Important: if you do not supply a merge function the implication will be
that there can only be one single value for this tag in a tag list and
any additional values will silently be discarded when being added (unless
<a class="link" href="GstTagList.html#GST-TAG-MERGE-REPLACE:CAPS"><span class="type">GST_TAG_MERGE_REPLACE</span></a>, <a class="link" href="GstTagList.html#GST-TAG-MERGE-REPLACE-ALL:CAPS"><span class="type">GST_TAG_MERGE_REPLACE_ALL</span></a>, or
<a class="link" href="GstTagList.html#GST-TAG-MERGE-PREPEND:CAPS"><span class="type">GST_TAG_MERGE_PREPEND</span></a> is used as merge mode, in which case the new
value will replace the old one in the list).</p>
<p>The merge function will be called from <a class="link" href="GstTagList.html#gst-tag-list-copy-value" title="gst_tag_list_copy_value ()"><code class="function">gst_tag_list_copy_value()</code></a> when
it is required that one or more values for a tag be condensed into
one single value. This may happen from <a class="link" href="GstTagList.html#gst-tag-list-get-string" title="gst_tag_list_get_string ()"><code class="function">gst_tag_list_get_string()</code></a>,
<a class="link" href="GstTagList.html#gst-tag-list-get-int" title="gst_tag_list_get_int ()"><code class="function">gst_tag_list_get_int()</code></a>, <a class="link" href="GstTagList.html#gst-tag-list-get-double" title="gst_tag_list_get_double ()"><code class="function">gst_tag_list_get_double()</code></a> etc. What will happen
exactly in that case depends on how the tag was registered and if a
merge function was supplied and if so which one.</p>
<p>Two default merge functions are provided: <a class="link" href="GstTagList.html#gst-tag-merge-use-first" title="gst_tag_merge_use_first ()"><code class="function">gst_tag_merge_use_first()</code></a> and
<a class="link" href="GstTagList.html#gst-tag-merge-strings-with-comma" title="gst_tag_merge_strings_with_comma ()"><code class="function">gst_tag_merge_strings_with_comma()</code></a>.</p>
<div class="refsect3">
<a name="id-1.3.48.8.4.8"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>name</p></td>
<td class="parameter_description"><p>the name or identifier string</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>flag</p></td>
<td class="parameter_description"><p>a flag describing the type of tag info</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>type</p></td>
<td class="parameter_description"><p>the type this data is in</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>nick</p></td>
<td class="parameter_description"><p>human-readable name</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>blurb</p></td>
<td class="parameter_description"><p>a human-readable description about this tag</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>func</p></td>
<td class="parameter_description"><p> function for merging multiple values of this tag, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-register-static"></a><h3>gst_tag_register_static ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gst_tag_register_static (<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *name</code></em>,
<em class="parameter"><code><a class="link" href="GstTagList.html#GstTagFlag" title="enum GstTagFlag"><span class="type">GstTagFlag</span></a> flag</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> type</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *nick</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *blurb</code></em>,
<em class="parameter"><code><a class="link" href="GstTagList.html#GstTagMergeFunc" title="GstTagMergeFunc ()"><span class="type">GstTagMergeFunc</span></a> func</code></em>);</pre>
<p>Registers a new tag type for the use with GStreamer's type system.</p>
<p>Same as <a class="link" href="GstTagList.html#gst-tag-register" title="gst_tag_register ()"><code class="function">gst_tag_register()</code></a>, but <em class="parameter"><code>name</code></em>
, <em class="parameter"><code>nick</code></em>
, and <em class="parameter"><code>blurb</code></em>
must be
static strings or inlined strings, as they will not be copied. (GStreamer
plugins will be made resident once loaded, so this function can be used
even from dynamically loaded plugins.)</p>
<div class="refsect3">
<a name="id-1.3.48.8.5.6"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>name</p></td>
<td class="parameter_description"><p>the name or identifier string (string constant)</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>flag</p></td>
<td class="parameter_description"><p>a flag describing the type of tag info</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>type</p></td>
<td class="parameter_description"><p>the type this data is in</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>nick</p></td>
<td class="parameter_description"><p>human-readable name or short description (string constant)</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>blurb</p></td>
<td class="parameter_description"><p>a human-readable description for this tag (string constant)</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>func</p></td>
<td class="parameter_description"><p> function for merging multiple values of this tag, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>][<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-merge-use-first"></a><h3>gst_tag_merge_use_first ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gst_tag_merge_use_first (<em class="parameter"><code><a href="https://developer.gnome.org/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *src</code></em>);</pre>
<p>This is a convenience function for the func argument of <a class="link" href="GstTagList.html#gst-tag-register" title="gst_tag_register ()"><code class="function">gst_tag_register()</code></a>.
It creates a copy of the first value from the list.</p>
<div class="refsect3">
<a name="id-1.3.48.8.6.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>dest</p></td>
<td class="parameter_description"><p> uninitialized GValue to store result in. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out caller-allocates</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>src</p></td>
<td class="parameter_description"><p>GValue to copy from</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-merge-strings-with-comma"></a><h3>gst_tag_merge_strings_with_comma ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gst_tag_merge_strings_with_comma (<em class="parameter"><code><a href="https://developer.gnome.org/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *src</code></em>);</pre>
<p>This is a convenience function for the func argument of <a class="link" href="GstTagList.html#gst-tag-register" title="gst_tag_register ()"><code class="function">gst_tag_register()</code></a>.
It concatenates all given strings using a comma. The tag must be registered
as a G_TYPE_STRING or this function will fail.</p>
<div class="refsect3">
<a name="id-1.3.48.8.7.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>dest</p></td>
<td class="parameter_description"><p> uninitialized GValue to store result in. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out caller-allocates</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>src</p></td>
<td class="parameter_description"><p>GValue to copy from</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-exists"></a><h3>gst_tag_exists ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gst_tag_exists (<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>);</pre>
<p>Checks if the given type is already registered.</p>
<div class="refsect3">
<a name="id-1.3.48.8.8.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>name of the tag</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.8.6"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the type is already registered</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-get-type"></a><h3>gst_tag_get_type ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/gobject/unstable/gobject-Type-Information.html#GType"><span class="returnvalue">GType</span></a>
gst_tag_get_type (<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>);</pre>
<p>Gets the <a href="https://developer.gnome.org/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> used for this tag.</p>
<div class="refsect3">
<a name="id-1.3.48.8.9.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>the tag</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.9.6"></a><h4>Returns</h4>
<p> the <a href="https://developer.gnome.org/gobject/unstable/gobject-Type-Information.html#GType"><span class="type">GType</span></a> of this tag</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-get-nick"></a><h3>gst_tag_get_nick ()</h3>
<pre class="programlisting">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
gst_tag_get_nick (<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>);</pre>
<p>Returns the human-readable name of this tag, You must not change or free
this string.</p>
<div class="refsect3">
<a name="id-1.3.48.8.10.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>the tag</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.10.6"></a><h4>Returns</h4>
<p> the human-readable name of this tag</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-get-description"></a><h3>gst_tag_get_description ()</h3>
<pre class="programlisting">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
gst_tag_get_description (<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>);</pre>
<p>Returns the human-readable description of this tag, You must not change or
free this string.</p>
<div class="refsect3">
<a name="id-1.3.48.8.11.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>the tag</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.11.6"></a><h4>Returns</h4>
<p> the human-readable description of this tag</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-get-flag"></a><h3>gst_tag_get_flag ()</h3>
<pre class="programlisting"><a class="link" href="GstTagList.html#GstTagFlag" title="enum GstTagFlag"><span class="returnvalue">GstTagFlag</span></a>
gst_tag_get_flag (<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>);</pre>
<p>Gets the flag of <em class="parameter"><code>tag</code></em>
.</p>
<div class="refsect3">
<a name="id-1.3.48.8.12.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>the tag</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.12.6"></a><h4>Returns</h4>
<p> the flag of this tag.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-is-fixed"></a><h3>gst_tag_is_fixed ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gst_tag_is_fixed (<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>);</pre>
<p>Checks if the given tag is fixed. A fixed tag can only contain one value.
Unfixed tags can contain lists of values.</p>
<div class="refsect3">
<a name="id-1.3.48.8.13.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag to check</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.13.6"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if the given tag is fixed.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-new"></a><h3>gst_tag_list_new ()</h3>
<pre class="programlisting"><a class="link" href="GstTagList.html" title="GstTagList"><span class="returnvalue">GstTagList</span></a> *
gst_tag_list_new (<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code>...</code></em>);</pre>
<p>Creates a new taglist and appends the values for the given tags. It expects
tag-value pairs like <a class="link" href="GstTagList.html#gst-tag-list-add" title="gst_tag_list_add ()"><code class="function">gst_tag_list_add()</code></a>, and a <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> terminator after the
last pair. The type of the values is implicit and is documented in the API
reference, but can also be queried at runtime with <a class="link" href="GstTagList.html#gst-tag-get-type" title="gst_tag_get_type ()"><code class="function">gst_tag_get_type()</code></a>. It
is an error to pass a value of a type not matching the tag type into this
function. The tag list will make copies of any arguments passed
(e.g. strings, buffers).</p>
<p>After creation you might also want to set a <a class="link" href="GstTagList.html#GstTagScope" title="enum GstTagScope"><span class="type">GstTagScope</span></a> on the returned
taglist to signal if the contained tags are global or stream tags. By
default stream scope is assumes. See <a class="link" href="GstTagList.html#gst-tag-list-set-scope" title="gst_tag_list_set_scope ()"><code class="function">gst_tag_list_set_scope()</code></a>.</p>
<p>Free-function: gst_tag_list_unref</p>
<div class="refsect3">
<a name="id-1.3.48.8.14.7"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>...</p></td>
<td class="parameter_description"><p><a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated list of values to set</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.14.8"></a><h4>Returns</h4>
<p> a new <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a>. Free with <a class="link" href="GstTagList.html#gst-tag-list-unref" title="gst_tag_list_unref ()"><code class="function">gst_tag_list_unref()</code></a>
when no longer needed. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-new-empty"></a><h3>gst_tag_list_new_empty ()</h3>
<pre class="programlisting"><a class="link" href="GstTagList.html" title="GstTagList"><span class="returnvalue">GstTagList</span></a> *
gst_tag_list_new_empty (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
<p>Creates a new empty GstTagList.</p>
<p>Free-function: gst_tag_list_unref</p>
<div class="refsect3">
<a name="id-1.3.48.8.15.6"></a><h4>Returns</h4>
<p> An empty tag list. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-new-valist"></a><h3>gst_tag_list_new_valist ()</h3>
<pre class="programlisting"><a class="link" href="GstTagList.html" title="GstTagList"><span class="returnvalue">GstTagList</span></a> *
gst_tag_list_new_valist (<em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);</pre>
<p>Just like <a class="link" href="GstTagList.html#gst-tag-list-new" title="gst_tag_list_new ()"><code class="function">gst_tag_list_new()</code></a>, only that it takes a va_list argument.
Useful mostly for language bindings.</p>
<p>Free-function: gst_tag_list_unref</p>
<div class="refsect3">
<a name="id-1.3.48.8.16.6"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>var_args</p></td>
<td class="parameter_description"><p>tag / value pairs to set</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.16.7"></a><h4>Returns</h4>
<p> a new <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a>. Free with <a class="link" href="GstTagList.html#gst-tag-list-unref" title="gst_tag_list_unref ()"><code class="function">gst_tag_list_unref()</code></a>
when no longer needed. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-new-from-string"></a><h3>gst_tag_list_new_from_string ()</h3>
<pre class="programlisting"><a class="link" href="GstTagList.html" title="GstTagList"><span class="returnvalue">GstTagList</span></a> *
gst_tag_list_new_from_string (<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *str</code></em>);</pre>
<p>Deserializes a tag list.</p>
<div class="refsect3">
<a name="id-1.3.48.8.17.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>str</p></td>
<td class="parameter_description"><p>a string created with <a class="link" href="GstTagList.html#gst-tag-list-to-string" title="gst_tag_list_to_string ()"><code class="function">gst_tag_list_to_string()</code></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.17.6"></a><h4>Returns</h4>
<p> a new <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a>, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in case of an
error. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-free"></a><h3>gst_tag_list_free()</h3>
<pre class="programlisting">#define gst_tag_list_free(taglist) gst_tag_list_unref(taglist)
</pre>
<div class="warning"><p><code class="literal">gst_tag_list_free</code> is deprecated and should not be used in newly-written code.</p></div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-get-scope"></a><h3>gst_tag_list_get_scope ()</h3>
<pre class="programlisting"><a class="link" href="GstTagList.html#GstTagScope" title="enum GstTagScope"><span class="returnvalue">GstTagScope</span></a>
gst_tag_list_get_scope (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>);</pre>
<p>Gets the scope of <em class="parameter"><code>list</code></em>
.</p>
<div class="refsect3">
<a name="id-1.3.48.8.19.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.19.6"></a><h4>Returns</h4>
<p> The scope of <em class="parameter"><code>list</code></em>
</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-set-scope"></a><h3>gst_tag_list_set_scope ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gst_tag_list_set_scope (<em class="parameter"><code><a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code><a class="link" href="GstTagList.html#GstTagScope" title="enum GstTagScope"><span class="type">GstTagScope</span></a> scope</code></em>);</pre>
<p>Sets the scope of <em class="parameter"><code>list</code></em>
to <em class="parameter"><code>scope</code></em>
. By default the scope
of a taglist is stream scope.</p>
<div class="refsect3">
<a name="id-1.3.48.8.20.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>scope</p></td>
<td class="parameter_description"><p>new scope for <em class="parameter"><code>list</code></em>
</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-to-string"></a><h3>gst_tag_list_to_string ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
gst_tag_list_to_string (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>);</pre>
<p>Serializes a tag list to a string.</p>
<div class="refsect3">
<a name="id-1.3.48.8.21.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.21.6"></a><h4>Returns</h4>
<p> a newly-allocated string, or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in case of
an error. The string must be freed with <a href="https://developer.gnome.org/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when no longer
needed. </p>
<p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-is-empty"></a><h3>gst_tag_list_is_empty ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gst_tag_list_is_empty (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>);</pre>
<p>Checks if the given taglist is empty.</p>
<div class="refsect3">
<a name="id-1.3.48.8.22.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>A <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.22.6"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the taglist is empty, otherwise <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a>.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-is-equal"></a><h3>gst_tag_list_is_equal ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gst_tag_list_is_equal (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list1</code></em>,
<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list2</code></em>);</pre>
<p>Checks if the two given taglists are equal.</p>
<div class="refsect3">
<a name="id-1.3.48.8.23.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list1</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>list2</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.23.6"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the taglists are equal, otherwise <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-copy"></a><h3>gst_tag_list_copy ()</h3>
<pre class="programlisting"><a class="link" href="GstTagList.html" title="GstTagList"><span class="returnvalue">GstTagList</span></a> *
gst_tag_list_copy (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *taglist</code></em>);</pre>
<p>Creates a new <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> as a copy of the old <em class="parameter"><code>taglist</code></em>
. The new taglist
will have a refcount of 1, owned by the caller, and will be writable as
a result.</p>
<p>Note that this function is the semantic equivalent of a <a class="link" href="GstTagList.html#gst-tag-list-ref" title="gst_tag_list_ref ()"><code class="function">gst_tag_list_ref()</code></a>
followed by a <a class="link" href="GstTagList.html#gst-tag-list-make-writable" title="gst_tag_list_make_writable()"><code class="function">gst_tag_list_make_writable()</code></a>. If you only want to hold on to a
reference to the data, you should use <a class="link" href="GstTagList.html#gst-tag-list-ref" title="gst_tag_list_ref ()"><code class="function">gst_tag_list_ref()</code></a>.</p>
<p>When you are finished with the taglist, call <a class="link" href="GstTagList.html#gst-tag-list-unref" title="gst_tag_list_unref ()"><code class="function">gst_tag_list_unref()</code></a> on it.</p>
<div class="refsect3">
<a name="id-1.3.48.8.24.7"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>taglist</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.24.8"></a><h4>Returns</h4>
<p> the new <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-ref"></a><h3>gst_tag_list_ref ()</h3>
<pre class="programlisting"><a class="link" href="GstTagList.html" title="GstTagList"><span class="returnvalue">GstTagList</span></a> *
gst_tag_list_ref (<em class="parameter"><code><a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *taglist</code></em>);</pre>
<p>Add a reference to a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> mini object.</p>
<p>From this point on, until the caller calls <a class="link" href="GstTagList.html#gst-tag-list-unref" title="gst_tag_list_unref ()"><code class="function">gst_tag_list_unref()</code></a> or
<a class="link" href="GstTagList.html#gst-tag-list-make-writable" title="gst_tag_list_make_writable()"><code class="function">gst_tag_list_make_writable()</code></a>, it is guaranteed that the taglist object will
not change. To use a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> object, you must always have a refcount on
it -- either the one made implicitly by e.g. <a class="link" href="GstTagList.html#gst-tag-list-new" title="gst_tag_list_new ()"><code class="function">gst_tag_list_new()</code></a>, or via
taking one explicitly with this function.</p>
<div class="refsect3">
<a name="id-1.3.48.8.25.6"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>taglist</p></td>
<td class="parameter_description"><p>the <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> to reference</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.25.7"></a><h4>Returns</h4>
<p> the same <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> mini object.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-unref"></a><h3>gst_tag_list_unref ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gst_tag_list_unref (<em class="parameter"><code><a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *taglist</code></em>);</pre>
<p>Unref a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a>, and and free all its memory when the refcount reaches 0.</p>
<div class="refsect3">
<a name="id-1.3.48.8.26.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>taglist</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-is-writable"></a><h3>gst_tag_list_is_writable()</h3>
<pre class="programlisting">#define gst_tag_list_is_writable(taglist) gst_mini_object_is_writable (GST_MINI_OBJECT_CAST (taglist))
</pre>
<p>Tests if you can safely modify <em class="parameter"><code>taglist</code></em>
. It is only safe to modify taglist
when there is only one owner of the taglist - ie, the refcount is 1.</p>
<div class="refsect3">
<a name="id-1.3.48.8.27.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>taglist</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-make-writable"></a><h3>gst_tag_list_make_writable()</h3>
<pre class="programlisting">#define gst_tag_list_make_writable(taglist) GST_TAG_LIST (gst_mini_object_make_writable (GST_MINI_OBJECT_CAST (taglist)))
</pre>
<p>Returns a writable copy of <em class="parameter"><code>taglist</code></em>
.</p>
<p>If there is only one reference count on <em class="parameter"><code>taglist</code></em>
, the caller must be the
owner, and so this function will return the taglist object unchanged. If on
the other hand there is more than one reference on the object, a new taglist
object will be returned (which will be a copy of <em class="parameter"><code>taglist</code></em>
). The caller's
reference on <em class="parameter"><code>taglist</code></em>
will be removed, and instead the caller will own a
reference to the returned object.</p>
<p>In short, this function unrefs the taglist in the argument and refs the
taglist that it returns. Don't access the argument after calling this
function. See also: <a class="link" href="GstTagList.html#gst-tag-list-ref" title="gst_tag_list_ref ()"><code class="function">gst_tag_list_ref()</code></a>.</p>
<div class="refsect3">
<a name="id-1.3.48.8.28.7"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>taglist</p></td>
<td class="parameter_description"><p> a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.28.8"></a><h4>Returns</h4>
<p> a writable taglist which may or may not be the
same as <em class="parameter"><code>taglist</code></em>
. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-insert"></a><h3>gst_tag_list_insert ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gst_tag_list_insert (<em class="parameter"><code><a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *into</code></em>,
<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *from</code></em>,
<em class="parameter"><code><a class="link" href="GstTagList.html#GstTagMergeMode" title="enum GstTagMergeMode"><span class="type">GstTagMergeMode</span></a> mode</code></em>);</pre>
<p>Inserts the tags of the <em class="parameter"><code>from</code></em>
list into the first list using the given mode.</p>
<div class="refsect3">
<a name="id-1.3.48.8.29.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>into</p></td>
<td class="parameter_description"><p>list to merge into</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>from</p></td>
<td class="parameter_description"><p>list to merge from</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>mode</p></td>
<td class="parameter_description"><p>the mode to use</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-merge"></a><h3>gst_tag_list_merge ()</h3>
<pre class="programlisting"><a class="link" href="GstTagList.html" title="GstTagList"><span class="returnvalue">GstTagList</span></a> *
gst_tag_list_merge (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list1</code></em>,
<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list2</code></em>,
<em class="parameter"><code><a class="link" href="GstTagList.html#GstTagMergeMode" title="enum GstTagMergeMode"><span class="type">GstTagMergeMode</span></a> mode</code></em>);</pre>
<p>Merges the two given lists into a new list. If one of the lists is <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, a
copy of the other is returned. If both lists are <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned.</p>
<p>Free-function: gst_tag_list_unref</p>
<div class="refsect3">
<a name="id-1.3.48.8.30.6"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list1</p></td>
<td class="parameter_description"><p> first list to merge. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>list2</p></td>
<td class="parameter_description"><p> second list to merge. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>mode</p></td>
<td class="parameter_description"><p>the mode to use</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.30.7"></a><h4>Returns</h4>
<p> the new list. </p>
<p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-get-tag-size"></a><h3>gst_tag_list_get_tag_size ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>
gst_tag_list_get_tag_size (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>);</pre>
<p>Checks how many value are stored in this tag list for the given tag.</p>
<div class="refsect3">
<a name="id-1.3.48.8.31.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a taglist</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>the tag to query</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.31.6"></a><h4>Returns</h4>
<p> The number of tags stored</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-n-tags"></a><h3>gst_tag_list_n_tags ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
gst_tag_list_n_tags (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>);</pre>
<p>Get the number of tags in <em class="parameter"><code>list</code></em>
.</p>
<div class="refsect3">
<a name="id-1.3.48.8.32.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>A <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.32.6"></a><h4>Returns</h4>
<p> The number of tags in <em class="parameter"><code>list</code></em>
.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-nth-tag-name"></a><h3>gst_tag_list_nth_tag_name ()</h3>
<pre class="programlisting">const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
gst_tag_list_nth_tag_name (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>);</pre>
<p>Get the name of the tag in <em class="parameter"><code>list</code></em>
at <em class="parameter"><code>index</code></em>
.</p>
<div class="refsect3">
<a name="id-1.3.48.8.33.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>A <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a>.</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>index</p></td>
<td class="parameter_description"><p>the index</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.33.6"></a><h4>Returns</h4>
<p> The name of the tag at <em class="parameter"><code>index</code></em>
.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-add"></a><h3>gst_tag_list_add ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gst_tag_list_add (<em class="parameter"><code><a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code><a class="link" href="GstTagList.html#GstTagMergeMode" title="enum GstTagMergeMode"><span class="type">GstTagMergeMode</span></a> mode</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code>...</code></em>);</pre>
<p>Sets the values for the given tags using the specified mode.</p>
<div class="refsect3">
<a name="id-1.3.48.8.34.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>list to set tags in</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>mode</p></td>
<td class="parameter_description"><p>the mode to use</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>...</p></td>
<td class="parameter_description"><p><a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated list of values to set</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-add-value"></a><h3>gst_tag_list_add_value ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gst_tag_list_add_value (<em class="parameter"><code><a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code><a class="link" href="GstTagList.html#GstTagMergeMode" title="enum GstTagMergeMode"><span class="type">GstTagMergeMode</span></a> mode</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *value</code></em>);</pre>
<p>Sets the GValue for a given tag using the specified mode.</p>
<div class="refsect3">
<a name="id-1.3.48.8.35.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>list to set tags in</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>mode</p></td>
<td class="parameter_description"><p>the mode to use</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p>GValue for this tag</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-add-values"></a><h3>gst_tag_list_add_values ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gst_tag_list_add_values (<em class="parameter"><code><a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code><a class="link" href="GstTagList.html#GstTagMergeMode" title="enum GstTagMergeMode"><span class="type">GstTagMergeMode</span></a> mode</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code>...</code></em>);</pre>
<p>Sets the GValues for the given tags using the specified mode.</p>
<div class="refsect3">
<a name="id-1.3.48.8.36.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>list to set tags in</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>mode</p></td>
<td class="parameter_description"><p>the mode to use</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>...</p></td>
<td class="parameter_description"><p>GValues to set</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-add-valist"></a><h3>gst_tag_list_add_valist ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gst_tag_list_add_valist (<em class="parameter"><code><a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code><a class="link" href="GstTagList.html#GstTagMergeMode" title="enum GstTagMergeMode"><span class="type">GstTagMergeMode</span></a> mode</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);</pre>
<p>Sets the values for the given tags using the specified mode.</p>
<div class="refsect3">
<a name="id-1.3.48.8.37.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>list to set tags in</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>mode</p></td>
<td class="parameter_description"><p>the mode to use</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>var_args</p></td>
<td class="parameter_description"><p>tag / value pairs to set</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-add-valist-values"></a><h3>gst_tag_list_add_valist_values ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gst_tag_list_add_valist_values (<em class="parameter"><code><a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code><a class="link" href="GstTagList.html#GstTagMergeMode" title="enum GstTagMergeMode"><span class="type">GstTagMergeMode</span></a> mode</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code><span class="type">va_list</span> var_args</code></em>);</pre>
<p>Sets the GValues for the given tags using the specified mode.</p>
<div class="refsect3">
<a name="id-1.3.48.8.38.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>list to set tags in</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>mode</p></td>
<td class="parameter_description"><p>the mode to use</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>var_args</p></td>
<td class="parameter_description"><p>tag / GValue pairs to set</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-remove-tag"></a><h3>gst_tag_list_remove_tag ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gst_tag_list_remove_tag (<em class="parameter"><code><a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>);</pre>
<p>Removes the given tag from the taglist.</p>
<div class="refsect3">
<a name="id-1.3.48.8.39.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>list to remove tag from</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag to remove</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-foreach"></a><h3>gst_tag_list_foreach ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gst_tag_list_foreach (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code><a class="link" href="GstTagList.html#GstTagForeachFunc" title="GstTagForeachFunc ()"><span class="type">GstTagForeachFunc</span></a> func</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
<p>Calls the given function for each tag inside the tag list. Note that if there
is no tag, the function won't be called at all.</p>
<div class="refsect3">
<a name="id-1.3.48.8.40.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>list to iterate over</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>func</p></td>
<td class="parameter_description"><p> function to be called for each tag. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p> user specified data. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="This parameter is a 'user_data', for callbacks; many bindings can pass NULL here."><span class="acronym">closure</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-get-value-index"></a><h3>gst_tag_list_get_value_index ()</h3>
<pre class="programlisting">const <a href="https://developer.gnome.org/gobject/unstable/gobject-Generic-values.html#GValue"><span class="returnvalue">GValue</span></a> *
gst_tag_list_get_value_index (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>);</pre>
<p>Gets the value that is at the given index for the given tag in the given
list.</p>
<div class="refsect3">
<a name="id-1.3.48.8.41.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>index</p></td>
<td class="parameter_description"><p>number of entry to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.41.6"></a><h4>Returns</h4>
<p> The GValue for the specified
entry or <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the tag wasn't available or the tag
doesn't have as many entries. </p>
<p><span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>]</span></p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-copy-value"></a><h3>gst_tag_list_copy_value ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gst_tag_list_copy_value (<em class="parameter"><code><a href="https://developer.gnome.org/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> *dest</code></em>,
<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>);</pre>
<p>Copies the contents for the given tag into the value,
merging multiple values into one if multiple values are associated
with the tag.
You must <a href="https://developer.gnome.org/gobject/unstable/gobject-Generic-values.html#g-value-unset"><code class="function">g_value_unset()</code></a> the value after use.</p>
<div class="refsect3">
<a name="id-1.3.48.8.42.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>dest</p></td>
<td class="parameter_description"><p> uninitialized <a href="https://developer.gnome.org/gobject/unstable/gobject-Generic-values.html#GValue"><span class="type">GValue</span></a> to copy into. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out caller-allocates</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>list to get the tag from</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.42.6"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if a value was copied, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the tag didn't exist in the
given list.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-get-boolean"></a><h3>gst_tag_list_get_boolean ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gst_tag_list_get_boolean (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> *value</code></em>);</pre>
<p>Copies the contents for the given tag into the value, merging multiple values
into one if multiple values are associated with the tag.</p>
<div class="refsect3">
<a name="id-1.3.48.8.43.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> to get the tag from</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p> location for the result. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.43.6"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if a value was copied, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the tag didn't exist in the
given list.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-get-boolean-index"></a><h3>gst_tag_list_get_boolean_index ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gst_tag_list_get_boolean_index (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> *value</code></em>);</pre>
<p>Gets the value that is at the given index for the given tag in the given
list.</p>
<div class="refsect3">
<a name="id-1.3.48.8.44.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> to get the tag from</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>index</p></td>
<td class="parameter_description"><p>number of entry to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p> location for the result. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.44.6"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if a value was copied, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the tag didn't exist in the
given list.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-get-int"></a><h3>gst_tag_list_get_int ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gst_tag_list_get_int (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *value</code></em>);</pre>
<p>Copies the contents for the given tag into the value, merging multiple values
into one if multiple values are associated with the tag.</p>
<div class="refsect3">
<a name="id-1.3.48.8.45.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> to get the tag from</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p> location for the result. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.45.6"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if a value was copied, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the tag didn't exist in the
given list.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-get-int-index"></a><h3>gst_tag_list_get_int_index ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gst_tag_list_get_int_index (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> *value</code></em>);</pre>
<p>Gets the value that is at the given index for the given tag in the given
list.</p>
<div class="refsect3">
<a name="id-1.3.48.8.46.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> to get the tag from</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>index</p></td>
<td class="parameter_description"><p>number of entry to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p> location for the result. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.46.6"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if a value was copied, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the tag didn't exist in the
given list.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-get-uint"></a><h3>gst_tag_list_get_uint ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gst_tag_list_get_uint (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *value</code></em>);</pre>
<p>Copies the contents for the given tag into the value, merging multiple values
into one if multiple values are associated with the tag.</p>
<div class="refsect3">
<a name="id-1.3.48.8.47.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> to get the tag from</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p> location for the result. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.47.6"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if a value was copied, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the tag didn't exist in the
given list.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-get-uint-index"></a><h3>gst_tag_list_get_uint_index ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gst_tag_list_get_uint_index (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *value</code></em>);</pre>
<p>Gets the value that is at the given index for the given tag in the given
list.</p>
<div class="refsect3">
<a name="id-1.3.48.8.48.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> to get the tag from</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>index</p></td>
<td class="parameter_description"><p>number of entry to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p> location for the result. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.48.6"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if a value was copied, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the tag didn't exist in the
given list.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-get-int64"></a><h3>gst_tag_list_get_int64 ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gst_tag_list_get_int64 (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> *value</code></em>);</pre>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-get-int64-index"></a><h3>gst_tag_list_get_int64_index ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gst_tag_list_get_int64_index (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gint64"><span class="type">gint64</span></a> *value</code></em>);</pre>
<p>Gets the value that is at the given index for the given tag in the given
list.</p>
<div class="refsect3">
<a name="id-1.3.48.8.50.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> to get the tag from</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>index</p></td>
<td class="parameter_description"><p>number of entry to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p> location for the result. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.50.6"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if a value was copied, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the tag didn't exist in the
given list.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-get-uint64"></a><h3>gst_tag_list_get_uint64 ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gst_tag_list_get_uint64 (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint64"><span class="type">guint64</span></a> *value</code></em>);</pre>
<p>Copies the contents for the given tag into the value, merging multiple values
into one if multiple values are associated with the tag.</p>
<div class="refsect3">
<a name="id-1.3.48.8.51.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> to get the tag from</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p> location for the result. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.51.6"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if a value was copied, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the tag didn't exist in the
given list.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-get-uint64-index"></a><h3>gst_tag_list_get_uint64_index ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gst_tag_list_get_uint64_index (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint64"><span class="type">guint64</span></a> *value</code></em>);</pre>
<p>Gets the value that is at the given index for the given tag in the given
list.</p>
<div class="refsect3">
<a name="id-1.3.48.8.52.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> to get the tag from</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>index</p></td>
<td class="parameter_description"><p>number of entry to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p> location for the result. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.52.6"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if a value was copied, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the tag didn't exist in the
given list.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-get-float"></a><h3>gst_tag_list_get_float ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gst_tag_list_get_float (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> *value</code></em>);</pre>
<p>Copies the contents for the given tag into the value, merging multiple values
into one if multiple values are associated with the tag.</p>
<div class="refsect3">
<a name="id-1.3.48.8.53.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> to get the tag from</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p> location for the result. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.53.6"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if a value was copied, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the tag didn't exist in the
given list.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-get-float-index"></a><h3>gst_tag_list_get_float_index ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gst_tag_list_get_float_index (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gfloat"><span class="type">gfloat</span></a> *value</code></em>);</pre>
<p>Gets the value that is at the given index for the given tag in the given
list.</p>
<div class="refsect3">
<a name="id-1.3.48.8.54.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> to get the tag from</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>index</p></td>
<td class="parameter_description"><p>number of entry to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p> location for the result. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.54.6"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if a value was copied, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the tag didn't exist in the
given list.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-get-double"></a><h3>gst_tag_list_get_double ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gst_tag_list_get_double (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *value</code></em>);</pre>
<p>Copies the contents for the given tag into the value, merging multiple values
into one if multiple values are associated with the tag.</p>
<div class="refsect3">
<a name="id-1.3.48.8.55.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> to get the tag from</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p> location for the result. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.55.6"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if a value was copied, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the tag didn't exist in the
given list.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-get-double-index"></a><h3>gst_tag_list_get_double_index ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gst_tag_list_get_double_index (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *value</code></em>);</pre>
<p>Gets the value that is at the given index for the given tag in the given
list.</p>
<div class="refsect3">
<a name="id-1.3.48.8.56.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> to get the tag from</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>index</p></td>
<td class="parameter_description"><p>number of entry to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p> location for the result. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.56.6"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if a value was copied, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the tag didn't exist in the
given list.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-get-string"></a><h3>gst_tag_list_get_string ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gst_tag_list_get_string (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **value</code></em>);</pre>
<p>Copies the contents for the given tag into the value, possibly merging
multiple values into one if multiple values are associated with the tag.</p>
<p>Use gst_tag_list_get_string_index (list, tag, 0, value) if you want
to retrieve the first string associated with this tag unmodified.</p>
<p>The resulting string in <em class="parameter"><code>value</code></em>
will be in UTF-8 encoding and should be
freed by the caller using g_free when no longer needed. The
returned string is also guaranteed to be non-<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> and non-empty.</p>
<p>Free-function: g_free</p>
<div class="refsect3">
<a name="id-1.3.48.8.57.8"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> to get the tag from</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p> location for the result. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out callee-allocates</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.57.9"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if a value was copied, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the tag didn't exist in the
given list.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-get-string-index"></a><h3>gst_tag_list_get_string_index ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gst_tag_list_get_string_index (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **value</code></em>);</pre>
<p>Gets the value that is at the given index for the given tag in the given
list.</p>
<p>The resulting string in <em class="parameter"><code>value</code></em>
will be in UTF-8 encoding and should be
freed by the caller using g_free when no longer needed. The
returned string is also guaranteed to be non-<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> and non-empty.</p>
<p>Free-function: g_free</p>
<div class="refsect3">
<a name="id-1.3.48.8.58.7"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> to get the tag from</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>index</p></td>
<td class="parameter_description"><p>number of entry to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p> location for the result. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out callee-allocates</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.58.8"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if a value was copied, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the tag didn't exist in the
given list.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-peek-string-index"></a><h3>gst_tag_list_peek_string_index ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gst_tag_list_peek_string_index (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **value</code></em>);</pre>
<p>Peeks at the value that is at the given index for the given tag in the given
list.</p>
<p>The resulting string in <em class="parameter"><code>value</code></em>
will be in UTF-8 encoding and doesn't need
to be freed by the caller. The returned string is also guaranteed to
be non-<a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> and non-empty.</p>
<div class="refsect3">
<a name="id-1.3.48.8.59.6"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> to get the tag from</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>index</p></td>
<td class="parameter_description"><p>number of entry to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p> location for the result. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.59.7"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if a value was set, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the tag didn't exist in the
given list.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-get-pointer"></a><h3>gst_tag_list_get_pointer ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gst_tag_list_get_pointer (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> *value</code></em>);</pre>
<p>Copies the contents for the given tag into the value, merging multiple values
into one if multiple values are associated with the tag.</p>
<div class="refsect3">
<a name="id-1.3.48.8.60.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> to get the tag from</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p> location for the result. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.60.6"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if a value was copied, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the tag didn't exist in the
given list.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-get-pointer-index"></a><h3>gst_tag_list_get_pointer_index ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gst_tag_list_get_pointer_index (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> *value</code></em>);</pre>
<p>Gets the value that is at the given index for the given tag in the given
list.</p>
<div class="refsect3">
<a name="id-1.3.48.8.61.5"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> to get the tag from</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>index</p></td>
<td class="parameter_description"><p>number of entry to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p> location for the result. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.61.6"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if a value was copied, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the tag didn't exist in the
given list.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-get-date"></a><h3>gst_tag_list_get_date ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gst_tag_list_get_date (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> **value</code></em>);</pre>
<p>Copies the first date for the given tag in the taglist into the variable
pointed to by <em class="parameter"><code>value</code></em>
. Free the date with <a href="https://developer.gnome.org/glib/unstable/glib-Date-and-Time-Functions.html#g-date-free"><code class="function">g_date_free()</code></a> when it is no longer
needed.</p>
<p>Free-function: g_date_free</p>
<div class="refsect3">
<a name="id-1.3.48.8.62.6"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> to get the tag from</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p> address of a GDate pointer
variable to store the result into. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out callee-allocates</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.62.7"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if a date was copied, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the tag didn't exist in the
given list or if it was <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-get-date-index"></a><h3>gst_tag_list_get_date_index ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gst_tag_list_get_date_index (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> **value</code></em>);</pre>
<p>Gets the date that is at the given index for the given tag in the given
list and copies it into the variable pointed to by <em class="parameter"><code>value</code></em>
. Free the date
with <a href="https://developer.gnome.org/glib/unstable/glib-Date-and-Time-Functions.html#g-date-free"><code class="function">g_date_free()</code></a> when it is no longer needed.</p>
<p>Free-function: g_date_free</p>
<div class="refsect3">
<a name="id-1.3.48.8.63.6"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> to get the tag from</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>index</p></td>
<td class="parameter_description"><p>number of entry to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p> location for the result. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out callee-allocates</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.63.7"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if a value was copied, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the tag didn't exist in the
given list or if it was <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-get-date-time"></a><h3>gst_tag_list_get_date_time ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gst_tag_list_get_date_time (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code><a class="link" href="GstDateTime.html" title="GstDateTime"><span class="type">GstDateTime</span></a> **value</code></em>);</pre>
<p>Copies the first datetime for the given tag in the taglist into the variable
pointed to by <em class="parameter"><code>value</code></em>
. Unref the date with <a class="link" href="GstDateTime.html#gst-date-time-unref" title="gst_date_time_unref ()"><code class="function">gst_date_time_unref()</code></a> when
it is no longer needed.</p>
<p>Free-function: gst_date_time_unref</p>
<div class="refsect3">
<a name="id-1.3.48.8.64.6"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> to get the tag from</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p> address of a <a class="link" href="GstDateTime.html" title="GstDateTime"><span class="type">GstDateTime</span></a>
pointer variable to store the result into. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out callee-allocates</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.64.7"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if a datetime was copied, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the tag didn't exist in
the given list or if it was <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-get-date-time-index"></a><h3>gst_tag_list_get_date_time_index ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gst_tag_list_get_date_time_index (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>,
<em class="parameter"><code><a class="link" href="GstDateTime.html" title="GstDateTime"><span class="type">GstDateTime</span></a> **value</code></em>);</pre>
<p>Gets the datetime that is at the given index for the given tag in the given
list and copies it into the variable pointed to by <em class="parameter"><code>value</code></em>
. Unref the datetime
with <a class="link" href="GstDateTime.html#gst-date-time-unref" title="gst_date_time_unref ()"><code class="function">gst_date_time_unref()</code></a> when it is no longer needed.</p>
<p>Free-function: gst_date_time_unref</p>
<div class="refsect3">
<a name="id-1.3.48.8.65.6"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> to get the tag from</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>index</p></td>
<td class="parameter_description"><p>number of entry to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>value</p></td>
<td class="parameter_description"><p> location for the result. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out callee-allocates</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.65.7"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if a value was copied, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the tag didn't exist in the
given list or if it was <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-get-sample"></a><h3>gst_tag_list_get_sample ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gst_tag_list_get_sample (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code><a class="link" href="GstSample.html" title="GstSample"><span class="type">GstSample</span></a> **sample</code></em>);</pre>
<p>Copies the first sample for the given tag in the taglist into the variable
pointed to by <em class="parameter"><code>sample</code></em>
. Free the sample with <a class="link" href="GstSample.html#gst-sample-unref" title="gst_sample_unref ()"><code class="function">gst_sample_unref()</code></a> when it is
no longer needed. You can retrieve the buffer from the sample using
<a class="link" href="GstSample.html#gst-sample-get-buffer" title="gst_sample_get_buffer ()"><code class="function">gst_sample_get_buffer()</code></a> and the associated caps (if any) with
<a class="link" href="GstSample.html#gst-sample-get-caps" title="gst_sample_get_caps ()"><code class="function">gst_sample_get_caps()</code></a>.</p>
<p>Free-function: gst_sample_unref</p>
<div class="refsect3">
<a name="id-1.3.48.8.66.6"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> to get the tag from</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>sample</p></td>
<td class="parameter_description"><p> address of a GstSample
pointer variable to store the result into. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out callee-allocates</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.66.7"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if a sample was returned, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the tag didn't exist in
the given list or if it was <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
</div>
</div>
<hr>
<div class="refsect2">
<a name="gst-tag-list-get-sample-index"></a><h3>gst_tag_list_get_sample_index ()</h3>
<pre class="programlisting"><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
gst_tag_list_get_sample_index (<em class="parameter"><code>const <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> *list</code></em>,
<em class="parameter"><code>const <a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *tag</code></em>,
<em class="parameter"><code><a href="https://developer.gnome.org/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> index</code></em>,
<em class="parameter"><code><a class="link" href="GstSample.html" title="GstSample"><span class="type">GstSample</span></a> **sample</code></em>);</pre>
<p>Gets the sample that is at the given index for the given tag in the given
list and copies it into the variable pointed to by <em class="parameter"><code>sample</code></em>
. Free the sample
with <a class="link" href="GstSample.html#gst-sample-unref" title="gst_sample_unref ()"><code class="function">gst_sample_unref()</code></a> when it is no longer needed. You can retrieve the
buffer from the sample using <a class="link" href="GstSample.html#gst-sample-get-buffer" title="gst_sample_get_buffer ()"><code class="function">gst_sample_get_buffer()</code></a> and the associated
caps (if any) with <a class="link" href="GstSample.html#gst-sample-get-caps" title="gst_sample_get_caps ()"><code class="function">gst_sample_get_caps()</code></a>.</p>
<p>Free-function: gst_sample_unref</p>
<div class="refsect3">
<a name="id-1.3.48.8.67.6"></a><h4>Parameters</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>list</p></td>
<td class="parameter_description"><p>a <a class="link" href="GstTagList.html" title="GstTagList"><span class="type">GstTagList</span></a> to get the tag from</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tag</p></td>
<td class="parameter_description"><p>tag to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>index</p></td>
<td class="parameter_description"><p>number of entry to read out</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>sample</p></td>
<td class="parameter_description"><p> address of a GstSample
pointer variable to store the result into. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Out parameter, where caller must allocate storage."><span class="acronym">out callee-allocates</span></acronym>][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="id-1.3.48.8.67.7"></a><h4>Returns</h4>
<p> <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, if a sample was copied, <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if the tag didn't exist in the
given list or if it was <a href="https://developer.gnome.org/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
</div>
</div>
</div>
<div class="refsect1">
<a name="GstTagList.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="GstTagList-struct"></a><h3>struct GstTagList</h3>
<pre class="programlisting">struct GstTagList {
GstMiniObject mini_object;
};
</pre>
<p>Object describing tags / metadata.</p>
<div class="refsect3">
<a name="id-1.3.48.9.2.5"></a><h4>Members</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="300px" class="struct_members_name">
<col class="struct_members_description">
<col width="200px" class="struct_members_annotations">
</colgroup>
<tbody><tr>
<td class="struct_member_name"><p><a class="link" href="gstreamer-GstMiniObject.html#GstMiniObject" title="struct GstMiniObject"><span class="type">GstMiniObject</span></a> <em class="structfield"><code><a name="GstTagList-struct.mini-object"></a>mini_object</code></em>;</p></td>
<td class="struct_member_description"><p>the parent type</p></td>
<td class="struct_member_annotations"> </td>
</tr></tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="GstTagMergeMode"></a><h3>enum GstTagMergeMode</h3>
<p>The different tag merging modes are basically replace, overwrite and append,
but they can be seen from two directions. Given two taglists: (A) the tags
already in the element and (B) the ones that are supplied to the element (
e.g. via <a class="link" href="GstTagSetter.html#gst-tag-setter-merge-tags" title="gst_tag_setter_merge_tags ()"><code class="function">gst_tag_setter_merge_tags()</code></a> / <a class="link" href="GstTagSetter.html#gst-tag-setter-add-tags" title="gst_tag_setter_add_tags ()"><code class="function">gst_tag_setter_add_tags()</code></a> or a
<a class="link" href="GstEvent.html#GST-EVENT-TAG:CAPS"><code class="literal">GST_EVENT_TAG</code></a>), how are these tags merged?
In the table below this is shown for the cases that a tag exists in the list
(A) or does not exists (!A) and combinations thereof.</p>
<div class="table">
<a name="id-1.3.48.9.3.4"></a><p class="title"><b>Table 1. merge mode</b></p>
<div class="table-contents"><table summary="merge mode" border="1">
<colgroup>
<col>
<col>
<col>
<col>
<col>
</colgroup>
<thead><tr>
<th align="left">merge mode</th>
<th align="left">A + B</th>
<th align="left">A + !B</th>
<th align="left">!A + B</th>
<th align="left">!A + !B</th>
</tr></thead>
<tbody>
<tr>
<td align="left">REPLACE_ALL</td>
<td align="left">B</td>
<td align="left">-</td>
<td align="left">B</td>
<td align="left">-</td>
</tr>
<tr>
<td align="left">REPLACE</td>
<td align="left">B</td>
<td align="left">A</td>
<td align="left">B</td>
<td align="left">-</td>
</tr>
<tr>
<td align="left">APPEND</td>
<td align="left">A, B</td>
<td align="left">A</td>
<td align="left">B</td>
<td align="left">-</td>
</tr>
<tr>
<td align="left">PREPEND</td>
<td align="left">B, A</td>
<td align="left">A</td>
<td align="left">B</td>
<td align="left">-</td>
</tr>
<tr>
<td align="left">KEEP</td>
<td align="left">A</td>
<td align="left">A</td>
<td align="left">B</td>
<td align="left">-</td>
</tr>
<tr>
<td align="left">KEEP_ALL</td>
<td align="left">A</td>
<td align="left">A</td>
<td align="left">-</td>
<td align="left">-</td>
</tr>
</tbody>
</table></div>
</div>
<br class="table-break"><div class="refsect3">
<a name="id-1.3.48.9.3.5"></a><h4>Members</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="300px" class="enum_members_name">
<col class="enum_members_description">
<col width="200px" class="enum_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="enum_member_name"><p><a name="GST-TAG-MERGE-UNDEFINED:CAPS"></a>GST_TAG_MERGE_UNDEFINED</p></td>
<td class="enum_member_description">
<p>undefined merge mode</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GST-TAG-MERGE-REPLACE-ALL:CAPS"></a>GST_TAG_MERGE_REPLACE_ALL</p></td>
<td class="enum_member_description">
<p>replace all tags (clear list and append)</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GST-TAG-MERGE-REPLACE:CAPS"></a>GST_TAG_MERGE_REPLACE</p></td>
<td class="enum_member_description">
<p>replace tags</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GST-TAG-MERGE-APPEND:CAPS"></a>GST_TAG_MERGE_APPEND</p></td>
<td class="enum_member_description">
<p>append tags</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GST-TAG-MERGE-PREPEND:CAPS"></a>GST_TAG_MERGE_PREPEND</p></td>
<td class="enum_member_description">
<p>prepend tags</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GST-TAG-MERGE-KEEP:CAPS"></a>GST_TAG_MERGE_KEEP</p></td>
<td class="enum_member_description">
<p>keep existing tags</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GST-TAG-MERGE-KEEP-ALL:CAPS"></a>GST_TAG_MERGE_KEEP_ALL</p></td>
<td class="enum_member_description">
<p>keep all existing tags</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GST-TAG-MERGE-COUNT:CAPS"></a>GST_TAG_MERGE_COUNT</p></td>
<td class="enum_member_description">
<p>the number of merge modes</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="GstTagFlag"></a><h3>enum GstTagFlag</h3>
<p>Extra tag flags used when registering tags.</p>
<div class="refsect3">
<a name="id-1.3.48.9.4.4"></a><h4>Members</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="300px" class="enum_members_name">
<col class="enum_members_description">
<col width="200px" class="enum_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="enum_member_name"><p><a name="GST-TAG-FLAG-UNDEFINED:CAPS"></a>GST_TAG_FLAG_UNDEFINED</p></td>
<td class="enum_member_description">
<p>undefined flag</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GST-TAG-FLAG-META:CAPS"></a>GST_TAG_FLAG_META</p></td>
<td class="enum_member_description">
<p>tag is meta data</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GST-TAG-FLAG-ENCODED:CAPS"></a>GST_TAG_FLAG_ENCODED</p></td>
<td class="enum_member_description">
<p>tag is encoded</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GST-TAG-FLAG-DECODED:CAPS"></a>GST_TAG_FLAG_DECODED</p></td>
<td class="enum_member_description">
<p>tag is decoded</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GST-TAG-FLAG-COUNT:CAPS"></a>GST_TAG_FLAG_COUNT</p></td>
<td class="enum_member_description">
<p>number of tag flags</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="GstTagScope"></a><h3>enum GstTagScope</h3>
<p>GstTagScope specifies if a taglist applies to the complete
medium or only to one single stream.</p>
<div class="refsect3">
<a name="id-1.3.48.9.5.4"></a><h4>Members</h4>
<div class="informaltable"><table width="100%" border="0">
<colgroup>
<col width="300px" class="enum_members_name">
<col class="enum_members_description">
<col width="200px" class="enum_members_annotations">
</colgroup>
<tbody>
<tr>
<td class="enum_member_name"><p><a name="GST-TAG-SCOPE-STREAM:CAPS"></a>GST_TAG_SCOPE_STREAM</p></td>
<td class="enum_member_description">
<p>tags specific to this single stream</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
<tr>
<td class="enum_member_name"><p><a name="GST-TAG-SCOPE-GLOBAL:CAPS"></a>GST_TAG_SCOPE_GLOBAL</p></td>
<td class="enum_member_description">
<p>global tags for the complete medium</p>
</td>
<td class="enum_member_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-TITLE:CAPS"></a><h3>GST_TAG_TITLE</h3>
<pre class="programlisting">#define GST_TAG_TITLE "title"
</pre>
<p>commonly used title (string)</p>
<p>The title as it should be displayed, e.g. 'The Doll House'</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-TITLE-SORTNAME:CAPS"></a><h3>GST_TAG_TITLE_SORTNAME</h3>
<pre class="programlisting">#define GST_TAG_TITLE_SORTNAME "title-sortname"
</pre>
<p>commonly used title, as used for sorting (string)</p>
<p>The title as it should be sorted, e.g. 'Doll House, The'</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-ARTIST:CAPS"></a><h3>GST_TAG_ARTIST</h3>
<pre class="programlisting">#define GST_TAG_ARTIST "artist"
</pre>
<p>person(s) responsible for the recording (string)</p>
<p>The artist name as it should be displayed, e.g. 'Jimi Hendrix' or
'The Guitar Heroes'</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-ARTIST-SORTNAME:CAPS"></a><h3>GST_TAG_ARTIST_SORTNAME</h3>
<pre class="programlisting">#define GST_TAG_ARTIST_SORTNAME "artist-sortname"
</pre>
<p>person(s) responsible for the recording, as used for sorting (string)</p>
<p>The artist name as it should be sorted, e.g. 'Hendrix, Jimi' or
'Guitar Heroes, The'</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-ALBUM:CAPS"></a><h3>GST_TAG_ALBUM</h3>
<pre class="programlisting">#define GST_TAG_ALBUM "album"
</pre>
<p>album containing this data (string)</p>
<p>The album name as it should be displayed, e.g. 'The Jazz Guitar'</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-ALBUM-SORTNAME:CAPS"></a><h3>GST_TAG_ALBUM_SORTNAME</h3>
<pre class="programlisting">#define GST_TAG_ALBUM_SORTNAME "album-sortname"
</pre>
<p>album containing this data, as used for sorting (string)</p>
<p>The album name as it should be sorted, e.g. 'Jazz Guitar, The'</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-ALBUM-ARTIST:CAPS"></a><h3>GST_TAG_ALBUM_ARTIST</h3>
<pre class="programlisting">#define GST_TAG_ALBUM_ARTIST "album-artist"
</pre>
<p>The artist of the entire album, as it should be displayed.</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-ALBUM-ARTIST-SORTNAME:CAPS"></a><h3>GST_TAG_ALBUM_ARTIST_SORTNAME</h3>
<pre class="programlisting">#define GST_TAG_ALBUM_ARTIST_SORTNAME "album-artist-sortname"
</pre>
<p>The artist of the entire album, as it should be sorted.</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-DATE:CAPS"></a><h3>GST_TAG_DATE</h3>
<pre class="programlisting">#define GST_TAG_DATE "date"
</pre>
<p>date the data was created (<a href="https://developer.gnome.org/glib/unstable/glib-Date-and-Time-Functions.html#GDate"><span class="type">GDate</span></a> structure)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-DATE-TIME:CAPS"></a><h3>GST_TAG_DATE_TIME</h3>
<pre class="programlisting">#define GST_TAG_DATE_TIME "datetime"
</pre>
<p>date and time the data was created (<a class="link" href="GstDateTime.html" title="GstDateTime"><span class="type">GstDateTime</span></a> structure)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-GENRE:CAPS"></a><h3>GST_TAG_GENRE</h3>
<pre class="programlisting">#define GST_TAG_GENRE "genre"
</pre>
<p>genre this data belongs to (string)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-COMMENT:CAPS"></a><h3>GST_TAG_COMMENT</h3>
<pre class="programlisting">#define GST_TAG_COMMENT "comment"
</pre>
<p>free text commenting the data (string)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-EXTENDED-COMMENT:CAPS"></a><h3>GST_TAG_EXTENDED_COMMENT</h3>
<pre class="programlisting">#define GST_TAG_EXTENDED_COMMENT "extended-comment"
</pre>
<p>key/value text commenting the data (string)</p>
<p>Must be in the form of 'key=comment' or
'key[lc]=comment' where 'lc' is an ISO-639
language code.</p>
<p>This tag is used for unknown Vorbis comment tags,
unknown APE tags and certain ID3v2 comment fields.</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-TRACK-NUMBER:CAPS"></a><h3>GST_TAG_TRACK_NUMBER</h3>
<pre class="programlisting">#define GST_TAG_TRACK_NUMBER "track-number"
</pre>
<p>track number inside a collection (unsigned integer)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-TRACK-COUNT:CAPS"></a><h3>GST_TAG_TRACK_COUNT</h3>
<pre class="programlisting">#define GST_TAG_TRACK_COUNT "track-count"
</pre>
<p>count of tracks inside collection this track belongs to (unsigned integer)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-ALBUM-VOLUME-NUMBER:CAPS"></a><h3>GST_TAG_ALBUM_VOLUME_NUMBER</h3>
<pre class="programlisting">#define GST_TAG_ALBUM_VOLUME_NUMBER "album-disc-number"
</pre>
<p>disc number inside a collection (unsigned integer)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-ALBUM-VOLUME-COUNT:CAPS"></a><h3>GST_TAG_ALBUM_VOLUME_COUNT</h3>
<pre class="programlisting">#define GST_TAG_ALBUM_VOLUME_COUNT "album-disc-count"
</pre>
<p>count of discs inside collection this disc belongs to (unsigned integer)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-LOCATION:CAPS"></a><h3>GST_TAG_LOCATION</h3>
<pre class="programlisting">#define GST_TAG_LOCATION "location"
</pre>
<p>Origin of media as a URI (location, where the original of the file or stream
is hosted) (string)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-HOMEPAGE:CAPS"></a><h3>GST_TAG_HOMEPAGE</h3>
<pre class="programlisting">#define GST_TAG_HOMEPAGE "homepage"
</pre>
<p>Homepage for this media (i.e. artist or movie homepage) (string)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-DESCRIPTION:CAPS"></a><h3>GST_TAG_DESCRIPTION</h3>
<pre class="programlisting">#define GST_TAG_DESCRIPTION "description"
</pre>
<p>short text describing the content of the data (string)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-VERSION:CAPS"></a><h3>GST_TAG_VERSION</h3>
<pre class="programlisting">#define GST_TAG_VERSION "version"
</pre>
<p>version of this data (string)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-ISRC:CAPS"></a><h3>GST_TAG_ISRC</h3>
<pre class="programlisting">#define GST_TAG_ISRC "isrc"
</pre>
<p>International Standard Recording Code - see http://www.ifpi.org/isrc/ (string)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-ORGANIZATION:CAPS"></a><h3>GST_TAG_ORGANIZATION</h3>
<pre class="programlisting">#define GST_TAG_ORGANIZATION "organization"
</pre>
<p>organization (string)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-COPYRIGHT:CAPS"></a><h3>GST_TAG_COPYRIGHT</h3>
<pre class="programlisting">#define GST_TAG_COPYRIGHT "copyright"
</pre>
<p>copyright notice of the data (string)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-COPYRIGHT-URI:CAPS"></a><h3>GST_TAG_COPYRIGHT_URI</h3>
<pre class="programlisting">#define GST_TAG_COPYRIGHT_URI "copyright-uri"
</pre>
<p>URI to location where copyright details can be found (string)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-ENCODED-BY:CAPS"></a><h3>GST_TAG_ENCODED_BY</h3>
<pre class="programlisting">#define GST_TAG_ENCODED_BY "encoded-by"
</pre>
<p>name of the person or organisation that encoded the file. May contain a
copyright message if the person or organisation also holds the copyright
(string)</p>
<p>Note: do not use this field to describe the encoding application. Use
<a class="link" href="GstTagList.html#GST-TAG-APPLICATION-NAME:CAPS" title="GST_TAG_APPLICATION_NAME"><span class="type">GST_TAG_APPLICATION_NAME</span></a> or <a class="link" href="GstTagList.html#GST-TAG-COMMENT:CAPS" title="GST_TAG_COMMENT"><span class="type">GST_TAG_COMMENT</span></a> for that.</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-COMPOSER:CAPS"></a><h3>GST_TAG_COMPOSER</h3>
<pre class="programlisting">#define GST_TAG_COMPOSER "composer"
</pre>
<p>person(s) who composed the recording (string)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-CONTACT:CAPS"></a><h3>GST_TAG_CONTACT</h3>
<pre class="programlisting">#define GST_TAG_CONTACT "contact"
</pre>
<p>contact information (string)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-LICENSE:CAPS"></a><h3>GST_TAG_LICENSE</h3>
<pre class="programlisting">#define GST_TAG_LICENSE "license"
</pre>
<p>license of data (string)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-LICENSE-URI:CAPS"></a><h3>GST_TAG_LICENSE_URI</h3>
<pre class="programlisting">#define GST_TAG_LICENSE_URI "license-uri"
</pre>
<p>URI to location where license details can be found (string)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-PERFORMER:CAPS"></a><h3>GST_TAG_PERFORMER</h3>
<pre class="programlisting">#define GST_TAG_PERFORMER "performer"
</pre>
<p>person(s) performing (string)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-DURATION:CAPS"></a><h3>GST_TAG_DURATION</h3>
<pre class="programlisting">#define GST_TAG_DURATION "duration"
</pre>
<p>length in GStreamer time units (nanoseconds) (unsigned 64-bit integer)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-CODEC:CAPS"></a><h3>GST_TAG_CODEC</h3>
<pre class="programlisting">#define GST_TAG_CODEC "codec"
</pre>
<p>codec the data is stored in (string)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-VIDEO-CODEC:CAPS"></a><h3>GST_TAG_VIDEO_CODEC</h3>
<pre class="programlisting">#define GST_TAG_VIDEO_CODEC "video-codec"
</pre>
<p>codec the video data is stored in (string)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-AUDIO-CODEC:CAPS"></a><h3>GST_TAG_AUDIO_CODEC</h3>
<pre class="programlisting">#define GST_TAG_AUDIO_CODEC "audio-codec"
</pre>
<p>codec the audio data is stored in (string)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-SUBTITLE-CODEC:CAPS"></a><h3>GST_TAG_SUBTITLE_CODEC</h3>
<pre class="programlisting">#define GST_TAG_SUBTITLE_CODEC "subtitle-codec"
</pre>
<p>codec/format the subtitle data is stored in (string)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-CONTAINER-FORMAT:CAPS"></a><h3>GST_TAG_CONTAINER_FORMAT</h3>
<pre class="programlisting">#define GST_TAG_CONTAINER_FORMAT "container-format"
</pre>
<p>container format the data is stored in (string)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-BITRATE:CAPS"></a><h3>GST_TAG_BITRATE</h3>
<pre class="programlisting">#define GST_TAG_BITRATE "bitrate"
</pre>
<p>exact or average bitrate in bits/s (unsigned integer)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-NOMINAL-BITRATE:CAPS"></a><h3>GST_TAG_NOMINAL_BITRATE</h3>
<pre class="programlisting">#define GST_TAG_NOMINAL_BITRATE "nominal-bitrate"
</pre>
<p>nominal bitrate in bits/s (unsigned integer). The actual bitrate might be
different from this target bitrate.</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-MINIMUM-BITRATE:CAPS"></a><h3>GST_TAG_MINIMUM_BITRATE</h3>
<pre class="programlisting">#define GST_TAG_MINIMUM_BITRATE "minimum-bitrate"
</pre>
<p>minimum bitrate in bits/s (unsigned integer)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-MAXIMUM-BITRATE:CAPS"></a><h3>GST_TAG_MAXIMUM_BITRATE</h3>
<pre class="programlisting">#define GST_TAG_MAXIMUM_BITRATE "maximum-bitrate"
</pre>
<p>maximum bitrate in bits/s (unsigned integer)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-SERIAL:CAPS"></a><h3>GST_TAG_SERIAL</h3>
<pre class="programlisting">#define GST_TAG_SERIAL "serial"
</pre>
<p>serial number of track (unsigned integer)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-ENCODER:CAPS"></a><h3>GST_TAG_ENCODER</h3>
<pre class="programlisting">#define GST_TAG_ENCODER "encoder"
</pre>
<p>encoder used to encode this stream (string)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-ENCODER-VERSION:CAPS"></a><h3>GST_TAG_ENCODER_VERSION</h3>
<pre class="programlisting">#define GST_TAG_ENCODER_VERSION "encoder-version"
</pre>
<p>version of the encoder used to encode this stream (unsigned integer)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-TRACK-GAIN:CAPS"></a><h3>GST_TAG_TRACK_GAIN</h3>
<pre class="programlisting">#define GST_TAG_TRACK_GAIN "replaygain-track-gain"
</pre>
<p>track gain in db (double)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-TRACK-PEAK:CAPS"></a><h3>GST_TAG_TRACK_PEAK</h3>
<pre class="programlisting">#define GST_TAG_TRACK_PEAK "replaygain-track-peak"
</pre>
<p>peak of the track (double)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-ALBUM-GAIN:CAPS"></a><h3>GST_TAG_ALBUM_GAIN</h3>
<pre class="programlisting">#define GST_TAG_ALBUM_GAIN "replaygain-album-gain"
</pre>
<p>album gain in db (double)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-ALBUM-PEAK:CAPS"></a><h3>GST_TAG_ALBUM_PEAK</h3>
<pre class="programlisting">#define GST_TAG_ALBUM_PEAK "replaygain-album-peak"
</pre>
<p>peak of the album (double)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-REFERENCE-LEVEL:CAPS"></a><h3>GST_TAG_REFERENCE_LEVEL</h3>
<pre class="programlisting">#define GST_TAG_REFERENCE_LEVEL "replaygain-reference-level"
</pre>
<p>reference level of track and album gain values (double)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-LANGUAGE-CODE:CAPS"></a><h3>GST_TAG_LANGUAGE_CODE</h3>
<pre class="programlisting">#define GST_TAG_LANGUAGE_CODE "language-code"
</pre>
<p>ISO-639-2 or ISO-639-1 code for the language the content is in (string)</p>
<p>There is utility API in libgsttag in gst-plugins-base to obtain a translated
language name from the language code: <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base-libs/html/gst-plugins-base-libs-gsttaglanguagecodes.html#gst-tag-get-language-name"><code class="function">gst_tag_get_language_name()</code></a></p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-LANGUAGE-NAME:CAPS"></a><h3>GST_TAG_LANGUAGE_NAME</h3>
<pre class="programlisting">#define GST_TAG_LANGUAGE_NAME "language-name"
</pre>
<p>Name of the language the content is in (string)</p>
<p>Free-form name of the language the content is in, if a language code
is not available. This tag should not be set in addition to a language
code. It is undefined what language or locale the language name is in.</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-IMAGE:CAPS"></a><h3>GST_TAG_IMAGE</h3>
<pre class="programlisting">#define GST_TAG_IMAGE "image"
</pre>
<p>image (sample) (sample taglist should specify the content type and preferably
also set "image-type" field as <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base-libs/html/gst-plugins-base-libs-gsttag.html#GstTagImageType"><span class="type">GstTagImageType</span></a>)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-PREVIEW-IMAGE:CAPS"></a><h3>GST_TAG_PREVIEW_IMAGE</h3>
<pre class="programlisting">#define GST_TAG_PREVIEW_IMAGE "preview-image"
</pre>
<p>image that is meant for preview purposes, e.g. small icon-sized version
(sample) (sample taglist should specify the content type)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-ATTACHMENT:CAPS"></a><h3>GST_TAG_ATTACHMENT</h3>
<pre class="programlisting">#define GST_TAG_ATTACHMENT "attachment"
</pre>
<p>generic file attachment (sample) (sample taglist should specify the content
type and if possible set "filename" to the file name of the
attachment)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-BEATS-PER-MINUTE:CAPS"></a><h3>GST_TAG_BEATS_PER_MINUTE</h3>
<pre class="programlisting">#define GST_TAG_BEATS_PER_MINUTE "beats-per-minute"
</pre>
<p>number of beats per minute in audio (double)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-KEYWORDS:CAPS"></a><h3>GST_TAG_KEYWORDS</h3>
<pre class="programlisting">#define GST_TAG_KEYWORDS "keywords"
</pre>
<p>comma separated keywords describing the content (string).</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-GEO-LOCATION-NAME:CAPS"></a><h3>GST_TAG_GEO_LOCATION_NAME</h3>
<pre class="programlisting">#define GST_TAG_GEO_LOCATION_NAME "geo-location-name"
</pre>
<p>human readable descriptive location of where the media has been recorded or
produced. (string).</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-GEO-LOCATION-LATITUDE:CAPS"></a><h3>GST_TAG_GEO_LOCATION_LATITUDE</h3>
<pre class="programlisting">#define GST_TAG_GEO_LOCATION_LATITUDE "geo-location-latitude"
</pre>
<p>geo latitude location of where the media has been recorded or produced in
degrees according to WGS84 (zero at the equator, negative values for southern
latitudes) (double).</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-GEO-LOCATION-LONGITUDE:CAPS"></a><h3>GST_TAG_GEO_LOCATION_LONGITUDE</h3>
<pre class="programlisting">#define GST_TAG_GEO_LOCATION_LONGITUDE "geo-location-longitude"
</pre>
<p>geo longitude location of where the media has been recorded or produced in
degrees according to WGS84 (zero at the prime meridian in Greenwich/UK,
negative values for western longitudes). (double).</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-GEO-LOCATION-ELEVATION:CAPS"></a><h3>GST_TAG_GEO_LOCATION_ELEVATION</h3>
<pre class="programlisting">#define GST_TAG_GEO_LOCATION_ELEVATION "geo-location-elevation"
</pre>
<p>geo elevation of where the media has been recorded or produced in meters
according to WGS84 (zero is average sea level) (double).</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-GEO-LOCATION-CITY:CAPS"></a><h3>GST_TAG_GEO_LOCATION_CITY</h3>
<pre class="programlisting">#define GST_TAG_GEO_LOCATION_CITY "geo-location-city"
</pre>
<p>The city (english name) where the media has been produced (string).</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-GEO-LOCATION-COUNTRY:CAPS"></a><h3>GST_TAG_GEO_LOCATION_COUNTRY</h3>
<pre class="programlisting">#define GST_TAG_GEO_LOCATION_COUNTRY "geo-location-country"
</pre>
<p>The country (english name) where the media has been produced (string).</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-GEO-LOCATION-SUBLOCATION:CAPS"></a><h3>GST_TAG_GEO_LOCATION_SUBLOCATION</h3>
<pre class="programlisting">#define GST_TAG_GEO_LOCATION_SUBLOCATION "geo-location-sublocation"
</pre>
<p>A location 'smaller' than GST_TAG_GEO_LOCATION_CITY that specifies better
where the media has been produced. (e.g. the neighborhood) (string).</p>
<p>This tag has been added as this is how it is handled/named in XMP's
Iptc4xmpcore schema.</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-GEO-LOCATION-HORIZONTAL-ERROR:CAPS"></a><h3>GST_TAG_GEO_LOCATION_HORIZONTAL_ERROR</h3>
<pre class="programlisting">#define GST_TAG_GEO_LOCATION_HORIZONTAL_ERROR "geo-location-horizontal-error"
</pre>
<p>Represents the expected error on the horizontal positioning in
meters (double).</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-GEO-LOCATION-MOVEMENT-DIRECTION:CAPS"></a><h3>GST_TAG_GEO_LOCATION_MOVEMENT_DIRECTION</h3>
<pre class="programlisting">#define GST_TAG_GEO_LOCATION_MOVEMENT_DIRECTION "geo-location-movement-direction"
</pre>
<p>Indicates the movement direction of the device performing the capture
of a media. It is represented as degrees in floating point representation,
0 means the geographic north, and increases clockwise (double from 0 to 360)</p>
<p>See also <a class="link" href="GstTagList.html#GST-TAG-GEO-LOCATION-CAPTURE-DIRECTION:CAPS" title="GST_TAG_GEO_LOCATION_CAPTURE_DIRECTION"><span class="type">GST_TAG_GEO_LOCATION_CAPTURE_DIRECTION</span></a></p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-GEO-LOCATION-MOVEMENT-SPEED:CAPS"></a><h3>GST_TAG_GEO_LOCATION_MOVEMENT_SPEED</h3>
<pre class="programlisting">#define GST_TAG_GEO_LOCATION_MOVEMENT_SPEED "geo-location-movement-speed"
</pre>
<p>Speed of the capturing device when performing the capture.
Represented in m/s. (double)</p>
<p>See also <a class="link" href="GstTagList.html#GST-TAG-GEO-LOCATION-MOVEMENT-DIRECTION:CAPS" title="GST_TAG_GEO_LOCATION_MOVEMENT_DIRECTION"><span class="type">GST_TAG_GEO_LOCATION_MOVEMENT_DIRECTION</span></a></p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-GEO-LOCATION-CAPTURE-DIRECTION:CAPS"></a><h3>GST_TAG_GEO_LOCATION_CAPTURE_DIRECTION</h3>
<pre class="programlisting">#define GST_TAG_GEO_LOCATION_CAPTURE_DIRECTION "geo-location-capture-direction"
</pre>
<p>Indicates the direction the device is pointing to when capturing
a media. It is represented as degrees in floating point representation,
0 means the geographic north, and increases clockwise (double from 0 to 360)</p>
<p>See also <a class="link" href="GstTagList.html#GST-TAG-GEO-LOCATION-MOVEMENT-DIRECTION:CAPS" title="GST_TAG_GEO_LOCATION_MOVEMENT_DIRECTION"><span class="type">GST_TAG_GEO_LOCATION_MOVEMENT_DIRECTION</span></a></p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-SHOW-NAME:CAPS"></a><h3>GST_TAG_SHOW_NAME</h3>
<pre class="programlisting">#define GST_TAG_SHOW_NAME "show-name"
</pre>
<p>Name of the show, used for displaying (string)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-SHOW-SORTNAME:CAPS"></a><h3>GST_TAG_SHOW_SORTNAME</h3>
<pre class="programlisting">#define GST_TAG_SHOW_SORTNAME "show-sortname"
</pre>
<p>Name of the show, used for sorting (string)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-SHOW-EPISODE-NUMBER:CAPS"></a><h3>GST_TAG_SHOW_EPISODE_NUMBER</h3>
<pre class="programlisting">#define GST_TAG_SHOW_EPISODE_NUMBER "show-episode-number"
</pre>
<p>Number of the episode within a season/show (unsigned integer)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-SHOW-SEASON-NUMBER:CAPS"></a><h3>GST_TAG_SHOW_SEASON_NUMBER</h3>
<pre class="programlisting">#define GST_TAG_SHOW_SEASON_NUMBER "show-season-number"
</pre>
<p>Number of the season of a show/series (unsigned integer)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-LYRICS:CAPS"></a><h3>GST_TAG_LYRICS</h3>
<pre class="programlisting">#define GST_TAG_LYRICS "lyrics"
</pre>
<p>The lyrics of the media (string)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-COMPOSER-SORTNAME:CAPS"></a><h3>GST_TAG_COMPOSER_SORTNAME</h3>
<pre class="programlisting">#define GST_TAG_COMPOSER_SORTNAME "composer-sortname"
</pre>
<p>The composer's name, used for sorting (string)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-GROUPING:CAPS"></a><h3>GST_TAG_GROUPING</h3>
<pre class="programlisting">#define GST_TAG_GROUPING "grouping"
</pre>
<p>Groups together media that are related and spans multiple tracks. An
example are multiple pieces of a concerto. (string)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-USER-RATING:CAPS"></a><h3>GST_TAG_USER_RATING</h3>
<pre class="programlisting">#define GST_TAG_USER_RATING "user-rating"
</pre>
<p>Rating attributed by a person (likely the application user).
The higher the value, the more the user likes this media
(unsigned int from 0 to 100)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-DEVICE-MANUFACTURER:CAPS"></a><h3>GST_TAG_DEVICE_MANUFACTURER</h3>
<pre class="programlisting">#define GST_TAG_DEVICE_MANUFACTURER "device-manufacturer"
</pre>
<p>Manufacturer of the device used to create the media (string)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-DEVICE-MODEL:CAPS"></a><h3>GST_TAG_DEVICE_MODEL</h3>
<pre class="programlisting">#define GST_TAG_DEVICE_MODEL "device-model"
</pre>
<p>Model of the device used to create the media (string)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-APPLICATION-NAME:CAPS"></a><h3>GST_TAG_APPLICATION_NAME</h3>
<pre class="programlisting">#define GST_TAG_APPLICATION_NAME "application-name"
</pre>
<p>Name of the application used to create the media (string)</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-APPLICATION-DATA:CAPS"></a><h3>GST_TAG_APPLICATION_DATA</h3>
<pre class="programlisting">#define GST_TAG_APPLICATION_DATA "application-data"
</pre>
<p>Arbitrary application data (sample)</p>
<p>Some formats allow applications to add their own arbitrary data
into files. This data is application dependent.</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-IMAGE-ORIENTATION:CAPS"></a><h3>GST_TAG_IMAGE_ORIENTATION</h3>
<pre class="programlisting">#define GST_TAG_IMAGE_ORIENTATION "image-orientation"
</pre>
<p>Represents the 'Orientation' tag from EXIF. Defines how the image
should be rotated and mirrored for display. (string)</p>
<p>This tag has a predefined set of allowed values:
"rotate-0"
"rotate-90"
"rotate-180"
"rotate-270"
"flip-rotate-0"
"flip-rotate-90"
"flip-rotate-180"
"flip-rotate-270"</p>
<p>The naming is adopted according to a possible transformation to perform
on the image to fix its orientation, obviously equivalent operations will
yield the same result.</p>
<p>Rotations indicated by the values are in clockwise direction and
'flip' means an horizontal mirroring.</p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-PUBLISHER:CAPS"></a><h3>GST_TAG_PUBLISHER</h3>
<pre class="programlisting">#define GST_TAG_PUBLISHER "publisher"
</pre>
<p>Name of the label or publisher (string)</p>
<p class="since">Since: <a class="link" href="ix06.html#api-index-1.2">1.2</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-INTERPRETED-BY:CAPS"></a><h3>GST_TAG_INTERPRETED_BY</h3>
<pre class="programlisting">#define GST_TAG_INTERPRETED_BY "interpreted-by"
</pre>
<p>Information about the people behind a remix and similar
interpretations of another existing piece (string)</p>
<p class="since">Since: <a class="link" href="ix06.html#api-index-1.2">1.2</a></p>
</div>
<hr>
<div class="refsect2">
<a name="GST-TAG-MIDI-BASE-NOTE:CAPS"></a><h3>GST_TAG_MIDI_BASE_NOTE</h3>
<pre class="programlisting">#define GST_TAG_MIDI_BASE_NOTE "midi-base-note"
</pre>
<a class="ulink" href="http://en.wikipedia.org/wiki/Note#Note_designation_in_accordance_with_octave_name" target="_top">Midi note number</a><p>of the audio track. This is useful for sample instruments and in particular
for multi-samples.</p>
<p class="since">Since: <a class="link" href="ix04.html#api-index-1.4">1.4</a></p>
</div>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.24</div>
</body>
</html>