From ef53753a6ba78105bcca584249560709eedd6f41 Mon Sep 17 00:00:00 2001
From: Julien Moutte <julien@moutte.net>
Date: Wed, 30 Nov 2005 18:57:48 +0000
Subject: [PATCH] Adding docs.

Original commit message from CVS:
2005-11-30  Julien MOUTTE  <julien@moutte.net>

* docs/libs/gst-plugins-base-libs-docs.sgml:
* docs/libs/gst-plugins-base-libs-sections.txt:
* gst-libs/gst/video/gstvideofilter.c:
* gst-libs/gst/video/gstvideosink.c:
* gst-libs/gst/video/gstvideosink.h: Adding docs.
---
 ChangeLog                                    |  8 ++++++++
 docs/libs/gst-plugins-base-libs-docs.sgml    | 13 +++++++++++++
 docs/libs/gst-plugins-base-libs-sections.txt | 17 +++++++++++++++++
 gst-libs/gst/video/gstvideofilter.c          | 12 ++++++++++++
 gst-libs/gst/video/gstvideosink.c            | 23 +++++++++++++++++++++++
 gst-libs/gst/video/gstvideosink.h            |  9 +++++++++
 6 files changed, 82 insertions(+)

diff --git a/ChangeLog b/ChangeLog
index acf0333..2800f6b 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2005-11-30  Julien MOUTTE  <julien@moutte.net>
+
+	* docs/libs/gst-plugins-base-libs-docs.sgml:
+	* docs/libs/gst-plugins-base-libs-sections.txt:
+	* gst-libs/gst/video/gstvideofilter.c:
+	* gst-libs/gst/video/gstvideosink.c:
+	* gst-libs/gst/video/gstvideosink.h: Adding docs.
+
 2005-11-30  Thomas Vander Stichele  <thomas (at) apestaart (dot) org>
 
 	* LICENSE:
diff --git a/docs/libs/gst-plugins-base-libs-docs.sgml b/docs/libs/gst-plugins-base-libs-docs.sgml
index 169416e..736eb39 100644
--- a/docs/libs/gst-plugins-base-libs-docs.sgml
+++ b/docs/libs/gst-plugins-base-libs-docs.sgml
@@ -6,6 +6,8 @@
 
 <!ENTITY GstCompiling SYSTEM "compiling.sgml">
 <!ENTITY GstAudio SYSTEM "xml/gstaudio.xml">
+<!ENTITY GstVideoSink SYSTEM "xml/element-videosink.xml">
+<!ENTITY GstVideoFilter SYSTEM "xml/element-videofilter.xml">
 <!ENTITY GstColorBalance SYSTEM "xml/gstcolorbalance.xml">
 <!ENTITY GstGConf SYSTEM "xml/gstgconf.xml">
 <!ENTITY GstMixer SYSTEM "xml/gstmixer.xml">
@@ -39,6 +41,17 @@ This library should be linked to by getting cflags and libs from
     &GstRingBuffer;
   </chapter>
 
+  <chapter id="gstreamer-video">
+    <title>Video Library</title>
+    <para>
+This library should be linked to by getting cflags and libs from
+<filename>gstreamer-plugins-base.pc</filename> and adding
+<filename>-lgstvideo-&GST_MAJORMINOR;</filename> to the library flags.
+    </para>
+    &GstVideoSink;
+    &GstVideoFilter;
+  </chapter>
+
   <chapter id="gstreamer-interfaces">
     <title>Interfaces Library</title>
     <para>
diff --git a/docs/libs/gst-plugins-base-libs-sections.txt b/docs/libs/gst-plugins-base-libs-sections.txt
index e514b89..f6558d9 100644
--- a/docs/libs/gst-plugins-base-libs-sections.txt
+++ b/docs/libs/gst-plugins-base-libs-sections.txt
@@ -115,3 +115,20 @@ gst_x_overlay_prepare_xwindow_id
 gst_x_overlay_expose
 </SECTION>
 
+<SECTION>
+<FILE>element-videosink</FILE>
+<INCLUDE>gst/video/gstvideosink.h</INCLUDE>
+GstVideoSink
+GstVideoSinkClass
+GstVideoRectangle
+gst_video_sink_center_rect
+</SECTION>
+
+<SECTION>
+<FILE>element-videofilter</FILE>
+<INCLUDE>gst/video/gstvideofilter.h</INCLUDE>
+GstVideoFilter
+GstVideoFilterClass
+</SECTION>
+
+
diff --git a/gst-libs/gst/video/gstvideofilter.c b/gst-libs/gst/video/gstvideofilter.c
index 686ebba..6899b53 100644
--- a/gst-libs/gst/video/gstvideofilter.c
+++ b/gst-libs/gst/video/gstvideofilter.c
@@ -18,6 +18,18 @@
  * Boston, MA 02111-1307, USA.
  */
 
+ /**
+ * SECTION:element-videofilter
+ * @short_description: Base class for video filters.
+ * 
+ * <refsect2>
+ * <para>
+ * Provides useful functions and a base class for video filters. Right now it's 
+ * mostly used as a place holder for adding common code later on.
+ * </para>
+ * </refsect2>
+ */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
diff --git a/gst-libs/gst/video/gstvideosink.c b/gst-libs/gst/video/gstvideosink.c
index 71a71f5..39075c1 100644
--- a/gst-libs/gst/video/gstvideosink.c
+++ b/gst-libs/gst/video/gstvideosink.c
@@ -19,6 +19,18 @@
  * Boston, MA 02111-1307, USA.
  */
 
+/**
+ * SECTION:element-videosink
+ * @short_description: Base class for video sinks.
+ * 
+ * <refsect2>
+ * <para>
+ * Provides useful functions and a base class for video sinks. Right now it's 
+ * mostly used as a place holder for adding common code later on.
+ * </para>
+ * </refsect2>
+ */
+
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
@@ -27,6 +39,17 @@
 
 static GstElementClass *parent_class = NULL;
 
+/**
+ * gst_video_sink_center_rect:
+ * @src: the #GstVideoRectangle describing the source area
+ * @dst: the #GstVideoRectangle describing the destination area
+ * @result: a pointer to a #GstVideoRectangle which will receive the result area
+ * @scaling: a #gboolean indicating if scaling should be applied or not
+ * 
+ * Takes @src rectangle and position it at the center of @dst rectangle with or
+ * without @scaling. It handles clipping if the @src rectangle is bigger than
+ * the @dst one and @scaling is set to FALSE.
+ */
 void
 gst_video_sink_center_rect (GstVideoRectangle src, GstVideoRectangle dst,
     GstVideoRectangle * result, gboolean scaling)
diff --git a/gst-libs/gst/video/gstvideosink.h b/gst-libs/gst/video/gstvideosink.h
index 49f5522..4cd36a3 100644
--- a/gst-libs/gst/video/gstvideosink.h
+++ b/gst-libs/gst/video/gstvideosink.h
@@ -48,6 +48,15 @@ typedef struct _GstVideoSink GstVideoSink;
 typedef struct _GstVideoSinkClass GstVideoSinkClass;
 typedef struct _GstVideoRectangle GstVideoRectangle;
 
+/**
+ * GstVideoRectangle:
+ * @x: X coordinate of rectangle's top-left point
+ * @y: Y coordinate of rectangle's top-left point
+ * @w: width of the rectangle
+ * @h: height of the rectangle
+ *
+ * Helper structure representing a rectangular area.
+ */
 struct _GstVideoRectangle {
   gint x;
   gint y;
-- 
2.7.4