diff --git a/gst/geometrictransform/gstbulge.c b/gst/geometrictransform/gstbulge.c index 4baf223573..98a7849ba0 100644 --- a/gst/geometrictransform/gstbulge.c +++ b/gst/geometrictransform/gstbulge.c @@ -41,6 +41,21 @@ * Boston, MA 02110-1301, USA. */ +/** + * SECTION:element-bulge + * @see_also: geometrictransform + * + * Bugle is a geometric image transform element. It adds a protuberance in the + * center point. + * + * + * Example launch line + * |[ + * gst-launch-1.0 -v videotestsrc ! bulge ! videoconvert ! autovideosink + * ]| + * + */ + #ifdef HAVE_CONFIG_H # include #endif diff --git a/gst/geometrictransform/gstcircle.c b/gst/geometrictransform/gstcircle.c index cf6ab01d9a..da4f48b0d6 100644 --- a/gst/geometrictransform/gstcircle.c +++ b/gst/geometrictransform/gstcircle.c @@ -47,6 +47,20 @@ * his code. */ +/** + * SECTION:element-circle + * @see_also: geometrictransform + * + * Circle is a geometric image transform element. It warps the picture into an + * arc shaped form. + * + * + * Example launch line + * |[ + * gst-launch-1.0 -v videotestsrc ! circle ! videoconvert ! autovideosink + * ]| + * + */ #ifdef HAVE_CONFIG_H # include diff --git a/gst/geometrictransform/gstdiffuse.c b/gst/geometrictransform/gstdiffuse.c index 97225c13a9..03009c724a 100644 --- a/gst/geometrictransform/gstdiffuse.c +++ b/gst/geometrictransform/gstdiffuse.c @@ -47,6 +47,20 @@ * his code. */ +/** + * SECTION:element-diffuse + * @see_also: geometrictransform + * + * Diffuse is a geometric image transform element. It diffuses the image by + * moving its pixels in random directions. + * + * + * Example launch line + * |[ + * gst-launch-1.0 -v videotestsrc ! diffuse ! videoconvert ! autovideosink + * ]| + * + */ #ifdef HAVE_CONFIG_H # include diff --git a/gst/geometrictransform/gstfisheye.c b/gst/geometrictransform/gstfisheye.c index 0d9f2b9c21..d08069c2cf 100644 --- a/gst/geometrictransform/gstfisheye.c +++ b/gst/geometrictransform/gstfisheye.c @@ -41,6 +41,21 @@ * Boston, MA 02110-1301, USA. */ +/** + * SECTION:element-fisheye + * @see_also: geometrictransform + * + * Fisheye is a geometric image transform element. It simulates a fisheye lens + * by zooming on the center of the image and compressing the edges. + * + * + * Example launch line + * |[ + * gst-launch-1.0 -v videotestsrc ! fisheye ! videoconvert ! autovideosink + * ]| + * + */ + #ifdef HAVE_CONFIG_H # include #endif diff --git a/gst/geometrictransform/gstkaleidoscope.c b/gst/geometrictransform/gstkaleidoscope.c index 5546558510..bb1bdfcb81 100644 --- a/gst/geometrictransform/gstkaleidoscope.c +++ b/gst/geometrictransform/gstkaleidoscope.c @@ -47,6 +47,20 @@ * his code. */ +/** + * SECTION:element-kaleidoscope + * @see_also: geometrictransform + * + * The kaleidscope element applies 'kaleidoscope' geometric transform to the + * image. + * + * + * Example launch line + * |[ + * gst-launch-1.0 -v videotestsrc ! kaleidoscope ! videoconvert ! autovideosink + * ]| + * + */ #ifdef HAVE_CONFIG_H # include diff --git a/gst/geometrictransform/gstmarble.c b/gst/geometrictransform/gstmarble.c index a268a3d6db..6898453669 100644 --- a/gst/geometrictransform/gstmarble.c +++ b/gst/geometrictransform/gstmarble.c @@ -47,6 +47,20 @@ * his code. */ +/** + * SECTION:element-marble + * @see_also: geometrictransform + * + * Marble is a geometric image transform element. It applies a marbling effect + * to the image. + * + * + * Example launch line + * |[ + * gst-launch-1.0 -v videotestsrc ! marble ! videoconvert ! autovideosink + * ]| + * + */ #ifdef HAVE_CONFIG_H # include diff --git a/gst/geometrictransform/gstmirror.c b/gst/geometrictransform/gstmirror.c index dceb3c58e6..df18234d47 100644 --- a/gst/geometrictransform/gstmirror.c +++ b/gst/geometrictransform/gstmirror.c @@ -41,6 +41,21 @@ * Boston, MA 02110-1301, USA. */ +/** + * SECTION:element-mirror + * @see_also: geometrictransform + * + * Mirror is a geometric transform element. It splits the image into two halves + * and reflects one over each other. + * + * + * Example launch line + * |[ + * gst-launch-1.0 -v videotestsrc ! mirror ! videoconvert ! autovideosink + * ]| + * + */ + #ifdef HAVE_CONFIG_H # include #endif diff --git a/gst/geometrictransform/gstperspective.c b/gst/geometrictransform/gstperspective.c index e9ed2300cd..bafa1fc5dc 100644 --- a/gst/geometrictransform/gstperspective.c +++ b/gst/geometrictransform/gstperspective.c @@ -47,6 +47,20 @@ * http://docs.oracle.com/cd/E17802_01/products/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/PerspectiveTransform.html */ +/** + * SECTION:element-perspective + * @see_also: geometrictransform + * + * The perspective element applies a 2D perspective transform. + * + * + * Example launch line + * |[ + * gst-launch-1.0 -v videotestsrc ! perspective ! videoconvert ! autovideosink + * ]| + * + */ + /* FIXME: suppress warnings for deprecated API such as GValueArray * with newer GLib versions (>= 2.31.0) * diff --git a/gst/geometrictransform/gstpinch.c b/gst/geometrictransform/gstpinch.c index 296b84ab0e..d68dcd168a 100644 --- a/gst/geometrictransform/gstpinch.c +++ b/gst/geometrictransform/gstpinch.c @@ -47,6 +47,19 @@ * his code. */ +/** + * SECTION:element-pinch + * @see_also: geometrictransform + * + * Pinch applies a 'pinch' geometric transform to the image. + * + * + * Example launch line + * |[ + * gst-launch-1.0 -v videotestsrc ! pinch ! videoconvert ! autovideosink + * ]| + * + */ #ifdef HAVE_CONFIG_H # include diff --git a/gst/geometrictransform/gstrotate.c b/gst/geometrictransform/gstrotate.c index 693c89885d..1e03339bf8 100644 --- a/gst/geometrictransform/gstrotate.c +++ b/gst/geometrictransform/gstrotate.c @@ -47,6 +47,19 @@ * his code. */ +/** + * SECTION:element-rotate + * @see_also: geometrictransform + * + * The rotate element transforms the image by rotating it by a specified angle. + * + * + * Example launch line + * |[ + * gst-launch-1.0 -v videotestsrc ! rotate angle=0.78 ! videoconvert ! autovideosink + * ]| + * + */ #ifdef HAVE_CONFIG_H # include diff --git a/gst/geometrictransform/gstsphere.c b/gst/geometrictransform/gstsphere.c index a425470f68..5f39a4765c 100644 --- a/gst/geometrictransform/gstsphere.c +++ b/gst/geometrictransform/gstsphere.c @@ -47,6 +47,19 @@ * his code. */ +/** + * SECTION:element-sphere + * @see_also: geometrictransform + * + * The sphere element applies a 'sphere' geometric transform to the image. + * + * + * Example launch line + * |[ + * gst-launch-1.0 -v videotestsrc ! sphere ! videoconvert ! autovideosink + * ]| + * + */ #ifdef HAVE_CONFIG_H # include diff --git a/gst/geometrictransform/gstsquare.c b/gst/geometrictransform/gstsquare.c index ba0d2bf4fd..4b044f1940 100644 --- a/gst/geometrictransform/gstsquare.c +++ b/gst/geometrictransform/gstsquare.c @@ -41,6 +41,20 @@ * Boston, MA 02110-1301, USA. */ +/** + * SECTION:element-square + * @see_also: geometrictransform + * + * The square element distorts the center part of the image into a square. + * + * + * Example launch line + * |[ + * gst-launch-1.0 -v videotestsrc ! square zoom=100 ! videoconvert ! autovideosink + * ]| + * + */ + #ifdef HAVE_CONFIG_H # include #endif diff --git a/gst/geometrictransform/gststretch.c b/gst/geometrictransform/gststretch.c index f0c7998fea..61eed37f0f 100644 --- a/gst/geometrictransform/gststretch.c +++ b/gst/geometrictransform/gststretch.c @@ -41,6 +41,20 @@ * Boston, MA 02110-1301, USA. */ +/** + * SECTION:element-stretch + * @see_also: geometrictransform + * + * The stretch element stretches the image in a circle around the center point. + * + * + * Example launch line + * |[ + * gst-launch-1.0 -v videotestsrc ! stretch ! videoconvert ! autovideosink + * ]| + * + */ + #ifdef HAVE_CONFIG_H # include #endif diff --git a/gst/geometrictransform/gsttunnel.c b/gst/geometrictransform/gsttunnel.c index a71f0ef0a1..94b6070cc3 100644 --- a/gst/geometrictransform/gsttunnel.c +++ b/gst/geometrictransform/gsttunnel.c @@ -41,6 +41,21 @@ * Boston, MA 02110-1301, USA. */ +/** + * SECTION:element-tunnel + * @see_also: geometrictransform + * + * Tunnel is a geometric image transform element. It applies a light tunnel + * effect. + * + * + * Example launch line + * |[ + * gst-launch-1.0 -v videotestsrc ! tunnel ! videoconvert ! autovideosink + * ]| + * + */ + #ifdef HAVE_CONFIG_H # include #endif diff --git a/gst/geometrictransform/gsttwirl.c b/gst/geometrictransform/gsttwirl.c index 33222c859f..962d3ba6d2 100644 --- a/gst/geometrictransform/gsttwirl.c +++ b/gst/geometrictransform/gsttwirl.c @@ -47,6 +47,19 @@ * his code. */ +/** + * SECTION:element-twirl + * @see_also: geometrictransform + * + * The twirl element twists the image from the center out. + * + * + * Example launch line + * |[ + * gst-launch-1.0 -v videotestsrc ! twirl ! videoconvert ! autovideosink + * ]| + * + */ #ifdef HAVE_CONFIG_H # include diff --git a/gst/geometrictransform/gstwaterripple.c b/gst/geometrictransform/gstwaterripple.c index 4daff2a422..96af6e8d70 100644 --- a/gst/geometrictransform/gstwaterripple.c +++ b/gst/geometrictransform/gstwaterripple.c @@ -47,6 +47,19 @@ * his code. */ +/** + * SECTION:element-waterripple + * @see_also: geometrictransform + * + * The waterripple element creates a water ripple effect on the image. + * + * + * Example launch line + * |[ + * gst-launch-1.0 -v videotestsrc ! waterripple ! videoconvert ! autovideosink + * ]| + * + */ #ifdef HAVE_CONFIG_H # include