RubyGems - gstreamer - Versions diffs - 2.2.5-x86-mingw32 → 3.0.0-x86-mingw32 - Mend

gstreamer 2.2.5-x86-mingw32 → 3.0.0-x86-mingw32

Files changed (2236) hide show

data/vendor/local/share/gtk-doc/html/gstreamer-libs-1.0/GstBaseTransform.html CHANGED

@@ -2,13 +2,13 @@
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>GStreamer 1.0 Library Reference Manual: GstBaseTransform</title>
+<title>GstBaseTransform: GStreamer 1.0 Library Reference Manual</title>
 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
 <link rel="home" href="index.html" title="GStreamer 1.0 Library Reference Manual">
 <link rel="up" href="gstreamer-base.html" title="GStreamer Base and Utillity Classes">
 <link rel="prev" href="GstBaseSink.html" title="GstBaseSink">
 <link rel="next" href="GstPushSrc.html" title="GstPushSrc">
-<meta name="generator" content="GTK-Doc V1.21 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.24 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -146,6 +146,14 @@
 </td>
 </tr>
 <tr>
+<td class="function_type">
+<a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+</td>
+<td class="function_name">
+<a class="link" href="GstBaseTransform.html#gst-base-transform-update-src-caps" title="gst_base_transform_update_src_caps ()">gst_base_transform_update_src_caps</a> <span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
 <td class="define_keyword">#define</td>
 <td class="function_name">
 <a class="link" href="GstBaseTransform.html#GST-BASE-TRANSFORM-SINK-PAD:CAPS" title="GST_BASE_TRANSFORM_SINK_PAD()">GST_BASE_TRANSFORM_SINK_PAD</a><span class="c_punctuation">()</span>
@@ -222,7 +230,14 @@
 </div>
 <div class="refsect1">
 <a name="GstBaseTransform.description"></a><h2>Description</h2>
-<p>This base class is for filter elements that process data.</p>
+<p>This base class is for filter elements that process data. Elements
+that are suitable for implementation using <a class="link" href="GstBaseTransform.html" title="GstBaseTransform"><span class="type">GstBaseTransform</span></a> are ones
+where the size and caps of the output is known entirely from the input
+caps and buffer sizes. These include elements that directly transform
+one buffer into another, modify the contents of a buffer in-place, as
+well as elements that collate multiple input buffers into one output buffer,
+or that expand one input buffer into multiple output buffers. See below
+for more concrete use cases.</p>
 <p>It provides for:</p>
 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
 <li class="listitem"><p>one sinkpad and one srcpad</p></li>
