From: Sebastian Dröge <sebastian.droege@collabora.co.uk>
Date: Sun, 31 May 2009 19:33:01 +0000 (+0200)
Subject: [MOVED FROM BAD 06/29] shapewipe: Add documentation and integrate into the build... 
X-Git-Tag: 1.19.3~509^2~9178
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=e207e7b8a39be08d26999c3f2e3349dbd40cf406;p=platform%2Fupstream%2Fgstreamer.git

[MOVED FROM BAD 06/29] shapewipe: Add documentation and integrate into the build system
---

diff --git a/gst/shapewipe/gstshapewipe.c b/gst/shapewipe/gstshapewipe.c
index ec33f0a..e09d0fc 100644
--- a/gst/shapewipe/gstshapewipe.c
+++ b/gst/shapewipe/gstshapewipe.c
@@ -17,6 +17,27 @@
  * Boston, MA 02111-1307, USA.
  */
 
+/**
+ * SECTION:element-shapewipe
+ *
+ * The shapewipe element provides custom transitions on video streams
+ * based on a grayscale bitmap. The state of the transition can be
+ * controlled by the position property and an optional blended border
+ * can be added by the border property.
+ *
+ * Transition bitmaps can be downloaded from the
+ * <ulink url="http://cinelerra.org/transitions.php">Cinelerra transition</ulink>
+ * page.
+ *
+ * <refsect2>
+ * <title>Example launch line</title>
+ * |[
+ * gst-launch -v videotestsrc ! video/x-raw-yuv,width=640,height=480 ! shapewipe position=0.5 name=shape ! videomixer name=mixer ! ffmpegcolorspace ! autovideosink     filesrc location=mask.png ! typefind ! decodebin2 ! ffmpegcolorspace ! videoscale ! queue ! shape.mask_sink    videotestsrc pattern=snow ! video/x-raw-yuv,width=640,height=480 ! queue ! mixer.
+ * ]| This pipeline adds the transition from mask.png with position 0.5 to an SMPTE test screen and snow.
+ * </refsect2>
+ */
+
+
 #ifdef HAVE_CONFIG_H
 #  include "config.h"
 #endif