From: Olivier Crête <olivier.crete@collabora.co.uk>
Date: Mon, 14 Jun 2010 19:15:09 +0000 (-0400)
Subject: videomaxrate: Add to docs
X-Git-Tag: 1.19.3~507^2~16771
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=7950499805315c637d7347a47f82d97af53a3a5a;p=platform%2Fupstream%2Fgstreamer.git

videomaxrate: Add to docs
---

diff --git a/docs/plugins/Makefile.am b/docs/plugins/Makefile.am
index 93aa454..0f9a065 100644
--- a/docs/plugins/Makefile.am
+++ b/docs/plugins/Makefile.am
@@ -161,6 +161,7 @@ EXTRA_HFILES = \
 	$(top_srcdir)/gst/selector/gstoutputselector.h \
 	$(top_srcdir)/gst/speed/gstspeed.h \
 	$(top_srcdir)/gst/stereo/gststereo.h \
+	$(top_srcdir)/gst/videomaxrate/videomaxrate.h \
 	$(top_srcdir)/gst/videosignal/gstvideoanalyse.h \
 	$(top_srcdir)/gst/videosignal/gstvideodetect.h \
 	$(top_srcdir)/gst/videosignal/gstvideomark.h \
diff --git a/docs/plugins/gst-plugins-bad-plugins-docs.sgml b/docs/plugins/gst-plugins-bad-plugins-docs.sgml
index c565459..342391d 100644
--- a/docs/plugins/gst-plugins-bad-plugins-docs.sgml
+++ b/docs/plugins/gst-plugins-bad-plugins-docs.sgml
@@ -89,6 +89,7 @@
     <xi:include href="xml/element-videoanalyse.xml" />
     <xi:include href="xml/element-videodetect.xml" />
     <xi:include href="xml/element-videomark.xml" />
+    <xi:include href="xml/element-videomaxrate.xml" />
     <xi:include href="xml/element-videoparse.xml" />
     <xi:include href="xml/element-wildmidi.xml" />
     <xi:include href="xml/element-zbar.xml" />
@@ -171,6 +172,7 @@
     <xi:include href="xml/plugin-tta.xml" />
     <xi:include href="xml/plugin-valve.xml" />
     <xi:include href="xml/plugin-vcdsrc.xml" />
+    <xi:include href="xml/plugin-videomaxrate.xml" />
     <xi:include href="xml/plugin-videosignal.xml" />
     <xi:include href="xml/plugin-vmnc.xml" />
     <xi:include href="xml/plugin-wildmidi.xml" />
diff --git a/docs/plugins/gst-plugins-bad-plugins-sections.txt b/docs/plugins/gst-plugins-bad-plugins-sections.txt
index 4302877..49535e6 100644
--- a/docs/plugins/gst-plugins-bad-plugins-sections.txt
+++ b/docs/plugins/gst-plugins-bad-plugins-sections.txt
@@ -1117,6 +1117,20 @@ GST_IS_VIDEO_DETECT_CLASS
 </SECTION>
 
 <SECTION>
+<FILE>element-videomaxrate</FILE>
+<TITLE>videomaxrate</TITLE>
+GstVideoMaxRate
+<SUBSECTION Standard>
+GstVideoMaxRateClass
+GST_VIDEO_MAX_RATE
+GST_IS_VIDEO_MAX_RATE
+GST_TYPE_VIDEO_MAX_RATE
+gst_video_max_rate_get_type
+GST_VIDEO_MAX_RATE_CLASS
+GST_IS_VIDEO_MAX_RATE_CLASS
+</SECTION>
+
+<SECTION>
 <FILE>element-videomark</FILE>
 <TITLE>videomark</TITLE>
 GstVideoMark
diff --git a/gst/videomaxrate/videomaxrate.c b/gst/videomaxrate/videomaxrate.c
index 52edbce..0d7bb4f 100644
--- a/gst/videomaxrate/videomaxrate.c
+++ b/gst/videomaxrate/videomaxrate.c
@@ -24,6 +24,20 @@
  *
  */
 
+
+/**
+ * SECTION:element-videomaxrate
+ * @see_also: videorate
+ *
+ * This object will drop buffers that go beyond a certain buffer rate
+ * (ie frame rate). It should work with any kind of data where each buffer
+ * is independent. This currently means raw video frames and still image
+ * formats.
+ *
+ * The framerate is computed using a moving average. The period over which this
+ * average is computed is configurable using the "average-period" property.
+ */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/gst/videomaxrate/videomaxrate.h b/gst/videomaxrate/videomaxrate.h
index 03b1733..ec8fb8d 100644
--- a/gst/videomaxrate/videomaxrate.h
+++ b/gst/videomaxrate/videomaxrate.h
@@ -45,6 +45,8 @@ struct _GstVideoMaxRate
 {
   GstBaseTransform parent;
 
+  /*< private >*/
+
   GstClockTimeDiff wanted_diff;
   GstClockTime average_period;