@@ -453,7 +468,6 @@ gst_base_transform_is_passthrough (<em class="parameter"><code><a class="link" h
 <a name="id-1.2.4.6.9.2.6"></a><h4>Returns</h4>
 <p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is the transform is configured in passthrough mode.</p>
 <p>MT safe.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -530,7 +544,7 @@ capsfilter.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 1.0.1</p>
+<p class="since">Since: <a class="link" href="ix06.html#api-index-1.0.1">1.0.1</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -558,7 +572,6 @@ gst_base_transform_is_in_place (<em class="parameter"><code><a class="link" href
 <a name="id-1.2.4.6.9.5.6"></a><h4>Returns</h4>
 <p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> is the transform is configured in in_place mode.</p>
 <p>MT safe.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -623,7 +636,6 @@ gst_base_transform_is_qos_enabled (<em class="parameter"><code><a class="link" h
 <a name="id-1.2.4.6.9.7.6"></a><h4>Returns</h4>
 <p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if QoS is enabled.</p>
 <p>MT safe.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -711,7 +723,7 @@ gst_base_transform_set_gap_aware (<em class="parameter"><code><a class="link" hr
                                   <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> gap_aware</code></em>);</pre>
 <p>If <em class="parameter"><code>gap_aware</code></em>
  is <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> (the default), output buffers will have the
-<code class="literal">GST_BUFFER_FLAG_GAP</code> flag unset.</p>
+<a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstBuffer.html#GST-BUFFER-FLAG-GAP:CAPS"><code class="literal">GST_BUFFER_FLAG_GAP</code></a> flag unset.</p>
 <p>If set to <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, the element must handle output buffers with this flag set
 correctly, i.e. it can assume that the buffer contains neutral data but must
 unset the flag if the output is no neutral data.</p>
@@ -863,12 +875,52 @@ were set that influence the output format.</p>
 </div>
 <hr>
 <div class="refsect2">
+<a name="gst-base-transform-update-src-caps"></a><h3>gst_base_transform_update_src_caps ()</h3>
+<pre class="programlisting"><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
+gst_base_transform_update_src_caps (<em class="parameter"><code><a class="link" href="GstBaseTransform.html" title="GstBaseTransform"><span class="type">GstBaseTransform</span></a> *trans</code></em>,
+                                    <em class="parameter"><code><a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstCaps.html"><span class="type">GstCaps</span></a> *updated_caps</code></em>);</pre>
+<p>Updates the srcpad caps and send the caps downstream. This function
+can be used by subclasses when they have already negotiated their caps
+but found a change in them (or computed new informations). This way,
+they can notify downstream about that change without loosing any
+buffer.</p>
+<div class="refsect3">
+<a name="id-1.2.4.6.9.15.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody>
+<tr>
+<td class="parameter_name"><p>trans</p></td>
+<td class="parameter_description"><p>a <a class="link" href="GstBaseTransform.html" title="GstBaseTransform"><span class="type">GstBaseTransform</span></a></p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+<tr>
+<td class="parameter_name"><p>updated_caps</p></td>
+<td class="parameter_description"><p>An updated version of the srcpad caps to be pushed
+downstream</p></td>
+<td class="parameter_annotations"> </td>
+</tr>
+</tbody>
+</table></div>
+</div>
+<div class="refsect3">
+<a name="id-1.2.4.6.9.15.6"></a><h4>Returns</h4>
+<p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the caps could be send downstream <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise</p>
+</div>
+<p class="since">Since: <a class="link" href="ix03.html#api-index-1.6">1.6</a></p>
+</div>
+<hr>
+<div class="refsect2">
 <a name="GST-BASE-TRANSFORM-SINK-PAD:CAPS"></a><h3>GST_BASE_TRANSFORM_SINK_PAD()</h3>
 <pre class="programlisting">#define GST_BASE_TRANSFORM_SINK_PAD(obj) (GST_BASE_TRANSFORM_CAST (obj)-&gt;sinkpad)
 </pre>
 <p>Gives the pointer to the sink <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstPad.html"><span class="type">GstPad</span></a> object of the element.</p>
 <div class="refsect3">
-<a name="id-1.2.4.6.9.15.5"></a><h4>Parameters</h4>
+<a name="id-1.2.4.6.9.16.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -890,7 +942,7 @@ were set that influence the output format.</p>
 </pre>
 <p>Gives the pointer to the source <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstPad.html"><span class="type">GstPad</span></a> object of the element.</p>
 <div class="refsect3">
-<a name="id-1.2.4.6.9.16.5"></a><h4>Parameters</h4>
+<a name="id-1.2.4.6.9.17.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -977,6 +1029,9 @@ were set that influence the output format.</p>
   GstFlowReturn (*transform)    (GstBaseTransform *trans, GstBuffer *inbuf,
                                  GstBuffer *outbuf);
   GstFlowReturn (*transform_ip) (GstBaseTransform *trans, GstBuffer *buf);
+  GstFlowReturn (*submit_input_buffer) (GstBaseTransform *trans, gboolean is_discont, GstBuffer *input);
+  GstFlowReturn (*generate_output) (GstBaseTransform *trans, GstBuffer **outbuf);
 };
 </pre>
 <p>Subclasses can override any of the available virtual methods or not, as
@@ -1185,6 +1240,34 @@ of the outgoing buffer.</p></td>
 Transform the incoming buffer in-place.</p></td>
 <td class="struct_member_annotations"> </td>
 </tr>
+<tr>
+<td class="struct_member_name"><p><em class="structfield"><code><a name="GstBaseTransformClass.submit-input-buffer"></a>submit_input_buffer</code></em> ()</p></td>
+<td class="struct_member_description"><p>Function which accepts a new input buffer and pre-processes it.
+The default implementation performs caps (re)negotiation, then
+QoS if needed, and places the input buffer into the <em class="parameter"><code>queued_buf</code></em>
+member variable. If the buffer is dropped due to QoS, it returns
+GST_BASE_TRANSFORM_FLOW_DROPPED. If this input buffer is not
+contiguous with any previous input buffer, then <em class="parameter"><code>is_discont</code></em>
+is set to <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><span class="type">TRUE</span></a>. (Since 1.6)</p></td>
+<td class="struct_member_annotations"> </td>
+</tr>
+<tr>
+<td class="struct_member_name"><p><em class="structfield"><code><a name="GstBaseTransformClass.generate-output"></a>generate_output</code></em> ()</p></td>
+<td class="struct_member_description"><p>Called after each new input buffer is submitted repeatedly
+until it either generates an error or fails to generate an output
+buffer. The default implementation takes the contents of the
+<em class="parameter"><code>queued_buf</code></em>
+variable, generates an output buffer if needed
+by calling the class <em class="parameter"><code>prepare_output_buffer</code></em>
+, and then
+calls either <em class="parameter"><code>transform</code></em>
+or <em class="parameter"><code>transform_ip</code></em>
+. Elements that don't
+do 1-to-1 transformations on input to output buffers can either
+return GST_BASE_TRANSFORM_FLOW_DROPPED or simply not generate
+an output buffer until they are ready to do so. (Since 1.6)</p></td>
+<td class="struct_member_annotations"> </td>
+</tr>
 </tbody>
 </table></div>
 </div>
@@ -1228,7 +1311,6 @@ indicate that no output buffer was generated.</p>
 </div>
 </div>
 <div class="footer">
-<hr>
-          Generated by GTK-Doc V1.21</div>
+<hr>Generated by GTK-Doc V1.24</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/gstreamer-libs-1.0/GstCollectPads.html CHANGED

@@ -2,13 +2,13 @@
 <html>
 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<title>GStreamer 1.0 Library Reference Manual: GstCollectPads</title>
+<title>GstCollectPads: GStreamer 1.0 Library Reference Manual</title>
 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
 <link rel="home" href="index.html" title="GStreamer 1.0 Library Reference Manual">
 <link rel="up" href="gstreamer-base.html" title="GStreamer Base and Utillity Classes">
 <link rel="prev" href="gstreamer-libs-GstByteWriter.html" title="GstByteWriter">
 <link rel="next" href="gstreamer-libs-GstFlowCombiner.html" title="GstFlowCombiner">
-<meta name="generator" content="GTK-Doc V1.21 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.24 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -147,6 +147,18 @@
 </td>
 </tr>
 <tr>
+<td class="define_keyword">#define</td>
+<td class="function_name">
+<a class="link" href="GstCollectPads.html#GST-COLLECT-PADS-DTS:CAPS" title="GST_COLLECT_PADS_DTS()">GST_COLLECT_PADS_DTS</a><span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
+<td class="define_keyword">#define</td>
+<td class="function_name">
+<a class="link" href="GstCollectPads.html#GST-COLLECT-PADS-DTS-IS-VALID:CAPS" title="GST_COLLECT_PADS_DTS_IS_VALID()">GST_COLLECT_PADS_DTS_IS_VALID</a><span class="c_punctuation">()</span>
+</td>
+</tr>
+<tr>
 <td class="function_type">
 <a class="link" href="GstCollectPads.html" title="GstCollectPads"><span class="returnvalue">GstCollectPads</span></a> *
 </td>
@@ -498,8 +510,7 @@ and <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/ht
 </div>
 <div class="refsect3">
 <a name="id-1.2.4.12.8.3.6"></a><h4>Returns</h4>
-<p> <code class="literal">GST_FLOW_OK</code> for success</p>
-<p></p>
+<p> <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstPad.html#GST-FLOW-OK:CAPS"><code class="literal">GST_FLOW_OK</code></a> for success</p>
 </div>
 </div>
 <hr>
@@ -565,7 +576,6 @@ the pad to perform clipping of <em class="parameter"><code>inbuffer</code></em>
 <div class="refsect3">
 <a name="id-1.2.4.12.8.4.8"></a><h4>Returns</h4>
 <p> a <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstPad.html#GstFlowReturn"><span class="type">GstFlowReturn</span></a> that corresponds to the result of clipping.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -626,7 +636,6 @@ the pad to perform clipping of <em class="parameter"><code>inbuffer</code></em>
 <p> Integer less than zero when first timestamp is deemed older than the second one.
 Zero if the timestamps are deemed equally old.
 Integer greater than zero when second timestamp is deemed older than the first one.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -676,7 +685,6 @@ being handled by the default handler).</p>
 <div class="refsect3">
 <a name="id-1.2.4.12.8.6.6"></a><h4>Returns</h4>
 <p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the pad could handle the event</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -713,7 +721,7 @@ gst_collect_pads_set_flushing nor gst_collect_pads_clear from this function.</p>
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 1.4</p>
+<p class="since">Since: <a class="link" href="ix04.html#api-index-1.4">1.4</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -761,7 +769,6 @@ events downstream (with <a href="http://gstreamer.freedesktop.org/data/doc/gstre
 <div class="refsect3">
 <a name="id-1.2.4.12.8.8.6"></a><h4>Returns</h4>
 <p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the pad could handle the event</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -795,8 +802,7 @@ events downstream (with <a href="http://gstreamer.freedesktop.org/data/doc/gstre
 </div>
 <div class="refsect3">
 <a name="id-1.2.4.12.8.9.6"></a><h4>Returns</h4>
-<p> <code class="literal">GST_FLOW_OK</code> for success</p>
-<p></p>
+<p> <a href="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/GstPad.html#GST-FLOW-OK:CAPS"><code class="literal">GST_FLOW_OK</code></a> for success</p>
 </div>
 </div>
 <hr>
@@ -982,13 +988,64 @@ protecting the resources used to accomplish this.</p>
 </div>
 <hr>
 <div class="refsect2">
+<a name="GST-COLLECT-PADS-DTS:CAPS"></a><h3>GST_COLLECT_PADS_DTS()</h3>
+<pre class="programlisting">#define GST_COLLECT_PADS_DTS(data)                   (((GstCollectData *) data)-&gt;ABI.abi.dts)
+</pre>
+<p>Returns the DTS that has been converted to running time when using
+<a class="link" href="GstCollectPads.html#gst-collect-pads-clip-running-time" title="gst_collect_pads_clip_running_time ()"><code class="function">gst_collect_pads_clip_running_time()</code></a>. Unlike the value saved into
+the buffer, this value is of type gint64 and may be negative. This allow
+properly handling streams with frame reordering where the first DTS may
+be negative. If the initial DTS was not set, this value will be
+set to <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#G-MININT64:CAPS"><code class="literal">G_MININT64</code></a>.</p>
+<div class="refsect3">
+<a name="id-1.2.4.12.8.17.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody><tr>
+<td class="parameter_name"><p>data</p></td>
+<td class="parameter_description"><p>A <a class="link" href="GstCollectPads.html#GstCollectData" title="struct GstCollectData"><span class="type">GstCollectData</span></a>.</p></td>
+<td class="parameter_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
+<p class="since">Since: <a class="link" href="ix03.html#api-index-1.6">1.6</a></p>
+</div>
+<hr>
+<div class="refsect2">
+<a name="GST-COLLECT-PADS-DTS-IS-VALID:CAPS"></a><h3>GST_COLLECT_PADS_DTS_IS_VALID()</h3>
+<pre class="programlisting">#define GST_COLLECT_PADS_DTS_IS_VALID(data)          (GST_CLOCK_STIME_IS_VALID (GST_COLLECT_PADS_DTS (data)))
+</pre>
+<p>Check if running DTS value store is valid.</p>
+<div class="refsect3">
+<a name="id-1.2.4.12.8.18.5"></a><h4>Parameters</h4>
+<div class="informaltable"><table width="100%" border="0">
+<colgroup>
+<col width="150px" class="parameters_name">
+<col class="parameters_description">
+<col width="200px" class="parameters_annotations">
+</colgroup>
+<tbody><tr>
+<td class="parameter_name"><p>data</p></td>
+<td class="parameter_description"><p>A <a class="link" href="GstCollectPads.html#GstCollectData" title="struct GstCollectData"><span class="type">GstCollectData</span></a>.</p></td>
+<td class="parameter_annotations"> </td>
+</tr></tbody>
+</table></div>
+</div>
+<p class="since">Since: <a class="link" href="ix03.html#api-index-1.6">1.6</a></p>
+</div>
+<hr>
+<div class="refsect2">
 <a name="gst-collect-pads-new"></a><h3>gst_collect_pads_new ()</h3>
 <pre class="programlisting"><a class="link" href="GstCollectPads.html" title="GstCollectPads"><span class="returnvalue">GstCollectPads</span></a> *
 gst_collect_pads_new (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
 <p>Create a new instance of <a class="link" href="GstCollectPads.html" title="GstCollectPads"><span class="type">GstCollectPads</span></a>.</p>
 <p>MT safe.</p>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.17.6"></a><h4>Returns</h4>
+<a name="id-1.2.4.12.8.19.6"></a><h4>Returns</h4>
 <p> a new <a class="link" href="GstCollectPads.html" title="GstCollectPads"><span class="type">GstCollectPads</span></a>, or <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> in case of an error. </p>
 <p><span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span></p>
 </div>
@@ -1024,7 +1081,7 @@ when initial headers have to be written.</p>
 started.</p>
 <p>MT safe.</p>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.18.10"></a><h4>Parameters</h4>
+<a name="id-1.2.4.12.8.20.10"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1062,7 +1119,7 @@ started.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.18.11"></a><h4>Returns</h4>
+<a name="id-1.2.4.12.8.20.11"></a><h4>Returns</h4>
 <p> a new <a class="link" href="GstCollectPads.html#GstCollectData" title="struct GstCollectData"><span class="type">GstCollectData</span></a> to identify the
 new pad. Or <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if wrong parameters are supplied. </p>
 <p><span class="annotation">[<acronym title="NULL may be passed as the value in, out, in-out; or as a return value."><span class="acronym">nullable</span></acronym>][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span></p>
@@ -1081,7 +1138,7 @@ free the <a class="link" href="GstCollectPads.html#GstCollectData" title="struct
  is stopped.</p>
 <p>MT safe.</p>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.19.7"></a><h4>Parameters</h4>
+<a name="id-1.2.4.12.8.21.7"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1103,9 +1160,8 @@ free the <a class="link" href="GstCollectPads.html#GstCollectData" title="struct
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.19.8"></a><h4>Returns</h4>
+<a name="id-1.2.4.12.8.21.8"></a><h4>Returns</h4>
 <p> <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the pad could be removed.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1116,7 +1172,7 @@ gst_collect_pads_start (<em class="parameter"><code><a class="link" href="GstCol
 <p>Starts the processing of data in the collect_pads.</p>
 <p>MT safe.</p>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.20.6"></a><h4>Parameters</h4>
+<a name="id-1.2.4.12.8.22.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1140,7 +1196,7 @@ gst_collect_pads_stop (<em class="parameter"><code><a class="link" href="GstColl
 will also unblock any blocking operations.</p>
 <p>MT safe.</p>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.21.6"></a><h4>Parameters</h4>
+<a name="id-1.2.4.12.8.23.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1168,7 +1224,7 @@ be read from each of the pads.</p>
 in the callback.</p>
 <p>MT safe.</p>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.22.7"></a><h4>Parameters</h4>
+<a name="id-1.2.4.12.8.24.7"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1183,10 +1239,9 @@ in the callback.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.22.8"></a><h4>Returns</h4>
+<a name="id-1.2.4.12.8.24.8"></a><h4>Returns</h4>
 <p> The maximum number of bytes queued on all pads. This function
 returns 0 if a pad has no queued buffer.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1204,7 +1259,7 @@ gst_collect_pads_flush (<em class="parameter"><code><a class="link" href="GstCol
 in the callback.</p>
 <p>MT safe.</p>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.23.7"></a><h4>Parameters</h4>
+<a name="id-1.2.4.12.8.25.7"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1231,11 +1286,10 @@ in the callback.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.23.8"></a><h4>Returns</h4>
+<a name="id-1.2.4.12.8.25.8"></a><h4>Returns</h4>
 <p> The number of bytes flushed This can be less than <em class="parameter"><code>size</code></em>
 and
 is 0 if the pad was end-of-stream.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1251,7 +1305,7 @@ should be called with the <em class="parameter"><code>pads</code></em>
 handler.</p>
 <p>MT safe.</p>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.24.6"></a><h4>Parameters</h4>
+<a name="id-1.2.4.12.8.26.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1273,11 +1327,10 @@ handler.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.24.7"></a><h4>Returns</h4>
+<a name="id-1.2.4.12.8.26.7"></a><h4>Returns</h4>
 <p> The buffer in <em class="parameter"><code>data</code></em>
 or <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no buffer is queued.
 should unref the buffer after usage.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1293,7 +1346,7 @@ should be called with the <em class="parameter"><code>pads</code></em>
 handler.</p>
 <p>MT safe.</p>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.25.6"></a><h4>Parameters</h4>
+<a name="id-1.2.4.12.8.27.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1315,7 +1368,7 @@ handler.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.25.7"></a><h4>Returns</h4>
+<a name="id-1.2.4.12.8.27.7"></a><h4>Returns</h4>
 <p> The buffer in <em class="parameter"><code>data</code></em>
 or <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no buffer was
 queued. You should unref the buffer after usage. </p>
@@ -1337,7 +1390,7 @@ gst_collect_pads_read_buffer (<em class="parameter"><code><a class="link" href="
 callback.</p>
 <p>MT safe.</p>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.26.7"></a><h4>Parameters</h4>
+<a name="id-1.2.4.12.8.28.7"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1364,7 +1417,7 @@ callback.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.26.8"></a><h4>Returns</h4>
+<a name="id-1.2.4.12.8.28.8"></a><h4>Returns</h4>
 <p> A sub buffer. The size of the buffer can be less that requested.
 A return of <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> signals that the pad is end-of-stream.
 Unref the buffer after use. </p>
@@ -1387,7 +1440,7 @@ of read bytes.</p>
 callback.</p>
 <p>MT safe.</p>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.27.7"></a><h4>Parameters</h4>
+<a name="id-1.2.4.12.8.29.7"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1414,11 +1467,10 @@ callback.</p>
 </table></div>
 </div>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.27.8"></a><h4>Returns</h4>
+<a name="id-1.2.4.12.8.29.8"></a><h4>Returns</h4>
 <p> A sub buffer. The size of the buffer can be less that requested.
 A return of <a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> signals that the pad is end-of-stream.
 Unref the buffer after use.</p>
-<p></p>
 </div>
 </div>
 <hr>
@@ -1432,8 +1484,11 @@ gst_collect_pads_clip_running_time (<em class="parameter"><code><a class="link"
                                     <em class="parameter"><code><a href="/home/vagrant/ruby-gnome2.win32/glib2/vendor/local/share/gtk-doc/html/glib/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data</code></em>);</pre>
 <p>Convenience clipping function that converts incoming buffer's timestamp
 to running time, or clips the buffer if outside configured segment.</p>
+<p>Since 1.6, this clipping function also sets the DTS parameter of the
+GstCollectData structure. This version of the running time DTS can be
+negative. G_MININT64 is used to indicate invalid value.</p>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.28.5"></a><h4>Parameters</h4>
+<a name="id-1.2.4.12.8.30.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1482,7 +1537,7 @@ gst_collect_pads_query_default (<em class="parameter"><code><a class="link" href
 chain up to to ensure proper operation.  Element might however indicate
 query should not be forwarded downstream.</p>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.29.5"></a><h4>Parameters</h4>
+<a name="id-1.2.4.12.8.31.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1526,7 +1581,7 @@ gst_collect_pads_event_default (<em class="parameter"><code><a class="link" href
 chain up to to ensure proper operation.  Element might however indicate
 event should not be forwarded downstream.</p>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.30.5"></a><h4>Parameters</h4>
+<a name="id-1.2.4.12.8.32.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1569,7 +1624,7 @@ gst_collect_pads_src_event_default (<em class="parameter"><code><a class="link"
 Elements can chain up to this to let flushing seek event handling
 be done by <a class="link" href="GstCollectPads.html" title="GstCollectPads"><span class="type">GstCollectPads</span></a>.</p>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.31.5"></a><h4>Parameters</h4>
+<a name="id-1.2.4.12.8.33.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1595,7 +1650,7 @@ be done by <a class="link" href="GstCollectPads.html" title="GstCollectPads"><sp
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 1.4</p>
+<p class="since">Since: <a class="link" href="ix04.html#api-index-1.4">1.4</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1610,7 +1665,7 @@ If a buffer is passed, the callback owns a reference and must unref
 it.</p>
 <p>MT safe.</p>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.32.6"></a><h4>Parameters</h4>
+<a name="id-1.2.4.12.8.34.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1625,8 +1680,8 @@ it.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>func</p></td>
-<td class="parameter_description"><p>the function to set</p></td>
-<td class="parameter_annotations"> </td>
+<td class="parameter_description"><p> the function to set. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>user_data</p></td>
@@ -1648,7 +1703,7 @@ gst_collect_pads_set_clip_function (<em class="parameter"><code><a class="link"
 on a pad managed by <em class="parameter"><code>pads</code></em>
 . See <a class="link" href="GstCollectPads.html#GstCollectPadsClipFunction" title="GstCollectPadsClipFunction ()"><span class="type">GstCollectPadsClipFunction</span></a> for more info.</p>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.33.5"></a><h4>Parameters</h4>
+<a name="id-1.2.4.12.8.35.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1663,8 +1718,8 @@ on a pad managed by <em class="parameter"><code>pads</code></em>
 </tr>
 <tr>
 <td class="parameter_name"><p>clipfunc</p></td>
-<td class="parameter_description"><p>clip function to install</p></td>
-<td class="parameter_annotations"> </td>
+<td class="parameter_description"><p> clip function to install. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>user_data</p></td>
@@ -1686,7 +1741,7 @@ gst_collect_pads_set_compare_function (<em class="parameter"><code><a class="lin
 <p>Set the timestamp comparison function.</p>
 <p>MT safe.</p>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.34.6"></a><h4>Parameters</h4>
+<a name="id-1.2.4.12.8.36.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1701,8 +1756,8 @@ gst_collect_pads_set_compare_function (<em class="parameter"><code><a class="lin
 </tr>
 <tr>
 <td class="parameter_name"><p>func</p></td>
-<td class="parameter_description"><p>the function to set</p></td>
-<td class="parameter_annotations"> </td>
+<td class="parameter_description"><p> the function to set. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>user_data</p></td>
@@ -1729,7 +1784,7 @@ held when calling a number of CollectPads functions, it should be acquired
 if so (unusually) needed.</p>
 <p>MT safe.</p>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.35.6"></a><h4>Parameters</h4>
+<a name="id-1.2.4.12.8.37.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1744,8 +1799,8 @@ if so (unusually) needed.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>func</p></td>
-<td class="parameter_description"><p>the function to set</p></td>
-<td class="parameter_annotations"> </td>
+<td class="parameter_description"><p> the function to set. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>user_data</p></td>
@@ -1767,7 +1822,7 @@ gst_collect_pads_set_flush_function (<em class="parameter"><code><a class="link"
 state of all pads should be flushed as part of flushing seek
 handling. See <a class="link" href="GstCollectPads.html#GstCollectPadsFlushFunction" title="GstCollectPadsFlushFunction ()"><span class="type">GstCollectPadsFlushFunction</span></a> for more info.</p>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.36.5"></a><h4>Parameters</h4>
+<a name="id-1.2.4.12.8.38.5"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1782,8 +1837,8 @@ handling. See <a class="link" href="GstCollectPads.html#GstCollectPadsFlushFunct
 </tr>
 <tr>
 <td class="parameter_name"><p>func</p></td>
-<td class="parameter_description"><p>flush function to install</p></td>
-<td class="parameter_annotations"> </td>
+<td class="parameter_description"><p> flush function to install. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>user_data</p></td>
@@ -1794,7 +1849,7 @@ handling. See <a class="link" href="GstCollectPads.html#GstCollectPadsFlushFunct
 </tbody>
 </table></div>
 </div>
-<p class="since">Since 1.4</p>
+<p class="since">Since: <a class="link" href="ix04.html#api-index-1.4">1.4</a></p>
 </div>
 <hr>
 <div class="refsect2">
@@ -1812,7 +1867,7 @@ held when calling a number of CollectPads functions, it should be acquired
 if so (unusually) needed.</p>
 <p>MT safe.</p>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.37.6"></a><h4>Parameters</h4>
+<a name="id-1.2.4.12.8.39.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1827,8 +1882,8 @@ if so (unusually) needed.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>func</p></td>
-<td class="parameter_description"><p>the function to set</p></td>
-<td class="parameter_annotations"> </td>
+<td class="parameter_description"><p> the function to set. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>user_data</p></td>
@@ -1855,7 +1910,7 @@ Caller must ensure that downstream streaming (thread) is not blocked,
 e.g. by sending a FLUSH_START downstream.</p>
 <p>MT safe.</p>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.38.6"></a><h4>Parameters</h4>
+<a name="id-1.2.4.12.8.40.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1895,7 +1950,7 @@ Evidently, this callback is not compatible with
 If this callback is set, the former will be unset.</p>
 <p>MT safe.</p>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.39.6"></a><h4>Parameters</h4>
+<a name="id-1.2.4.12.8.41.6"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -1910,8 +1965,8 @@ If this callback is set, the former will be unset.</p>
 </tr>
 <tr>
 <td class="parameter_name"><p>func</p></td>
-<td class="parameter_description"><p>the function to set</p></td>
-<td class="parameter_annotations"> </td>
+<td class="parameter_description"><p> the function to set. </p></td>
+<td class="parameter_annotations"><span class="annotation">[<acronym title="The callback is valid only during the call to the method."><span class="acronym">scope call</span></acronym>]</span></td>
 </tr>
 <tr>
 <td class="parameter_name"><p>user_data</p></td>
@@ -1937,7 +1992,7 @@ in which case nothing happens.</p>
 in the callback.</p>
 <p>MT safe.</p>
 <div class="refsect3">
-<a name="id-1.2.4.12.8.40.7"></a><h4>Parameters</h4>
+<a name="id-1.2.4.12.8.42.7"></a><h4>Parameters</h4>
 <div class="informaltable"><table width="100%" border="0">
 <colgroup>
 <col width="150px" class="parameters_name">
@@ -2002,6 +2057,8 @@ by this <a class="link" href="GstCollectPads.html" title="GstCollectPads"><span
   GstBuffer             *buffer;
   guint                  pos;
   GstSegment             segment;
+      gint64 dts;
 };
 </pre>
 <p>Structure used by the collect_pads.</p>
@@ -2039,6 +2096,12 @@ by this <a class="link" href="GstCollectPads.html" title="GstCollectPads"><span
 <td class="struct_member_description"><p>last segment received.</p></td>
 <td class="struct_member_annotations"> </td>
 </tr>
+<tr>
+<td class="struct_member_name"><p><span class="type">gint64</span> <em class="structfield"><code><a name="GstCollectData.dts"></a>dts</code></em>;</p></td>
+<td class="struct_member_description"><p>the signed version of the DTS converted to running time. To access
+this memeber, use <a class="link" href="GstCollectPads.html#GST-COLLECT-PADS-DTS:CAPS" title="GST_COLLECT_PADS_DTS()"><code class="literal">GST_COLLECT_PADS_DTS</code></a> macro. (Since 1.6)</p></td>
+<td class="struct_member_annotations"> </td>
+</tr>
 </tbody>
 </table></div>
 </div>
@@ -2101,7 +2164,6 @@ by this <a class="link" href="GstCollectPads.html" title="GstCollectPads"><span
 </div>
 </div>
 <div class="footer">
-<hr>
-          Generated by GTK-Doc V1.21</div>
+<hr>Generated by GTK-Doc V1.24</div>
 </body>
 </html>