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>mplex: GStreamer Bad Plugins 1.0 Plugins Reference Manual</title> 6<meta name="generator" content="DocBook XSL Stylesheets V1.79.1"> 7<link rel="home" href="index.html" title="GStreamer Bad Plugins 1.0 Plugins Reference Manual"> 8<link rel="up" href="ch01.html" title="gst-plugins-bad Elements"> 9<link rel="prev" href="gst-plugins-bad-plugins-mpegvideoparse.html" title="mpegvideoparse"> 10<link rel="next" href="gst-plugins-bad-plugins-mssdemux.html" title="mssdemux"> 11<meta name="generator" content="GTK-Doc V1.28 (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="5"><tr valign="middle"> 16<td width="100%" align="left" class="shortcuts"> 17<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span> 18 <a href="#gst-plugins-bad-plugins-mplex.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> 19 <a href="#gst-plugins-bad-plugins-mplex.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_properties"> <span class="dim">|</span> 20 <a href="#gst-plugins-bad-plugins-mplex.properties" class="shortcut">Properties</a></span> 21</td> 22<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td> 23<td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td> 24<td><a accesskey="p" href="gst-plugins-bad-plugins-mpegvideoparse.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td> 25<td><a accesskey="n" href="gst-plugins-bad-plugins-mssdemux.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td> 26</tr></table> 27<div class="refentry"> 28<a name="gst-plugins-bad-plugins-mplex"></a><div class="titlepage"></div> 29<div class="refnamediv"><table width="100%"><tr> 30<td valign="top"> 31<h2><span class="refentrytitle"><a name="gst-plugins-bad-plugins-mplex.top_of_page"></a>mplex</span></h2> 32<p>mplex</p> 33</td> 34<td class="gallery_image" valign="top" align="right"></td> 35</tr></table></div> 36<div class="refsect1"> 37<a name="gst-plugins-bad-plugins-mplex.properties"></a><h2>Properties</h2> 38<div class="informaltable"><table class="informaltable" border="0"> 39<colgroup> 40<col width="150px" class="properties_type"> 41<col width="300px" class="properties_name"> 42<col width="200px" class="properties_flags"> 43</colgroup> 44<tbody> 45<tr> 46<td class="property_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td> 47<td class="property_name"><a class="link" href="gst-plugins-bad-plugins-mplex.html#GstMplex--bufsize" title="The “bufsize” property">bufsize</a></td> 48<td class="property_flags">Read / Write</td> 49</tr> 50<tr> 51<td class="property_type"><span class="type">GstMplexFormat</span></td> 52<td class="property_name"><a class="link" href="gst-plugins-bad-plugins-mplex.html#GstMplex--format" title="The “format” property">format</a></td> 53<td class="property_flags">Read / Write</td> 54</tr> 55<tr> 56<td class="property_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td> 57<td class="property_name"><a class="link" href="gst-plugins-bad-plugins-mplex.html#GstMplex--mux-bitrate" title="The “mux-bitrate” property">mux-bitrate</a></td> 58<td class="property_flags">Read / Write</td> 59</tr> 60<tr> 61<td class="property_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td> 62<td class="property_name"><a class="link" href="gst-plugins-bad-plugins-mplex.html#GstMplex--packets-per-pack" title="The “packets-per-pack” property">packets-per-pack</a></td> 63<td class="property_flags">Read / Write</td> 64</tr> 65<tr> 66<td class="property_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td> 67<td class="property_name"><a class="link" href="gst-plugins-bad-plugins-mplex.html#GstMplex--sector-size" title="The “sector-size” property">sector-size</a></td> 68<td class="property_flags">Read / Write</td> 69</tr> 70<tr> 71<td class="property_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td> 72<td class="property_name"><a class="link" href="gst-plugins-bad-plugins-mplex.html#GstMplex--system-headers" title="The “system-headers” property">system-headers</a></td> 73<td class="property_flags">Read / Write</td> 74</tr> 75<tr> 76<td class="property_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td> 77<td class="property_name"><a class="link" href="gst-plugins-bad-plugins-mplex.html#GstMplex--vbr" title="The “vbr” property">vbr</a></td> 78<td class="property_flags">Read / Write</td> 79</tr> 80</tbody> 81</table></div> 82</div> 83<a name="GstMplex"></a><div class="refsect1"> 84<a name="gst-plugins-bad-plugins-mplex.other"></a><h2>Types and Values</h2> 85<div class="informaltable"><table class="informaltable" width="100%" border="0"> 86<colgroup> 87<col width="150px" class="name"> 88<col class="description"> 89</colgroup> 90<tbody><tr> 91<td class="datatype_keyword"> </td> 92<td class="function_name"><a class="link" href="gst-plugins-bad-plugins-mplex.html#GstMplex-struct" title="GstMplex">GstMplex</a></td> 93</tr></tbody> 94</table></div> 95</div> 96<div class="refsect1"> 97<a name="gst-plugins-bad-plugins-mplex.object-hierarchy"></a><h2>Object Hierarchy</h2> 98<pre class="screen"> <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a> 99 <span class="lineart">╰──</span> <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a> 100 <span class="lineart">╰──</span> <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstObject.html#GstObject-struct">GstObject</a> 101 <span class="lineart">╰──</span> <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstElement.html#GstElement-struct">GstElement</a> 102 <span class="lineart">╰──</span> GstMplex 103</pre> 104</div> 105<div class="refsect1"> 106<a name="gst-plugins-bad-plugins-mplex.description"></a><h2>Description</h2> 107<p>This element is an audio/video multiplexer for MPEG-1/2 video streams 108and (un)compressed audio streams such as AC3, MPEG layer I/II/III. 109It is based on the <a class="ulink" href="http://mjpeg.sourceforge.net/" target="_top">mjpegtools</a> library. 110Documentation on creating MPEG videos in general can be found in the</p> 111<a class="ulink" href="https://sourceforge.net/docman/display_doc.php?docid=3456&group_id=5776" target="_top">MJPEG Howto</a><p>and the man-page of the mplex tool documents the properties of this element, 112which are shared with the mplex tool.</p> 113<div class="refsect2"> 114<a name="id-1.2.148.7.5"></a><h3>Example pipeline</h3> 115<div class="informalexample"> 116 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> 117 <tbody> 118 <tr> 119 <td class="listing_lines" align="right"><pre>1</pre></td> 120 <td class="listing_code"><pre class="programlisting">gst<span class="gtkdoc opt">-</span>launch<span class="gtkdoc opt">-</span><span class="number">1.0</span> <span class="gtkdoc opt">-</span>v videotestsrc num<span class="gtkdoc opt">-</span>buffers<span class="gtkdoc opt">=</span><span class="number">1000</span> <span class="gtkdoc opt">!</span> mpeg2enc <span class="gtkdoc opt">!</span> mplex <span class="gtkdoc opt">!</span> filesink location<span class="gtkdoc opt">=</span>videotestsrc<span class="gtkdoc opt">.</span>mpg</pre></td> 121 </tr> 122 </tbody> 123 </table> 124</div> 125 This example pipeline will encode a test video source to an 126MPEG1 elementary stream and multiplexes this to an MPEG system stream. 127<p> 128If several streams are being multiplexed, there should (as usual) be 129a queue in each stream, and due to mplex' buffering the capacities of these 130may have to be set to a few times the default settings to prevent the 131pipeline stalling. 132</p> 133</div> 134<div class="refsynopsisdiv"> 135<h2>Synopsis</h2> 136<div class="refsect2"> 137<a name="id-1.2.148.7.6.1"></a><h3>Element Information</h3> 138<div class="variablelist"><table border="0" class="variablelist"> 139<colgroup> 140<col align="left" valign="top"> 141<col> 142</colgroup> 143<tbody> 144<tr> 145<td><p><span class="term">plugin</span></p></td> 146<td> 147 <a class="link" href="gst-plugins-bad-plugins-plugin-mplex.html#plugin-mplex">mplex</a> 148 </td> 149</tr> 150<tr> 151<td><p><span class="term">author</span></p></td> 152<td>Andrew Stevens <andrew.stevens@nexgo.de> 153Ronald Bultje <rbultje@ronald.bitfreak.net> 154Mark Nauwelaerts <mnauw@users.sourceforge.net></td> 155</tr> 156<tr> 157<td><p><span class="term">class</span></p></td> 158<td>Codec/Muxer</td> 159</tr> 160</tbody> 161</table></div> 162</div> 163<hr> 164<div class="refsect2"> 165<a name="id-1.2.148.7.6.2"></a><h3>Element Pads</h3> 166<div class="variablelist"><table border="0" class="variablelist"> 167<colgroup> 168<col align="left" valign="top"> 169<col> 170</colgroup> 171<tbody> 172<tr> 173<td><p><span class="term">name</span></p></td> 174<td>audio_%u</td> 175</tr> 176<tr> 177<td><p><span class="term">direction</span></p></td> 178<td>sink</td> 179</tr> 180<tr> 181<td><p><span class="term">presence</span></p></td> 182<td>request</td> 183</tr> 184<tr> 185<td><p><span class="term">details</span></p></td> 186<td>audio/mpeg, mpegversion=(int)1, layer=(int)[ 1, 3 ], channels=(int)[ 1, 8 ], rate=(int)[ 8000, 96000 ]</td> 187</tr> 188<tr> 189<td><p><span class="term"></span></p></td> 190<td> audio/x-ac3, channels=(int)[ 1, 8 ], rate=(int)[ 8000, 96000 ]</td> 191</tr> 192<tr> 193<td><p><span class="term"></span></p></td> 194<td> audio/x-dts</td> 195</tr> 196<tr> 197<td><p><span class="term"></span></p></td> 198<td> audio/x-raw, format=(string){ S16BE, S20BE, S24BE }, rate=(int){ 48000, 96000 }, channels=(int)[ 1, 6 ]</td> 199</tr> 200</tbody> 201</table></div> 202<div class="variablelist"><table border="0" class="variablelist"> 203<colgroup> 204<col align="left" valign="top"> 205<col> 206</colgroup> 207<tbody> 208<tr> 209<td><p><span class="term">name</span></p></td> 210<td>video_%u</td> 211</tr> 212<tr> 213<td><p><span class="term">direction</span></p></td> 214<td>sink</td> 215</tr> 216<tr> 217<td><p><span class="term">presence</span></p></td> 218<td>request</td> 219</tr> 220<tr> 221<td><p><span class="term">details</span></p></td> 222<td>video/mpeg, mpegversion=(int){ 1, 2 }, systemstream=(boolean)false, width=(int)[ 16, 4096 ], height=(int)[ 16, 4096 ], framerate=(fraction)[ 0/1, 2147483647/1 ]</td> 223</tr> 224</tbody> 225</table></div> 226<div class="variablelist"><table border="0" class="variablelist"> 227<colgroup> 228<col align="left" valign="top"> 229<col> 230</colgroup> 231<tbody> 232<tr> 233<td><p><span class="term">name</span></p></td> 234<td>src</td> 235</tr> 236<tr> 237<td><p><span class="term">direction</span></p></td> 238<td>source</td> 239</tr> 240<tr> 241<td><p><span class="term">presence</span></p></td> 242<td>always</td> 243</tr> 244<tr> 245<td><p><span class="term">details</span></p></td> 246<td>video/mpeg, systemstream=(boolean)true</td> 247</tr> 248</tbody> 249</table></div> 250</div> 251</div> 252</div> 253<div class="refsect1"> 254<a name="gst-plugins-bad-plugins-mplex.functions_details"></a><h2>Functions</h2> 255<p></p> 256</div> 257<div class="refsect1"> 258<a name="gst-plugins-bad-plugins-mplex.other_details"></a><h2>Types and Values</h2> 259<div class="refsect2"> 260<a name="GstMplex-struct"></a><h3>GstMplex</h3> 261<pre class="programlisting">typedef struct _GstMplex GstMplex;</pre> 262</div> 263</div> 264<div class="refsect1"> 265<a name="gst-plugins-bad-plugins-mplex.property-details"></a><h2>Property Details</h2> 266<div class="refsect2"> 267<a name="GstMplex--bufsize"></a><h3>The <code class="literal">“bufsize”</code> property</h3> 268<pre class="programlisting"> “bufsize” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre> 269<p>Target decoders video buffer size (kB) [default determined by format if not explicitly set].</p> 270<p>Flags: Read / Write</p> 271<p>Allowed values: [20,4000]</p> 272<p>Default value: 46</p> 273</div> 274<hr> 275<div class="refsect2"> 276<a name="GstMplex--format"></a><h3>The <code class="literal">“format”</code> property</h3> 277<pre class="programlisting"> “format” <span class="type">GstMplexFormat</span></pre> 278<p>Encoding profile format.</p> 279<p>Flags: Read / Write</p> 280<p>Default value: DVD MPEG-2</p> 281</div> 282<hr> 283<div class="refsect2"> 284<a name="GstMplex--mux-bitrate"></a><h3>The <code class="literal">“mux-bitrate”</code> property</h3> 285<pre class="programlisting"> “mux-bitrate” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre> 286<p>Bitrate of output stream in kbps (0 = autodetect).</p> 287<p>Flags: Read / Write</p> 288<p>Allowed values: [0,15360]</p> 289<p>Default value: 0</p> 290</div> 291<hr> 292<div class="refsect2"> 293<a name="GstMplex--packets-per-pack"></a><h3>The <code class="literal">“packets-per-pack”</code> property</h3> 294<pre class="programlisting"> “packets-per-pack” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre> 295<p>Number of packets per pack for generic formats.</p> 296<p>Flags: Read / Write</p> 297<p>Allowed values: [1,100]</p> 298<p>Default value: 1</p> 299</div> 300<hr> 301<div class="refsect2"> 302<a name="GstMplex--sector-size"></a><h3>The <code class="literal">“sector-size”</code> property</h3> 303<pre class="programlisting"> “sector-size” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre> 304<p>Specify sector size in bytes for generic formats.</p> 305<p>Flags: Read / Write</p> 306<p>Allowed values: [256,16384]</p> 307<p>Default value: 2048</p> 308</div> 309<hr> 310<div class="refsect2"> 311<a name="GstMplex--system-headers"></a><h3>The <code class="literal">“system-headers”</code> property</h3> 312<pre class="programlisting"> “system-headers” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre> 313<p>Create system header in every pack for generic formats.</p> 314<p>Flags: Read / Write</p> 315<p>Default value: FALSE</p> 316</div> 317<hr> 318<div class="refsect2"> 319<a name="GstMplex--vbr"></a><h3>The <code class="literal">“vbr”</code> property</h3> 320<pre class="programlisting"> “vbr” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre> 321<p>Whether the input video stream is variable bitrate.</p> 322<p>Flags: Read / Write</p> 323<p>Default value: FALSE</p> 324</div> 325</div> 326<div class="refsect1"> 327<a name="gst-plugins-bad-plugins-mplex.see-also"></a><h2>See Also</h2> 328<p>mpeg2enc</p> 329</div> 330</div> 331<div class="footer"> 332<hr>Generated by GTK-Doc V1.28</div> 333</body> 334</html>
