unmaintained/gstreamer/plugins/tag/GstTag-0.10.gir

   1 <?xml version="1.0"?>
   2 <!-- This file was automatically generated from C sources - DO NOT EDIT!
   3 To affect the contents of this file, edit the original C definitions,
   4 and/or use gtk-doc annotations.  -->
   5 <repository version="1.2"
   6             xmlns="http://www.gtk.org/introspection/core/1.0"
   7             xmlns:c="http://www.gtk.org/introspection/c/1.0"
   8             xmlns:glib="http://www.gtk.org/introspection/glib/1.0">
   9   <include name="GLib" version="2.0"/>
  10   <include name="GModule" version="2.0"/>
  11   <include name="GObject" version="2.0"/>
  12   <include name="Gst" version="0.10"/>
  13   <include name="GstBase" version="0.10"/>
  14   <include name="libxml2" version="2.0"/>
  15   <package name="gstreamer-tag-0.10"/>
  16   <namespace name="GstTag"
  17              version="0.10"
  18              shared-library="libgsttag-0.10.so.0"
  19              c:identifier-prefixes="Gst"
  20              c:symbol-prefixes="gst">
  21     <constant name="TAG_CAPTURING_CONTRAST" value="capturing-contrast">
  22       <type name="utf8" c:type="gchar*"/>
  23     </constant>
  24     <constant name="TAG_CAPTURING_DIGITAL_ZOOM_RATIO"
  25               value="capturing-digital-zoom-ratio">
  26       <type name="utf8" c:type="gchar*"/>
  27     </constant>
  28     <constant name="TAG_CAPTURING_EXPOSURE_MODE"
  29               value="capturing-exposure-mode">
  30       <type name="utf8" c:type="gchar*"/>
  31     </constant>
  32     <constant name="TAG_CAPTURING_EXPOSURE_PROGRAM"
  33               value="capturing-exposure-program">
  34       <type name="utf8" c:type="gchar*"/>
  35     </constant>
  36     <constant name="TAG_CAPTURING_FLASH_FIRED" value="capturing-flash-fired">
  37       <type name="utf8" c:type="gchar*"/>
  38     </constant>
  39     <constant name="TAG_CAPTURING_FLASH_MODE" value="capturing-flash-mode">
  40       <type name="utf8" c:type="gchar*"/>
  41     </constant>
  42     <constant name="TAG_CAPTURING_FOCAL_LENGTH" value="capturing-focal-length">
  43       <type name="utf8" c:type="gchar*"/>
  44     </constant>
  45     <constant name="TAG_CAPTURING_FOCAL_RATIO" value="capturing-focal-ratio">
  46       <type name="utf8" c:type="gchar*"/>
  47     </constant>
  48     <constant name="TAG_CAPTURING_GAIN_ADJUSTMENT"
  49               value="capturing-gain-adjustment">
  50       <type name="utf8" c:type="gchar*"/>
  51     </constant>
  52     <constant name="TAG_CAPTURING_ISO_SPEED" value="capturing-iso-speed">
  53       <type name="utf8" c:type="gchar*"/>
  54     </constant>
  55     <constant name="TAG_CAPTURING_METERING_MODE"
  56               value="capturing-metering-mode">
  57       <type name="utf8" c:type="gchar*"/>
  58     </constant>
  59     <constant name="TAG_CAPTURING_SATURATION" value="capturing-saturation">
  60       <type name="utf8" c:type="gchar*"/>
  61     </constant>
  62     <constant name="TAG_CAPTURING_SCENE_CAPTURE_TYPE"
  63               value="capturing-scene-capture-type">
  64       <type name="utf8" c:type="gchar*"/>
  65     </constant>
  66     <constant name="TAG_CAPTURING_SHARPNESS" value="capturing-sharpness">
  67       <type name="utf8" c:type="gchar*"/>
  68     </constant>
  69     <constant name="TAG_CAPTURING_SHUTTER_SPEED"
  70               value="capturing-shutter-speed">
  71       <type name="utf8" c:type="gchar*"/>
  72     </constant>
  73     <constant name="TAG_CAPTURING_SOURCE" value="capturing-source">
  74       <type name="utf8" c:type="gchar*"/>
  75     </constant>
  76     <constant name="TAG_CAPTURING_WHITE_BALANCE"
  77               value="capturing-white-balance">
  78       <type name="utf8" c:type="gchar*"/>
  79     </constant>
  80     <constant name="TAG_CDDA_CDDB_DISCID" value="discid">
  81       <type name="utf8" c:type="gchar*"/>
  82     </constant>
  83     <constant name="TAG_CDDA_CDDB_DISCID_FULL" value="discid-full">
  84       <type name="utf8" c:type="gchar*"/>
  85     </constant>
  86     <constant name="TAG_CDDA_MUSICBRAINZ_DISCID" value="musicbrainz-discid">
  87       <type name="utf8" c:type="gchar*"/>
  88     </constant>
  89     <constant name="TAG_CDDA_MUSICBRAINZ_DISCID_FULL"
  90               value="musicbrainz-discid-full">
  91       <type name="utf8" c:type="gchar*"/>
  92     </constant>
  93     <constant name="TAG_CMML_CLIP" value="cmml-clip">
  94       <type name="utf8" c:type="gchar*"/>
  95     </constant>
  96     <constant name="TAG_CMML_HEAD" value="cmml-head">
  97       <type name="utf8" c:type="gchar*"/>
  98     </constant>
  99     <constant name="TAG_CMML_STREAM" value="cmml-stream">
 100       <type name="utf8" c:type="gchar*"/>
 101     </constant>
 102     <constant name="TAG_IMAGE_HORIZONTAL_PPI" value="image-horizontal-ppi">
 103       <type name="utf8" c:type="gchar*"/>
 104     </constant>
 105     <constant name="TAG_IMAGE_VERTICAL_PPI" value="image-vertical-ppi">
 106       <type name="utf8" c:type="gchar*"/>
 107     </constant>
 108     <constant name="TAG_MUSICBRAINZ_ALBUMARTISTID"
 109               value="musicbrainz-albumartistid">
 110       <type name="utf8" c:type="gchar*"/>
 111     </constant>
 112     <constant name="TAG_MUSICBRAINZ_ALBUMID" value="musicbrainz-albumid">
 113       <type name="utf8" c:type="gchar*"/>
 114     </constant>
 115     <constant name="TAG_MUSICBRAINZ_ARTISTID" value="musicbrainz-artistid">
 116       <type name="utf8" c:type="gchar*"/>
 117     </constant>
 118     <constant name="TAG_MUSICBRAINZ_TRACKID" value="musicbrainz-trackid">
 119       <type name="utf8" c:type="gchar*"/>
 120     </constant>
 121     <constant name="TAG_MUSICBRAINZ_TRMID" value="musicbrainz-trmid">
 122       <type name="utf8" c:type="gchar*"/>
 123     </constant>
 124     <class name="TagDemux"
 125            c:symbol-prefix="tag_demux"
 126            c:type="GstTagDemux"
 127            version="0.10.15"
 128            parent="Gst.Element"
 129            abstract="1"
 130            glib:type-name="GstTagDemux"
 131            glib:get-type="gst_tag_demux_get_type"
 132            glib:type-struct="TagDemuxClass">
 133       <doc xml:whitespace="preserve">Opaque #GstTagDemux structure.</doc>
 134       <virtual-method name="identify_tag">
 135         <return-value transfer-ownership="none">
 136           <type name="gboolean" c:type="gboolean"/>
 137         </return-value>
 138         <parameters>
 139           <parameter name="buffer" transfer-ownership="none">
 140             <type name="Gst.Buffer" c:type="GstBuffer*"/>
 141           </parameter>
 142           <parameter name="start_tag" transfer-ownership="none">
 143             <type name="gboolean" c:type="gboolean"/>
 144           </parameter>
 145           <parameter name="tag_size" transfer-ownership="none">
 146             <type name="guint" c:type="guint*"/>
 147           </parameter>
 148         </parameters>
 149       </virtual-method>
 150       <virtual-method name="merge_tags">
 151         <return-value transfer-ownership="full">
 152           <type name="Gst.TagList" c:type="GstTagList*"/>
 153         </return-value>
 154         <parameters>
 155           <parameter name="start_tags" transfer-ownership="none">
 156             <type name="Gst.TagList" c:type="GstTagList*"/>
 157           </parameter>
 158           <parameter name="end_tags" transfer-ownership="none">
 159             <type name="Gst.TagList" c:type="GstTagList*"/>
 160           </parameter>
 161         </parameters>
 162       </virtual-method>
 163       <virtual-method name="parse_tag">
 164         <return-value transfer-ownership="none">
 165           <type name="TagDemuxResult" c:type="GstTagDemuxResult"/>
 166         </return-value>
 167         <parameters>
 168           <parameter name="buffer" transfer-ownership="none">
 169             <type name="Gst.Buffer" c:type="GstBuffer*"/>
 170           </parameter>
 171           <parameter name="start_tag" transfer-ownership="none">
 172             <type name="gboolean" c:type="gboolean"/>
 173           </parameter>
 174           <parameter name="tag_size" transfer-ownership="none">
 175             <type name="guint" c:type="guint*"/>
 176           </parameter>
 177           <parameter name="tags" transfer-ownership="none">
 178             <type name="Gst.TagList" c:type="GstTagList**"/>
 179           </parameter>
 180         </parameters>
 181       </virtual-method>
 182       <field name="element">
 183         <type name="Gst.Element" c:type="GstElement"/>
 184       </field>
 185       <field name="priv">
 186         <type name="TagDemuxPrivate" c:type="GstTagDemuxPrivate*"/>
 187       </field>
 188       <field name="reserved">
 189         <array zero-terminated="0" c:type="gpointer" fixed-size="4">
 190           <type name="gpointer" c:type="gpointer"/>
 191         </array>
 192       </field>
 193     </class>
 194     <record name="TagDemuxClass"
 195             c:type="GstTagDemuxClass"
 196             glib:is-gtype-struct-for="TagDemux"
 197             version="0.10.15">
 198       <doc xml:whitespace="preserve">The #GstTagDemuxClass structure.  See documentation at beginning of section
 199 for details about what subclasses need to override and do.</doc>
 200       <field name="parent_class">
 201         <type name="Gst.ElementClass" c:type="GstElementClass"/>
 202       </field>
 203       <field name="min_start_size">
 204         <type name="guint" c:type="guint"/>
 205       </field>
 206       <field name="min_end_size">
 207         <type name="guint" c:type="guint"/>
 208       </field>
 209       <field name="identify_tag">
 210         <callback name="identify_tag">
 211           <return-value transfer-ownership="none">
 212             <type name="gboolean" c:type="gboolean"/>
 213           </return-value>
 214           <parameters>
 215             <parameter name="demux" transfer-ownership="none">
 216               <type name="TagDemux" c:type="GstTagDemux*"/>
 217             </parameter>
 218             <parameter name="buffer" transfer-ownership="none">
 219               <type name="Gst.Buffer" c:type="GstBuffer*"/>
 220             </parameter>
 221             <parameter name="start_tag" transfer-ownership="none">
 222               <type name="gboolean" c:type="gboolean"/>
 223             </parameter>
 224             <parameter name="tag_size" transfer-ownership="none">
 225               <type name="guint" c:type="guint*"/>
 226             </parameter>
 227           </parameters>
 228         </callback>
 229       </field>
 230       <field name="parse_tag">
 231         <callback name="parse_tag">
 232           <return-value transfer-ownership="none">
 233             <type name="TagDemuxResult" c:type="GstTagDemuxResult"/>
 234           </return-value>
 235           <parameters>
 236             <parameter name="demux" transfer-ownership="none">
 237               <type name="TagDemux" c:type="GstTagDemux*"/>
 238             </parameter>
 239             <parameter name="buffer" transfer-ownership="none">
 240               <type name="Gst.Buffer" c:type="GstBuffer*"/>
 241             </parameter>
 242             <parameter name="start_tag" transfer-ownership="none">
 243               <type name="gboolean" c:type="gboolean"/>
 244             </parameter>
 245             <parameter name="tag_size" transfer-ownership="none">
 246               <type name="guint" c:type="guint*"/>
 247             </parameter>
 248             <parameter name="tags" transfer-ownership="none">
 249               <type name="Gst.TagList" c:type="GstTagList**"/>
 250             </parameter>
 251           </parameters>
 252         </callback>
 253       </field>
 254       <field name="merge_tags">
 255         <callback name="merge_tags">
 256           <return-value transfer-ownership="full">
 257             <type name="Gst.TagList" c:type="GstTagList*"/>
 258           </return-value>
 259           <parameters>
 260             <parameter name="demux" transfer-ownership="none">
 261               <type name="TagDemux" c:type="GstTagDemux*"/>
 262             </parameter>
 263             <parameter name="start_tags" transfer-ownership="none">
 264               <type name="Gst.TagList" c:type="GstTagList*"/>
 265             </parameter>
 266             <parameter name="end_tags" transfer-ownership="none">
 267               <type name="Gst.TagList" c:type="GstTagList*"/>
 268             </parameter>
 269           </parameters>
 270         </callback>
 271       </field>
 272       <field name="reserved">
 273         <array zero-terminated="0" c:type="gpointer" fixed-size="4">
 274           <type name="gpointer" c:type="gpointer"/>
 275         </array>
 276       </field>
 277     </record>
 278     <record name="TagDemuxPrivate" c:type="GstTagDemuxPrivate" disguised="1">
 279     </record>
 280     <enumeration name="TagDemuxResult"
 281                  version="0.10.15"
 282                  glib:type-name="GstTagDemuxResult"
 283                  glib:get-type="gst_tag_demux_result_get_type"
 284                  c:type="GstTagDemuxResult">
 285       <doc xml:whitespace="preserve">Result values from the parse_tag virtual function.</doc>
 286       <member name="broken_tag"
 287               value="0"
 288               c:identifier="GST_TAG_DEMUX_RESULT_BROKEN_TAG"
 289               glib:nick="broken-tag"/>
 290       <member name="again"
 291               value="1"
 292               c:identifier="GST_TAG_DEMUX_RESULT_AGAIN"
 293               glib:nick="again"/>
 294       <member name="ok"
 295               value="2"
 296               c:identifier="GST_TAG_DEMUX_RESULT_OK"
 297               glib:nick="ok"/>
 298     </enumeration>
 299     <enumeration name="TagImageType"
 300                  version="0.10.9"
 301                  glib:type-name="GstTagImageType"
 302                  glib:get-type="gst_tag_image_type_get_type"
 303                  c:type="GstTagImageType">
 304       <doc xml:whitespace="preserve">Type of image contained in an image tag (specified as field in
 305 the image buffer's caps structure)</doc>
 306       <member name="none"
 307               value="-1"
 308               c:identifier="GST_TAG_IMAGE_TYPE_NONE"
 309               glib:nick="none"/>
 310       <member name="undefined"
 311               value="0"
 312               c:identifier="GST_TAG_IMAGE_TYPE_UNDEFINED"
 313               glib:nick="undefined"/>
 314       <member name="front_cover"
 315               value="1"
 316               c:identifier="GST_TAG_IMAGE_TYPE_FRONT_COVER"
 317               glib:nick="front-cover"/>
 318       <member name="back_cover"
 319               value="2"
 320               c:identifier="GST_TAG_IMAGE_TYPE_BACK_COVER"
 321               glib:nick="back-cover"/>
 322       <member name="leaflet_page"
 323               value="3"
 324               c:identifier="GST_TAG_IMAGE_TYPE_LEAFLET_PAGE"
 325               glib:nick="leaflet-page"/>
 326       <member name="medium"
 327               value="4"
 328               c:identifier="GST_TAG_IMAGE_TYPE_MEDIUM"
 329               glib:nick="medium"/>
 330       <member name="lead_artist"
 331               value="5"
 332               c:identifier="GST_TAG_IMAGE_TYPE_LEAD_ARTIST"
 333               glib:nick="lead-artist"/>
 334       <member name="artist"
 335               value="6"
 336               c:identifier="GST_TAG_IMAGE_TYPE_ARTIST"
 337               glib:nick="artist"/>
 338       <member name="conductor"
 339               value="7"
 340               c:identifier="GST_TAG_IMAGE_TYPE_CONDUCTOR"
 341               glib:nick="conductor"/>
 342       <member name="band_orchestra"
 343               value="8"
 344               c:identifier="GST_TAG_IMAGE_TYPE_BAND_ORCHESTRA"
 345               glib:nick="band-orchestra"/>
 346       <member name="composer"
 347               value="9"
 348               c:identifier="GST_TAG_IMAGE_TYPE_COMPOSER"
 349               glib:nick="composer"/>
 350       <member name="lyricist"
 351               value="10"
 352               c:identifier="GST_TAG_IMAGE_TYPE_LYRICIST"
 353               glib:nick="lyricist"/>
 354       <member name="recording_location"
 355               value="11"
 356               c:identifier="GST_TAG_IMAGE_TYPE_RECORDING_LOCATION"
 357               glib:nick="recording-location"/>
 358       <member name="during_recording"
 359               value="12"
 360               c:identifier="GST_TAG_IMAGE_TYPE_DURING_RECORDING"
 361               glib:nick="during-recording"/>
 362       <member name="during_performance"
 363               value="13"
 364               c:identifier="GST_TAG_IMAGE_TYPE_DURING_PERFORMANCE"
 365               glib:nick="during-performance"/>
 366       <member name="video_capture"
 367               value="14"
 368               c:identifier="GST_TAG_IMAGE_TYPE_VIDEO_CAPTURE"
 369               glib:nick="video-capture"/>
 370       <member name="fish"
 371               value="15"
 372               c:identifier="GST_TAG_IMAGE_TYPE_FISH"
 373               glib:nick="fish"/>
 374       <member name="illustration"
 375               value="16"
 376               c:identifier="GST_TAG_IMAGE_TYPE_ILLUSTRATION"
 377               glib:nick="illustration"/>
 378       <member name="artist_logo"
 379               value="17"
 380               c:identifier="GST_TAG_IMAGE_TYPE_BAND_ARTIST_LOGO"
 381               glib:nick="artist-logo"/>
 382       <member name="publisher_studio_logo"
 383               value="18"
 384               c:identifier="GST_TAG_IMAGE_TYPE_PUBLISHER_STUDIO_LOGO"
 385               glib:nick="publisher-studio-logo"/>
 386     </enumeration>
 387     <function name="tag_freeform_string_to_utf8"
 388               c:identifier="gst_tag_freeform_string_to_utf8"
 389               version="0.10.13">
 390       <doc xml:whitespace="preserve">Convenience function to read a string with unknown character encoding. If
 391 the string is already in UTF-8 encoding, it will be returned right away.
 392 If not it tries to detect byte-order-mark for UTF-16/32 cases and use that.
 393 Otherwise, the environment will be searched for a number of environment
 394 variables (whose names are specified in the NULL-terminated string array
 395 are specified, the current locale will be tried. If that also doesn't work,
 396 WINDOWS-1252/ISO-8859-1 is assumed (which will almost always succeed).</doc>
 397       <return-value transfer-ownership="full">
 398         <doc xml:whitespace="preserve">a newly-allocated string in UTF-8 encoding, or NULL</doc>
 399         <type name="utf8" c:type="gchar*"/>
 400       </return-value>
 401       <parameters>
 402         <parameter name="data" transfer-ownership="none">
 403           <doc xml:whitespace="preserve">string data</doc>
 404           <type name="utf8" c:type="gchar*"/>
 405         </parameter>
 406         <parameter name="size" transfer-ownership="none">
 407           <doc xml:whitespace="preserve">length of string data, or -1 if the string is NUL-terminated</doc>
 408           <type name="gint" c:type="gint"/>
 409         </parameter>
 410         <parameter name="env_vars" transfer-ownership="none">
 411           <doc xml:whitespace="preserve">a NULL-terminated string array of environment variable names, or NULL</doc>
 412           <type name="utf8" c:type="gchar**"/>
 413         </parameter>
 414       </parameters>
 415     </function>
 416     <function name="tag_from_id3_tag" c:identifier="gst_tag_from_id3_tag">
 417       <doc xml:whitespace="preserve">Looks up the GStreamer tag for a ID3v2 tag.</doc>
 418       <return-value transfer-ownership="none">
 419         <doc xml:whitespace="preserve">The corresponding GStreamer tag or NULL if none exists.</doc>
 420         <type name="utf8" c:type="gchar*"/>
 421       </return-value>
 422       <parameters>
 423         <parameter name="id3_tag" transfer-ownership="none">
 424           <doc xml:whitespace="preserve">ID3v2 tag to convert to GStreamer tag</doc>
 425           <type name="utf8" c:type="gchar*"/>
 426         </parameter>
 427       </parameters>
 428     </function>
 429     <function name="tag_from_id3_user_tag"
 430               c:identifier="gst_tag_from_id3_user_tag">
 431       <doc xml:whitespace="preserve">Looks up the GStreamer tag for an ID3v2 user tag (e.g. description in
 432 TXXX frame or owner in UFID frame).</doc>
 433       <return-value transfer-ownership="none">
 434         <doc xml:whitespace="preserve">The corresponding GStreamer tag or NULL if none exists.</doc>
 435         <type name="utf8" c:type="gchar*"/>
 436       </return-value>
 437       <parameters>
 438         <parameter name="type" transfer-ownership="none">
 439           <doc xml:whitespace="preserve">the type of ID3v2 user tag (e.g. "TXXX" or "UDIF")</doc>
 440           <type name="utf8" c:type="gchar*"/>
 441         </parameter>
 442         <parameter name="id3_user_tag" transfer-ownership="none">
 443           <doc xml:whitespace="preserve">ID3v2 user tag to convert to GStreamer tag</doc>
 444           <type name="utf8" c:type="gchar*"/>
 445         </parameter>
 446       </parameters>
 447     </function>
 448     <function name="tag_from_vorbis_tag"
 449               c:identifier="gst_tag_from_vorbis_tag">
 450       <doc xml:whitespace="preserve">Looks up the GStreamer tag for a vorbiscomment tag.</doc>
 451       <return-value transfer-ownership="none">
 452         <doc xml:whitespace="preserve">The corresponding GStreamer tag or NULL if none exists.</doc>
 453         <type name="utf8" c:type="gchar*"/>
 454       </return-value>
 455       <parameters>
 456         <parameter name="vorbis_tag" transfer-ownership="none">
 457           <doc xml:whitespace="preserve">vorbiscomment tag to convert to GStreamer tag</doc>
 458           <type name="utf8" c:type="gchar*"/>
 459         </parameter>
 460       </parameters>
 461     </function>
 462     <function name="tag_get_language_code_iso_639_1"
 463               c:identifier="gst_tag_get_language_code_iso_639_1"
 464               version="0.10.26">
 465       <doc xml:whitespace="preserve">Returns two-letter ISO-639-1 language code given a three-letter ISO-639-2
 466 language code or two-letter ISO-639-1 language code (both are accepted for
 467 convenience).
 468 Language codes are case-sensitive and expected to be lower case.
 469 or NULL if no mapping is known. The returned string must not be
 470 modified or freed.</doc>
 471       <return-value transfer-ownership="none">
 472         <doc xml:whitespace="preserve">two-letter ISO-639-1 language code string that maps to @lang_code,</doc>
 473         <type name="utf8" c:type="gchar*"/>
 474       </return-value>
 475       <parameters>
 476         <parameter name="lang_code" transfer-ownership="none">
 477           <doc xml:whitespace="preserve">ISO-639 language code (e.g. "deu" or "ger" or "de")</doc>
 478           <type name="utf8" c:type="gchar*"/>
 479         </parameter>
 480       </parameters>
 481     </function>
 482     <function name="tag_get_language_code_iso_639_2B"
 483               c:identifier="gst_tag_get_language_code_iso_639_2B"
 484               version="0.10.26">
 485       <doc xml:whitespace="preserve">Returns three-letter ISO-639-2 "bibliographic" language code given a
 486 two-letter ISO-639-1 language code or a three-letter ISO-639-2 language
 487 code (both are accepted for convenience).
 488 The "bibliographic" code is derived from the English name of the language
 489 (e.g. "ger" for German instead of "de" or "deu"). In most scenarios, the
 490 "terminological" codes are prefered.
 491 Language codes are case-sensitive and expected to be lower case.
 492 or NULL if no mapping is known. The returned string must not be
 493 modified or freed.</doc>
 494       <return-value transfer-ownership="none">
 495         <doc xml:whitespace="preserve">three-letter ISO-639-2 language code string that maps to @lang_code,</doc>
 496         <type name="utf8" c:type="gchar*"/>
 497       </return-value>
 498       <parameters>
 499         <parameter name="lang_code" transfer-ownership="none">
 500           <doc xml:whitespace="preserve">ISO-639 language code (e.g. "deu" or "ger" or "de")</doc>
 501           <type name="utf8" c:type="gchar*"/>
 502         </parameter>
 503       </parameters>
 504     </function>
 505     <function name="tag_get_language_code_iso_639_2T"
 506               c:identifier="gst_tag_get_language_code_iso_639_2T"
 507               version="0.10.26">
 508       <doc xml:whitespace="preserve">Returns three-letter ISO-639-2 "terminological" language code given a
 509 two-letter ISO-639-1 language code or a three-letter ISO-639-2 language
 510 code (both are accepted for convenience).
 511 The "terminological" code is derived from the local name of the language
 512 (e.g. "deu" for German instead of "ger"). In most scenarios, the
 513 "terminological" codes are prefered over the "bibliographic" ones.
 514 Language codes are case-sensitive and expected to be lower case.
 515 or NULL if no mapping is known. The returned string must not be
 516 modified or freed.</doc>
 517       <return-value transfer-ownership="none">
 518         <doc xml:whitespace="preserve">three-letter ISO-639-2 language code string that maps to @lang_code,</doc>
 519         <type name="utf8" c:type="gchar*"/>
 520       </return-value>
 521       <parameters>
 522         <parameter name="lang_code" transfer-ownership="none">
 523           <doc xml:whitespace="preserve">ISO-639 language code (e.g. "deu" or "ger" or "de")</doc>
 524           <type name="utf8" c:type="gchar*"/>
 525         </parameter>
 526       </parameters>
 527     </function>
 528     <function name="tag_get_language_codes"
 529               c:identifier="gst_tag_get_language_codes"
 530               version="0.10.26"
 531               introspectable="0">
 532       <doc xml:whitespace="preserve">Returns a list of known language codes (in form of two-letter ISO-639-1
 533 codes). This is useful for UIs to build a list of available languages for
 534 tagging purposes (e.g. to tag an audio track appropriately in a video or
 535 audio editor).
 536 with g_strfreev() when no longer needed.</doc>
 537       <return-value>
 538         <doc xml:whitespace="preserve">NULL-terminated string array with two-letter language codes. Free</doc>
 539         <array c:type="gchar**">
 540           <type name="utf8"/>
 541         </array>
 542       </return-value>
 543     </function>
 544     <function name="tag_get_language_name"
 545               c:identifier="gst_tag_get_language_name"
 546               version="0.10.26">
 547       <doc xml:whitespace="preserve">Returns the name of the language given an ISO-639 language code, such
 548 as often found in a GST_TAG_LANGUAGE tag. The name will be translated
 549 according to the current locale (if the library was built against the
 550 iso-codes package, otherwise the English name will be returned).
 551 Language codes are case-sensitive and expected to be lower case.
 552 not be mapped to a language name. The returned string must not be
 553 modified and does not need to freed; it will stay valid until the
 554 application is terminated.</doc>
 555       <return-value transfer-ownership="none">
 556         <doc xml:whitespace="preserve">language name in UTF-8 format, or NULL if @language_code could</doc>
 557         <type name="utf8" c:type="gchar*"/>
 558       </return-value>
 559       <parameters>
 560         <parameter name="language_code" transfer-ownership="none">
 561           <doc xml:whitespace="preserve">two or three-letter ISO-639 language code</doc>
 562           <type name="utf8" c:type="gchar*"/>
 563         </parameter>
 564       </parameters>
 565     </function>
 566     <function name="tag_id3_genre_count"
 567               c:identifier="gst_tag_id3_genre_count">
 568       <doc xml:whitespace="preserve">Gets the number of ID3v1 genres that can be identified. Winamp genres are
 569 included.</doc>
 570       <return-value transfer-ownership="none">
 571         <doc xml:whitespace="preserve">the number of ID3v1 genres that can be identified</doc>
 572         <type name="guint" c:type="guint"/>
 573       </return-value>
 574     </function>
 575     <function name="tag_id3_genre_get" c:identifier="gst_tag_id3_genre_get">
 576       <doc xml:whitespace="preserve">Gets the ID3v1 genre name for a given ID.</doc>
 577       <return-value transfer-ownership="none">
 578         <doc xml:whitespace="preserve">the genre or NULL if no genre is associated with that ID.</doc>
 579         <type name="utf8" c:type="gchar*"/>
 580       </return-value>
 581       <parameters>
 582         <parameter name="id" transfer-ownership="none">
 583           <doc xml:whitespace="preserve">ID of genre to query</doc>
 584           <type name="guint" c:type="guint"/>
 585         </parameter>
 586       </parameters>
 587     </function>
 588     <function name="tag_image_data_to_image_buffer"
 589               c:identifier="gst_tag_image_data_to_image_buffer"
 590               version="0.10.20"
 591               introspectable="0">
 592       <doc xml:whitespace="preserve">Helper function for tag-reading plugins to create a #GstBuffer suitable to
 593 add to a #GstTagList as an image tag (such as #GST_TAG_IMAGE or
 594 #GST_TAG_PREVIEW_IMAGE) from the encoded image data and an (optional) image
 595 type.
 596 blob of binary image data, often accompanied by a MIME type or some other
 597 content type string (e.g. 'png', 'jpeg', 'jpg'). Sometimes there is also an
 598 'image type' to indicate what kind of image this is (e.g. front cover,
 599 back cover, artist, etc.). The image data may also be an URI to the image
 600 rather than the image itself.
 601 In GStreamer, image tags are #GstBuffer&lt;!-- --&gt;s containing the raw image
 602 data, with the buffer caps describing the content type of the image
 603 (e.g. image/jpeg, image/png, text/uri-list). The buffer caps may contain
 604 an additional 'image-type' field of #GST_TYPE_TAG_IMAGE_TYPE to describe
 605 the type of image (front cover, back cover etc.). #GST_TAG_PREVIEW_IMAGE
 606 tags should not carry an image type, their type is already indicated via
 607 the special tag name.
 608 This function will do various checks and typefind the encoded image
 609 data (we can't trust the declared mime type).</doc>
 610       <return-value>
 611         <doc xml:whitespace="preserve">a newly-allocated image buffer for use in tag lists, or NULL</doc>
 612         <type name="Gst.Buffer" c:type="GstBuffer*"/>
 613       </return-value>
 614       <parameters>
 615         <parameter name="image_data" transfer-ownership="none">
 616           <doc xml:whitespace="preserve">the (encoded) image</doc>
 617           <type name="guint8" c:type="guint8*"/>
 618         </parameter>
 619         <parameter name="image_data_len" transfer-ownership="none">
 620           <doc xml:whitespace="preserve">the length of the encoded image data at @image_data</doc>
 621           <type name="guint" c:type="guint"/>
 622         </parameter>
 623         <parameter name="image_type" transfer-ownership="none">
 624           <doc xml:whitespace="preserve">type of the image, or #GST_TAG_IMAGE_TYPE_UNDEFINED. Pass #GST_TAG_IMAGE_TYPE_NONE if no image type should be set at all (e.g. for preview images)</doc>
 625           <type name="TagImageType" c:type="GstTagImageType"/>
 626         </parameter>
 627       </parameters>
 628     </function>
 629     <function name="tag_list_add_id3_image"
 630               c:identifier="gst_tag_list_add_id3_image"
 631               version="0.10.20">
 632       <doc xml:whitespace="preserve">Adds an image from an ID3 APIC frame (or similar, such as used in FLAC)
 633 to the given tag list. Also see gst_tag_image_data_to_image_buffer() for
 634 more information on image tags in GStreamer.</doc>
 635       <return-value transfer-ownership="none">
 636         <doc xml:whitespace="preserve">%TRUE if the image was processed, otherwise %FALSE</doc>
 637         <type name="gboolean" c:type="gboolean"/>
 638       </return-value>
 639       <parameters>
 640         <parameter name="tag_list" transfer-ownership="none">
 641           <doc xml:whitespace="preserve">a tag list</doc>
 642           <type name="Gst.TagList" c:type="GstTagList*"/>
 643         </parameter>
 644         <parameter name="image_data" transfer-ownership="none">
 645           <doc xml:whitespace="preserve">the (encoded) image</doc>
 646           <type name="guint8" c:type="guint8*"/>
 647         </parameter>
 648         <parameter name="image_data_len" transfer-ownership="none">
 649           <doc xml:whitespace="preserve">the length of the encoded image data at @image_data</doc>
 650           <type name="guint" c:type="guint"/>
 651         </parameter>
 652         <parameter name="id3_picture_type" transfer-ownership="none">
 653           <doc xml:whitespace="preserve">picture type as per the ID3 (v2.4.0) specification for the APIC frame (0 = unknown/other)</doc>
 654           <type name="guint" c:type="guint"/>
 655         </parameter>
 656       </parameters>
 657     </function>
 658     <function name="tag_list_from_exif_buffer"
 659               c:identifier="gst_tag_list_from_exif_buffer"
 660               version="0.10.30">
 661       <doc xml:whitespace="preserve">Parses the IFD and IFD tags data contained in the buffer and puts it
 662 on a taglist. The base_offset is used to subtract from the offset in
 663 the tag entries and be able to get the offset relative to the buffer
 664 start</doc>
 665       <return-value transfer-ownership="full">
 666         <doc xml:whitespace="preserve">The parsed taglist</doc>
 667         <type name="Gst.TagList" c:type="GstTagList*"/>
 668       </return-value>
 669       <parameters>
 670         <parameter name="buffer" transfer-ownership="none">
 671           <doc xml:whitespace="preserve">The exif buffer</doc>
 672           <type name="Gst.Buffer" c:type="GstBuffer*"/>
 673         </parameter>
 674         <parameter name="byte_order" transfer-ownership="none">
 675           <doc xml:whitespace="preserve">byte order of the data</doc>
 676           <type name="gint" c:type="gint"/>
 677         </parameter>
 678         <parameter name="base_offset" transfer-ownership="none">
 679           <doc xml:whitespace="preserve">Offset from the tiff header to this buffer</doc>
 680           <type name="guint32" c:type="guint32"/>
 681         </parameter>
 682       </parameters>
 683     </function>
 684     <function name="tag_list_from_exif_buffer_with_tiff_header"
 685               c:identifier="gst_tag_list_from_exif_buffer_with_tiff_header"
 686               version="0.10.30">
 687       <doc xml:whitespace="preserve">Parses the exif tags starting with a tiff header structure.</doc>
 688       <return-value transfer-ownership="full">
 689         <doc xml:whitespace="preserve">The taglist</doc>
 690         <type name="Gst.TagList" c:type="GstTagList*"/>
 691       </return-value>
 692       <parameters>
 693         <parameter name="buffer" transfer-ownership="none">
 694           <doc xml:whitespace="preserve">The exif buffer</doc>
 695           <type name="Gst.Buffer" c:type="GstBuffer*"/>
 696         </parameter>
 697       </parameters>
 698     </function>
 699     <function name="tag_list_from_vorbiscomment_buffer"
 700               c:identifier="gst_tag_list_from_vorbiscomment_buffer">
 701       <doc xml:whitespace="preserve">Creates a new tag list that contains the information parsed out of a
 702 vorbiscomment packet.
 703 given vorbiscomment buffer or NULL on error.</doc>
 704       <return-value transfer-ownership="full">
 705         <doc xml:whitespace="preserve">A new #GstTagList with all tags that could be extracted from the</doc>
 706         <type name="Gst.TagList" c:type="GstTagList*"/>
 707       </return-value>
 708       <parameters>
 709         <parameter name="buffer" transfer-ownership="none">
 710           <doc xml:whitespace="preserve">buffer to convert</doc>
 711           <type name="Gst.Buffer" c:type="GstBuffer*"/>
 712         </parameter>
 713         <parameter name="id_data" transfer-ownership="none">
 714           <doc xml:whitespace="preserve">identification data at start of stream</doc>
 715           <type name="guint8" c:type="guint8*"/>
 716         </parameter>
 717         <parameter name="id_data_length" transfer-ownership="none">
 718           <doc xml:whitespace="preserve">length of identification data</doc>
 719           <type name="guint" c:type="guint"/>
 720         </parameter>
 721         <parameter name="vendor_string" transfer-ownership="none">
 722           <doc xml:whitespace="preserve">pointer to a string that should take the vendor string of this vorbis comment or NULL if you don't need it.</doc>
 723           <type name="utf8" c:type="gchar**"/>
 724         </parameter>
 725       </parameters>
 726     </function>
 727     <function name="tag_list_from_xmp_buffer"
 728               c:identifier="gst_tag_list_from_xmp_buffer"
 729               version="0.10.29">
 730       <doc xml:whitespace="preserve">Parse a xmp packet into a taglist.</doc>
 731       <return-value transfer-ownership="full">
 732         <doc xml:whitespace="preserve">new taglist or %NULL, free the list when done</doc>
 733         <type name="Gst.TagList" c:type="GstTagList*"/>
 734       </return-value>
 735       <parameters>
 736         <parameter name="buffer" transfer-ownership="none">
 737           <doc xml:whitespace="preserve">buffer</doc>
 738           <type name="Gst.Buffer" c:type="GstBuffer*"/>
 739         </parameter>
 740       </parameters>
 741     </function>
 742     <function name="tag_list_new_from_id3v1"
 743               c:identifier="gst_tag_list_new_from_id3v1">
 744       <doc xml:whitespace="preserve">Parses the data containing an ID3v1 tag and returns a #GstTagList from the
 745 parsed data.</doc>
 746       <return-value transfer-ownership="full">
 747         <doc xml:whitespace="preserve">A new tag list or NULL if the data was not an ID3v1 tag.</doc>
 748         <type name="Gst.TagList" c:type="GstTagList*"/>
 749       </return-value>
 750       <parameters>
 751         <parameter name="data" transfer-ownership="none">
 752           <doc xml:whitespace="preserve">128 bytes of data containing the ID3v1 tag</doc>
 753           <type name="guint8" c:type="guint8*"/>
 754         </parameter>
 755       </parameters>
 756     </function>
 757     <function name="tag_list_to_exif_buffer"
 758               c:identifier="gst_tag_list_to_exif_buffer"
 759               version="0.10.30"
 760               introspectable="0">
 761       <doc xml:whitespace="preserve">Formats the tags in taglist on exif format. The resulting buffer contains
 762 the tags IFD and is followed by the data pointed by the tag entries.</doc>
 763       <return-value>
 764         <doc xml:whitespace="preserve">A GstBuffer containing the tag entries followed by the tag data</doc>
 765         <type name="Gst.Buffer" c:type="GstBuffer*"/>
 766       </return-value>
 767       <parameters>
 768         <parameter name="taglist" transfer-ownership="none">
 769           <doc xml:whitespace="preserve">The taglist</doc>
 770           <type name="Gst.TagList" c:type="GstTagList*"/>
 771         </parameter>
 772         <parameter name="byte_order" transfer-ownership="none">
 773           <doc xml:whitespace="preserve">byte order used in writing (G_LITTLE_ENDIAN or G_BIG_ENDIAN)</doc>
 774           <type name="gint" c:type="gint"/>
 775         </parameter>
 776         <parameter name="base_offset" transfer-ownership="none">
 777           <doc xml:whitespace="preserve">Offset from the tiff header first byte</doc>
 778           <type name="guint32" c:type="guint32"/>
 779         </parameter>
 780       </parameters>
 781     </function>
 782     <function name="tag_list_to_exif_buffer_with_tiff_header"
 783               c:identifier="gst_tag_list_to_exif_buffer_with_tiff_header"
 784               version="0.10.30"
 785               introspectable="0">
 786       <doc xml:whitespace="preserve">Formats the tags in taglist into exif structure, a tiff header
 787 is put in the beginning of the buffer.</doc>
 788       <return-value>
 789         <doc xml:whitespace="preserve">A GstBuffer containing the data</doc>
 790         <type name="Gst.Buffer" c:type="GstBuffer*"/>
 791       </return-value>
 792       <parameters>
 793         <parameter name="taglist" transfer-ownership="none">
 794           <doc xml:whitespace="preserve">The taglist</doc>
 795           <type name="Gst.TagList" c:type="GstTagList*"/>
 796         </parameter>
 797       </parameters>
 798     </function>
 799     <function name="tag_list_to_vorbiscomment_buffer"
 800               c:identifier="gst_tag_list_to_vorbiscomment_buffer"
 801               introspectable="0">
 802       <doc xml:whitespace="preserve">Creates a new vorbiscomment buffer from a tag list.
 803 that could be converted from the given tag list.</doc>
 804       <return-value>
 805         <doc xml:whitespace="preserve">A new #GstBuffer containing a vorbiscomment buffer with all tags</doc>
 806         <type name="Gst.Buffer" c:type="GstBuffer*"/>
 807       </return-value>
 808       <parameters>
 809         <parameter name="list" transfer-ownership="none">
 810           <doc xml:whitespace="preserve">tag list to convert</doc>
 811           <type name="Gst.TagList" c:type="GstTagList*"/>
 812         </parameter>
 813         <parameter name="id_data" transfer-ownership="none">
 814           <doc xml:whitespace="preserve">identification data at start of stream</doc>
 815           <type name="guint8" c:type="guint8*"/>
 816         </parameter>
 817         <parameter name="id_data_length" transfer-ownership="none">
 818           <doc xml:whitespace="preserve">length of identification data, may be 0 if @id_data is NULL</doc>
 819           <type name="guint" c:type="guint"/>
 820         </parameter>
 821         <parameter name="vendor_string" transfer-ownership="none">
 822           <doc xml:whitespace="preserve">string that describes the vendor string or NULL</doc>
 823           <type name="utf8" c:type="gchar*"/>
 824         </parameter>
 825       </parameters>
 826     </function>
 827     <function name="tag_list_to_xmp_buffer"
 828               c:identifier="gst_tag_list_to_xmp_buffer"
 829               version="0.10.29"
 830               introspectable="0">
 831       <doc xml:whitespace="preserve">Formats a taglist as a xmp packet.</doc>
 832       <return-value>
 833         <doc xml:whitespace="preserve">new buffer or %NULL, unref the buffer when done</doc>
 834         <type name="Gst.Buffer" c:type="GstBuffer*"/>
 835       </return-value>
 836       <parameters>
 837         <parameter name="list" transfer-ownership="none">
 838           <doc xml:whitespace="preserve">tags</doc>
 839           <type name="Gst.TagList" c:type="GstTagList*"/>
 840         </parameter>
 841         <parameter name="read_only" transfer-ownership="none">
 842           <doc xml:whitespace="preserve">does the container forbid inplace editing</doc>
 843           <type name="gboolean" c:type="gboolean"/>
 844         </parameter>
 845       </parameters>
 846     </function>
 847     <function name="tag_parse_extended_comment"
 848               c:identifier="gst_tag_parse_extended_comment"
 849               version="0.10.10">
 850       <doc xml:whitespace="preserve">Convenience function to parse a GST_TAG_EXTENDED_COMMENT string and
 851 separate it into its components.
 852 If successful, @key, @lang and/or @value will be set to newly allocated
 853 strings that you need to free with g_free() when done. @key and @lang
 854 may also be set to NULL by this function if there is no key or no language
 855 code in the extended comment string.</doc>
 856       <return-value transfer-ownership="none">
 857         <doc xml:whitespace="preserve">TRUE if the string could be parsed, otherwise FALSE</doc>
 858         <type name="gboolean" c:type="gboolean"/>
 859       </return-value>
 860       <parameters>
 861         <parameter name="ext_comment" transfer-ownership="none">
 862           <doc xml:whitespace="preserve">an extended comment string, see #GST_TAG_EXTENDED_COMMENT</doc>
 863           <type name="utf8" c:type="gchar*"/>
 864         </parameter>
 865         <parameter name="key" transfer-ownership="none">
 866           <doc xml:whitespace="preserve">return location for the comment description key, or NULL</doc>
 867           <type name="utf8" c:type="gchar**"/>
 868         </parameter>
 869         <parameter name="lang" transfer-ownership="none">
 870           <doc xml:whitespace="preserve">return location for the comment ISO-639 language code, or NULL</doc>
 871           <type name="utf8" c:type="gchar**"/>
 872         </parameter>
 873         <parameter name="value" transfer-ownership="none">
 874           <doc xml:whitespace="preserve">return location for the actual comment string, or NULL</doc>
 875           <type name="utf8" c:type="gchar**"/>
 876         </parameter>
 877         <parameter name="fail_if_no_key" transfer-ownership="none">
 878           <doc xml:whitespace="preserve">whether to fail if strings are not in key=value form</doc>
 879           <type name="gboolean" c:type="gboolean"/>
 880         </parameter>
 881       </parameters>
 882     </function>
 883     <function name="tag_register_musicbrainz_tags"
 884               c:identifier="gst_tag_register_musicbrainz_tags">
 885       <return-value transfer-ownership="none">
 886         <type name="none" c:type="void"/>
 887       </return-value>
 888     </function>
 889     <function name="tag_to_id3_tag" c:identifier="gst_tag_to_id3_tag">
 890       <doc xml:whitespace="preserve">Looks up the ID3v2 tag for a GStreamer tag.</doc>
 891       <return-value transfer-ownership="none">
 892         <doc xml:whitespace="preserve">The corresponding ID3v2 tag or NULL if none exists.</doc>
 893         <type name="utf8" c:type="gchar*"/>
 894       </return-value>
 895       <parameters>
 896         <parameter name="gst_tag" transfer-ownership="none">
 897           <doc xml:whitespace="preserve">GStreamer tag to convert to vorbiscomment tag</doc>
 898           <type name="utf8" c:type="gchar*"/>
 899         </parameter>
 900       </parameters>
 901     </function>
 902     <function name="tag_to_vorbis_comments"
 903               c:identifier="gst_tag_to_vorbis_comments"
 904               introspectable="0">
 905       <doc xml:whitespace="preserve">Creates a new tag list that contains the information parsed out of a
 906 vorbiscomment packet.
 907 g_list_foreach (list, (GFunc) g_free, NULL) plus g_list_free (list)</doc>
 908       <return-value>
 909         <doc xml:whitespace="preserve">A #GList of newly-allowcated key=value strings. Free with</doc>
 910         <type name="GLib.List" c:type="GList*">
 911           <type name="gpointer" c:type="gpointer"/>
 912         </type>
 913       </return-value>
 914       <parameters>
 915         <parameter name="list" transfer-ownership="none">
 916           <doc xml:whitespace="preserve">a #GstTagList</doc>
 917           <type name="Gst.TagList" c:type="GstTagList*"/>
 918         </parameter>
 919         <parameter name="tag" transfer-ownership="none">
 920           <doc xml:whitespace="preserve">a GStreamer tag identifier, such as #GST_TAG_ARTIST</doc>
 921           <type name="utf8" c:type="gchar*"/>
 922         </parameter>
 923       </parameters>
 924     </function>
 925     <function name="tag_to_vorbis_tag" c:identifier="gst_tag_to_vorbis_tag">
 926       <doc xml:whitespace="preserve">Looks up the vorbiscomment tag for a GStreamer tag.</doc>
 927       <return-value transfer-ownership="none">
 928         <doc xml:whitespace="preserve">The corresponding vorbiscomment tag or NULL if none exists.</doc>
 929         <type name="utf8" c:type="gchar*"/>
 930       </return-value>
 931       <parameters>
 932         <parameter name="gst_tag" transfer-ownership="none">
 933           <doc xml:whitespace="preserve">GStreamer tag to convert to vorbiscomment tag</doc>
 934           <type name="utf8" c:type="gchar*"/>
 935         </parameter>
 936       </parameters>
 937     </function>
 938     <function name="vorbis_tag_add" c:identifier="gst_vorbis_tag_add">
 939       <doc xml:whitespace="preserve">Convenience function using gst_tag_from_vorbis_tag(), parsing
 940 a vorbis comment string into the right type and adding it to the
 941 given taglist @list.
 942 Unknown vorbiscomment tags will be added to the tag list in form
 943 of a #GST_TAG_EXTENDED_COMMENT (since 0.10.10 at least).</doc>
 944       <return-value transfer-ownership="none">
 945         <type name="none" c:type="void"/>
 946       </return-value>
 947       <parameters>
 948         <parameter name="list" transfer-ownership="none">
 949           <doc xml:whitespace="preserve">a #GstTagList</doc>
 950           <type name="Gst.TagList" c:type="GstTagList*"/>
 951         </parameter>
 952         <parameter name="tag" transfer-ownership="none">
 953           <doc xml:whitespace="preserve">a vorbiscomment tag string (key in key=value), must be valid UTF-8</doc>
 954           <type name="utf8" c:type="gchar*"/>
 955         </parameter>
 956         <parameter name="value" transfer-ownership="none">
 957           <doc xml:whitespace="preserve">a vorbiscomment value string (value in key=value), must be valid UTF-8</doc>
 958           <type name="utf8" c:type="gchar*"/>
 959         </parameter>
 960       </parameters>
 961     </function>
 962   </namespace>
 963 </repository>