wearable/docs/plugins/html/gst-plugins-base-plugins-uridecodebin.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>uridecodebin</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 Plugins Reference Manual">
   8 <link rel="up" href="ch01.html" title="gst-plugins-base Elements">
   9 <link rel="prev" href="gst-plugins-base-plugins-timeoverlay.html" title="timeoverlay">
  10 <link rel="next" href="gst-plugins-base-plugins-videorate.html" title="videorate">
  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="gst-plugins-base-plugins-timeoverlay.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  18 <td><a accesskey="u" href="ch01.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 Plugins Reference Manual</th>
  21 <td><a accesskey="n" href="gst-plugins-base-plugins-videorate.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-plugins-uridecodebin.synopsis" class="shortcut">Top</a>
  25                    |
  26                   <a href="#gst-plugins-base-plugins-uridecodebin.description" class="shortcut">Description</a>
  27                    |
  28                   <a href="#gst-plugins-base-plugins-uridecodebin.object-hierarchy" class="shortcut">Object Hierarchy</a>
  29                    |
  30                   <a href="#gst-plugins-base-plugins-uridecodebin.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
  31                    |
  32                   <a href="#gst-plugins-base-plugins-uridecodebin.properties" class="shortcut">Properties</a>
  33                    |
  34                   <a href="#gst-plugins-base-plugins-uridecodebin.signals" class="shortcut">Signals</a>
  35 </td></tr>
  36 </table>
  37 <div class="refentry">
  38 <a name="gst-plugins-base-plugins-uridecodebin"></a><div class="titlepage"></div>
  39 <div class="refnamediv"><table width="100%"><tr>
  40 <td valign="top">
  41 <h2><span class="refentrytitle"><a name="gst-plugins-base-plugins-uridecodebin.top_of_page"></a>uridecodebin</span></h2>
  42 <p>uridecodebin — Autoplug and decode an URI to raw media</p>
  43 </td>
  44 <td valign="top" align="right"></td>
  45 </tr></table></div>
  46 <div class="refsynopsisdiv">
  47 <a name="gst-plugins-base-plugins-uridecodebin.synopsis"></a><h2>Synopsis</h2>
  48 <a name="GstURIDecodeBin"></a><pre class="synopsis">struct              <a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GstURIDecodeBin-struct" title="struct GstURIDecodeBin">GstURIDecodeBin</a>;
  49 enum                <a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GstAutoplugSelectResult" title="enum GstAutoplugSelectResult">GstAutoplugSelectResult</a>;
  50 </pre>
  51 </div>
  52 <div class="refsect1">
  53 <a name="gst-plugins-base-plugins-uridecodebin.object-hierarchy"></a><h2>Object Hierarchy</h2>
  54 <pre class="synopsis">
  55   <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
  56    +----<a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstObject.html">GstObject</a>
  57          +----<a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstElement.html">GstElement</a>
  58                +----<a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstBin.html">GstBin</a>
  59                      +----GstURIDecodeBin
  60 </pre>
  61 </div>
  62 <div class="refsect1">
  63 <a name="gst-plugins-base-plugins-uridecodebin.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
  64 <p>
  65 GstURIDecodeBin implements
  66  <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstChildProxy.html">GstChildProxy</a>.</p>
  67 </div>
  68 <div class="refsect1">
  69 <a name="gst-plugins-base-plugins-uridecodebin.properties"></a><h2>Properties</h2>
  70 <pre class="synopsis">
  71   "<a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GstURIDecodeBin--uri" title='The "uri" property'>uri</a>"                      <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
  72   "<a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GstURIDecodeBin--connection-speed" title='The "connection-speed" property'>connection-speed</a>"         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write
  73   "<a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GstURIDecodeBin--caps" title='The "caps" property'>caps</a>"                     <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a>*              : Read / Write
  74   "<a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GstURIDecodeBin--subtitle-encoding" title='The "subtitle-encoding" property'>subtitle-encoding</a>"        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write
  75   "<a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GstURIDecodeBin--source" title='The "source" property'>source</a>"                   <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstElement.html"><span class="type">GstElement</span></a>*           : Read
  76   "<a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GstURIDecodeBin--buffer-duration" title='The "buffer-duration" property'>buffer-duration</a>"          <span class="type">gint64</span>                : Read / Write
  77   "<a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GstURIDecodeBin--buffer-size" title='The "buffer-size" property'>buffer-size</a>"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write
  78   "<a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GstURIDecodeBin--download" title='The "download" property'>download</a>"                 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
  79   "<a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GstURIDecodeBin--use-buffering" title='The "use-buffering" property'>use-buffering</a>"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
  80   "<a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GstURIDecodeBin--expose-all-streams" title='The "expose-all-streams" property'>expose-all-streams</a>"       <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
  81   "<a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GstURIDecodeBin--ring-buffer-max-size" title='The "ring-buffer-max-size" property'>ring-buffer-max-size</a>"     <span class="type">guint64</span>               : Read / Write
  82 </pre>
  83 </div>
  84 <div class="refsect1">
  85 <a name="gst-plugins-base-plugins-uridecodebin.signals"></a><h2>Signals</h2>
  86 <pre class="synopsis">
  87   "<a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GstURIDecodeBin-autoplug-continue" title='The "autoplug-continue" signal'>autoplug-continue</a>"                              : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
  88   "<a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GstURIDecodeBin-autoplug-factories" title='The "autoplug-factories" signal'>autoplug-factories</a>"                             : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
  89   "<a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GstURIDecodeBin-autoplug-select" title='The "autoplug-select" signal'>autoplug-select</a>"                                : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
  90   "<a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GstURIDecodeBin-unknown-type" title='The "unknown-type" signal'>unknown-type</a>"                                   : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
  91   "<a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GstURIDecodeBin-drained" title='The "drained" signal'>drained</a>"                                        : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
  92   "<a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GstURIDecodeBin-autoplug-sort" title='The "autoplug-sort" signal'>autoplug-sort</a>"                                  : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
  93   "<a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GstURIDecodeBin-source-setup" title='The "source-setup" signal'>source-setup</a>"                                   : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a>
  94 </pre>
  95 </div>
  96 <div class="refsect1">
  97 <a name="gst-plugins-base-plugins-uridecodebin.description"></a><h2>Description</h2>
  98 <p>
  99 Decodes data from a URI into raw media. It selects a source element that can
 100 handle the given <a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GstURIDecodeBin--uri" title='The "uri" property'><span class="type">"uri"</span></a> scheme and connects it to a decodebin2.
 101 </p>
 102 <div class="refsynopsisdiv">
 103 <h2>Synopsis</h2>
 104 <div class="refsect2">
 105 <a name="idp14538000"></a><h3>Element Information</h3>
 106 <div class="variablelist"><table border="0">
 107 <col align="left" valign="top">
 108 <tbody>
 109 <tr>
 110 <td><p><span class="term">plugin</span></p></td>
 111 <td>
 112             <a class="link" href="gst-plugins-base-plugins-plugin-uridecodebin.html#plugin-uridecodebin">uridecodebin</a>
 113           </td>
 114 </tr>
 115 <tr>
 116 <td><p><span class="term">author</span></p></td>
 117 <td>Wim Taymans &lt;wim.taymans@gmail.com&gt;</td>
 118 </tr>
 119 <tr>
 120 <td><p><span class="term">class</span></p></td>
 121 <td>Generic/Bin/Decoder</td>
 122 </tr>
 123 </tbody>
 124 </table></div>
 125 </div>
 126 <hr>
 127 <div class="refsect2">
 128 <a name="idp14545456"></a><h3>Element Pads</h3>
 129 <div class="variablelist"><table border="0">
 130 <col align="left" valign="top">
 131 <tbody>
 132 <tr>
 133 <td><p><span class="term">name</span></p></td>
 134 <td>src%d</td>
 135 </tr>
 136 <tr>
 137 <td><p><span class="term">direction</span></p></td>
 138 <td>source</td>
 139 </tr>
 140 <tr>
 141 <td><p><span class="term">presence</span></p></td>
 142 <td>sometimes</td>
 143 </tr>
 144 <tr>
 145 <td><p><span class="term">details</span></p></td>
 146 <td>ANY</td>
 147 </tr>
 148 </tbody>
 149 </table></div>
 150 </div>
 151 </div>
 152 <p>
 153 </p>
 154 </div>
 155 <div class="refsect1">
 156 <a name="gst-plugins-base-plugins-uridecodebin.details"></a><h2>Details</h2>
 157 <div class="refsect2">
 158 <a name="GstURIDecodeBin-struct"></a><h3>struct GstURIDecodeBin</h3>
 159 <pre class="programlisting">struct GstURIDecodeBin;</pre>
 160 <p>
 161 uridecodebin element struct
 162 </p>
 163 </div>
 164 <hr>
 165 <div class="refsect2">
 166 <a name="GstAutoplugSelectResult"></a><h3>enum GstAutoplugSelectResult</h3>
 167 <pre class="programlisting">typedef enum {
 168   GST_AUTOPLUG_SELECT_TRY,
 169   GST_AUTOPLUG_SELECT_EXPOSE,
 170   GST_AUTOPLUG_SELECT_SKIP
 171 } GstAutoplugSelectResult;
 172 </pre>
 173 <p>
 174 return values for the autoplug-select signal.
 175 </p>
 176 <div class="variablelist"><table border="0">
 177 <col align="left" valign="top">
 178 <tbody>
 179 <tr>
 180 <td><p><a name="GST-AUTOPLUG-SELECT-TRY:CAPS"></a><span class="term"><code class="literal">GST_AUTOPLUG_SELECT_TRY</code></span></p></td>
 181 <td>try to autoplug the current factory
 182 </td>
 183 </tr>
 184 <tr>
 185 <td><p><a name="GST-AUTOPLUG-SELECT-EXPOSE:CAPS"></a><span class="term"><code class="literal">GST_AUTOPLUG_SELECT_EXPOSE</code></span></p></td>
 186 <td>expose the pad as a raw stream
 187 </td>
 188 </tr>
 189 <tr>
 190 <td><p><a name="GST-AUTOPLUG-SELECT-SKIP:CAPS"></a><span class="term"><code class="literal">GST_AUTOPLUG_SELECT_SKIP</code></span></p></td>
 191 <td>skip the current factory
 192 </td>
 193 </tr>
 194 </tbody>
 195 </table></div>
 196 </div>
 197 </div>
 198 <div class="refsect1">
 199 <a name="gst-plugins-base-plugins-uridecodebin.property-details"></a><h2>Property Details</h2>
 200 <div class="refsect2">
 201 <a name="GstURIDecodeBin--uri"></a><h3>The <code class="literal">"uri"</code> property</h3>
 202 <pre class="programlisting">  "uri"                      <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
 203 <p>URI to decode.</p>
 204 <p>Default value: NULL</p>
 205 </div>
 206 <hr>
 207 <div class="refsect2">
 208 <a name="GstURIDecodeBin--connection-speed"></a><h3>The <code class="literal">"connection-speed"</code> property</h3>
 209 <pre class="programlisting">  "connection-speed"         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write</pre>
 210 <p>Network connection speed in kbps (0 = unknown).</p>
 211 <p>Allowed values: &lt;= 4294967</p>
 212 <p>Default value: 0</p>
 213 </div>
 214 <hr>
 215 <div class="refsect2">
 216 <a name="GstURIDecodeBin--caps"></a><h3>The <code class="literal">"caps"</code> property</h3>
 217 <pre class="programlisting">  "caps"                     <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a>*              : Read / Write</pre>
 218 <p>The caps on which to stop decoding. (NULL = default).</p>
 219 </div>
 220 <hr>
 221 <div class="refsect2">
 222 <a name="GstURIDecodeBin--subtitle-encoding"></a><h3>The <code class="literal">"subtitle-encoding"</code> property</h3>
 223 <pre class="programlisting">  "subtitle-encoding"        <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a>*                : Read / Write</pre>
 224 <p>Encoding to assume if input subtitles are not in UTF-8 encoding. If not set, the GST_SUBTITLE_ENCODING environment variable will be checked for an encoding to use. If that is not set either, ISO-8859-15 will be assumed.</p>
 225 <p>Default value: NULL</p>
 226 </div>
 227 <hr>
 228 <div class="refsect2">
 229 <a name="GstURIDecodeBin--source"></a><h3>The <code class="literal">"source"</code> property</h3>
 230 <pre class="programlisting">  "source"                   <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstElement.html"><span class="type">GstElement</span></a>*           : Read</pre>
 231 <p>Source object used.</p>
 232 </div>
 233 <hr>
 234 <div class="refsect2">
 235 <a name="GstURIDecodeBin--buffer-duration"></a><h3>The <code class="literal">"buffer-duration"</code> property</h3>
 236 <pre class="programlisting">  "buffer-duration"          <span class="type">gint64</span>                : Read / Write</pre>
 237 <p>Buffer duration when buffering streams (-1 default value).</p>
 238 <p>Allowed values: &gt;= G_MAXULONG</p>
 239 <p>Default value: -1</p>
 240 </div>
 241 <hr>
 242 <div class="refsect2">
 243 <a name="GstURIDecodeBin--buffer-size"></a><h3>The <code class="literal">"buffer-size"</code> property</h3>
 244 <pre class="programlisting">  "buffer-size"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a>                  : Read / Write</pre>
 245 <p>Buffer size when buffering streams (-1 default value).</p>
 246 <p>Allowed values: &gt;= G_MAXULONG</p>
 247 <p>Default value: -1</p>
 248 </div>
 249 <hr>
 250 <div class="refsect2">
 251 <a name="GstURIDecodeBin--download"></a><h3>The <code class="literal">"download"</code> property</h3>
 252 <pre class="programlisting">  "download"                 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 253 <p>Attempt download buffering when buffering network streams.</p>
 254 <p>Default value: FALSE</p>
 255 </div>
 256 <hr>
 257 <div class="refsect2">
 258 <a name="GstURIDecodeBin--use-buffering"></a><h3>The <code class="literal">"use-buffering"</code> property</h3>
 259 <pre class="programlisting">  "use-buffering"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 260 <p>Perform buffering on demuxed/parsed media.</p>
 261 <p>Default value: FALSE</p>
 262 </div>
 263 <hr>
 264 <div class="refsect2">
 265 <a name="GstURIDecodeBin--expose-all-streams"></a><h3>The <code class="literal">"expose-all-streams"</code> property</h3>
 266 <pre class="programlisting">  "expose-all-streams"       <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
 267 <p>Expose all streams, including those of unknown type or that don't match the 'caps' property.</p>
 268 <p>Default value: TRUE</p>
 269 </div>
 270 <hr>
 271 <div class="refsect2">
 272 <a name="GstURIDecodeBin--ring-buffer-max-size"></a><h3>The <code class="literal">"ring-buffer-max-size"</code> property</h3>
 273 <pre class="programlisting">  "ring-buffer-max-size"     <span class="type">guint64</span>               : Read / Write</pre>
 274 <p>Max. amount of data in the ring buffer (bytes, 0 = ring buffer disabled).</p>
 275 <p>Allowed values: &lt;= G_MAXUINT</p>
 276 <p>Default value: 0</p>
 277 </div>
 278 </div>
 279 <div class="refsect1">
 280 <a name="gst-plugins-base-plugins-uridecodebin.signal-details"></a><h2>Signal Details</h2>
 281 <div class="refsect2">
 282 <a name="GstURIDecodeBin-autoplug-continue"></a><h3>The <code class="literal">"autoplug-continue"</code> signal</h3>
 283 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            user_function                      (<a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GstURIDecodeBin"><span class="type">GstURIDecodeBin</span></a> *bin,
 284                                                         <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstPad.html"><span class="type">GstPad</span></a>          *pad,
 285                                                         <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a>         *caps,
 286                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>         user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
 287 <p>
 288 This signal is emitted whenever uridecodebin finds a new stream. It is
 289 emitted before looking for any elements that can handle that stream.
 290 </p>
 291 <p>
 292 </p>
 293 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
 294 <h3 class="title">Note</h3>
 295   Invocation of signal handlers stops after the first signal handler
 296 returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><span class="type">FALSE</span></a>. Signal handlers are invoked in the order they were
 297   connected in.
 298 </div>
 299 <p>
 300 </p>
 301 <div class="variablelist"><table border="0">
 302 <col align="left" valign="top">
 303 <tbody>
 304 <tr>
 305 <td><p><span class="term"><em class="parameter"><code>bin</code></em> :</span></p></td>
 306 <td>The uridecodebin.</td>
 307 </tr>
 308 <tr>
 309 <td><p><span class="term"><em class="parameter"><code>pad</code></em> :</span></p></td>
 310 <td>The <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstPad.html"><span class="type">GstPad</span></a>.</td>
 311 </tr>
 312 <tr>
 313 <td><p><span class="term"><em class="parameter"><code>caps</code></em> :</span></p></td>
 314 <td>The <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a> found.</td>
 315 </tr>
 316 <tr>
 317 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 318 <td>user data set when the signal handler was connected.</td>
 319 </tr>
 320 <tr>
 321 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 322 <td>
 323 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><span class="type">TRUE</span></a> if you wish uridecodebin to look for elements that can
 324 handle the given <em class="parameter"><code>caps</code></em>. If <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><span class="type">FALSE</span></a>, those caps will be considered as
 325 final and the pad will be exposed as such (see 'new-decoded-pad'
 326 signal).</td>
 327 </tr>
 328 </tbody>
 329 </table></div>
 330 </div>
 331 <hr>
 332 <div class="refsect2">
 333 <a name="GstURIDecodeBin-autoplug-factories"></a><h3>The <code class="literal">"autoplug-factories"</code> signal</h3>
 334 <pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Value-arrays.html#GValueArray"><span class="returnvalue">GValueArray</span></a>*        user_function                      (<a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GstURIDecodeBin"><span class="type">GstURIDecodeBin</span></a> *bin,
 335                                                         <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstPad.html"><span class="type">GstPad</span></a>          *pad,
 336                                                         <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a>         *caps,
 337                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>         user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
 338 <p>
 339 This function is emitted when an array of possible factories for <em class="parameter"><code>caps</code></em> on
 340 <em class="parameter"><code>pad</code></em> is needed. Uridecodebin will by default return an array with all
 341 compatible factories, sorted by rank.
 342 </p>
 343 <p>
 344 If this function returns NULL, <em class="parameter"><code>pad</code></em> will be exposed as a final caps.
 345 </p>
 346 <p>
 347 If this function returns an empty array, the pad will be considered as
 348 having an unhandled type media type.
 349 </p>
 350 <p>
 351 </p>
 352 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
 353 <h3 class="title">Note</h3>
 354   Only the signal handler that is connected first will ever by invoked.
 355   Don't connect signal handlers with the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-CONNECT-AFTER:CAPS"><span class="type">G_CONNECT_AFTER</span></a> flag to this
 356   signal, they will never be invoked!
 357 </div>
 358 <p>
 359 </p>
 360 <div class="variablelist"><table border="0">
 361 <col align="left" valign="top">
 362 <tbody>
 363 <tr>
 364 <td><p><span class="term"><em class="parameter"><code>bin</code></em> :</span></p></td>
 365 <td>The uridecodebin.</td>
 366 </tr>
 367 <tr>
 368 <td><p><span class="term"><em class="parameter"><code>pad</code></em> :</span></p></td>
 369 <td>The <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstPad.html"><span class="type">GstPad</span></a>.</td>
 370 </tr>
 371 <tr>
 372 <td><p><span class="term"><em class="parameter"><code>caps</code></em> :</span></p></td>
 373 <td>The <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a> found.</td>
 374 </tr>
 375 <tr>
 376 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 377 <td>user data set when the signal handler was connected.</td>
 378 </tr>
 379 <tr>
 380 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 381 <td>a <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Value-arrays.html#GValueArray"><span class="type">GValueArray</span></a>* with a list of factories to try. The factories are
 382 by default tried in the returned order or based on the index returned by
 383 "autoplug-select".</td>
 384 </tr>
 385 </tbody>
 386 </table></div>
 387 </div>
 388 <hr>
 389 <div class="refsect2">
 390 <a name="GstURIDecodeBin-autoplug-select"></a><h3>The <code class="literal">"autoplug-select"</code> signal</h3>
 391 <pre class="programlisting"><a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GstAutoplugSelectResult" title="enum GstAutoplugSelectResult"><span class="returnvalue">GstAutoplugSelectResult</span></a>user_function                      (<a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GstURIDecodeBin"><span class="type">GstURIDecodeBin</span></a>   *bin,
 392                                                         <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstPad.html"><span class="type">GstPad</span></a>            *pad,
 393                                                         <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a>           *caps,
 394                                                         <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstElementFactory.html"><span class="type">GstElementFactory</span></a> *factory,
 395                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>           user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
 396 <p>
 397 This signal is emitted once uridecodebin has found all the possible
 398 <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstElementFactory.html"><span class="type">GstElementFactory</span></a> that can be used to handle the given <em class="parameter"><code>caps</code></em>. For each of
 399 those factories, this signal is emitted.
 400 </p>
 401 <p>
 402 The signal handler should return a <span class="type">GST_TYPE_AUTOPLUG_SELECT_RESULT</span> enum
 403 value indicating what decodebin2 should do next.
 404 </p>
 405 <p>
 406 A value of <a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GST-AUTOPLUG-SELECT-TRY:CAPS"><span class="type">GST_AUTOPLUG_SELECT_TRY</span></a> will try to autoplug an element from
 407 <em class="parameter"><code>factory</code></em>.
 408 </p>
 409 <p>
 410 A value of <a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GST-AUTOPLUG-SELECT-EXPOSE:CAPS"><span class="type">GST_AUTOPLUG_SELECT_EXPOSE</span></a> will expose <em class="parameter"><code>pad</code></em> without plugging
 411 any element to it.
 412 </p>
 413 <p>
 414 A value of <a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GST-AUTOPLUG-SELECT-SKIP:CAPS"><span class="type">GST_AUTOPLUG_SELECT_SKIP</span></a> will skip <em class="parameter"><code>factory</code></em> and move to the
 415 next factory.
 416 </p>
 417 <p>
 418 </p>
 419 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
 420 <h3 class="title">Note</h3>
 421   Only the signal handler that is connected first will ever by invoked.
 422   Don't connect signal handlers with the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-CONNECT-AFTER:CAPS"><span class="type">G_CONNECT_AFTER</span></a> flag to this
 423   signal, they will never be invoked!
 424 </div>
 425 <p>
 426 </p>
 427 <div class="variablelist"><table border="0">
 428 <col align="left" valign="top">
 429 <tbody>
 430 <tr>
 431 <td><p><span class="term"><em class="parameter"><code>bin</code></em> :</span></p></td>
 432 <td>The uridecodebin.</td>
 433 </tr>
 434 <tr>
 435 <td><p><span class="term"><em class="parameter"><code>pad</code></em> :</span></p></td>
 436 <td>The <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstPad.html"><span class="type">GstPad</span></a>.</td>
 437 </tr>
 438 <tr>
 439 <td><p><span class="term"><em class="parameter"><code>caps</code></em> :</span></p></td>
 440 <td>The <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a>.</td>
 441 </tr>
 442 <tr>
 443 <td><p><span class="term"><em class="parameter"><code>factory</code></em> :</span></p></td>
 444 <td>A <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstElementFactory.html"><span class="type">GstElementFactory</span></a> to use.</td>
 445 </tr>
 446 <tr>
 447 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 448 <td>user data set when the signal handler was connected.</td>
 449 </tr>
 450 <tr>
 451 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 452 <td>a <span class="type">GST_TYPE_AUTOPLUG_SELECT_RESULT</span> that indicates the required
 453 operation. The default handler will always return
 454 <a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GST-AUTOPLUG-SELECT-TRY:CAPS"><span class="type">GST_AUTOPLUG_SELECT_TRY</span></a>.</td>
 455 </tr>
 456 </tbody>
 457 </table></div>
 458 </div>
 459 <hr>
 460 <div class="refsect2">
 461 <a name="GstURIDecodeBin-unknown-type"></a><h3>The <code class="literal">"unknown-type"</code> signal</h3>
 462 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GstURIDecodeBin"><span class="type">GstURIDecodeBin</span></a> *bin,
 463                                                         <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstPad.html"><span class="type">GstPad</span></a>          *pad,
 464                                                         <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a>         *caps,
 465                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>         user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
 466 <p>
 467 This signal is emitted when a pad for which there is no further possible
 468 decoding is added to the uridecodebin.
 469 </p>
 470 <div class="variablelist"><table border="0">
 471 <col align="left" valign="top">
 472 <tbody>
 473 <tr>
 474 <td><p><span class="term"><em class="parameter"><code>bin</code></em> :</span></p></td>
 475 <td>The uridecodebin.</td>
 476 </tr>
 477 <tr>
 478 <td><p><span class="term"><em class="parameter"><code>pad</code></em> :</span></p></td>
 479 <td>the new pad containing caps that cannot be resolved to a 'final'.
 480 stream type.</td>
 481 </tr>
 482 <tr>
 483 <td><p><span class="term"><em class="parameter"><code>caps</code></em> :</span></p></td>
 484 <td>the <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a> of the pad that cannot be resolved.</td>
 485 </tr>
 486 <tr>
 487 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 488 <td>user data set when the signal handler was connected.</td>
 489 </tr>
 490 </tbody>
 491 </table></div>
 492 </div>
 493 <hr>
 494 <div class="refsect2">
 495 <a name="GstURIDecodeBin-drained"></a><h3>The <code class="literal">"drained"</code> signal</h3>
 496 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GstURIDecodeBin"><span class="type">GstURIDecodeBin</span></a> *arg0,
 497                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>         user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
 498 <p>
 499 This signal is emitted when the data for the current uri is played.
 500 </p>
 501 <div class="variablelist"><table border="0">
 502 <col align="left" valign="top">
 503 <tbody><tr>
 504 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 505 <td>user data set when the signal handler was connected.</td>
 506 </tr></tbody>
 507 </table></div>
 508 </div>
 509 <hr>
 510 <div class="refsect2">
 511 <a name="GstURIDecodeBin-autoplug-sort"></a><h3>The <code class="literal">"autoplug-sort"</code> signal</h3>
 512 <pre class="programlisting"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Value-arrays.html#GValueArray"><span class="returnvalue">GValueArray</span></a>*        user_function                      (<a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GstURIDecodeBin"><span class="type">GstURIDecodeBin</span></a> *bin,
 513                                                         <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstPad.html"><span class="type">GstPad</span></a>          *pad,
 514                                                         <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a>         *caps,
 515                                                         <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Value-arrays.html#GValueArray"><span class="type">GValueArray</span></a>     *factories,
 516                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>         user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
 517 <p>
 518 Once decodebin2 has found the possible <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstElementFactory.html"><span class="type">GstElementFactory</span></a> objects to try
 519 for <em class="parameter"><code>caps</code></em> on <em class="parameter"><code>pad</code></em>, this signal is emitted. The purpose of the signal is for
 520 the application to perform additional sorting or filtering on the element
 521 factory array.
 522 </p>
 523 <p>
 524 The callee should copy and modify <em class="parameter"><code>factories</code></em> or return <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a> if the
 525 order should not change.
 526 </p>
 527 <p>
 528 </p>
 529 <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
 530 <h3 class="title">Note</h3>
 531   Invocation of signal handlers stops after one signal handler has
 532   returned something else than <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><span class="type">NULL</span></a>. Signal handlers are invoked in
 533   the order they were connected in.
 534   Don't connect signal handlers with the <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-CONNECT-AFTER:CAPS"><span class="type">G_CONNECT_AFTER</span></a> flag to this
 535   signal, they will never be invoked!
 536 </div>
 537 <p>
 538 </p>
 539 <div class="variablelist"><table border="0">
 540 <col align="left" valign="top">
 541 <tbody>
 542 <tr>
 543 <td><p><span class="term"><em class="parameter"><code>bin</code></em> :</span></p></td>
 544 <td>The uridecodebin.</td>
 545 </tr>
 546 <tr>
 547 <td><p><span class="term"><em class="parameter"><code>pad</code></em> :</span></p></td>
 548 <td>The <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstPad.html"><span class="type">GstPad</span></a>.</td>
 549 </tr>
 550 <tr>
 551 <td><p><span class="term"><em class="parameter"><code>caps</code></em> :</span></p></td>
 552 <td>The <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a>.</td>
 553 </tr>
 554 <tr>
 555 <td><p><span class="term"><em class="parameter"><code>factories</code></em> :</span></p></td>
 556 <td>A <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Value-arrays.html#GValueArray"><span class="type">GValueArray</span></a> of possible <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstElementFactory.html"><span class="type">GstElementFactory</span></a> to use.</td>
 557 </tr>
 558 <tr>
 559 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 560 <td>user data set when the signal handler was connected.</td>
 561 </tr>
 562 <tr>
 563 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 564 <td>A new sorted array of <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstElementFactory.html"><span class="type">GstElementFactory</span></a> objects.</td>
 565 </tr>
 566 </tbody>
 567 </table></div>
 568 <p class="since">Since 0.10.33</p>
 569 </div>
 570 <hr>
 571 <div class="refsect2">
 572 <a name="GstURIDecodeBin-source-setup"></a><h3>The <code class="literal">"source-setup"</code> signal</h3>
 573 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gst-plugins-base-plugins-uridecodebin.html#GstURIDecodeBin"><span class="type">GstURIDecodeBin</span></a> *bin,
 574                                                         <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstElement.html"><span class="type">GstElement</span></a>      *source,
 575                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a>         user_data)      : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>
 576 <p>
 577 This signal is emitted after the source element has been created, so
 578 it can be configured by setting additional properties (e.g. set a
 579 proxy server for an http source, or set the device and read speed for
 580 an audio cd source). This is functionally equivalent to connecting to
 581 the notify::source signal, but more convenient.
 582 </p>
 583 <div class="variablelist"><table border="0">
 584 <col align="left" valign="top">
 585 <tbody>
 586 <tr>
 587 <td><p><span class="term"><em class="parameter"><code>bin</code></em> :</span></p></td>
 588 <td>the uridecodebin.</td>
 589 </tr>
 590 <tr>
 591 <td><p><span class="term"><em class="parameter"><code>source</code></em> :</span></p></td>
 592 <td>source element</td>
 593 </tr>
 594 <tr>
 595 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 596 <td>user data set when the signal handler was connected.</td>
 597 </tr>
 598 </tbody>
 599 </table></div>
 600 <p class="since">Since 0.10.33</p>
 601 </div>
 602 </div>
 603 </div>
 604 <div class="footer">
 605 <hr>
 606           Generated by GTK-Doc V1.18</div>
 607 </body>
 608 </html>