videomaxrate: Add to docs

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 \

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" />

docs/plugins/gst-plugins-bad-plugins-sections.txt

@@ -1116,6 +1116,20 @@ GST_VIDEO_DETECT_CLASS
 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>

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

gst/videomaxrate/videomaxrate.h

@@ -45,6 +45,8 @@ struct _GstVideoMaxRate
 {
   GstBaseTransform parent;
 
+  /*< private >*/
+
   GstClockTimeDiff wanted_diff;
   GstClockTime average_period;