docs/plugins/html/gst-plugins-good-plugins-gstrtpptdemux.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>gstrtpptdemux</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-gstrtpjitterbuffer.html" title="gstrtpjitterbuffer">
  10 <link rel="next" href="gst-plugins-good-plugins-gstrtpsession.html" title="gstrtpsession">
  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-gstrtpjitterbuffer.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-gstrtpsession.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-gstrtpptdemux.synopsis" class="shortcut">Top</a>
  25                    |
  26                   <a href="#gst-plugins-good-plugins-gstrtpptdemux.description" class="shortcut">Description</a>
  27                    |
  28                   <a href="#gst-plugins-good-plugins-gstrtpptdemux.object-hierarchy" class="shortcut">Object Hierarchy</a>
  29                    |
  30                   <a href="#gst-plugins-good-plugins-gstrtpptdemux.signals" class="shortcut">Signals</a>
  31 </td></tr>
  32 </table>
  33 <div class="refentry">
  34 <a name="gst-plugins-good-plugins-gstrtpptdemux"></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-gstrtpptdemux.top_of_page"></a>gstrtpptdemux</span></h2>
  38 <p>gstrtpptdemux — Parses codec streams transmitted in the same RTP session</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-gstrtpptdemux.synopsis"></a><h2>Synopsis</h2>
  44 <a name="GstRtpPtDemux"></a><pre class="synopsis">struct              <a class="link" href="gst-plugins-good-plugins-gstrtpptdemux.html#GstRtpPtDemux-struct" title="struct GstRtpPtDemux">GstRtpPtDemux</a>;
  45 </pre>
  46 </div>
  47 <div class="refsect1">
  48 <a name="gst-plugins-good-plugins-gstrtpptdemux.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                +----GstRtpPtDemux
  54 </pre>
  55 </div>
  56 <div class="refsect1">
  57 <a name="gst-plugins-good-plugins-gstrtpptdemux.signals"></a><h2>Signals</h2>
  58 <pre class="synopsis">
  59   "<a class="link" href="gst-plugins-good-plugins-gstrtpptdemux.html#GstRtpPtDemux-clear-pt-map" title='The "clear-pt-map" signal'>clear-pt-map</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-gstrtpptdemux.html#GstRtpPtDemux-new-payload-type" title='The "new-payload-type" signal'>new-payload-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>
  61   "<a class="link" href="gst-plugins-good-plugins-gstrtpptdemux.html#GstRtpPtDemux-payload-type-change" title='The "payload-type-change" signal'>payload-type-change</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   "<a class="link" href="gst-plugins-good-plugins-gstrtpptdemux.html#GstRtpPtDemux-request-pt-map" title='The "request-pt-map" signal'>request-pt-map</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>
  63 </pre>
  64 </div>
  65 <div class="refsect1">
  66 <a name="gst-plugins-good-plugins-gstrtpptdemux.description"></a><h2>Description</h2>
  67 <p>
  68 gstrtpptdemux acts as a demuxer for RTP packets based on the payload type of
  69 the packets. Its main purpose is to allow an application to easily receive
  70 and decode an RTP stream with multiple payload types.
  71 </p>
  72 <p>
  73 For each payload type that is detected, a new pad will be created and the
  74 <a class="link" href="gst-plugins-good-plugins-gstrtpptdemux.html#GstRtpPtDemux-new-payload-type" title='The "new-payload-type" signal'><span class="type">"new-payload-type"</span></a> signal will be emitted. When the payload for
  75 the RTP stream changes, the <a class="link" href="gst-plugins-good-plugins-gstrtpptdemux.html#GstRtpPtDemux-payload-type-change" title='The "payload-type-change" signal'><span class="type">"payload-type-change"</span></a> signal will be
  76 emitted.
  77 </p>
  78 <p>
  79 The element will try to set complete and unique application/x-rtp caps on the
  80 outgoing buffers and pads based on the result of the
  81 <a class="link" href="gst-plugins-good-plugins-gstrtpptdemux.html#GstRtpPtDemux-request-pt-map" title='The "request-pt-map" signal'><span class="type">"request-pt-map"</span></a> signal.
  82 </p>
  83 <p>
  84 </p>
  85 <div class="refsect2">
  86 <a name="idp13382144"></a><h3>Example pipelines</h3>
  87 <div class="informalexample">
  88   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
  89     <tbody>
  90       <tr>
  91         <td class="listing_lines" align="right"><pre>1</pre></td>
  92         <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> gstrtpptdemux <span class="gtkdoc opt">!</span> fakesink</pre></td>
  93       </tr>
  94     </tbody>
  95   </table>
  96 </div>
  97  Takes an RTP stream and send the RTP packets with the first detected
  98 payload type to fakesink, discarding the other payload types.
  99 </div>
 100 <p>
 101 </p>
 102 <p>
 103 Last reviewed on 2007-05-28 (0.10.5)
 104 </p>
 105 <div class="refsynopsisdiv">
 106 <h2>Synopsis</h2>
 107 <div class="refsect2">
 108 <a name="idp14792240"></a><h3>Element Information</h3>
 109 <div class="variablelist"><table border="0">
 110 <col align="left" valign="top">
 111 <tbody>
 112 <tr>
 113 <td><p><span class="term">plugin</span></p></td>
 114 <td>
 115             <a class="link" href="gst-plugins-good-plugins-plugin-gstrtpmanager.html#plugin-gstrtpmanager">gstrtpmanager</a>
 116           </td>
 117 </tr>
 118 <tr>
 119 <td><p><span class="term">author</span></p></td>
 120 <td>Kai Vehmanen &lt;kai.vehmanen@nokia.com&gt;</td>
 121 </tr>
 122 <tr>
 123 <td><p><span class="term">class</span></p></td>
 124 <td>Demux/Network/RTP</td>
 125 </tr>
 126 </tbody>
 127 </table></div>
 128 </div>
 129 <hr>
 130 <div class="refsect2">
 131 <a name="idp15811344"></a><h3>Element Pads</h3>
 132 <div class="variablelist"><table border="0">
 133 <col align="left" valign="top">
 134 <tbody>
 135 <tr>
 136 <td><p><span class="term">name</span></p></td>
 137 <td>sink</td>
 138 </tr>
 139 <tr>
 140 <td><p><span class="term">direction</span></p></td>
 141 <td>sink</td>
 142 </tr>
 143 <tr>
 144 <td><p><span class="term">presence</span></p></td>
 145 <td>always</td>
 146 </tr>
 147 <tr>
 148 <td><p><span class="term">details</span></p></td>
 149 <td>application/x-rtp</td>
 150 </tr>
 151 </tbody>
 152 </table></div>
 153 <div class="variablelist"><table border="0">
 154 <col align="left" valign="top">
 155 <tbody>
 156 <tr>
 157 <td><p><span class="term">name</span></p></td>
 158 <td>src_%d</td>
 159 </tr>
 160 <tr>
 161 <td><p><span class="term">direction</span></p></td>
 162 <td>source</td>
 163 </tr>
 164 <tr>
 165 <td><p><span class="term">presence</span></p></td>
 166 <td>sometimes</td>
 167 </tr>
 168 <tr>
 169 <td><p><span class="term">details</span></p></td>
 170 <td>application/x-rtp, payload=(int)[ 0, 255 ]</td>
 171 </tr>
 172 </tbody>
 173 </table></div>
 174 </div>
 175 </div>
 176 <p>
 177 </p>
 178 </div>
 179 <div class="refsect1">
 180 <a name="gst-plugins-good-plugins-gstrtpptdemux.details"></a><h2>Details</h2>
 181 <div class="refsect2">
 182 <a name="GstRtpPtDemux-struct"></a><h3>struct GstRtpPtDemux</h3>
 183 <pre class="programlisting">struct GstRtpPtDemux;</pre>
 184 <p>
 185 </p>
 186 </div>
 187 </div>
 188 <div class="refsect1">
 189 <a name="gst-plugins-good-plugins-gstrtpptdemux.signal-details"></a><h2>Signal Details</h2>
 190 <div class="refsect2">
 191 <a name="GstRtpPtDemux-clear-pt-map"></a><h3>The <code class="literal">"clear-pt-map"</code> signal</h3>
 192 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gst-plugins-good-plugins-gstrtpptdemux.html#GstRtpPtDemux"><span class="type">GstRtpPtDemux</span></a> *demux,
 193                                                         <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>
 194 <p>
 195 The application can call this signal to instruct the element to discard the
 196 currently cached payload type map.
 197 </p>
 198 <div class="variablelist"><table border="0">
 199 <col align="left" valign="top">
 200 <tbody>
 201 <tr>
 202 <td><p><span class="term"><em class="parameter"><code>demux</code></em> :</span></p></td>
 203 <td>the object which received the signal</td>
 204 </tr>
 205 <tr>
 206 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 207 <td>user data set when the signal handler was connected.</td>
 208 </tr>
 209 </tbody>
 210 </table></div>
 211 </div>
 212 <hr>
 213 <div class="refsect2">
 214 <a name="GstRtpPtDemux-new-payload-type"></a><h3>The <code class="literal">"new-payload-type"</code> signal</h3>
 215 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gst-plugins-good-plugins-gstrtpptdemux.html#GstRtpPtDemux"><span class="type">GstRtpPtDemux</span></a> *demux,
 216                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>          pt,
 217                                                         <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstPad.html"><span class="type">GstPad</span></a>        *pad,
 218                                                         <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>
 219 <p>
 220 Emited when a new payload type pad has been created in <em class="parameter"><code>demux</code></em>.
 221 </p>
 222 <div class="variablelist"><table border="0">
 223 <col align="left" valign="top">
 224 <tbody>
 225 <tr>
 226 <td><p><span class="term"><em class="parameter"><code>demux</code></em> :</span></p></td>
 227 <td>the object which received the signal</td>
 228 </tr>
 229 <tr>
 230 <td><p><span class="term"><em class="parameter"><code>pt</code></em> :</span></p></td>
 231 <td>the payload type</td>
 232 </tr>
 233 <tr>
 234 <td><p><span class="term"><em class="parameter"><code>pad</code></em> :</span></p></td>
 235 <td>the pad with the new payload</td>
 236 </tr>
 237 <tr>
 238 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 239 <td>user data set when the signal handler was connected.</td>
 240 </tr>
 241 </tbody>
 242 </table></div>
 243 </div>
 244 <hr>
 245 <div class="refsect2">
 246 <a name="GstRtpPtDemux-payload-type-change"></a><h3>The <code class="literal">"payload-type-change"</code> signal</h3>
 247 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="gst-plugins-good-plugins-gstrtpptdemux.html#GstRtpPtDemux"><span class="type">GstRtpPtDemux</span></a> *demux,
 248                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>          pt,
 249                                                         <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>
 250 <p>
 251 Emited when the payload type changed.
 252 </p>
 253 <div class="variablelist"><table border="0">
 254 <col align="left" valign="top">
 255 <tbody>
 256 <tr>
 257 <td><p><span class="term"><em class="parameter"><code>demux</code></em> :</span></p></td>
 258 <td>the object which received the signal</td>
 259 </tr>
 260 <tr>
 261 <td><p><span class="term"><em class="parameter"><code>pt</code></em> :</span></p></td>
 262 <td>the new payload type</td>
 263 </tr>
 264 <tr>
 265 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 266 <td>user data set when the signal handler was connected.</td>
 267 </tr>
 268 </tbody>
 269 </table></div>
 270 </div>
 271 <hr>
 272 <div class="refsect2">
 273 <a name="GstRtpPtDemux-request-pt-map"></a><h3>The <code class="literal">"request-pt-map"</code> signal</h3>
 274 <pre class="programlisting"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="returnvalue">GstCaps</span></a>*            user_function                      (<a class="link" href="gst-plugins-good-plugins-gstrtpptdemux.html#GstRtpPtDemux"><span class="type">GstRtpPtDemux</span></a> *demux,
 275                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>          pt,
 276                                                         <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>
 277 <p>
 278 Request the payload type as <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a> for <em class="parameter"><code>pt</code></em>.
 279 </p>
 280 <div class="variablelist"><table border="0">
 281 <col align="left" valign="top">
 282 <tbody>
 283 <tr>
 284 <td><p><span class="term"><em class="parameter"><code>demux</code></em> :</span></p></td>
 285 <td>the object which received the signal</td>
 286 </tr>
 287 <tr>
 288 <td><p><span class="term"><em class="parameter"><code>pt</code></em> :</span></p></td>
 289 <td>the payload type</td>
 290 </tr>
 291 <tr>
 292 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 293 <td>user data set when the signal handler was connected.</td>
 294 </tr>
 295 </tbody>
 296 </table></div>
 297 </div>
 298 </div>
 299 </div>
 300 <div class="footer">
 301 <hr>
 302           Generated by GTK-Doc V1.18</div>
 303 </body>
 304 </html>