docs/libs/html/gst-plugins-base-libs-gsttag.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <title>gsttag</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
   7 <link rel="home" href="index.html" title="GStreamer Base Plugins 0.10 Library Reference Manual">
   8 <link rel="up" href="gstreamer-tag.html" title="Tag Support Library">
   9 <link rel="prev" href="gstreamer-tag.html" title="Tag Support Library">
  10 <link rel="next" href="gst-plugins-base-libs-gsttagvorbis.html" title="gsttagvorbis">
  11 <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 </head>
  14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
  16 <tr valign="middle">
  17 <td><a accesskey="p" href="gstreamer-tag.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  18 <td><a accesskey="u" href="gstreamer-tag.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  20 <th width="100%" align="center">GStreamer Base Plugins 0.10 Library Reference Manual</th>
  21 <td><a accesskey="n" href="gst-plugins-base-libs-gsttagvorbis.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  22 </tr>
  23 <tr><td colspan="5" class="shortcuts">
  24 <a href="#gst-plugins-base-libs-gsttag.synopsis" class="shortcut">Top</a>
  25                    |
  26                   <a href="#gst-plugins-base-libs-gsttag.description" class="shortcut">Description</a>
  27 </td></tr>
  28 </table>
  29 <div class="refentry">
  30 <a name="gst-plugins-base-libs-gsttag"></a><div class="titlepage"></div>
  31 <div class="refnamediv"><table width="100%"><tr>
  32 <td valign="top">
  33 <h2><span class="refentrytitle"><a name="gst-plugins-base-libs-gsttag.top_of_page"></a>gsttag</span></h2>
  34 <p>gsttag — additional tag definitions for plugins and applications</p>
  35 </td>
  36 <td valign="top" align="right"></td>
  37 </tr></table></div>
  38 <div class="refsynopsisdiv">
  39 <a name="gst-plugins-base-libs-gsttag.synopsis"></a><h2>Synopsis</h2>
  40 <pre class="synopsis">
  41 #include &lt;gst/tag/tag.h&gt;
  42
  43 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-MUSICBRAINZ-TRACKID:CAPS" title="GST_TAG_MUSICBRAINZ_TRACKID">GST_TAG_MUSICBRAINZ_TRACKID</a>
  44 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-MUSICBRAINZ-ARTISTID:CAPS" title="GST_TAG_MUSICBRAINZ_ARTISTID">GST_TAG_MUSICBRAINZ_ARTISTID</a>
  45 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-MUSICBRAINZ-ALBUMID:CAPS" title="GST_TAG_MUSICBRAINZ_ALBUMID">GST_TAG_MUSICBRAINZ_ALBUMID</a>
  46 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-MUSICBRAINZ-ALBUMARTISTID:CAPS" title="GST_TAG_MUSICBRAINZ_ALBUMARTISTID">GST_TAG_MUSICBRAINZ_ALBUMARTISTID</a>
  47 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-MUSICBRAINZ-TRMID:CAPS" title="GST_TAG_MUSICBRAINZ_TRMID">GST_TAG_MUSICBRAINZ_TRMID</a>
  48 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-MUSICBRAINZ-SORTNAME:CAPS" title="GST_TAG_MUSICBRAINZ_SORTNAME">GST_TAG_MUSICBRAINZ_SORTNAME</a>
  49 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CDDA-CDDB-DISCID:CAPS" title="GST_TAG_CDDA_CDDB_DISCID">GST_TAG_CDDA_CDDB_DISCID</a>
  50 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CDDA-CDDB-DISCID-FULL:CAPS" title="GST_TAG_CDDA_CDDB_DISCID_FULL">GST_TAG_CDDA_CDDB_DISCID_FULL</a>
  51 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CDDA-MUSICBRAINZ-DISCID:CAPS" title="GST_TAG_CDDA_MUSICBRAINZ_DISCID">GST_TAG_CDDA_MUSICBRAINZ_DISCID</a>
  52 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CDDA-MUSICBRAINZ-DISCID-FULL:CAPS" title="GST_TAG_CDDA_MUSICBRAINZ_DISCID_FULL">GST_TAG_CDDA_MUSICBRAINZ_DISCID_FULL</a>
  53 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CDDA-TRACK-TAGS:CAPS" title="GST_TAG_CDDA_TRACK_TAGS">GST_TAG_CDDA_TRACK_TAGS</a>
  54 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CMML-CLIP:CAPS" title="GST_TAG_CMML_CLIP">GST_TAG_CMML_CLIP</a>
  55 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CMML-HEAD:CAPS" title="GST_TAG_CMML_HEAD">GST_TAG_CMML_HEAD</a>
  56 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CMML-STREAM:CAPS" title="GST_TAG_CMML_STREAM">GST_TAG_CMML_STREAM</a>
  57 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-SHUTTER-SPEED:CAPS" title="GST_TAG_CAPTURING_SHUTTER_SPEED">GST_TAG_CAPTURING_SHUTTER_SPEED</a>
  58 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-FOCAL-RATIO:CAPS" title="GST_TAG_CAPTURING_FOCAL_RATIO">GST_TAG_CAPTURING_FOCAL_RATIO</a>
  59 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-FOCAL-LENGTH:CAPS" title="GST_TAG_CAPTURING_FOCAL_LENGTH">GST_TAG_CAPTURING_FOCAL_LENGTH</a>
  60 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-DIGITAL-ZOOM-RATIO:CAPS" title="GST_TAG_CAPTURING_DIGITAL_ZOOM_RATIO">GST_TAG_CAPTURING_DIGITAL_ZOOM_RATIO</a>
  61 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-ISO-SPEED:CAPS" title="GST_TAG_CAPTURING_ISO_SPEED">GST_TAG_CAPTURING_ISO_SPEED</a>
  62 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-EXPOSURE-PROGRAM:CAPS" title="GST_TAG_CAPTURING_EXPOSURE_PROGRAM">GST_TAG_CAPTURING_EXPOSURE_PROGRAM</a>
  63 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-EXPOSURE-MODE:CAPS" title="GST_TAG_CAPTURING_EXPOSURE_MODE">GST_TAG_CAPTURING_EXPOSURE_MODE</a>
  64 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-SCENE-CAPTURE-TYPE:CAPS" title="GST_TAG_CAPTURING_SCENE_CAPTURE_TYPE">GST_TAG_CAPTURING_SCENE_CAPTURE_TYPE</a>
  65 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-GAIN-ADJUSTMENT:CAPS" title="GST_TAG_CAPTURING_GAIN_ADJUSTMENT">GST_TAG_CAPTURING_GAIN_ADJUSTMENT</a>
  66 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-WHITE-BALANCE:CAPS" title="GST_TAG_CAPTURING_WHITE_BALANCE">GST_TAG_CAPTURING_WHITE_BALANCE</a>
  67 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-CONTRAST:CAPS" title="GST_TAG_CAPTURING_CONTRAST">GST_TAG_CAPTURING_CONTRAST</a>
  68 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-SATURATION:CAPS" title="GST_TAG_CAPTURING_SATURATION">GST_TAG_CAPTURING_SATURATION</a>
  69 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-SHARPNESS:CAPS" title="GST_TAG_CAPTURING_SHARPNESS">GST_TAG_CAPTURING_SHARPNESS</a>
  70 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-FLASH-FIRED:CAPS" title="GST_TAG_CAPTURING_FLASH_FIRED">GST_TAG_CAPTURING_FLASH_FIRED</a>
  71 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-FLASH-MODE:CAPS" title="GST_TAG_CAPTURING_FLASH_MODE">GST_TAG_CAPTURING_FLASH_MODE</a>
  72 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-METERING-MODE:CAPS" title="GST_TAG_CAPTURING_METERING_MODE">GST_TAG_CAPTURING_METERING_MODE</a>
  73 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-SOURCE:CAPS" title="GST_TAG_CAPTURING_SOURCE">GST_TAG_CAPTURING_SOURCE</a>
  74 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-CAPTURING-EXPOSURE-COMPENSATION:CAPS" title="GST_TAG_CAPTURING_EXPOSURE_COMPENSATION">GST_TAG_CAPTURING_EXPOSURE_COMPENSATION</a>
  75 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-IMAGE-HORIZONTAL-PPI:CAPS" title="GST_TAG_IMAGE_HORIZONTAL_PPI">GST_TAG_IMAGE_HORIZONTAL_PPI</a>
  76 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-IMAGE-VERTICAL-PPI:CAPS" title="GST_TAG_IMAGE_VERTICAL_PPI">GST_TAG_IMAGE_VERTICAL_PPI</a>
  77 #define             <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-ID3V2-HEADER-SIZE:CAPS" title="GST_TAG_ID3V2_HEADER_SIZE">GST_TAG_ID3V2_HEADER_SIZE</a>
  78 <span class="returnvalue">void</span>                <a class="link" href="gst-plugins-base-libs-gsttag.html#gst-tag-register-musicbrainz-tags" title="gst_tag_register_musicbrainz_tags ()">gst_tag_register_musicbrainz_tags</a>   (<em class="parameter"><code><span class="type">void</span></code></em>);
  79 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="gst-plugins-base-libs-gsttag.html#gst-tag-freeform-string-to-utf8" title="gst_tag_freeform_string_to_utf8 ()">gst_tag_freeform_string_to_utf8</a>     (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *data</code></em>,
  80                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> size</code></em>,
  81                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **env_vars</code></em>);
  82 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gst-plugins-base-libs-gsttag.html#gst-tag-parse-extended-comment" title="gst_tag_parse_extended_comment ()">gst_tag_parse_extended_comment</a>      (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *ext_comment</code></em>,
  83                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **key</code></em>,
  84                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **lang</code></em>,
  85                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **value</code></em>,
  86                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> fail_if_no_key</code></em>);
  87 <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstBuffer.html#GstBuffer"><span class="returnvalue">GstBuffer</span></a> *         <a class="link" href="gst-plugins-base-libs-gsttag.html#gst-tag-image-data-to-image-buffer" title="gst_tag_image_data_to_image_buffer ()">gst_tag_image_data_to_image_buffer</a>  (<em class="parameter"><code>const <span class="type">guint8</span> *image_data</code></em>,
  88                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> image_data_len</code></em>,
  89                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttag.html#GstTagImageType" title="enum GstTagImageType"><span class="type">GstTagImageType</span></a> image_type</code></em>);
  90 enum                <a class="link" href="gst-plugins-base-libs-gsttag.html#GstTagImageType" title="enum GstTagImageType">GstTagImageType</a>;
  91 </pre>
  92 </div>
  93 <div class="refsect1">
  94 <a name="gst-plugins-base-libs-gsttag.description"></a><h2>Description</h2>
  95 <p>
  96 </p>
  97 <div class="refsect2">
  98 <a name="idp26027584"></a><p>
  99 Contains additional standardized GStreamer tag definitions for plugins
 100 and applications, and functions to register them with the GStreamer
 101 tag system.
 102 </p>
 103 </div>
 104 <p>
 105 </p>
 106 </div>
 107 <div class="refsect1">
 108 <a name="gst-plugins-base-libs-gsttag.details"></a><h2>Details</h2>
 109 <div class="refsect2">
 110 <a name="GST-TAG-MUSICBRAINZ-TRACKID:CAPS"></a><h3>GST_TAG_MUSICBRAINZ_TRACKID</h3>
 111 <pre class="programlisting">#define GST_TAG_MUSICBRAINZ_TRACKID "musicbrainz-trackid"
 112 </pre>
 113 <p>
 114 MusicBrainz track ID
 115 </p>
 116 </div>
 117 <hr>
 118 <div class="refsect2">
 119 <a name="GST-TAG-MUSICBRAINZ-ARTISTID:CAPS"></a><h3>GST_TAG_MUSICBRAINZ_ARTISTID</h3>
 120 <pre class="programlisting">#define GST_TAG_MUSICBRAINZ_ARTISTID "musicbrainz-artistid"
 121 </pre>
 122 <p>
 123 MusicBrainz artist ID
 124 </p>
 125 </div>
 126 <hr>
 127 <div class="refsect2">
 128 <a name="GST-TAG-MUSICBRAINZ-ALBUMID:CAPS"></a><h3>GST_TAG_MUSICBRAINZ_ALBUMID</h3>
 129 <pre class="programlisting">#define GST_TAG_MUSICBRAINZ_ALBUMID "musicbrainz-albumid"
 130 </pre>
 131 <p>
 132 MusicBrainz album ID
 133 </p>
 134 </div>
 135 <hr>
 136 <div class="refsect2">
 137 <a name="GST-TAG-MUSICBRAINZ-ALBUMARTISTID:CAPS"></a><h3>GST_TAG_MUSICBRAINZ_ALBUMARTISTID</h3>
 138 <pre class="programlisting">#define GST_TAG_MUSICBRAINZ_ALBUMARTISTID "musicbrainz-albumartistid"
 139 </pre>
 140 <p>
 141 MusicBrainz album artist ID
 142 </p>
 143 </div>
 144 <hr>
 145 <div class="refsect2">
 146 <a name="GST-TAG-MUSICBRAINZ-TRMID:CAPS"></a><h3>GST_TAG_MUSICBRAINZ_TRMID</h3>
 147 <pre class="programlisting">#define GST_TAG_MUSICBRAINZ_TRMID "musicbrainz-trmid"
 148 </pre>
 149 <p>
 150 MusicBrainz track TRM ID
 151 </p>
 152 </div>
 153 <hr>
 154 <div class="refsect2">
 155 <a name="GST-TAG-MUSICBRAINZ-SORTNAME:CAPS"></a><h3>GST_TAG_MUSICBRAINZ_SORTNAME</h3>
 156 <pre class="programlisting">#define GST_TAG_MUSICBRAINZ_SORTNAME GST_TAG_ARTIST_SORTNAME
 157 </pre>
 158 <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 159 <h3 class="title">Warning</h3>
 160 <p><code class="literal">GST_TAG_MUSICBRAINZ_SORTNAME</code> is deprecated and should not be used in newly-written code.</p>
 161 </div>
 162 <p>
 163 MusicBrainz artist sort name
 164 </p>
 165 <p>
 166 Deprecated.  Use GST_TAG_ARTIST_SORTNAME instead.
 167 </p>
 168 </div>
 169 <hr>
 170 <div class="refsect2">
 171 <a name="GST-TAG-CDDA-CDDB-DISCID:CAPS"></a><h3>GST_TAG_CDDA_CDDB_DISCID</h3>
 172 <pre class="programlisting">#define GST_TAG_CDDA_CDDB_DISCID              "discid"
 173 </pre>
 174 <p>
 175 CDDB disc id in its short form (e.g. 'aa063d0f')
 176 </p>
 177 </div>
 178 <hr>
 179 <div class="refsect2">
 180 <a name="GST-TAG-CDDA-CDDB-DISCID-FULL:CAPS"></a><h3>GST_TAG_CDDA_CDDB_DISCID_FULL</h3>
 181 <pre class="programlisting">#define GST_TAG_CDDA_CDDB_DISCID_FULL         "discid-full"
 182 </pre>
 183 <p>
 184 CDDB disc id including all details
 185 </p>
 186 </div>
 187 <hr>
 188 <div class="refsect2">
 189 <a name="GST-TAG-CDDA-MUSICBRAINZ-DISCID:CAPS"></a><h3>GST_TAG_CDDA_MUSICBRAINZ_DISCID</h3>
 190 <pre class="programlisting">#define GST_TAG_CDDA_MUSICBRAINZ_DISCID       "musicbrainz-discid"
 191 </pre>
 192 <p>
 193 Musicbrainz disc id (e.g. 'ahg7JUcfR3vCYBphSDIogOOWrr0-')
 194 </p>
 195 </div>
 196 <hr>
 197 <div class="refsect2">
 198 <a name="GST-TAG-CDDA-MUSICBRAINZ-DISCID-FULL:CAPS"></a><h3>GST_TAG_CDDA_MUSICBRAINZ_DISCID_FULL</h3>
 199 <pre class="programlisting">#define GST_TAG_CDDA_MUSICBRAINZ_DISCID_FULL  "musicbrainz-discid-full"
 200 </pre>
 201 <p>
 202 Musicbrainz disc id details
 203 </p>
 204 </div>
 205 <hr>
 206 <div class="refsect2">
 207 <a name="GST-TAG-CDDA-TRACK-TAGS:CAPS"></a><h3>GST_TAG_CDDA_TRACK_TAGS</h3>
 208 <pre class="programlisting">#define GST_TAG_CDDA_TRACK_TAGS               "track-tags"
 209 </pre>
 210 </div>
 211 <hr>
 212 <div class="refsect2">
 213 <a name="GST-TAG-CMML-CLIP:CAPS"></a><h3>GST_TAG_CMML_CLIP</h3>
 214 <pre class="programlisting">#define GST_TAG_CMML_CLIP "cmml-clip"
 215 </pre>
 216 <p>
 217 Annodex CMML clip element tag
 218 </p>
 219 </div>
 220 <hr>
 221 <div class="refsect2">
 222 <a name="GST-TAG-CMML-HEAD:CAPS"></a><h3>GST_TAG_CMML_HEAD</h3>
 223 <pre class="programlisting">#define GST_TAG_CMML_HEAD "cmml-head"
 224 </pre>
 225 <p>
 226 Annodex CMML head element tag
 227 </p>
 228 </div>
 229 <hr>
 230 <div class="refsect2">
 231 <a name="GST-TAG-CMML-STREAM:CAPS"></a><h3>GST_TAG_CMML_STREAM</h3>
 232 <pre class="programlisting">#define GST_TAG_CMML_STREAM "cmml-stream"
 233 </pre>
 234 <p>
 235 Annodex CMML stream element tag
 236 </p>
 237 </div>
 238 <hr>
 239 <div class="refsect2">
 240 <a name="GST-TAG-CAPTURING-SHUTTER-SPEED:CAPS"></a><h3>GST_TAG_CAPTURING_SHUTTER_SPEED</h3>
 241 <pre class="programlisting">#define GST_TAG_CAPTURING_SHUTTER_SPEED        "capturing-shutter-speed"
 242 </pre>
 243 <p>
 244 Shutter speed used when capturing an image, in seconds. (fraction)
 245 </p>
 246 <p class="since">Since 0.10.31</p>
 247 </div>
 248 <hr>
 249 <div class="refsect2">
 250 <a name="GST-TAG-CAPTURING-FOCAL-RATIO:CAPS"></a><h3>GST_TAG_CAPTURING_FOCAL_RATIO</h3>
 251 <pre class="programlisting">#define GST_TAG_CAPTURING_FOCAL_RATIO          "capturing-focal-ratio"
 252 </pre>
 253 <p>
 254 Focal ratio (f-number) used when capturing an image. (double)
 255 </p>
 256 <p>
 257 The value stored is the denominator of the focal ratio (f-number).
 258 For example, if this tag value is 2, the focal ratio is f/2.
 259 </p>
 260 <p class="since">Since 0.10.31</p>
 261 </div>
 262 <hr>
 263 <div class="refsect2">
 264 <a name="GST-TAG-CAPTURING-FOCAL-LENGTH:CAPS"></a><h3>GST_TAG_CAPTURING_FOCAL_LENGTH</h3>
 265 <pre class="programlisting">#define GST_TAG_CAPTURING_FOCAL_LENGTH         "capturing-focal-length"
 266 </pre>
 267 <p>
 268 Focal length used when capturing an image, in mm. (double)
 269 </p>
 270 <p class="since">Since 0.10.31</p>
 271 </div>
 272 <hr>
 273 <div class="refsect2">
 274 <a name="GST-TAG-CAPTURING-DIGITAL-ZOOM-RATIO:CAPS"></a><h3>GST_TAG_CAPTURING_DIGITAL_ZOOM_RATIO</h3>
 275 <pre class="programlisting">#define GST_TAG_CAPTURING_DIGITAL_ZOOM_RATIO   "capturing-digital-zoom-ratio"
 276 </pre>
 277 <p>
 278 Digital zoom ratio used when capturing an image. (double)
 279 </p>
 280 <p class="since">Since 0.10.31</p>
 281 </div>
 282 <hr>
 283 <div class="refsect2">
 284 <a name="GST-TAG-CAPTURING-ISO-SPEED:CAPS"></a><h3>GST_TAG_CAPTURING_ISO_SPEED</h3>
 285 <pre class="programlisting">#define GST_TAG_CAPTURING_ISO_SPEED           "capturing-iso-speed"
 286 </pre>
 287 <p>
 288 ISO speed used when capturing an image. (integer)
 289 </p>
 290 <p class="since">Since 0.10.31</p>
 291 </div>
 292 <hr>
 293 <div class="refsect2">
 294 <a name="GST-TAG-CAPTURING-EXPOSURE-PROGRAM:CAPS"></a><h3>GST_TAG_CAPTURING_EXPOSURE_PROGRAM</h3>
 295 <pre class="programlisting">#define GST_TAG_CAPTURING_EXPOSURE_PROGRAM     "capturing-exposure-program"
 296 </pre>
 297 <p>
 298 Type of exposure control used when capturing an image. (string)
 299 </p>
 300 <p>
 301 The allowed values are:
 302   "undefined"
 303   "manual"
 304   "normal" - automatically controlled
 305   "aperture-priority" - user selects aperture value
 306   "shutter-priority" - user selects shutter speed
 307   "creative" - biased towards depth of field
 308   "action" - biased towards fast shutter speed
 309   "portrait" - closeup, leaving background out of focus
 310   "landscape" - landscape photos, background in focus
 311 </p>
 312 <p class="since">Since 0.10.31</p>
 313 </div>
 314 <hr>
 315 <div class="refsect2">
 316 <a name="GST-TAG-CAPTURING-EXPOSURE-MODE:CAPS"></a><h3>GST_TAG_CAPTURING_EXPOSURE_MODE</h3>
 317 <pre class="programlisting">#define GST_TAG_CAPTURING_EXPOSURE_MODE       "capturing-exposure-mode"
 318 </pre>
 319 <p>
 320 Exposure mode used when capturing an image. (string)
 321 </p>
 322 <p>
 323 The allowed values are:
 324   "auto-exposure"
 325   "manual-exposure"
 326   "auto-bracket"
 327 </p>
 328 <p class="since">Since 0.10.31</p>
 329 </div>
 330 <hr>
 331 <div class="refsect2">
 332 <a name="GST-TAG-CAPTURING-SCENE-CAPTURE-TYPE:CAPS"></a><h3>GST_TAG_CAPTURING_SCENE_CAPTURE_TYPE</h3>
 333 <pre class="programlisting">#define GST_TAG_CAPTURING_SCENE_CAPTURE_TYPE  "capturing-scene-capture-type"
 334 </pre>
 335 <p>
 336 Scene mode used when capturing an image. (string)
 337 </p>
 338 <p>
 339 The allowed values are:
 340   "standard"
 341   "landscape"
 342   "portrait"
 343   "night-scene"
 344 </p>
 345 <p class="since">Since 0.10.31</p>
 346 </div>
 347 <hr>
 348 <div class="refsect2">
 349 <a name="GST-TAG-CAPTURING-GAIN-ADJUSTMENT:CAPS"></a><h3>GST_TAG_CAPTURING_GAIN_ADJUSTMENT</h3>
 350 <pre class="programlisting">#define GST_TAG_CAPTURING_GAIN_ADJUSTMENT     "capturing-gain-adjustment"
 351 </pre>
 352 <p>
 353 Gain adjustment applied to an image. (string)
 354 </p>
 355 <p>
 356 The allowed values are:
 357   "none"
 358   "low-gain-up"
 359   "high-gain-up"
 360   "low-gain-down"
 361   "high-gain-down"
 362 </p>
 363 <p class="since">Since 0.10.31</p>
 364 </div>
 365 <hr>
 366 <div class="refsect2">
 367 <a name="GST-TAG-CAPTURING-WHITE-BALANCE:CAPS"></a><h3>GST_TAG_CAPTURING_WHITE_BALANCE</h3>
 368 <pre class="programlisting">#define GST_TAG_CAPTURING_WHITE_BALANCE       "capturing-white-balance"
 369 </pre>
 370 <p>
 371 White balance mode used when capturing an image. (string)
 372 </p>
 373 <p>
 374 The allowed values are:
 375   "auto"
 376   "manual"
 377   "daylight"
 378   "cloudy"
 379   "tungsten"
 380   "fluorescent"
 381   "fluorescent h" (newer daylight-calibrated fluorescents)
 382   "flash"
 383 </p>
 384 <p class="since">Since 0.10.31</p>
 385 </div>
 386 <hr>
 387 <div class="refsect2">
 388 <a name="GST-TAG-CAPTURING-CONTRAST:CAPS"></a><h3>GST_TAG_CAPTURING_CONTRAST</h3>
 389 <pre class="programlisting">#define GST_TAG_CAPTURING_CONTRAST            "capturing-contrast"
 390 </pre>
 391 <p>
 392 Direction of contrast processing applied when capturing an image. (string)
 393 </p>
 394 <p>
 395 The allowed values are:
 396  "normal"
 397  "soft"
 398  "hard"
 399 </p>
 400 <p class="since">Since 0.10.31</p>
 401 </div>
 402 <hr>
 403 <div class="refsect2">
 404 <a name="GST-TAG-CAPTURING-SATURATION:CAPS"></a><h3>GST_TAG_CAPTURING_SATURATION</h3>
 405 <pre class="programlisting">#define GST_TAG_CAPTURING_SATURATION          "capturing-saturation"
 406 </pre>
 407 <p>
 408 Direction of saturation processing applied when capturing an image. (string)
 409 </p>
 410 <p>
 411 The allowed values are:
 412  "normal"
 413  "low-saturation"
 414  "high-saturation"
 415 </p>
 416 <p class="since">Since 0.10.31</p>
 417 </div>
 418 <hr>
 419 <div class="refsect2">
 420 <a name="GST-TAG-CAPTURING-SHARPNESS:CAPS"></a><h3>GST_TAG_CAPTURING_SHARPNESS</h3>
 421 <pre class="programlisting">#define GST_TAG_CAPTURING_SHARPNESS          "capturing-sharpness"
 422 </pre>
 423 <p>
 424 Direction of sharpness processing applied when capturing an image. (string)
 425 </p>
 426 <p>
 427 The allowed values are:
 428  "normal"
 429  "soft"
 430  "hard"
 431 </p>
 432 <p class="since">Since 0.10.31</p>
 433 </div>
 434 <hr>
 435 <div class="refsect2">
 436 <a name="GST-TAG-CAPTURING-FLASH-FIRED:CAPS"></a><h3>GST_TAG_CAPTURING_FLASH_FIRED</h3>
 437 <pre class="programlisting">#define GST_TAG_CAPTURING_FLASH_FIRED         "capturing-flash-fired"
 438 </pre>
 439 <p>
 440 If flash was fired during the capture of an image. (boolean)
 441 </p>
 442 <p>
 443 Note that if this tag isn't present, it should not be assumed that
 444 the flash did not fire. It should be treated as unknown.
 445 </p>
 446 <p class="since">Since 0.10.31</p>
 447 </div>
 448 <hr>
 449 <div class="refsect2">
 450 <a name="GST-TAG-CAPTURING-FLASH-MODE:CAPS"></a><h3>GST_TAG_CAPTURING_FLASH_MODE</h3>
 451 <pre class="programlisting">#define GST_TAG_CAPTURING_FLASH_MODE         "capturing-flash-mode"
 452 </pre>
 453 <p>
 454 The flash mode selected during the capture of an image. (string)
 455 </p>
 456 <p>
 457 The allowed values are:
 458  "auto"
 459  "always"
 460  "never"
 461 </p>
 462 <p class="since">Since 0.10.31</p>
 463 </div>
 464 <hr>
 465 <div class="refsect2">
 466 <a name="GST-TAG-CAPTURING-METERING-MODE:CAPS"></a><h3>GST_TAG_CAPTURING_METERING_MODE</h3>
 467 <pre class="programlisting">#define GST_TAG_CAPTURING_METERING_MODE      "capturing-metering-mode"
 468 </pre>
 469 <p>
 470 Defines the way a camera determines the exposure. (string)
 471 </p>
 472 <p>
 473 The allowed values are:
 474   "unknown"
 475   "average"
 476   "center-weighted-average"
 477   "spot"
 478   "multi-spot"
 479   "pattern"
 480   "partial"
 481   "other"
 482 </p>
 483 <p class="since">Since 0.10.31</p>
 484 </div>
 485 <hr>
 486 <div class="refsect2">
 487 <a name="GST-TAG-CAPTURING-SOURCE:CAPS"></a><h3>GST_TAG_CAPTURING_SOURCE</h3>
 488 <pre class="programlisting">#define GST_TAG_CAPTURING_SOURCE             "capturing-source"
 489 </pre>
 490 <p>
 491 Indicates the source of capture. The device/medium used to do the
 492 capture. (string)
 493 </p>
 494 <p>
 495 Allowed values are:
 496   "dsc" (= digital still camera)
 497   "transparent-scanner"
 498   "reflex-scanner"
 499   "other"
 500 </p>
 501 <p class="since">Since 0.10.31</p>
 502 </div>
 503 <hr>
 504 <div class="refsect2">
 505 <a name="GST-TAG-CAPTURING-EXPOSURE-COMPENSATION:CAPS"></a><h3>GST_TAG_CAPTURING_EXPOSURE_COMPENSATION</h3>
 506 <pre class="programlisting">#define GST_TAG_CAPTURING_EXPOSURE_COMPENSATION "capturing-exposure-compensation"
 507 </pre>
 508 <p>
 509 Exposure compensation using when capturing an image in EV. (double)
 510 </p>
 511 <p class="since">Since 0.10.33</p>
 512 </div>
 513 <hr>
 514 <div class="refsect2">
 515 <a name="GST-TAG-IMAGE-HORIZONTAL-PPI:CAPS"></a><h3>GST_TAG_IMAGE_HORIZONTAL_PPI</h3>
 516 <pre class="programlisting">#define GST_TAG_IMAGE_HORIZONTAL_PPI         "image-horizontal-ppi"
 517 </pre>
 518 <p>
 519 Media (image/video) intended horizontal pixel density in ppi. (double)
 520 </p>
 521 <p class="since">Since 0.10.31</p>
 522 </div>
 523 <hr>
 524 <div class="refsect2">
 525 <a name="GST-TAG-IMAGE-VERTICAL-PPI:CAPS"></a><h3>GST_TAG_IMAGE_VERTICAL_PPI</h3>
 526 <pre class="programlisting">#define GST_TAG_IMAGE_VERTICAL_PPI           "image-vertical-ppi"
 527 </pre>
 528 <p>
 529 Media (image/video) intended vertical pixel density in ppi. (double)
 530 </p>
 531 <p class="since">Since 0.10.31</p>
 532 </div>
 533 <hr>
 534 <div class="refsect2">
 535 <a name="GST-TAG-ID3V2-HEADER-SIZE:CAPS"></a><h3>GST_TAG_ID3V2_HEADER_SIZE</h3>
 536 <pre class="programlisting">#define GST_TAG_ID3V2_HEADER_SIZE            10
 537 </pre>
 538 <p>
 539 ID3V2 header size considered minimum input for some functions such as
 540 <a class="link" href="gst-plugins-base-libs-gsttagid3.html#gst-tag-list-from-id3v2-tag" title="gst_tag_list_from_id3v2_tag ()"><code class="function">gst_tag_list_from_id3v2_tag()</code></a> and <a class="link" href="gst-plugins-base-libs-gsttagid3.html#gst-tag-get-id3v2-tag-size" title="gst_tag_get_id3v2_tag_size ()"><code class="function">gst_tag_get_id3v2_tag_size()</code></a> for example.
 541 </p>
 542 <p class="since">Since 0.10.36</p>
 543 </div>
 544 <hr>
 545 <div class="refsect2">
 546 <a name="gst-tag-register-musicbrainz-tags"></a><h3>gst_tag_register_musicbrainz_tags ()</h3>
 547 <pre class="programlisting"><span class="returnvalue">void</span>                gst_tag_register_musicbrainz_tags   (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 548 <p>
 549 Registers additional musicbrainz-specific tags with the GStreamer tag
 550 system. Plugins and applications that use these tags should call this
 551 function before using them. Can be called multiple times.
 552 </p>
 553 </div>
 554 <hr>
 555 <div class="refsect2">
 556 <a name="gst-tag-freeform-string-to-utf8"></a><h3>gst_tag_freeform_string_to_utf8 ()</h3>
 557 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             gst_tag_freeform_string_to_utf8     (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *data</code></em>,
 558                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> size</code></em>,
 559                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **env_vars</code></em>);</pre>
 560 <p>
 561 Convenience function to read a string with unknown character encoding. If
 562 the string is already in UTF-8 encoding, it will be returned right away.
 563 If not it tries to detect byte-order-mark for UTF-16/32 cases and use that.
 564 Otherwise, the environment will be searched for a number of environment
 565 variables (whose names are specified in the NULL-terminated string array
 566 <em class="parameter"><code>env_vars</code></em>) containing a list of character encodings to try/use. If none
 567 are specified, the current locale will be tried. If that also doesn't work,
 568 WINDOWS-1252/ISO-8859-1 is assumed (which will almost always succeed).
 569 </p>
 570 <div class="variablelist"><table border="0">
 571 <col align="left" valign="top">
 572 <tbody>
 573 <tr>
 574 <td><p><span class="term"><em class="parameter"><code>data</code></em> :</span></p></td>
 575 <td>string data</td>
 576 </tr>
 577 <tr>
 578 <td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td>
 579 <td>length of string data, or -1 if the string is NUL-terminated</td>
 580 </tr>
 581 <tr>
 582 <td><p><span class="term"><em class="parameter"><code>env_vars</code></em> :</span></p></td>
 583 <td>a NULL-terminated string array of environment variable names,
 584 or NULL</td>
 585 </tr>
 586 <tr>
 587 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 588 <td>a newly-allocated string in UTF-8 encoding, or NULL</td>
 589 </tr>
 590 </tbody>
 591 </table></div>
 592 <p class="since">Since 0.10.13</p>
 593 </div>
 594 <hr>
 595 <div class="refsect2">
 596 <a name="gst-tag-parse-extended-comment"></a><h3>gst_tag_parse_extended_comment ()</h3>
 597 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_tag_parse_extended_comment      (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *ext_comment</code></em>,
 598                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **key</code></em>,
 599                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **lang</code></em>,
 600                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> **value</code></em>,
 601                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> fail_if_no_key</code></em>);</pre>
 602 <p>
 603 Convenience function to parse a GST_TAG_EXTENDED_COMMENT string and
 604 separate it into its components.
 605 </p>
 606 <p>
 607 If successful, <em class="parameter"><code>key</code></em>, <em class="parameter"><code>lang</code></em> and/or <em class="parameter"><code>value</code></em> will be set to newly allocated
 608 strings that you need to free with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a> when done. <em class="parameter"><code>key</code></em> and <em class="parameter"><code>lang</code></em>
 609 may also be set to NULL by this function if there is no key or no language
 610 code in the extended comment string.
 611 </p>
 612 <div class="variablelist"><table border="0">
 613 <col align="left" valign="top">
 614 <tbody>
 615 <tr>
 616 <td><p><span class="term"><em class="parameter"><code>ext_comment</code></em> :</span></p></td>
 617 <td>an extended comment string, see <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstTagList.html#GST-TAG-EXTENDED-COMMENT:CAPS"><span class="type">GST_TAG_EXTENDED_COMMENT</span></a>
 618 </td>
 619 </tr>
 620 <tr>
 621 <td><p><span class="term"><em class="parameter"><code>key</code></em> :</span></p></td>
 622 <td>return location for the comment description key, or NULL</td>
 623 </tr>
 624 <tr>
 625 <td><p><span class="term"><em class="parameter"><code>lang</code></em> :</span></p></td>
 626 <td>return location for the comment ISO-639 language code, or NULL</td>
 627 </tr>
 628 <tr>
 629 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
 630 <td>return location for the actual comment string, or NULL</td>
 631 </tr>
 632 <tr>
 633 <td><p><span class="term"><em class="parameter"><code>fail_if_no_key</code></em> :</span></p></td>
 634 <td>whether to fail if strings are not in key=value form</td>
 635 </tr>
 636 <tr>
 637 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 638 <td>TRUE if the string could be parsed, otherwise FALSE</td>
 639 </tr>
 640 </tbody>
 641 </table></div>
 642 <p class="since">Since 0.10.10</p>
 643 </div>
 644 <hr>
 645 <div class="refsect2">
 646 <a name="gst-tag-image-data-to-image-buffer"></a><h3>gst_tag_image_data_to_image_buffer ()</h3>
 647 <pre class="programlisting"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstBuffer.html#GstBuffer"><span class="returnvalue">GstBuffer</span></a> *         gst_tag_image_data_to_image_buffer  (<em class="parameter"><code>const <span class="type">guint8</span> *image_data</code></em>,
 648                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> image_data_len</code></em>,
 649                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-gsttag.html#GstTagImageType" title="enum GstTagImageType"><span class="type">GstTagImageType</span></a> image_type</code></em>);</pre>
 650 <p>
 651 Helper function for tag-reading plugins to create a <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstBuffer.html#GstBuffer"><span class="type">GstBuffer</span></a> suitable to
 652 add to a <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstTagList.html#GstTagList"><span class="type">GstTagList</span></a> as an image tag (such as <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstTagList.html#GST-TAG-IMAGE:CAPS"><span class="type">GST_TAG_IMAGE</span></a> or
 653 <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstTagList.html#GST-TAG-PREVIEW-IMAGE:CAPS"><span class="type">GST_TAG_PREVIEW_IMAGE</span></a>) from the encoded image data and an (optional) image
 654 type.
 655 </p>
 656 <p>
 657 Background: cover art and other images in tags are usually stored as a
 658 blob of binary image data, often accompanied by a MIME type or some other
 659 content type string (e.g. 'png', 'jpeg', 'jpg'). Sometimes there is also an
 660 'image type' to indicate what kind of image this is (e.g. front cover,
 661 back cover, artist, etc.). The image data may also be an URI to the image
 662 rather than the image itself.
 663 </p>
 664 <p>
 665 In GStreamer, image tags are <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstBuffer.html#GstBuffer"><span class="type">GstBuffer</span></a>s containing the raw image
 666 data, with the buffer caps describing the content type of the image
 667 (e.g. image/jpeg, image/png, text/uri-list). The buffer caps may contain
 668 an additional 'image-type' field of <span class="type">GST_TYPE_TAG_IMAGE_TYPE</span> to describe
 669 the type of image (front cover, back cover etc.). <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstTagList.html#GST-TAG-PREVIEW-IMAGE:CAPS"><span class="type">GST_TAG_PREVIEW_IMAGE</span></a>
 670 tags should not carry an image type, their type is already indicated via
 671 the special tag name.
 672 </p>
 673 <p>
 674 This function will do various checks and typefind the encoded image
 675 data (we can't trust the declared mime type).
 676 </p>
 677 <div class="variablelist"><table border="0">
 678 <col align="left" valign="top">
 679 <tbody>
 680 <tr>
 681 <td><p><span class="term"><em class="parameter"><code>image_data</code></em> :</span></p></td>
 682 <td>the (encoded) image</td>
 683 </tr>
 684 <tr>
 685 <td><p><span class="term"><em class="parameter"><code>image_data_len</code></em> :</span></p></td>
 686 <td>the length of the encoded image data at <em class="parameter"><code>image_data</code></em>
 687 </td>
 688 </tr>
 689 <tr>
 690 <td><p><span class="term"><em class="parameter"><code>image_type</code></em> :</span></p></td>
 691 <td>type of the image, or <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-IMAGE-TYPE-UNDEFINED:CAPS"><span class="type">GST_TAG_IMAGE_TYPE_UNDEFINED</span></a>. Pass
 692 <a class="link" href="gst-plugins-base-libs-gsttag.html#GST-TAG-IMAGE-TYPE-NONE:CAPS"><span class="type">GST_TAG_IMAGE_TYPE_NONE</span></a> if no image type should be set at all (e.g.
 693 for preview images)</td>
 694 </tr>
 695 <tr>
 696 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 697 <td>a newly-allocated image buffer for use in tag lists, or NULL</td>
 698 </tr>
 699 </tbody>
 700 </table></div>
 701 <p class="since">Since 0.10.20</p>
 702 </div>
 703 <hr>
 704 <div class="refsect2">
 705 <a name="GstTagImageType"></a><h3>enum GstTagImageType</h3>
 706 <pre class="programlisting">typedef enum {
 707   GST_TAG_IMAGE_TYPE_NONE = -1,
 708   GST_TAG_IMAGE_TYPE_UNDEFINED = 0,
 709   GST_TAG_IMAGE_TYPE_FRONT_COVER,
 710   GST_TAG_IMAGE_TYPE_BACK_COVER,
 711   GST_TAG_IMAGE_TYPE_LEAFLET_PAGE,
 712   GST_TAG_IMAGE_TYPE_MEDIUM,
 713   GST_TAG_IMAGE_TYPE_LEAD_ARTIST,
 714   GST_TAG_IMAGE_TYPE_ARTIST,
 715   GST_TAG_IMAGE_TYPE_CONDUCTOR,
 716   GST_TAG_IMAGE_TYPE_BAND_ORCHESTRA,
 717   GST_TAG_IMAGE_TYPE_COMPOSER,
 718   GST_TAG_IMAGE_TYPE_LYRICIST,
 719   GST_TAG_IMAGE_TYPE_RECORDING_LOCATION,
 720   GST_TAG_IMAGE_TYPE_DURING_RECORDING,
 721   GST_TAG_IMAGE_TYPE_DURING_PERFORMANCE,
 722   GST_TAG_IMAGE_TYPE_VIDEO_CAPTURE,
 723   GST_TAG_IMAGE_TYPE_FISH,
 724   GST_TAG_IMAGE_TYPE_ILLUSTRATION,
 725   GST_TAG_IMAGE_TYPE_BAND_ARTIST_LOGO,
 726   GST_TAG_IMAGE_TYPE_PUBLISHER_STUDIO_LOGO
 727 } GstTagImageType;
 728 </pre>
 729 <p>
 730 Type of image contained in an image tag (specified as field in
 731 the image buffer's caps structure)
 732 </p>
 733 <div class="variablelist"><table border="0">
 734 <col align="left" valign="top">
 735 <tbody>
 736 <tr>
 737 <td><p><a name="GST-TAG-IMAGE-TYPE-NONE:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_NONE</code></span></p></td>
 738 <td>No image type. Can be used to
 739      tell functions such as <a class="link" href="gst-plugins-base-libs-gsttag.html#gst-tag-image-data-to-image-buffer" title="gst_tag_image_data_to_image_buffer ()"><code class="function">gst_tag_image_data_to_image_buffer()</code></a> that no
 740      image type should be set. (Since: 0.10.20)
 741 </td>
 742 </tr>
 743 <tr>
 744 <td><p><a name="GST-TAG-IMAGE-TYPE-UNDEFINED:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_UNDEFINED</code></span></p></td>
 745 <td>Undefined/other image type
 746 </td>
 747 </tr>
 748 <tr>
 749 <td><p><a name="GST-TAG-IMAGE-TYPE-FRONT-COVER:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_FRONT_COVER</code></span></p></td>
 750 <td>Cover (front)
 751 </td>
 752 </tr>
 753 <tr>
 754 <td><p><a name="GST-TAG-IMAGE-TYPE-BACK-COVER:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_BACK_COVER</code></span></p></td>
 755 <td>Cover (back)
 756 </td>
 757 </tr>
 758 <tr>
 759 <td><p><a name="GST-TAG-IMAGE-TYPE-LEAFLET-PAGE:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_LEAFLET_PAGE</code></span></p></td>
 760 <td>Leaflet page
 761 </td>
 762 </tr>
 763 <tr>
 764 <td><p><a name="GST-TAG-IMAGE-TYPE-MEDIUM:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_MEDIUM</code></span></p></td>
 765 <td>Medium (e.g. label side of CD)
 766 </td>
 767 </tr>
 768 <tr>
 769 <td><p><a name="GST-TAG-IMAGE-TYPE-LEAD-ARTIST:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_LEAD_ARTIST</code></span></p></td>
 770 <td>Lead artist/lead performer/soloist
 771 </td>
 772 </tr>
 773 <tr>
 774 <td><p><a name="GST-TAG-IMAGE-TYPE-ARTIST:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_ARTIST</code></span></p></td>
 775 <td>Artist/performer
 776 </td>
 777 </tr>
 778 <tr>
 779 <td><p><a name="GST-TAG-IMAGE-TYPE-CONDUCTOR:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_CONDUCTOR</code></span></p></td>
 780 <td>Conductor
 781 </td>
 782 </tr>
 783 <tr>
 784 <td><p><a name="GST-TAG-IMAGE-TYPE-BAND-ORCHESTRA:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_BAND_ORCHESTRA</code></span></p></td>
 785 <td>Band/orchestra
 786 </td>
 787 </tr>
 788 <tr>
 789 <td><p><a name="GST-TAG-IMAGE-TYPE-COMPOSER:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_COMPOSER</code></span></p></td>
 790 <td>Composer
 791 </td>
 792 </tr>
 793 <tr>
 794 <td><p><a name="GST-TAG-IMAGE-TYPE-LYRICIST:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_LYRICIST</code></span></p></td>
 795 <td>Lyricist/text writer
 796 </td>
 797 </tr>
 798 <tr>
 799 <td><p><a name="GST-TAG-IMAGE-TYPE-RECORDING-LOCATION:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_RECORDING_LOCATION</code></span></p></td>
 800 <td>Recording location
 801 </td>
 802 </tr>
 803 <tr>
 804 <td><p><a name="GST-TAG-IMAGE-TYPE-DURING-RECORDING:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_DURING_RECORDING</code></span></p></td>
 805 <td>During recording
 806 </td>
 807 </tr>
 808 <tr>
 809 <td><p><a name="GST-TAG-IMAGE-TYPE-DURING-PERFORMANCE:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_DURING_PERFORMANCE</code></span></p></td>
 810 <td>During performance
 811 </td>
 812 </tr>
 813 <tr>
 814 <td><p><a name="GST-TAG-IMAGE-TYPE-VIDEO-CAPTURE:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_VIDEO_CAPTURE</code></span></p></td>
 815 <td>Movie/video screen capture
 816 </td>
 817 </tr>
 818 <tr>
 819 <td><p><a name="GST-TAG-IMAGE-TYPE-FISH:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_FISH</code></span></p></td>
 820 <td>A fish as funny as the ID3v2 spec
 821 </td>
 822 </tr>
 823 <tr>
 824 <td><p><a name="GST-TAG-IMAGE-TYPE-ILLUSTRATION:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_ILLUSTRATION</code></span></p></td>
 825 <td>Illustration
 826 </td>
 827 </tr>
 828 <tr>
 829 <td><p><a name="GST-TAG-IMAGE-TYPE-BAND-ARTIST-LOGO:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_BAND_ARTIST_LOGO</code></span></p></td>
 830 <td>Band/artist logotype
 831 </td>
 832 </tr>
 833 <tr>
 834 <td><p><a name="GST-TAG-IMAGE-TYPE-PUBLISHER-STUDIO-LOGO:CAPS"></a><span class="term"><code class="literal">GST_TAG_IMAGE_TYPE_PUBLISHER_STUDIO_LOGO</code></span></p></td>
 835 <td>Publisher/studio logotype
 836 </td>
 837 </tr>
 838 </tbody>
 839 </table></div>
 840 <p class="since">Since 0.10.9</p>
 841 </div>
 842 </div>
 843 <div class="refsect1">
 844 <a name="gst-plugins-base-libs-gsttag.see-also"></a><h2>See Also</h2>
 845 <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstTagList.html#GstTagList"><span class="type">GstTagList</span></a>
 846 </div>
 847 </div>
 848 <div class="footer">
 849 <hr>
 850           Generated by GTK-Doc V1.18</div>
 851 </body>
 852 </html>