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>multifilesrc: GStreamer Good 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 Good Plugins 1.0 Plugins Reference Manual"> 8<link rel="up" href="ch01.html" title="gst-plugins-good Elements"> 9<link rel="prev" href="gst-plugins-good-plugins-multifilesink.html" title="multifilesink"> 10<link rel="next" href="gst-plugins-good-plugins-multipartdemux.html" title="multipartdemux"> 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-good-plugins-multifilesrc.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span> 19 <a href="#gst-plugins-good-plugins-multifilesrc.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces"> <span class="dim">|</span> 20 <a href="#gst-plugins-good-plugins-multifilesrc.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties"> <span class="dim">|</span> 21 <a href="#gst-plugins-good-plugins-multifilesrc.properties" class="shortcut">Properties</a></span> 22</td> 23<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td> 24<td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td> 25<td><a accesskey="p" href="gst-plugins-good-plugins-multifilesink.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td> 26<td><a accesskey="n" href="gst-plugins-good-plugins-multipartdemux.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td> 27</tr></table> 28<div class="refentry"> 29<a name="gst-plugins-good-plugins-multifilesrc"></a><div class="titlepage"></div> 30<div class="refnamediv"><table width="100%"><tr> 31<td valign="top"> 32<h2><span class="refentrytitle"><a name="gst-plugins-good-plugins-multifilesrc.top_of_page"></a>multifilesrc</span></h2> 33<p>multifilesrc</p> 34</td> 35<td class="gallery_image" valign="top" align="right"></td> 36</tr></table></div> 37<div class="refsect1"> 38<a name="gst-plugins-good-plugins-multifilesrc.properties"></a><h2>Properties</h2> 39<div class="informaltable"><table class="informaltable" border="0"> 40<colgroup> 41<col width="150px" class="properties_type"> 42<col width="300px" class="properties_name"> 43<col width="200px" class="properties_flags"> 44</colgroup> 45<tbody> 46<tr> 47<td class="property_type"> 48<a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#GstCaps-struct"><span class="type">GstCaps</span></a> *</td> 49<td class="property_name"><a class="link" href="gst-plugins-good-plugins-multifilesrc.html#GstMultiFileSrc--caps" title="The “caps” property">caps</a></td> 50<td class="property_flags">Read / Write</td> 51</tr> 52<tr> 53<td class="property_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td> 54<td class="property_name"><a class="link" href="gst-plugins-good-plugins-multifilesrc.html#GstMultiFileSrc--index" title="The “index” property">index</a></td> 55<td class="property_flags">Read / Write</td> 56</tr> 57<tr> 58<td class="property_type"> 59<a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</td> 60<td class="property_name"><a class="link" href="gst-plugins-good-plugins-multifilesrc.html#GstMultiFileSrc--location" title="The “location” property">location</a></td> 61<td class="property_flags">Read / Write</td> 62</tr> 63<tr> 64<td class="property_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></td> 65<td class="property_name"><a class="link" href="gst-plugins-good-plugins-multifilesrc.html#GstMultiFileSrc--loop" title="The “loop” property">loop</a></td> 66<td class="property_flags">Read / Write</td> 67</tr> 68<tr> 69<td class="property_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td> 70<td class="property_name"><a class="link" href="gst-plugins-good-plugins-multifilesrc.html#GstMultiFileSrc--start-index" title="The “start-index” property">start-index</a></td> 71<td class="property_flags">Read / Write</td> 72</tr> 73<tr> 74<td class="property_type"><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></td> 75<td class="property_name"><a class="link" href="gst-plugins-good-plugins-multifilesrc.html#GstMultiFileSrc--stop-index" title="The “stop-index” property">stop-index</a></td> 76<td class="property_flags">Read / Write</td> 77</tr> 78</tbody> 79</table></div> 80</div> 81<a name="GstMultiFileSrc"></a><div class="refsect1"> 82<a name="gst-plugins-good-plugins-multifilesrc.other"></a><h2>Types and Values</h2> 83<div class="informaltable"><table class="informaltable" width="100%" border="0"> 84<colgroup> 85<col width="150px" class="name"> 86<col class="description"> 87</colgroup> 88<tbody><tr> 89<td class="datatype_keyword">struct</td> 90<td class="function_name"><a class="link" href="gst-plugins-good-plugins-multifilesrc.html#GstMultiFileSrc-struct" title="struct GstMultiFileSrc">GstMultiFileSrc</a></td> 91</tr></tbody> 92</table></div> 93</div> 94<div class="refsect1"> 95<a name="gst-plugins-good-plugins-multifilesrc.object-hierarchy"></a><h2>Object Hierarchy</h2> 96<pre class="screen"> <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GObject-struct">GObject</a> 97 <span class="lineart">╰──</span> <a href="/usr/share/gtk-doc/html/gobject/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a> 98 <span class="lineart">╰──</span> <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstObject.html#GstObject-struct">GstObject</a> 99 <span class="lineart">╰──</span> <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstElement.html#GstElement-struct">GstElement</a> 100 <span class="lineart">╰──</span> <a href="/usr/share/gtk-doc/html/gstreamer-libs-1.0/GstBaseSrc.html#GstBaseSrc-struct">GstBaseSrc</a> 101 <span class="lineart">╰──</span> <a href="/usr/share/gtk-doc/html/gstreamer-libs-1.0/GstPushSrc.html#GstPushSrc-struct">GstPushSrc</a> 102 <span class="lineart">╰──</span> GstMultiFileSrc 103</pre> 104</div> 105<div class="refsect1"> 106<a name="gst-plugins-good-plugins-multifilesrc.implemented-interfaces"></a><h2>Implemented Interfaces</h2> 107<p> 108GstMultiFileSrc implements 109 <a href="/usr/share/gtk-doc/html/gstreamer-1.0/gstreamer-GstUriHandler.html#GstURIHandler-struct">GstURIHandler</a>.</p> 110</div> 111<div class="refsect1"> 112<a name="gst-plugins-good-plugins-multifilesrc.description"></a><h2>Description</h2> 113<p>Reads buffers from sequentially named files. If used together with an image 114decoder, one needs to use the <a class="link" href="gst-plugins-good-plugins-multifilesrc.html#GstMultiFileSrc--caps" title="The “caps” property"><span class="type">“caps”</span></a> property or a capsfilter 115to force to caps containing a framerate. Otherwise image decoders send EOS 116after the first picture. We also need a videorate element to set timestamps 117on all buffers after the first one in accordance with the framerate.</p> 118<p>File names are created by replacing "%d" with the index using <code class="function">printf()</code>.</p> 119<div class="refsect2"> 120<a name="id-1.2.99.8.4"></a><h3>Example launch line</h3> 121<div class="informalexample"> 122 <table class="listing_frame" border="0" cellpadding="0" cellspacing="0"> 123 <tbody> 124 <tr> 125 <td class="listing_lines" align="right"><pre>1 1262 1273</pre></td> 128 <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> multifilesrc location<span class="gtkdoc opt">=</span><span class="string">"img.%04d.png"</span> index<span class="gtkdoc opt">=</span><span class="number">0</span> caps<span class="gtkdoc opt">=</span><span class="string">"image/png,framerate=\(fraction\)12/1"</span> <span class="gtkdoc opt">!</span> \ 129 pngdec <span class="gtkdoc opt">!</span> videoconvert <span class="gtkdoc opt">!</span> videorate <span class="gtkdoc opt">!</span> theoraenc <span class="gtkdoc opt">!</span> oggmux <span class="gtkdoc opt">!</span> \ 130 filesink location<span class="gtkdoc opt">=</span><span class="string">"images.ogg"</span></pre></td> 131 </tr> 132 </tbody> 133 </table> 134</div> 135 This pipeline creates a video file "images.ogg" by joining multiple PNG 136files named img.0000.png, img.0001.png, etc. 137</div> 138<div class="refsynopsisdiv"> 139<h2>Synopsis</h2> 140<div class="refsect2"> 141<a name="id-1.2.99.8.5.1"></a><h3>Element Information</h3> 142<div class="variablelist"><table border="0" class="variablelist"> 143<colgroup> 144<col align="left" valign="top"> 145<col> 146</colgroup> 147<tbody> 148<tr> 149<td><p><span class="term">plugin</span></p></td> 150<td> 151 <a class="link" href="gst-plugins-good-plugins-plugin-multifile.html#plugin-multifile">multifile</a> 152 </td> 153</tr> 154<tr> 155<td><p><span class="term">author</span></p></td> 156<td>David Schleef <ds@schleef.org></td> 157</tr> 158<tr> 159<td><p><span class="term">class</span></p></td> 160<td>Source/File</td> 161</tr> 162</tbody> 163</table></div> 164</div> 165<hr> 166<div class="refsect2"> 167<a name="id-1.2.99.8.5.2"></a><h3>Element Pads</h3> 168<div class="variablelist"><table border="0" class="variablelist"> 169<colgroup> 170<col align="left" valign="top"> 171<col> 172</colgroup> 173<tbody> 174<tr> 175<td><p><span class="term">name</span></p></td> 176<td>src</td> 177</tr> 178<tr> 179<td><p><span class="term">direction</span></p></td> 180<td>source</td> 181</tr> 182<tr> 183<td><p><span class="term">presence</span></p></td> 184<td>always</td> 185</tr> 186<tr> 187<td><p><span class="term">details</span></p></td> 188<td>ANY</td> 189</tr> 190</tbody> 191</table></div> 192</div> 193</div> 194</div> 195<div class="refsect1"> 196<a name="gst-plugins-good-plugins-multifilesrc.functions_details"></a><h2>Functions</h2> 197<p></p> 198</div> 199<div class="refsect1"> 200<a name="gst-plugins-good-plugins-multifilesrc.other_details"></a><h2>Types and Values</h2> 201<div class="refsect2"> 202<a name="GstMultiFileSrc-struct"></a><h3>struct GstMultiFileSrc</h3> 203<pre class="programlisting">struct GstMultiFileSrc;</pre> 204</div> 205</div> 206<div class="refsect1"> 207<a name="gst-plugins-good-plugins-multifilesrc.property-details"></a><h2>Property Details</h2> 208<div class="refsect2"> 209<a name="GstMultiFileSrc--caps"></a><h3>The <code class="literal">“caps”</code> property</h3> 210<pre class="programlisting"> “caps” <a href="/usr/share/gtk-doc/html/gstreamer-1.0/GstCaps.html#GstCaps-struct"><span class="type">GstCaps</span></a> *</pre> 211<p>Caps describing the format of the data.</p> 212<p>Flags: Read / Write</p> 213</div> 214<hr> 215<div class="refsect2"> 216<a name="GstMultiFileSrc--index"></a><h3>The <code class="literal">“index”</code> property</h3> 217<pre class="programlisting"> “index” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre> 218<p>Index to use with location property to create file names. The index is incremented by one for each buffer read.</p> 219<p>Flags: Read / Write</p> 220<p>Allowed values: >= 0</p> 221<p>Default value: 0</p> 222</div> 223<hr> 224<div class="refsect2"> 225<a name="GstMultiFileSrc--location"></a><h3>The <code class="literal">“location”</code> property</h3> 226<pre class="programlisting"> “location” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *</pre> 227<p>Pattern to create file names of input files. File names are created by calling sprintf() with the pattern and the current index.</p> 228<p>Flags: Read / Write</p> 229<p>Default value: "%05d"</p> 230</div> 231<hr> 232<div class="refsect2"> 233<a name="GstMultiFileSrc--loop"></a><h3>The <code class="literal">“loop”</code> property</h3> 234<pre class="programlisting"> “loop” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a></pre> 235<p>Whether to repeat from the beginning when all files have been read.</p> 236<p>Flags: Read / Write</p> 237<p>Default value: FALSE</p> 238</div> 239<hr> 240<div class="refsect2"> 241<a name="GstMultiFileSrc--start-index"></a><h3>The <code class="literal">“start-index”</code> property</h3> 242<pre class="programlisting"> “start-index” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre> 243<p>Start value of index. The initial value of index can be set either by setting index or start-index. When the end of the loop is reached, the index will be set to the value start-index.</p> 244<p>Flags: Read / Write</p> 245<p>Allowed values: >= 0</p> 246<p>Default value: 0</p> 247</div> 248<hr> 249<div class="refsect2"> 250<a name="GstMultiFileSrc--stop-index"></a><h3>The <code class="literal">“stop-index”</code> property</h3> 251<pre class="programlisting"> “stop-index” <a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gint"><span class="type">gint</span></a></pre> 252<p>Stop value of index. The special value -1 means no stop.</p> 253<p>Flags: Read / Write</p> 254<p>Allowed values: >= G_MAXULONG</p> 255<p>Default value: 0</p> 256</div> 257</div> 258<div class="refsect1"> 259<a name="gst-plugins-good-plugins-multifilesrc.see-also"></a><h2>See Also</h2> 260<p><a href="/usr/share/gtk-doc/html/gstreamer-plugins-1.0/gstreamer-plugins-filesrc.html#GstFileSrc-struct"><span class="type">GstFileSrc</span></a></p> 261</div> 262</div> 263<div class="footer"> 264<hr>Generated by GTK-Doc V1.28</div> 265</body> 266</html>
