docs/plugins/html/gst-plugins-good-plugins-gstrtpssrcdemux.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>gstrtpssrcdemux</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
   7 <link rel="home" href="index.html" title="GStreamer Good Plugins 0.10 Plugins Reference Manual">
   8 <link rel="up" href="ch01.html" title="gst-plugins-good Elements">
   9 <link rel="prev" href="gst-plugins-good-plugins-gstrtpsession.html" title="gstrtpsession">
  10 <link rel="next" href="gst-plugins-good-plugins-halaudiosink.html" title="halaudiosink">
  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-good-plugins-gstrtpsession.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 Good Plugins 0.10 Plugins Reference Manual</th>
  21 <td><a accesskey="n" href="gst-plugins-good-plugins-halaudiosink.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-good-plugins-gstrtpssrcdemux.synopsis" class="shortcut">Top</a>
  25                    |
  26                   <a href="#gst-plugins-good-plugins-gstrtpssrcdemux.description" class="shortcut">Description</a>
  27                    |
  28                   <a href="#gst-plugins-good-plugins-gstrtpssrcdemux.object-hierarchy" class="shortcut">Object Hierarchy</a>
  29                    |
  30                   <a href="#gst-plugins-good-plugins-gstrtpssrcdemux.signals" class="shortcut">Signals</a>
  31 </td></tr>
  32 </table>
  33 <div class="refentry">
  34 <a name="gst-plugins-good-plugins-gstrtpssrcdemux"></a><div class="titlepage"></div>
  35 <div class="refnamediv"><table width="100%"><tr>
  36 <td valign="top">
  37 <h2><span class="refentrytitle"><a name="gst-plugins-good-plugins-gstrtpssrcdemux.top_of_page"></a>gstrtpssrcdemux</span></h2>
  38 <p>gstrtpssrcdemux — Splits RTP streams based on the SSRC</p>
  39 </td>
  40 <td valign="top" align="right"></td>
  41 </tr></table></div>
  42 <div class="refsynopsisdiv">
  43 <a name="gst-plugins-good-plugins-gstrtpssrcdemux.synopsis"></a><h2>Synopsis</h2>
  44 <a name="GstRtpSsrcDemux"></a><pre class="synopsis">struct              <a class="link" href="gst-plugins-good-plugins-gstrtpssrcdemux.html#GstRtpSsrcDemux-struct" title="struct GstRtpSsrcDemux">GstRtpSsrcDemux</a>;
  45 </pre>
  46 </div>
  47 <div class="refsect1">
  48 <a name="gst-plugins-good-plugins-gstrtpssrcdemux.object-hierarchy"></a><h2>Object Hierarchy</h2>
  49 <pre class="synopsis">
  50   <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
  51    +----<a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstObject.html">GstObject</a>
  52          +----<a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstElement.html">GstElement</a>
  53                +----GstRtpSsrcDemux
  54 </pre>
  55 </div>
  56 <div class="refsect1">
  57 <a name="gst-plugins-good-plugins-gstrtpssrcdemux.signals"></a><h2>Signals</h2>
  58 <pre class="synopsis">
  59   "<a class="link" href="gst-plugins-good-plugins-gstrtpssrcdemux.html#GstRtpSsrcDemux-clear-ssrc" title='The "clear-ssrc" signal'>clear-ssrc</a>"                                     : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-ACTION:CAPS"><code class="literal">Action</code></a>
  60   "<a class="link" href="gst-plugins-good-plugins-gstrtpssrcdemux.html#GstRtpSsrcDemux-new-ssrc-pad" title='The "new-ssrc-pad" signal'>new-ssrc-pad</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>
  61   "<a class="link" href="gst-plugins-good-plugins-gstrtpssrcdemux.html#GstRtpSsrcDemux-removed-ssrc-pad" title='The "removed-ssrc-pad" signal'>removed-ssrc-pad</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>
  62 </pre>
  63 </div>
  64 <div class="refsect1">
  65 <a name="gst-plugins-good-plugins-gstrtpssrcdemux.description"></a><h2>Description</h2>
  66 <p>
  67 gstrtpssrcdemux acts as a demuxer for RTP packets based on the SSRC of the
  68 packets. Its main purpose is to allow an application to easily receive and
  69 decode an RTP stream with multiple SSRCs.
  70 </p>
  71 <p>
  72 For each SSRC that is detected, a new pad will be created and the
  73 <a class="link" href="gst-plugins-good-plugins-gstrtpssrcdemux.html#GstRtpSsrcDemux-new-ssrc-pad" title='The "new-ssrc-pad" signal'><span class="type">"new-ssrc-pad"</span></a> signal will be emitted.
  74 </p>
  75 <p>
  76 </p>
  77 <div class="refsect2">
  78 <a name="idp11361936"></a><h3>Example pipelines</h3>
  79 <div class="informalexample">
  80   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
  81     <tbody>
  82       <tr>
  83         <td class="listing_lines" align="right"><pre>1</pre></td>
  84         <td class="listing_code"><pre class="programlisting">gst<span class="gtkdoc opt">-</span>launch udpsrc caps<span class="gtkdoc opt">=</span><span class="string">&quot;application/x-rtp&quot;</span> <span class="gtkdoc opt">!</span> gstrtpssrcdemux <span class="gtkdoc opt">!</span> fakesink</pre></td>
  85       </tr>
  86     </tbody>
  87   </table>
  88 </div>
  89  Takes an RTP stream and send the RTP packets with the first detected SSRC
  90 to fakesink, discarding the other SSRCs.
  91 </div>
  92 <p>
  93 </p>
  94 <p>
  95 Last reviewed on 2007-05-28 (0.10.5)
  96 </p>
  97 <div class="refsynopsisdiv">
  98 <h2>Synopsis</h2>
  99 <div class="refsect2">
 100 <a name="idp5124272"></a><h3>Element Information</h3>
 101 <div class="variablelist"><table border="0">
 102 <col align="left" valign="top">
 103 <tbody>
 104 <tr>
 105 <td><p><span class="term">plugin</span></p></td>
 106 <td>
 107             <a class="link" href="gst-plugins-good-plugins-plugin-gstrtpmanager.html#plugin-gstrtpmanager">gstrtpmanager</a>
 108           </td>
 109 </tr>
 110 <tr>
 111 <td><p><span class="term">author</span></p></td>
 112 <td>Wim Taymans &lt;wim.taymans@gmail.com&gt;</td>
 113 </tr>
 114 <tr>
 115 <td><p><span class="term">class</span></p></td>
 116 <td>Demux/Network/RTP</td>
 117 </tr>
 118 </tbody>
 119 </table></div>
 120 </div>
 121 <hr>
 122 <div class="refsect2">
 123 <a name="idp11636064"></a><h3>Element Pads</h3>
 124 <div class="variablelist"><table border="0">
 125 <col align="left" valign="top">
 126 <tbody>
 127 <tr>
 128 <td><p><span class="term">name</span></p></td>
 129 <td>rtcp_sink</td>
 130 </tr>
 131 <tr>
 132 <td><p><span class="term">direction</span></p></td>
 133 <td>sink</td>
 134 </tr>
 135 <tr>
 136 <td><p><span class="term">presence</span></p></td>
 137 <td>always</td>
 138 </tr>
 139 <tr>
 140 <td><p><span class="term">details</span></p></td>
 141 <td>application/x-rtcp</td>
 142 </tr>
 143 </tbody>
 144 </table></div>
 145 <div class="variablelist"><table border="0">
 146 <col align="left" valign="top">
 147 <tbody>
 148 <tr>
 149 <td><p><span class="term">name</span></p></td>
 150 <td>sink</td>
 151 </tr>
 152 <tr>
 153 <td><p><span class="term">direction</span></p></td>
 154 <td>sink</td>
 155 </tr>
 156 <tr>
 157 <td><p><span class="term">presence</span></p></td>
 158 <td>always</td>
 159 </tr>
 160 <tr>
 161 <td><p><span class="term">details</span></p></td>
 162 <td>application/x-rtp</td>
 163 </tr>
 164 </tbody>
 165 </table></div>
 166 <div class="variablelist"><table border="0">
 167 <col align="left" valign="top">
 168 <tbody>
 169 <tr>
 170 <td><p><span class="term">name</span></p></td>
 171 <td>rtcp_src_%d</td>
 172 </tr>
 173 <tr>
 174 <td><p><span class="term">direction</span></p></td>
 175 <td>source</td>
 176 </tr>
 177 <tr>
 178 <td><p><span class="term">presence</span></p></td>
 179 <td>sometimes</td>
 180 </tr>
 181 <tr>
 182 <td><p><span class="term">details</span></p></td>
 183 <td>application/x-rtcp</td>
 184 </tr>
 185 </tbody>
 186 </table></div>
 187 <div class="variablelist"><table border="0">
 188 <col align="left" valign="top">
 189 <tbody>
 190 <tr>
 191 <td><p><span class="term">name</span></p></td>
 192 <td>src_%d</td>
 193 </tr>
 194 <tr>
 195 <td><p><span class="term">direction</span></p></td>
 196 <td>source</td>
 197 </tr>
 198 <tr>
 199 <td><p><span class="term">presence</span></p></td>
 200 <td>sometimes</td>
 201 </tr>
 202 <tr>
 203 <td><p><span class="term">details</span></p></td>
 204 <td>application/x-rtp</td>
 205 </tr>
 206 </tbody>
 207 </table></div>
 208 </div>
 209 </div>
 210 <p>
 211 </p>
 212 </div>
 213 <div class="refsect1">
 214 <a name="gst-plugins-good-plugins-gstrtpssrcdemux.details"></a><h2>Details</h2>
 215 <div class="refsect2">
 216 <a name="GstRtpSsrcDemux-struct"></a><h3>struct GstRtpSsrcDemux</h3>
 217 <pre class="programlisting">struct GstRtpSsrcDemux;</pre>
 218 <p>
 219 </p>
 220 </div>
 221 </div>
 222 <div class="refsect1">
 223 <a name="gst-plugins-good-plugins-gstrtpssrcdemux.signal-details"></a><h2>Signal Details</h2>
 224 <div class="refsect2">
 225 <a name="GstRtpSsrcDemux-clear-ssrc"></a><h3>The <code class="literal">"clear-ssrc"</code> signal</h3>
 226 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gst-plugins-good-plugins-gstrtpssrcdemux.html#GstRtpSsrcDemux"><span class="type">GstRtpSsrcDemux</span></a> *demux,
 227                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>            ssrc,
 228                                                         <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-ACTION:CAPS"><code class="literal">Action</code></a></pre>
 229 <p>
 230 Action signal to remove the pad for SSRC.
 231 </p>
 232 <div class="variablelist"><table border="0">
 233 <col align="left" valign="top">
 234 <tbody>
 235 <tr>
 236 <td><p><span class="term"><em class="parameter"><code>demux</code></em> :</span></p></td>
 237 <td>the object which received the signal</td>
 238 </tr>
 239 <tr>
 240 <td><p><span class="term"><em class="parameter"><code>ssrc</code></em> :</span></p></td>
 241 <td>the SSRC of the pad</td>
 242 </tr>
 243 <tr>
 244 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 245 <td>user data set when the signal handler was connected.</td>
 246 </tr>
 247 </tbody>
 248 </table></div>
 249 </div>
 250 <hr>
 251 <div class="refsect2">
 252 <a name="GstRtpSsrcDemux-new-ssrc-pad"></a><h3>The <code class="literal">"new-ssrc-pad"</code> signal</h3>
 253 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gst-plugins-good-plugins-gstrtpssrcdemux.html#GstRtpSsrcDemux"><span class="type">GstRtpSsrcDemux</span></a> *demux,
 254                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>            ssrc,
 255                                                         <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstPad.html"><span class="type">GstPad</span></a>          *pad,
 256                                                         <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>
 257 <p>
 258 Emited when a new SSRC pad has been created.
 259 </p>
 260 <div class="variablelist"><table border="0">
 261 <col align="left" valign="top">
 262 <tbody>
 263 <tr>
 264 <td><p><span class="term"><em class="parameter"><code>demux</code></em> :</span></p></td>
 265 <td>the object which received the signal</td>
 266 </tr>
 267 <tr>
 268 <td><p><span class="term"><em class="parameter"><code>ssrc</code></em> :</span></p></td>
 269 <td>the SSRC of the pad</td>
 270 </tr>
 271 <tr>
 272 <td><p><span class="term"><em class="parameter"><code>pad</code></em> :</span></p></td>
 273 <td>the new pad.</td>
 274 </tr>
 275 <tr>
 276 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 277 <td>user data set when the signal handler was connected.</td>
 278 </tr>
 279 </tbody>
 280 </table></div>
 281 </div>
 282 <hr>
 283 <div class="refsect2">
 284 <a name="GstRtpSsrcDemux-removed-ssrc-pad"></a><h3>The <code class="literal">"removed-ssrc-pad"</code> signal</h3>
 285 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gst-plugins-good-plugins-gstrtpssrcdemux.html#GstRtpSsrcDemux"><span class="type">GstRtpSsrcDemux</span></a> *demux,
 286                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>            ssrc,
 287                                                         <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstPad.html"><span class="type">GstPad</span></a>          *pad,
 288                                                         <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>
 289 <p>
 290 Emited when a SSRC pad has been removed.
 291 </p>
 292 <div class="variablelist"><table border="0">
 293 <col align="left" valign="top">
 294 <tbody>
 295 <tr>
 296 <td><p><span class="term"><em class="parameter"><code>demux</code></em> :</span></p></td>
 297 <td>the object which received the signal</td>
 298 </tr>
 299 <tr>
 300 <td><p><span class="term"><em class="parameter"><code>ssrc</code></em> :</span></p></td>
 301 <td>the SSRC of the pad</td>
 302 </tr>
 303 <tr>
 304 <td><p><span class="term"><em class="parameter"><code>pad</code></em> :</span></p></td>
 305 <td>the removed pad.</td>
 306 </tr>
 307 <tr>
 308 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 309 <td>user data set when the signal handler was connected.</td>
 310 </tr>
 311 </tbody>
 312 </table></div>
 313 </div>
 314 </div>
 315 </div>
 316 <div class="footer">
 317 <hr>
 318           Generated by GTK-Doc V1.18</div>
 319 </body>
 320 </html>