docs/plugins/: add more plugins and elements to docs

Original commit message from CVS:
* docs/plugins/Makefile.am:
* docs/plugins/gst-plugins-bad-plugins-docs.sgml:
* docs/plugins/gst-plugins-bad-plugins-sections.txt:
add more plugins and elements to docs
* gst/gdp/gstgdpdepay.c: (gst_gdp_depay_chain):
fix segfaults due to wrong g_free
add example
* gst/gdp/gstgdppay.c:
add example

diff --git a/gst/gdp/gstgdpdepay.c b/gst/gdp/gstgdpdepay.c
index 3f973b8bd8874bed5ec6a5060d543527e62fe969..21d6c7303b3b4b0e51e4fe3e20cedc1035907d4e 100644 (file)
--- a/gst/gdp/gstgdpdepay.c
+++ b/gst/gdp/gstgdpdepay.c
@@ -26,6 +26,13 @@
  * This element depayloads GStreamer Data Protocol buffers back to deserialized
  * buffers and events.
  * </para>
  * This element depayloads GStreamer Data Protocol buffers back to deserialized
  * buffers and events.
  * </para>

+ * <para>
+ * <programlisting>
+ * gst-launch -v -m filesrc location=test.gdp ! gdpdepay ! xvimagesink
+ * </programlisting>
+ * This pipeline plays back a serialized video stream as created in the
+ * example for gdppay.
+ * </para>

  * </refsect2>
  */
 
  * </refsect2>
  */
 


@@ -231,6 +238,7 @@ gst_gdp_depay_chain (GstPad * pad, GstBuffer * buffer)
         payload = gst_adapter_take (this->adapter, this->payload_length);
         memcpy (GST_BUFFER_DATA (buf), payload, this->payload_length);
         g_free (payload);
         payload = gst_adapter_take (this->adapter, this->payload_length);
         memcpy (GST_BUFFER_DATA (buf), payload, this->payload_length);
         g_free (payload);

+        payload = NULL;

 
         gst_buffer_set_caps (buf, this->caps);
         ret = gst_pad_push (this->srcpad, buf);
 
         gst_buffer_set_caps (buf, this->caps);
         ret = gst_pad_push (this->srcpad, buf);


@@ -250,6 +258,7 @@ gst_gdp_depay_chain (GstPad * pad, GstBuffer * buffer)
         caps = gst_dp_caps_from_packet (GST_DP_HEADER_LENGTH, this->header,
             payload);
         g_free (payload);
         caps = gst_dp_caps_from_packet (GST_DP_HEADER_LENGTH, this->header,
             payload);
         g_free (payload);

+        payload = NULL;

         if (!caps) {
           GST_ELEMENT_ERROR (this, STREAM, DECODE, (NULL),
               ("could not create caps from GDP packet"));
         if (!caps) {
           GST_ELEMENT_ERROR (this, STREAM, DECODE, (NULL),
               ("could not create caps from GDP packet"));


@@ -273,8 +282,10 @@ gst_gdp_depay_chain (GstPad * pad, GstBuffer * buffer)
           payload = gst_adapter_take (this->adapter, this->payload_length);
         event = gst_dp_event_from_packet (GST_DP_HEADER_LENGTH, this->header,
             payload);
           payload = gst_adapter_take (this->adapter, this->payload_length);
         event = gst_dp_event_from_packet (GST_DP_HEADER_LENGTH, this->header,
             payload);

-        if (payload)
+        if (payload) {

           g_free (payload);
           g_free (payload);

+          payload = NULL;
+        }

         if (!event) {
           GST_ELEMENT_ERROR (this, STREAM, DECODE, (NULL),
               ("could not create event from GDP packet"));
         if (!event) {
           GST_ELEMENT_ERROR (this, STREAM, DECODE, (NULL),
               ("could not create event from GDP packet"));

diff --git a/gst/gdp/gstgdppay.c b/gst/gdp/gstgdppay.c
index e80476e51f962b1e9df38b4df3ebfaf8647d0a20..36585a0286e6fef11a7a604d44e21ba9be82868d 100644 (file)
--- a/gst/gdp/gstgdppay.c
+++ b/gst/gdp/gstgdppay.c
@@ -26,6 +26,13 @@
  * This element payloads GStreamer buffers and events using the
  * GStreamer Data Protocol.
  * </para>
  * This element payloads GStreamer buffers and events using the
  * GStreamer Data Protocol.
  * </para>

+ * <para>
+ * <programlisting>
+ * gst-launch -v -m videotestsrc num-buffers=50 ! gdppay ! filesink location=test.gdp
+ * </programlisting>
+ * This pipeline creates a serialized video stream that can be played back
+ * with the example shown in gdpdepay.
+ * </para>

  * </refsect2>
  */
 
  * </refsect2>
  */