2 * Copyright (C) <2009> Sebastian Dröge <sebastian.droege@collabora.co.uk>
4 * EffecTV - Realtime Digital Video Effector
5 * Copyright (C) 2001-2006 FUKUCHI Kentaro
7 * RippleTV - Water ripple effect.
8 * Copyright (C) 2001-2002 FUKUCHI Kentaro
10 * This combines the RippleTV and BaltanTV effects, which are
11 * very similar. BaltanTV is used if the feedback property is set
12 * to TRUE, otherwise RippleTV is used.
14 * EffecTV is free software. This library is free software;
15 * you can redistribute it and/or
16 * modify it under the terms of the GNU Library General Public
17 * License as published by the Free Software Foundation; either
18 * version 2 of the License, or (at your option) any later version.
20 * This library is distributed in the hope that it will be useful,
21 * but WITHOUT ANY WARRANTY; without even the implied warranty of
22 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
23 * Library General Public License for more details.
25 * You should have received a copy of the GNU Library General Public
26 * License along with this library; if not, write to the
27 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
28 * Boston, MA 02111-1307, USA.
32 * SECTION:element-rippletv
34 * RippleTV does ripple mark effect on the video input. The ripple is caused
35 * by motion or random rain drops.
38 * <title>Example launch line</title>
40 * gst-launch -v videotestsrc ! rippletv ! videoconvert ! autovideosink
41 * ]| This pipeline shows the effect of rippletv on a test stream.
52 #include "gstripple.h"
53 #include "gsteffectv.h"
55 #include <gst/controller/gstcontroller.h>
57 #define DEFAULT_MODE 0
66 static gint sqrtable[256];
68 #define GST_TYPE_RIPPLETV_MODE (gst_rippletv_mode_get_type())
70 gst_rippletv_mode_get_type (void)
72 static GType type = 0;
74 static const GEnumValue enumvalue[] = {
75 {0, "Motion Detection", "motion-detection"},
81 type = g_enum_register_static ("GstRippleTVMode", enumvalue);
86 #define gst_rippletv_parent_class parent_class
87 G_DEFINE_TYPE (GstRippleTV, gst_rippletv, GST_TYPE_VIDEO_FILTER);
89 static GstStaticPadTemplate gst_rippletv_src_template =
90 GST_STATIC_PAD_TEMPLATE ("src",
93 GST_STATIC_CAPS (GST_VIDEO_CAPS_MAKE ("{ BGRx, RGBx, xBGR, xRGB }"))
96 static GstStaticPadTemplate gst_rippletv_sink_template =
97 GST_STATIC_PAD_TEMPLATE ("sink",
100 GST_STATIC_CAPS (GST_VIDEO_CAPS_MAKE ("{ BGRx, RGBx, xBGR, xRGB }"))
103 static const gint point = 16;
104 static const gint impact = 2;
105 static const gint decay = 8;
106 static const gint loopnum = 2;
113 for (i = 0; i < 128; i++) {
116 for (i = 1; i <= 128; i++) {
117 sqrtable[256 - i] = -i * i;
122 image_bgset_y (guint32 * src, gint16 * background, gint video_area)
131 for (i = 0; i < video_area; i++) {
132 R = ((*p) & 0xff0000) >> (16 - 1);
133 G = ((*p) & 0xff00) >> (8 - 2);
135 *q = (gint16) (R + G + B);
142 setBackground (GstRippleTV * filter, guint32 * src)
144 image_bgset_y (src, filter->background,
145 GST_VIDEO_INFO_WIDTH (&filter->info) *
146 GST_VIDEO_INFO_HEIGHT (&filter->info));
147 filter->bg_is_set = TRUE;
153 image_bgsubtract_update_y (guint32 * src, gint16 * background, guint8 * diff,
166 for (i = 0; i < video_area; i++) {
167 R = ((*p) & 0xff0000) >> (16 - 1);
168 G = ((*p) & 0xff00) >> (8 - 2);
170 v = (R + G + B) - (gint) (*q);
171 *q = (gint16) (R + G + B);
172 *r = ((v + 70 * 7) >> 24) | ((70 * 7 - v) >> 24);
181 motiondetect (GstRippleTV * filter, guint32 * src)
183 guint8 *diff = filter->diff;
188 width = GST_VIDEO_INFO_WIDTH (&filter->info);
189 height = GST_VIDEO_INFO_HEIGHT (&filter->info);
191 if (!filter->bg_is_set)
192 setBackground (filter, src);
194 image_bgsubtract_update_y (src, filter->background, filter->diff,
196 p = filter->map1 + filter->map_w + 1;
197 q = filter->map2 + filter->map_w + 1;
200 for (y = filter->map_h - 2; y > 0; y--) {
201 for (x = filter->map_w - 2; x > 0; x--) {
202 h = (gint) * diff + (gint) * (diff + 1) + (gint) * (diff + width) +
203 (gint) * (diff + width + 1);
205 *p = h << (point + impact - 8);
219 drop (gint power, gint * map1, gint * map2, gint map_w, gint map_h)
224 x = fastrand () % (map_w - 4) + 2;
225 y = fastrand () % (map_h - 4) + 2;
226 p = map1 + y * map_w + x;
227 q = map2 + y * map_w + x;
230 *(p - map_w) = *(p - 1) = *(p + 1) = *(p + map_w) = power / 2;
231 *(p - map_w - 1) = *(p - map_w + 1) = *(p + map_w - 1) = *(p + map_w + 1) =
233 *(q - map_w) = *(q - 1) = *(q + 1) = *(q + map_w) = power / 2;
234 *(q - map_w - 1) = *(q - map_w + 1) = *(q + map_w - 1) = *(p + map_w + 1) =
239 raindrop (GstRippleTV * filter)
243 if (filter->period == 0) {
244 switch (filter->rain_stat) {
246 filter->period = (fastrand () >> 23) + 100;
247 filter->drop_prob = 0;
248 filter->drop_prob_increment = 0x00ffffff / filter->period;
249 filter->drop_power = (-(fastrand () >> 28) - 2) << point;
250 filter->drops_per_frame_max = 2 << (fastrand () >> 30); // 2,4,8 or 16
251 filter->rain_stat = 1;
254 filter->drop_prob = 0x00ffffff;
255 filter->drops_per_frame = 1;
256 filter->drop_prob_increment = 1;
257 filter->period = (filter->drops_per_frame_max - 1) * 16;
258 filter->rain_stat = 2;
261 filter->period = (fastrand () >> 22) + 1000;
262 filter->drop_prob_increment = 0;
263 filter->rain_stat = 3;
266 filter->period = (filter->drops_per_frame_max - 1) * 16;
267 filter->drop_prob_increment = -1;
268 filter->rain_stat = 4;
271 filter->period = (fastrand () >> 24) + 60;
272 filter->drop_prob_increment = -(filter->drop_prob / filter->period);
273 filter->rain_stat = 5;
277 filter->period = (fastrand () >> 23) + 500;
278 filter->drop_prob = 0;
279 filter->rain_stat = 0;
283 switch (filter->rain_stat) {
289 if ((fastrand () >> 8) < filter->drop_prob) {
290 drop (filter->drop_power, filter->map1, filter->map2, filter->map_w,
293 filter->drop_prob += filter->drop_prob_increment;
298 for (i = filter->drops_per_frame / 16; i > 0; i--) {
299 drop (filter->drop_power, filter->map1, filter->map2, filter->map_w,
302 filter->drops_per_frame += filter->drop_prob_increment;
309 gst_rippletv_transform (GstBaseTransform * trans, GstBuffer * in,
312 GstRippleTV *filter = GST_RIPPLETV (trans);
314 GstVideoFrame in_frame, out_frame;
321 GstClockTime timestamp, stream_time;
323 timestamp = GST_BUFFER_TIMESTAMP (in);
325 gst_segment_to_stream_time (&trans->segment, GST_FORMAT_TIME, timestamp);
327 GST_DEBUG_OBJECT (filter, "sync to %" GST_TIME_FORMAT,
328 GST_TIME_ARGS (timestamp));
330 if (GST_CLOCK_TIME_IS_VALID (stream_time))
331 gst_object_sync_values (G_OBJECT (filter), stream_time);
333 if (!gst_video_frame_map (&in_frame, &filter->info, in, GST_MAP_READ))
336 if (!gst_video_frame_map (&out_frame, &filter->info, out, GST_MAP_WRITE))
339 src = GST_VIDEO_FRAME_PLANE_DATA (&in_frame, 0);
340 dest = GST_VIDEO_FRAME_PLANE_DATA (&out_frame, 0);
342 GST_OBJECT_LOCK (filter);
343 /* impact from the motion or rain drop */
347 motiondetect (filter, src);
349 /* simulate surface wave */
350 width = filter->map_w;
351 height = filter->map_h;
353 /* This function is called only 30 times per second. To increase a speed
354 * of wave, iterates this loop several times. */
355 for (i = loopnum; i > 0; i--) {
356 /* wave simulation */
357 p = filter->map1 + width + 1;
358 q = filter->map2 + width + 1;
359 r = filter->map3 + width + 1;
360 for (y = height - 2; y > 0; y--) {
361 for (x = width - 2; x > 0; x--) {
362 h = *(p - width - 1) + *(p - width + 1) + *(p + width - 1) + *(p +
364 + *(p - width) + *(p - 1) + *(p + 1) + *(p + width) - (*p) * 9;
367 v += h - (v >> decay);
378 /* low pass filter */
379 p = filter->map3 + width + 1;
380 q = filter->map2 + width + 1;
381 for (y = height - 2; y > 0; y--) {
382 for (x = width - 2; x > 0; x--) {
383 h = *(p - width) + *(p - 1) + *(p + 1) + *(p + width) + (*p) * 60;
393 filter->map1 = filter->map2;
399 for (y = height - 1; y > 0; y--) {
400 for (x = width - 1; x > 0; x--) {
401 /* difference of the height between two voxel. They are twiced to
402 * emphasise the wave. */
403 vp[0] = sqrtable[((p[0] - p[1]) >> (point - 1)) & 0xff];
404 vp[1] = sqrtable[((p[0] - p[width]) >> (point - 1)) & 0xff];
412 width = GST_VIDEO_FRAME_WIDTH (&in_frame);
413 height = GST_VIDEO_FRAME_HEIGHT (&in_frame);
416 /* draw refracted image. The vector table is stretched. */
417 for (y = 0; y < height; y += 2) {
418 for (x = 0; x < width; x += 2) {
431 dest[0] = src[dy * width + dx];
435 dx = x + 1 + (h + (gint) vp[2]) / 2;
440 dest[1] = src[dy * width + dx];
442 dy = y + 1 + (v + (gint) vp[filter->map_w * 2 + 1]) / 2;
447 dest[width] = src[dy * width + i];
449 dest[width + 1] = src[dy * width + dx];
456 GST_OBJECT_UNLOCK (filter);
458 gst_video_frame_unmap (&in_frame);
459 gst_video_frame_unmap (&out_frame);
466 GST_DEBUG_OBJECT (filter, "invalid input frame");
467 return GST_FLOW_ERROR;
471 GST_DEBUG_OBJECT (filter, "invalid output frame");
472 gst_video_frame_unmap (&in_frame);
473 return GST_FLOW_ERROR;
479 gst_rippletv_set_caps (GstBaseTransform * btrans, GstCaps * incaps,
482 GstRippleTV *filter = GST_RIPPLETV (btrans);
486 if (!gst_video_info_from_caps (&info, incaps))
491 width = GST_VIDEO_INFO_WIDTH (&info);
492 height = GST_VIDEO_INFO_HEIGHT (&info);
494 GST_OBJECT_LOCK (filter);
495 filter->map_h = height / 2 + 1;
496 filter->map_w = width / 2 + 1;
499 g_free (filter->map);
500 filter->map = g_new0 (gint, filter->map_h * filter->map_w * 3);
502 filter->map1 = filter->map;
503 filter->map2 = filter->map + filter->map_w * filter->map_h;
504 filter->map3 = filter->map + filter->map_w * filter->map_h * 2;
507 g_free (filter->vtable);
508 filter->vtable = g_new0 (gint8, filter->map_h * filter->map_w * 2);
510 if (filter->background)
511 g_free (filter->background);
512 filter->background = g_new0 (gint16, width * height);
515 g_free (filter->diff);
516 filter->diff = g_new0 (guint8, width * height);
517 GST_OBJECT_UNLOCK (filter);
524 GST_DEBUG_OBJECT (filter, "invalid caps received");
530 gst_rippletv_start (GstBaseTransform * trans)
532 GstRippleTV *filter = GST_RIPPLETV (trans);
534 filter->bg_is_set = FALSE;
537 filter->rain_stat = 0;
538 filter->drop_prob = 0;
539 filter->drop_prob_increment = 0;
540 filter->drops_per_frame_max = 0;
541 filter->drops_per_frame = 0;
542 filter->drop_power = 0;
548 gst_rippletv_finalize (GObject * object)
550 GstRippleTV *filter = GST_RIPPLETV (object);
553 g_free (filter->map);
557 g_free (filter->vtable);
558 filter->vtable = NULL;
560 if (filter->background)
561 g_free (filter->background);
562 filter->background = NULL;
565 g_free (filter->diff);
568 G_OBJECT_CLASS (parent_class)->finalize (object);
572 gst_rippletv_set_property (GObject * object, guint prop_id,
573 const GValue * value, GParamSpec * pspec)
575 GstRippleTV *filter = GST_RIPPLETV (object);
577 GST_OBJECT_LOCK (filter);
580 memset (filter->map, 0,
581 filter->map_h * filter->map_w * 2 * sizeof (gint));
585 filter->mode = g_value_get_enum (value);
588 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
591 GST_OBJECT_UNLOCK (filter);
595 gst_rippletv_get_property (GObject * object, guint prop_id, GValue * value,
598 GstRippleTV *filter = GST_RIPPLETV (object);
602 g_value_set_enum (value, filter->mode);
605 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
611 gst_rippletv_class_init (GstRippleTVClass * klass)
613 GObjectClass *gobject_class = (GObjectClass *) klass;
614 GstElementClass *gstelement_class = (GstElementClass *) klass;
615 GstBaseTransformClass *trans_class = (GstBaseTransformClass *) klass;
617 gobject_class->set_property = gst_rippletv_set_property;
618 gobject_class->get_property = gst_rippletv_get_property;
620 gobject_class->finalize = gst_rippletv_finalize;
622 g_object_class_install_property (gobject_class, PROP_RESET,
623 g_param_spec_boolean ("reset", "Reset",
624 "Reset all current ripples", FALSE,
625 G_PARAM_WRITABLE | G_PARAM_STATIC_STRINGS | GST_PARAM_CONTROLLABLE));
627 g_object_class_install_property (gobject_class, PROP_MODE,
628 g_param_spec_enum ("mode", "Mode",
629 "Mode", GST_TYPE_RIPPLETV_MODE, DEFAULT_MODE,
630 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS | GST_PARAM_CONTROLLABLE));
632 gst_element_class_set_details_simple (gstelement_class, "RippleTV effect",
633 "Filter/Effect/Video",
634 "RippleTV does ripple mark effect on the video input",
635 "FUKUCHI, Kentarou <fukuchi@users.sourceforge.net>, "
636 "Sebastian Dröge <sebastian.droege@collabora.co.uk>");
638 gst_element_class_add_pad_template (gstelement_class,
639 gst_static_pad_template_get (&gst_rippletv_sink_template));
640 gst_element_class_add_pad_template (gstelement_class,
641 gst_static_pad_template_get (&gst_rippletv_src_template));
643 trans_class->set_caps = GST_DEBUG_FUNCPTR (gst_rippletv_set_caps);
644 trans_class->transform = GST_DEBUG_FUNCPTR (gst_rippletv_transform);
645 trans_class->start = GST_DEBUG_FUNCPTR (gst_rippletv_start);
651 gst_rippletv_init (GstRippleTV * filter)
653 filter->mode = DEFAULT_MODE;
655 gst_pad_use_fixed_caps (GST_BASE_TRANSFORM_SRC_PAD (filter));
656 gst_pad_use_fixed_caps (GST_BASE_TRANSFORM_SINK_PAD (filter));