docs/libs/html/gst-plugins-base-libs-appsrc.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>appsrc</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
   7 <link rel="home" href="index.html" title="GStreamer Base Plugins 0.10 Library Reference Manual">
   8 <link rel="up" href="gstreamer-app.html" title="App Library">
   9 <link rel="prev" href="gstreamer-app.html" title="App Library">
  10 <link rel="next" href="gst-plugins-base-libs-appsink.html" title="appsink">
  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="gstreamer-app.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  18 <td><a accesskey="u" href="gstreamer-app.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 Base Plugins 0.10 Library Reference Manual</th>
  21 <td><a accesskey="n" href="gst-plugins-base-libs-appsink.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-base-libs-appsrc.synopsis" class="shortcut">Top</a>
  25                    |
  26                   <a href="#gst-plugins-base-libs-appsrc.description" class="shortcut">Description</a>
  27 </td></tr>
  28 </table>
  29 <div class="refentry">
  30 <a name="gst-plugins-base-libs-appsrc"></a><div class="titlepage"></div>
  31 <div class="refnamediv"><table width="100%"><tr>
  32 <td valign="top">
  33 <h2><span class="refentrytitle"><a name="gst-plugins-base-libs-appsrc.top_of_page"></a>appsrc</span></h2>
  34 <p>appsrc — Easy way for applications to inject buffers into a
  35     pipeline</p>
  36 </td>
  37 <td valign="top" align="right"></td>
  38 </tr></table></div>
  39 <div class="refsynopsisdiv">
  40 <a name="gst-plugins-base-libs-appsrc.synopsis"></a><h2>Synopsis</h2>
  41 <pre class="synopsis">
  42 #include &lt;gst/app/gstappsrc.h&gt;
  43
  44 enum                <a class="link" href="gst-plugins-base-libs-appsrc.html#GstAppStreamType" title="enum GstAppStreamType">GstAppStreamType</a>;
  45 <span class="returnvalue">void</span>                <a class="link" href="gst-plugins-base-libs-appsrc.html#gst-app-src-set-caps" title="gst_app_src_set_caps ()">gst_app_src_set_caps</a>                (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a> *appsrc</code></em>,
  46                                                          <em class="parameter"><code>const <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a> *caps</code></em>);
  47 <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="returnvalue">GstCaps</span></a> *           <a class="link" href="gst-plugins-base-libs-appsrc.html#gst-app-src-get-caps" title="gst_app_src_get_caps ()">gst_app_src_get_caps</a>                (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a> *appsrc</code></em>);
  48 <span class="returnvalue">void</span>                <a class="link" href="gst-plugins-base-libs-appsrc.html#gst-app-src-get-latency" title="gst_app_src_get_latency ()">gst_app_src_get_latency</a>             (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a> *appsrc</code></em>,
  49                                                          <em class="parameter"><code><span class="type">guint64</span> *min</code></em>,
  50                                                          <em class="parameter"><code><span class="type">guint64</span> *max</code></em>);
  51 <span class="returnvalue">void</span>                <a class="link" href="gst-plugins-base-libs-appsrc.html#gst-app-src-set-latency" title="gst_app_src_set_latency ()">gst_app_src_set_latency</a>             (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a> *appsrc</code></em>,
  52                                                          <em class="parameter"><code><span class="type">guint64</span> min</code></em>,
  53                                                          <em class="parameter"><code><span class="type">guint64</span> max</code></em>);
  54 <span class="returnvalue">void</span>                <a class="link" href="gst-plugins-base-libs-appsrc.html#gst-app-src-set-size" title="gst_app_src_set_size ()">gst_app_src_set_size</a>                (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a> *appsrc</code></em>,
  55                                                          <em class="parameter"><code><span class="type">gint64</span> size</code></em>);
  56 <span class="returnvalue">gint64</span>              <a class="link" href="gst-plugins-base-libs-appsrc.html#gst-app-src-get-size" title="gst_app_src_get_size ()">gst_app_src_get_size</a>                (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a> *appsrc</code></em>);
  57 <span class="returnvalue">void</span>                <a class="link" href="gst-plugins-base-libs-appsrc.html#gst-app-src-set-stream-type" title="gst_app_src_set_stream_type ()">gst_app_src_set_stream_type</a>         (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a> *appsrc</code></em>,
  58                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-appsrc.html#GstAppStreamType" title="enum GstAppStreamType"><span class="type">GstAppStreamType</span></a> type</code></em>);
  59 <a class="link" href="gst-plugins-base-libs-appsrc.html#GstAppStreamType" title="enum GstAppStreamType"><span class="returnvalue">GstAppStreamType</span></a>    <a class="link" href="gst-plugins-base-libs-appsrc.html#gst-app-src-get-stream-type" title="gst_app_src_get_stream_type ()">gst_app_src_get_stream_type</a>         (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a> *appsrc</code></em>);
  60 <span class="returnvalue">void</span>                <a class="link" href="gst-plugins-base-libs-appsrc.html#gst-app-src-set-max-bytes" title="gst_app_src_set_max_bytes ()">gst_app_src_set_max_bytes</a>           (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a> *appsrc</code></em>,
  61                                                          <em class="parameter"><code><span class="type">guint64</span> max</code></em>);
  62 <span class="returnvalue">guint64</span>             <a class="link" href="gst-plugins-base-libs-appsrc.html#gst-app-src-get-max-bytes" title="gst_app_src_get_max_bytes ()">gst_app_src_get_max_bytes</a>           (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a> *appsrc</code></em>);
  63 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="gst-plugins-base-libs-appsrc.html#gst-app-src-get-emit-signals" title="gst_app_src_get_emit_signals ()">gst_app_src_get_emit_signals</a>        (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a> *appsrc</code></em>);
  64 <span class="returnvalue">void</span>                <a class="link" href="gst-plugins-base-libs-appsrc.html#gst-app-src-set-emit-signals" title="gst_app_src_set_emit_signals ()">gst_app_src_set_emit_signals</a>        (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a> *appsrc</code></em>,
  65                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> emit</code></em>);
  66                     <a class="link" href="gst-plugins-base-libs-appsrc.html#GstAppSrcCallbacks" title="GstAppSrcCallbacks">GstAppSrcCallbacks</a>;
  67 <span class="returnvalue">void</span>                <a class="link" href="gst-plugins-base-libs-appsrc.html#gst-app-src-set-callbacks" title="gst_app_src_set_callbacks ()">gst_app_src_set_callbacks</a>           (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a> *appsrc</code></em>,
  68                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-appsrc.html#GstAppSrcCallbacks" title="GstAppSrcCallbacks"><span class="type">GstAppSrcCallbacks</span></a> *callbacks</code></em>,
  69                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
  70                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> notify</code></em>);
  71 <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstPad.html#GstFlowReturn"><span class="returnvalue">GstFlowReturn</span></a>       <a class="link" href="gst-plugins-base-libs-appsrc.html#gst-app-src-push-buffer" title="gst_app_src_push_buffer ()">gst_app_src_push_buffer</a>             (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a> *appsrc</code></em>,
  72                                                          <em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstBuffer.html#GstBuffer"><span class="type">GstBuffer</span></a> *buffer</code></em>);
  73 <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstPad.html#GstFlowReturn"><span class="returnvalue">GstFlowReturn</span></a>       <a class="link" href="gst-plugins-base-libs-appsrc.html#gst-app-src-end-of-stream" title="gst_app_src_end_of_stream ()">gst_app_src_end_of_stream</a>           (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a> *appsrc</code></em>);
  74 </pre>
  75 </div>
  76 <div class="refsect1">
  77 <a name="gst-plugins-base-libs-appsrc.description"></a><h2>Description</h2>
  78 <p>
  79 The appsrc element can be used by applications to insert data into a
  80 GStreamer pipeline. Unlike most GStreamer elements, Appsrc provides
  81 external API functions.
  82 </p>
  83 <p>
  84 appsrc can be used by linking with the libgstapp library to access the
  85 methods directly or by using the appsrc action signals.
  86 </p>
  87 <p>
  88 Before operating appsrc, the caps property must be set to a fixed caps
  89 describing the format of the data that will be pushed with appsrc. An
  90 exception to this is when pushing buffers with unknown caps, in which case no
  91 caps should be set. This is typically true of file-like sources that push raw
  92 byte buffers.
  93 </p>
  94 <p>
  95 The main way of handing data to the appsrc element is by calling the
  96 <a class="link" href="gst-plugins-base-libs-appsrc.html#gst-app-src-push-buffer" title="gst_app_src_push_buffer ()"><code class="function">gst_app_src_push_buffer()</code></a> method or by emitting the push-buffer action signal.
  97 This will put the buffer onto a queue from which appsrc will read from in its
  98 streaming thread. It is important to note that data transport will not happen
  99 from the thread that performed the push-buffer call.
 100 </p>
 101 <p>
 102 The "max-bytes" property controls how much data can be queued in appsrc
 103 before appsrc considers the queue full. A filled internal queue will always
 104 signal the "enough-data" signal, which signals the application that it should
 105 stop pushing data into appsrc. The "block" property will cause appsrc to
 106 block the push-buffer method until free data becomes available again.
 107 </p>
 108 <p>
 109 When the internal queue is running out of data, the "need-data" signal is
 110 emitted, which signals the application that it should start pushing more data
 111 into appsrc.
 112 </p>
 113 <p>
 114 In addition to the "need-data" and "enough-data" signals, appsrc can emit the
 115 "seek-data" signal when the "stream-mode" property is set to "seekable" or
 116 "random-access". The signal argument will contain the new desired position in
 117 the stream expressed in the unit set with the "format" property. After
 118 receiving the seek-data signal, the application should push-buffers from the
 119 new position.
 120 </p>
 121 <p>
 122 These signals allow the application to operate the appsrc in two different
 123 ways:
 124 </p>
 125 <p>
 126 The push model, in which the application repeatedly calls the push-buffer method
 127 with a new buffer. Optionally, the queue size in the appsrc can be controlled
 128 with the enough-data and need-data signals by respectively stopping/starting
 129 the push-buffer calls. This is a typical mode of operation for the
 130 stream-type "stream" and "seekable". Use this model when implementing various
 131 network protocols or hardware devices.
 132 </p>
 133 <p>
 134 The pull model where the need-data signal triggers the next push-buffer call.
 135 This mode is typically used in the "random-access" stream-type. Use this
 136 model for file access or other randomly accessable sources. In this mode, a
 137 buffer of exactly the amount of bytes given by the need-data signal should be
 138 pushed into appsrc.
 139 </p>
 140 <p>
 141 In all modes, the size property on appsrc should contain the total stream
 142 size in bytes. Setting this property is mandatory in the random-access mode.
 143 For the stream and seekable modes, setting this property is optional but
 144 recommended.
 145 </p>
 146 <p>
 147 When the application is finished pushing data into appsrc, it should call
 148 <a class="link" href="gst-plugins-base-libs-appsrc.html#gst-app-src-end-of-stream" title="gst_app_src_end_of_stream ()"><code class="function">gst_app_src_end_of_stream()</code></a> or emit the end-of-stream action signal. After
 149 this call, no more buffers can be pushed into appsrc until a flushing seek
 150 happened or the state of the appsrc has gone through READY.
 151 </p>
 152 <p>
 153 Last reviewed on 2008-12-17 (0.10.10)
 154 </p>
 155 </div>
 156 <div class="refsect1">
 157 <a name="gst-plugins-base-libs-appsrc.details"></a><h2>Details</h2>
 158 <div class="refsect2">
 159 <a name="GstAppStreamType"></a><h3>enum GstAppStreamType</h3>
 160 <pre class="programlisting">typedef enum {
 161   GST_APP_STREAM_TYPE_STREAM,
 162   GST_APP_STREAM_TYPE_SEEKABLE,
 163   GST_APP_STREAM_TYPE_RANDOM_ACCESS
 164 } GstAppStreamType;
 165 </pre>
 166 <p>
 167 The stream type.
 168 </p>
 169 <div class="variablelist"><table border="0">
 170 <col align="left" valign="top">
 171 <tbody>
 172 <tr>
 173 <td><p><a name="GST-APP-STREAM-TYPE-STREAM:CAPS"></a><span class="term"><code class="literal">GST_APP_STREAM_TYPE_STREAM</code></span></p></td>
 174 <td>No seeking is supported in the stream, such as a
 175 live stream.
 176 </td>
 177 </tr>
 178 <tr>
 179 <td><p><a name="GST-APP-STREAM-TYPE-SEEKABLE:CAPS"></a><span class="term"><code class="literal">GST_APP_STREAM_TYPE_SEEKABLE</code></span></p></td>
 180 <td>The stream is seekable but seeking might not
 181 be very fast, such as data from a webserver.
 182 </td>
 183 </tr>
 184 <tr>
 185 <td><p><a name="GST-APP-STREAM-TYPE-RANDOM-ACCESS:CAPS"></a><span class="term"><code class="literal">GST_APP_STREAM_TYPE_RANDOM_ACCESS</code></span></p></td>
 186 <td>The stream is seekable and seeking is fast,
 187 such as in a local file.
 188 </td>
 189 </tr>
 190 </tbody>
 191 </table></div>
 192 </div>
 193 <hr>
 194 <div class="refsect2">
 195 <a name="gst-app-src-set-caps"></a><h3>gst_app_src_set_caps ()</h3>
 196 <pre class="programlisting"><span class="returnvalue">void</span>                gst_app_src_set_caps                (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a> *appsrc</code></em>,
 197                                                          <em class="parameter"><code>const <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a> *caps</code></em>);</pre>
 198 <p>
 199 Set the capabilities on the appsrc element.  This function takes
 200 a copy of the caps structure. After calling this method, the source will
 201 only produce caps that match <em class="parameter"><code>caps</code></em>. <em class="parameter"><code>caps</code></em> must be fixed and the caps on the
 202 buffers must match the caps or left NULL.
 203 </p>
 204 <div class="variablelist"><table border="0">
 205 <col align="left" valign="top">
 206 <tbody>
 207 <tr>
 208 <td><p><span class="term"><em class="parameter"><code>appsrc</code></em> :</span></p></td>
 209 <td>a <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a>
 210 </td>
 211 </tr>
 212 <tr>
 213 <td><p><span class="term"><em class="parameter"><code>caps</code></em> :</span></p></td>
 214 <td>caps to set</td>
 215 </tr>
 216 </tbody>
 217 </table></div>
 218 <p class="since">Since 0.10.22</p>
 219 </div>
 220 <hr>
 221 <div class="refsect2">
 222 <a name="gst-app-src-get-caps"></a><h3>gst_app_src_get_caps ()</h3>
 223 <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> *           gst_app_src_get_caps                (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a> *appsrc</code></em>);</pre>
 224 <p>
 225 Get the configured caps on <em class="parameter"><code>appsrc</code></em>.
 226 </p>
 227 <div class="variablelist"><table border="0">
 228 <col align="left" valign="top">
 229 <tbody>
 230 <tr>
 231 <td><p><span class="term"><em class="parameter"><code>appsrc</code></em> :</span></p></td>
 232 <td>a <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a>
 233 </td>
 234 </tr>
 235 <tr>
 236 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 237 <td>the <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#GstCaps"><span class="type">GstCaps</span></a> produced by the source. <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstCaps.html#gst-caps-unref"><code class="function">gst_caps_unref()</code></a> after usage.</td>
 238 </tr>
 239 </tbody>
 240 </table></div>
 241 <p class="since">Since 0.10.22</p>
 242 </div>
 243 <hr>
 244 <div class="refsect2">
 245 <a name="gst-app-src-get-latency"></a><h3>gst_app_src_get_latency ()</h3>
 246 <pre class="programlisting"><span class="returnvalue">void</span>                gst_app_src_get_latency             (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a> *appsrc</code></em>,
 247                                                          <em class="parameter"><code><span class="type">guint64</span> *min</code></em>,
 248                                                          <em class="parameter"><code><span class="type">guint64</span> *max</code></em>);</pre>
 249 <p>
 250 Retrieve the min and max latencies in <em class="parameter"><code>min</code></em> and <em class="parameter"><code>max</code></em> respectively.
 251 </p>
 252 <div class="variablelist"><table border="0">
 253 <col align="left" valign="top">
 254 <tbody>
 255 <tr>
 256 <td><p><span class="term"><em class="parameter"><code>appsrc</code></em> :</span></p></td>
 257 <td>a <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a>
 258 </td>
 259 </tr>
 260 <tr>
 261 <td><p><span class="term"><em class="parameter"><code>min</code></em> :</span></p></td>
 262 <td>the min latency</td>
 263 </tr>
 264 <tr>
 265 <td><p><span class="term"><em class="parameter"><code>max</code></em> :</span></p></td>
 266 <td>the min latency</td>
 267 </tr>
 268 </tbody>
 269 </table></div>
 270 <p class="since">Since 0.10.22</p>
 271 </div>
 272 <hr>
 273 <div class="refsect2">
 274 <a name="gst-app-src-set-latency"></a><h3>gst_app_src_set_latency ()</h3>
 275 <pre class="programlisting"><span class="returnvalue">void</span>                gst_app_src_set_latency             (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a> *appsrc</code></em>,
 276                                                          <em class="parameter"><code><span class="type">guint64</span> min</code></em>,
 277                                                          <em class="parameter"><code><span class="type">guint64</span> max</code></em>);</pre>
 278 <p>
 279 Configure the <em class="parameter"><code>min</code></em> and <em class="parameter"><code>max</code></em> latency in <em class="parameter"><code>src</code></em>. If <em class="parameter"><code>min</code></em> is set to -1, the
 280 default latency calculations for pseudo-live sources will be used.
 281 </p>
 282 <div class="variablelist"><table border="0">
 283 <col align="left" valign="top">
 284 <tbody>
 285 <tr>
 286 <td><p><span class="term"><em class="parameter"><code>appsrc</code></em> :</span></p></td>
 287 <td>a <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a>
 288 </td>
 289 </tr>
 290 <tr>
 291 <td><p><span class="term"><em class="parameter"><code>min</code></em> :</span></p></td>
 292 <td>the min latency</td>
 293 </tr>
 294 <tr>
 295 <td><p><span class="term"><em class="parameter"><code>max</code></em> :</span></p></td>
 296 <td>the min latency</td>
 297 </tr>
 298 </tbody>
 299 </table></div>
 300 <p class="since">Since 0.10.22</p>
 301 </div>
 302 <hr>
 303 <div class="refsect2">
 304 <a name="gst-app-src-set-size"></a><h3>gst_app_src_set_size ()</h3>
 305 <pre class="programlisting"><span class="returnvalue">void</span>                gst_app_src_set_size                (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a> *appsrc</code></em>,
 306                                                          <em class="parameter"><code><span class="type">gint64</span> size</code></em>);</pre>
 307 <p>
 308 Set the size of the stream in bytes. A value of -1 means that the size is
 309 not known.
 310 </p>
 311 <div class="variablelist"><table border="0">
 312 <col align="left" valign="top">
 313 <tbody>
 314 <tr>
 315 <td><p><span class="term"><em class="parameter"><code>appsrc</code></em> :</span></p></td>
 316 <td>a <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a>
 317 </td>
 318 </tr>
 319 <tr>
 320 <td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td>
 321 <td>the size to set</td>
 322 </tr>
 323 </tbody>
 324 </table></div>
 325 <p class="since">Since 0.10.22</p>
 326 </div>
 327 <hr>
 328 <div class="refsect2">
 329 <a name="gst-app-src-get-size"></a><h3>gst_app_src_get_size ()</h3>
 330 <pre class="programlisting"><span class="returnvalue">gint64</span>              gst_app_src_get_size                (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a> *appsrc</code></em>);</pre>
 331 <p>
 332 Get the size of the stream in bytes. A value of -1 means that the size is
 333 not known.
 334 </p>
 335 <div class="variablelist"><table border="0">
 336 <col align="left" valign="top">
 337 <tbody>
 338 <tr>
 339 <td><p><span class="term"><em class="parameter"><code>appsrc</code></em> :</span></p></td>
 340 <td>a <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a>
 341 </td>
 342 </tr>
 343 <tr>
 344 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 345 <td>the size of the stream previously set with <a class="link" href="gst-plugins-base-libs-appsrc.html#gst-app-src-set-size" title="gst_app_src_set_size ()"><code class="function">gst_app_src_set_size()</code></a>;</td>
 346 </tr>
 347 </tbody>
 348 </table></div>
 349 <p class="since">Since 0.10.22</p>
 350 </div>
 351 <hr>
 352 <div class="refsect2">
 353 <a name="gst-app-src-set-stream-type"></a><h3>gst_app_src_set_stream_type ()</h3>
 354 <pre class="programlisting"><span class="returnvalue">void</span>                gst_app_src_set_stream_type         (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a> *appsrc</code></em>,
 355                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-appsrc.html#GstAppStreamType" title="enum GstAppStreamType"><span class="type">GstAppStreamType</span></a> type</code></em>);</pre>
 356 <p>
 357 Set the stream type on <em class="parameter"><code>appsrc</code></em>. For seekable streams, the "seek" signal must
 358 be connected to.
 359 </p>
 360 <p>
 361 A stream_type stream
 362 </p>
 363 <div class="variablelist"><table border="0">
 364 <col align="left" valign="top">
 365 <tbody>
 366 <tr>
 367 <td><p><span class="term"><em class="parameter"><code>appsrc</code></em> :</span></p></td>
 368 <td>a <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a>
 369 </td>
 370 </tr>
 371 <tr>
 372 <td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
 373 <td>the new state</td>
 374 </tr>
 375 </tbody>
 376 </table></div>
 377 <p class="since">Since 0.10.22</p>
 378 </div>
 379 <hr>
 380 <div class="refsect2">
 381 <a name="gst-app-src-get-stream-type"></a><h3>gst_app_src_get_stream_type ()</h3>
 382 <pre class="programlisting"><a class="link" href="gst-plugins-base-libs-appsrc.html#GstAppStreamType" title="enum GstAppStreamType"><span class="returnvalue">GstAppStreamType</span></a>    gst_app_src_get_stream_type         (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a> *appsrc</code></em>);</pre>
 383 <p>
 384 Get the stream type. Control the stream type of <em class="parameter"><code>appsrc</code></em>
 385 with <a class="link" href="gst-plugins-base-libs-appsrc.html#gst-app-src-set-stream-type" title="gst_app_src_set_stream_type ()"><code class="function">gst_app_src_set_stream_type()</code></a>.
 386 </p>
 387 <div class="variablelist"><table border="0">
 388 <col align="left" valign="top">
 389 <tbody>
 390 <tr>
 391 <td><p><span class="term"><em class="parameter"><code>appsrc</code></em> :</span></p></td>
 392 <td>a <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a>
 393 </td>
 394 </tr>
 395 <tr>
 396 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 397 <td>the stream type.</td>
 398 </tr>
 399 </tbody>
 400 </table></div>
 401 <p class="since">Since 0.10.22</p>
 402 </div>
 403 <hr>
 404 <div class="refsect2">
 405 <a name="gst-app-src-set-max-bytes"></a><h3>gst_app_src_set_max_bytes ()</h3>
 406 <pre class="programlisting"><span class="returnvalue">void</span>                gst_app_src_set_max_bytes           (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a> *appsrc</code></em>,
 407                                                          <em class="parameter"><code><span class="type">guint64</span> max</code></em>);</pre>
 408 <p>
 409 Set the maximum amount of bytes that can be queued in <em class="parameter"><code>appsrc</code></em>.
 410 After the maximum amount of bytes are queued, <em class="parameter"><code>appsrc</code></em> will emit the
 411 "enough-data" signal.
 412 </p>
 413 <div class="variablelist"><table border="0">
 414 <col align="left" valign="top">
 415 <tbody>
 416 <tr>
 417 <td><p><span class="term"><em class="parameter"><code>appsrc</code></em> :</span></p></td>
 418 <td>a <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a>
 419 </td>
 420 </tr>
 421 <tr>
 422 <td><p><span class="term"><em class="parameter"><code>max</code></em> :</span></p></td>
 423 <td>the maximum number of bytes to queue</td>
 424 </tr>
 425 </tbody>
 426 </table></div>
 427 <p class="since">Since 0.10.22</p>
 428 </div>
 429 <hr>
 430 <div class="refsect2">
 431 <a name="gst-app-src-get-max-bytes"></a><h3>gst_app_src_get_max_bytes ()</h3>
 432 <pre class="programlisting"><span class="returnvalue">guint64</span>             gst_app_src_get_max_bytes           (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a> *appsrc</code></em>);</pre>
 433 <p>
 434 Get the maximum amount of bytes that can be queued in <em class="parameter"><code>appsrc</code></em>.
 435 </p>
 436 <div class="variablelist"><table border="0">
 437 <col align="left" valign="top">
 438 <tbody>
 439 <tr>
 440 <td><p><span class="term"><em class="parameter"><code>appsrc</code></em> :</span></p></td>
 441 <td>a <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a>
 442 </td>
 443 </tr>
 444 <tr>
 445 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 446 <td>The maximum amount of bytes that can be queued.</td>
 447 </tr>
 448 </tbody>
 449 </table></div>
 450 <p class="since">Since 0.10.22</p>
 451 </div>
 452 <hr>
 453 <div class="refsect2">
 454 <a name="gst-app-src-get-emit-signals"></a><h3>gst_app_src_get_emit_signals ()</h3>
 455 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gst_app_src_get_emit_signals        (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a> *appsrc</code></em>);</pre>
 456 <p>
 457 Check if appsrc will emit the "new-preroll" and "new-buffer" signals.
 458 </p>
 459 <div class="variablelist"><table border="0">
 460 <col align="left" valign="top">
 461 <tbody>
 462 <tr>
 463 <td><p><span class="term"><em class="parameter"><code>appsrc</code></em> :</span></p></td>
 464 <td>a <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a>
 465 </td>
 466 </tr>
 467 <tr>
 468 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 469 <td>
 470 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>appsrc</code></em> is emitting the "new-preroll" and "new-buffer"
 471 signals.</td>
 472 </tr>
 473 </tbody>
 474 </table></div>
 475 <p class="since">Since 0.10.23</p>
 476 </div>
 477 <hr>
 478 <div class="refsect2">
 479 <a name="gst-app-src-set-emit-signals"></a><h3>gst_app_src_set_emit_signals ()</h3>
 480 <pre class="programlisting"><span class="returnvalue">void</span>                gst_app_src_set_emit_signals        (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a> *appsrc</code></em>,
 481                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> emit</code></em>);</pre>
 482 <p>
 483 Make appsrc emit the "new-preroll" and "new-buffer" signals. This option is
 484 by default disabled because signal emission is expensive and unneeded when
 485 the application prefers to operate in pull mode.
 486 </p>
 487 <div class="variablelist"><table border="0">
 488 <col align="left" valign="top">
 489 <tbody>
 490 <tr>
 491 <td><p><span class="term"><em class="parameter"><code>appsrc</code></em> :</span></p></td>
 492 <td>a <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a>
 493 </td>
 494 </tr>
 495 <tr>
 496 <td><p><span class="term"><em class="parameter"><code>emit</code></em> :</span></p></td>
 497 <td>the new state</td>
 498 </tr>
 499 </tbody>
 500 </table></div>
 501 <p class="since">Since 0.10.23</p>
 502 </div>
 503 <hr>
 504 <div class="refsect2">
 505 <a name="GstAppSrcCallbacks"></a><h3>GstAppSrcCallbacks</h3>
 506 <pre class="programlisting">typedef struct {
 507   void      (*need_data)    (GstAppSrc *src, guint length, gpointer user_data);
 508   void      (*enough_data)  (GstAppSrc *src, gpointer user_data);
 509   gboolean  (*seek_data)    (GstAppSrc *src, guint64 offset, gpointer user_data);
 510 } GstAppSrcCallbacks;
 511 </pre>
 512 <p>
 513 A set of callbacks that can be installed on the appsrc with
 514 <a class="link" href="gst-plugins-base-libs-appsrc.html#gst-app-src-set-callbacks" title="gst_app_src_set_callbacks ()"><code class="function">gst_app_src_set_callbacks()</code></a>.
 515 </p>
 516 <div class="variablelist"><table border="0">
 517 <col align="left" valign="top">
 518 <tbody>
 519 <tr>
 520 <td><p><span class="term"><em class="structfield"><code><a name="GstAppSrcCallbacks.need-data"></a>need_data</code></em> ()</span></p></td>
 521 <td>Called when the appsrc needs more data. A buffer or EOS should be
 522 pushed to appsrc from this thread or another thread. <em class="parameter"><code>length</code></em> is just a hint
 523 and when it is set to -1, any number of bytes can be pushed into <em class="parameter"><code>appsrc</code></em>.</td>
 524 </tr>
 525 <tr>
 526 <td><p><span class="term"><em class="structfield"><code><a name="GstAppSrcCallbacks.enough-data"></a>enough_data</code></em> ()</span></p></td>
 527 <td>Called when appsrc has enough data. It is recommended that the
 528 application stops calling push-buffer until the need_data callback is
 529 emitted again to avoid excessive buffer queueing.</td>
 530 </tr>
 531 <tr>
 532 <td><p><span class="term"><em class="structfield"><code><a name="GstAppSrcCallbacks.seek-data"></a>seek_data</code></em> ()</span></p></td>
 533 <td>Called when a seek should be performed to the offset.
 534 The next push-buffer should produce buffers from the new <em class="parameter"><code>offset</code></em>.
 535 This callback is only called for seekable stream types.</td>
 536 </tr>
 537 </tbody>
 538 </table></div>
 539 <p class="since">Since 0.10.23</p>
 540 </div>
 541 <hr>
 542 <div class="refsect2">
 543 <a name="gst-app-src-set-callbacks"></a><h3>gst_app_src_set_callbacks ()</h3>
 544 <pre class="programlisting"><span class="returnvalue">void</span>                gst_app_src_set_callbacks           (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a> *appsrc</code></em>,
 545                                                          <em class="parameter"><code><a class="link" href="gst-plugins-base-libs-appsrc.html#GstAppSrcCallbacks" title="GstAppSrcCallbacks"><span class="type">GstAppSrcCallbacks</span></a> *callbacks</code></em>,
 546                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>,
 547                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Datasets.html#GDestroyNotify"><span class="type">GDestroyNotify</span></a> notify</code></em>);</pre>
 548 <p>
 549 Set callbacks which will be executed when data is needed, enough data has
 550 been collected or when a seek should be performed.
 551 This is an alternative to using the signals, it has lower overhead and is thus
 552 less expensive, but also less flexible.
 553 </p>
 554 <p>
 555 If callbacks are installed, no signals will be emitted for performance
 556 reasons.
 557 </p>
 558 <div class="variablelist"><table border="0">
 559 <col align="left" valign="top">
 560 <tbody>
 561 <tr>
 562 <td><p><span class="term"><em class="parameter"><code>appsrc</code></em> :</span></p></td>
 563 <td>a <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a>
 564 </td>
 565 </tr>
 566 <tr>
 567 <td><p><span class="term"><em class="parameter"><code>callbacks</code></em> :</span></p></td>
 568 <td>the callbacks</td>
 569 </tr>
 570 <tr>
 571 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 572 <td>a user_data argument for the callbacks</td>
 573 </tr>
 574 <tr>
 575 <td><p><span class="term"><em class="parameter"><code>notify</code></em> :</span></p></td>
 576 <td>a destroy notify function</td>
 577 </tr>
 578 </tbody>
 579 </table></div>
 580 <p class="since">Since 0.10.23</p>
 581 </div>
 582 <hr>
 583 <div class="refsect2">
 584 <a name="gst-app-src-push-buffer"></a><h3>gst_app_src_push_buffer ()</h3>
 585 <pre class="programlisting"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstPad.html#GstFlowReturn"><span class="returnvalue">GstFlowReturn</span></a>       gst_app_src_push_buffer             (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a> *appsrc</code></em>,
 586                                                          <em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstBuffer.html#GstBuffer"><span class="type">GstBuffer</span></a> *buffer</code></em>);</pre>
 587 <p>
 588 Adds a buffer to the queue of buffers that the appsrc element will
 589 push to its source pad.  This function takes ownership of the buffer.
 590 </p>
 591 <p>
 592 When the block property is TRUE, this function can block until free
 593 space becomes available in the queue.
 594 </p>
 595 <div class="variablelist"><table border="0">
 596 <col align="left" valign="top">
 597 <tbody>
 598 <tr>
 599 <td><p><span class="term"><em class="parameter"><code>appsrc</code></em> :</span></p></td>
 600 <td>a <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a>
 601 </td>
 602 </tr>
 603 <tr>
 604 <td><p><span class="term"><em class="parameter"><code>buffer</code></em> :</span></p></td>
 605 <td>a <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/gstreamer-GstBuffer.html#GstBuffer"><span class="type">GstBuffer</span></a> to push</td>
 606 </tr>
 607 <tr>
 608 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 609 <td>
 610 <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstPad.html#GST-FLOW-OK:CAPS"><span class="type">GST_FLOW_OK</span></a> when the buffer was successfuly queued.
 611 <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstPad.html#GST-FLOW-WRONG-STATE:CAPS"><span class="type">GST_FLOW_WRONG_STATE</span></a> when <em class="parameter"><code>appsrc</code></em> is not PAUSED or PLAYING.
 612 <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstPad.html#GST-FLOW-UNEXPECTED:CAPS"><span class="type">GST_FLOW_UNEXPECTED</span></a> when EOS occured.</td>
 613 </tr>
 614 </tbody>
 615 </table></div>
 616 <p class="since">Since 0.10.22</p>
 617 </div>
 618 <hr>
 619 <div class="refsect2">
 620 <a name="gst-app-src-end-of-stream"></a><h3>gst_app_src_end_of_stream ()</h3>
 621 <pre class="programlisting"><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstPad.html#GstFlowReturn"><span class="returnvalue">GstFlowReturn</span></a>       gst_app_src_end_of_stream           (<em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a> *appsrc</code></em>);</pre>
 622 <p>
 623 Indicates to the appsrc element that the last buffer queued in the
 624 element is the last buffer of the stream.
 625 </p>
 626 <div class="variablelist"><table border="0">
 627 <col align="left" valign="top">
 628 <tbody>
 629 <tr>
 630 <td><p><span class="term"><em class="parameter"><code>appsrc</code></em> :</span></p></td>
 631 <td>a <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gst-plugins-base/html/gst-plugins-base-plugins-appsrc.html#GstAppSrc"><span class="type">GstAppSrc</span></a>
 632 </td>
 633 </tr>
 634 <tr>
 635 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 636 <td>
 637 <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstPad.html#GST-FLOW-OK:CAPS"><span class="type">GST_FLOW_OK</span></a> when the EOS was successfuly queued.
 638 <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstPad.html#GST-FLOW-WRONG-STATE:CAPS"><span class="type">GST_FLOW_WRONG_STATE</span></a> when <em class="parameter"><code>appsrc</code></em> is not PAUSED or PLAYING.</td>
 639 </tr>
 640 </tbody>
 641 </table></div>
 642 <p class="since">Since 0.10.22</p>
 643 </div>
 644 </div>
 645 <div class="refsect1">
 646 <a name="gst-plugins-base-libs-appsrc.see-also"></a><h2>See Also</h2>
 647 <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer-libs/html/GstBaseSrc.html"><span class="type">GstBaseSrc</span></a>, appsink
 648 </div>
 649 </div>
 650 <div class="footer">
 651 <hr>
 652           Generated by GTK-Doc V1.18</div>
 653 </body>
 654 </html>