From a99d3f8769ed3fd1266d5216ecefebfd1bdcf663 Mon Sep 17 00:00:00 2001 From: Stefan Kost Date: Wed, 28 Jan 2009 12:29:42 +0200 Subject: Update and add documentation for plugins with no deps (gst). Link to properties. Correct titles for examples. Document a few trivial cases. Keep lists in section file and docs/plugins/Makefile.am alphabetically ordered. --- gst/videobox/gstvideobox.c | 21 ++++++++++++++++++++- 1 file changed, 20 insertions(+), 1 deletion(-) (limited to 'gst/videobox') diff --git a/gst/videobox/gstvideobox.c b/gst/videobox/gstvideobox.c index 0e6e112c..c515634d 100644 --- a/gst/videobox/gstvideobox.c +++ b/gst/videobox/gstvideobox.c @@ -16,7 +16,25 @@ * Free Software Foundation, Inc., 59 Temple Place - Suite 330, * Boston, MA 02111-1307, USA. */ - +/** + * SECTION:element-videobox + * @see_also: #GstVideoCrop + * + * This plugin crops or enlarges the image. It takes 4 values as input, a + * top, bottom, left and right offset. Positive values will crop that much + * pixels from the respective border of the image, negative values will add + * that much pixels. When pixels are added, you can specify their color. + * Some predefined colors are usable with an enum property. + * + * The plugin is alpha channel aware and will try to negotiate with a format + * that supports alpha channels first. When alpha channel is active two + * other properties, alpha and border_alpha can be used to set the alpha + * values of the inner picture and the border respectively. an alpha value of + * 0.0 means total transparency, 1.0 is opaque. + * + * The videobox plugin has many uses such as doing a mosaic of pictures, + * letterboxing video, cutting out pieces of video, picture in picture, etc.. + */ #ifdef HAVE_CONFIG_H #include "config.h" #endif @@ -1147,6 +1165,7 @@ invalid_format: } } +/* FIXME: 0.11 merge with videocrop plugin */ static gboolean plugin_init (GstPlugin * plugin) { -- cgit