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>decodebin3: GStreamer Base 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 Base Plugins 1.0 Plugins Reference Manual"> 8<link rel="up" href="ch01.html" title="gst-plugins-base Elements"> 9<link rel="prev" href="gst-plugins-base-plugins-decodebin.html" title="decodebin"> 10<link rel="next" href="gst-plugins-base-plugins-encodebin.html" title="encodebin"> 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-base-plugins-decodebin3.description" class="shortcut">Description</a></span> 19</td> 20<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td> 21<td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td> 22<td><a accesskey="p" href="gst-plugins-base-plugins-decodebin.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td> 23<td><a accesskey="n" href="gst-plugins-base-plugins-encodebin.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td> 24</tr></table> 25<div class="refentry"> 26<a name="gst-plugins-base-plugins-decodebin3"></a><div class="titlepage"></div> 27<div class="refnamediv"><table width="100%"><tr> 28<td valign="top"> 29<h2><span class="refentrytitle"><a name="gst-plugins-base-plugins-decodebin3.top_of_page"></a>decodebin3</span></h2> 30<p>decodebin3</p> 31</td> 32<td class="gallery_image" valign="top" align="right"></td> 33</tr></table></div> 34<div class="refsect1"> 35<a name="gst-plugins-base-plugins-decodebin3.description"></a><h2>Description</h2> 36<p><a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstBin.html#GstBin-struct"><span class="type">GstBin</span></a> that auto-magically constructs a decoding pipeline using available 37decoders and demuxers via auto-plugging. The output is raw audio, video 38or subtitle streams.</p> 39<p>decodebin3 differs from the previous decodebin (decodebin2) in important ways:</p> 40<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 41<li class="listitem"><p>supports publication and selection of stream information via 42GstStreamCollection messages and <span class="type">GST_EVENT_SELECT_STREAM</span> events.</p></li> 43<li class="listitem"><p>dynamically switches stream connections internally, and 44reuses decoder elements when stream selections change, so that in 45the normal case it maintains 1 decoder of each type (video/audio/subtitle) 46and only creates new elements when streams change and an existing decoder 47is not capable of handling the new format.</p></li> 48<li class="listitem"><p>supports multiple input pads for the parallel decoding of auxilliary streams 49not muxed with the primary stream.</p></li> 50<li class="listitem"><p>does not handle network stream buffering. decodebin3 expects that network stream 51buffering is handled upstream, before data is passed to it.</p></li> 52</ul></div> 53<p><span class="emphasis"><em>decodebin3 is still experimental API and a technology preview. 54Its behaviour and exposed API is subject to change.</em></span></p> 55<div class="refsynopsisdiv"> 56<h2>Synopsis</h2> 57<div class="refsect2"> 58<a name="id-1.2.18.3.6.1"></a><h3>Element Information</h3> 59<div class="variablelist"><table border="0" class="variablelist"> 60<colgroup> 61<col align="left" valign="top"> 62<col> 63</colgroup> 64<tbody> 65<tr> 66<td><p><span class="term">plugin</span></p></td> 67<td> 68 <a class="link" href="gst-plugins-base-plugins-plugin-playback.html#plugin-playback">playback</a> 69 </td> 70</tr> 71<tr> 72<td><p><span class="term">author</span></p></td> 73<td>Edward Hervey <edward@centricular.com></td> 74</tr> 75<tr> 76<td><p><span class="term">class</span></p></td> 77<td>Generic/Bin/Decoder</td> 78</tr> 79</tbody> 80</table></div> 81</div> 82<hr> 83<div class="refsect2"> 84<a name="id-1.2.18.3.6.2"></a><h3>Element Pads</h3> 85<div class="variablelist"><table border="0" class="variablelist"> 86<colgroup> 87<col align="left" valign="top"> 88<col> 89</colgroup> 90<tbody> 91<tr> 92<td><p><span class="term">name</span></p></td> 93<td>sink</td> 94</tr> 95<tr> 96<td><p><span class="term">direction</span></p></td> 97<td>sink</td> 98</tr> 99<tr> 100<td><p><span class="term">presence</span></p></td> 101<td>always</td> 102</tr> 103<tr> 104<td><p><span class="term">details</span></p></td> 105<td>ANY</td> 106</tr> 107</tbody> 108</table></div> 109<div class="variablelist"><table border="0" class="variablelist"> 110<colgroup> 111<col align="left" valign="top"> 112<col> 113</colgroup> 114<tbody> 115<tr> 116<td><p><span class="term">name</span></p></td> 117<td>sink_%u</td> 118</tr> 119<tr> 120<td><p><span class="term">direction</span></p></td> 121<td>sink</td> 122</tr> 123<tr> 124<td><p><span class="term">presence</span></p></td> 125<td>request</td> 126</tr> 127<tr> 128<td><p><span class="term">details</span></p></td> 129<td>ANY</td> 130</tr> 131</tbody> 132</table></div> 133<div class="variablelist"><table border="0" class="variablelist"> 134<colgroup> 135<col align="left" valign="top"> 136<col> 137</colgroup> 138<tbody> 139<tr> 140<td><p><span class="term">name</span></p></td> 141<td>audio_%u</td> 142</tr> 143<tr> 144<td><p><span class="term">direction</span></p></td> 145<td>source</td> 146</tr> 147<tr> 148<td><p><span class="term">presence</span></p></td> 149<td>sometimes</td> 150</tr> 151<tr> 152<td><p><span class="term">details</span></p></td> 153<td>ANY</td> 154</tr> 155</tbody> 156</table></div> 157<div class="variablelist"><table border="0" class="variablelist"> 158<colgroup> 159<col align="left" valign="top"> 160<col> 161</colgroup> 162<tbody> 163<tr> 164<td><p><span class="term">name</span></p></td> 165<td>src_%u</td> 166</tr> 167<tr> 168<td><p><span class="term">direction</span></p></td> 169<td>source</td> 170</tr> 171<tr> 172<td><p><span class="term">presence</span></p></td> 173<td>sometimes</td> 174</tr> 175<tr> 176<td><p><span class="term">details</span></p></td> 177<td>ANY</td> 178</tr> 179</tbody> 180</table></div> 181<div class="variablelist"><table border="0" class="variablelist"> 182<colgroup> 183<col align="left" valign="top"> 184<col> 185</colgroup> 186<tbody> 187<tr> 188<td><p><span class="term">name</span></p></td> 189<td>text_%u</td> 190</tr> 191<tr> 192<td><p><span class="term">direction</span></p></td> 193<td>source</td> 194</tr> 195<tr> 196<td><p><span class="term">presence</span></p></td> 197<td>sometimes</td> 198</tr> 199<tr> 200<td><p><span class="term">details</span></p></td> 201<td>ANY</td> 202</tr> 203</tbody> 204</table></div> 205<div class="variablelist"><table border="0" class="variablelist"> 206<colgroup> 207<col align="left" valign="top"> 208<col> 209</colgroup> 210<tbody> 211<tr> 212<td><p><span class="term">name</span></p></td> 213<td>video_%u</td> 214</tr> 215<tr> 216<td><p><span class="term">direction</span></p></td> 217<td>source</td> 218</tr> 219<tr> 220<td><p><span class="term">presence</span></p></td> 221<td>sometimes</td> 222</tr> 223<tr> 224<td><p><span class="term">details</span></p></td> 225<td>ANY</td> 226</tr> 227</tbody> 228</table></div> 229</div> 230</div> 231</div> 232<div class="refsect1"> 233<a name="gst-plugins-base-plugins-decodebin3.functions_details"></a><h2>Functions</h2> 234<p></p> 235</div> 236<div class="refsect1"> 237<a name="gst-plugins-base-plugins-decodebin3.other_details"></a><h2>Types and Values</h2> 238</div> 239</div> 240<div class="footer"> 241<hr>Generated by GTK-Doc V1.28</div> 242</body> 243</html>
