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., 51 Franklin St, Fifth Floor,
28 * Boston, MA 02110-1301, USA.
32 * SECTION:element-rippletv
35 * RippleTV does ripple mark effect on the video input. The ripple is caused
36 * by motion or random rain drops.
38 * ## Example launch line
40 * gst-launch-1.0 -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 #define DEFAULT_MODE 0
64 static gint sqrtable[256];
66 #define GST_TYPE_RIPPLETV_MODE (gst_rippletv_mode_get_type())
68 gst_rippletv_mode_get_type (void)
70 static GType type = 0;
72 static const GEnumValue enumvalue[] = {
73 {0, "Motion Detection", "motion-detection"},
79 type = g_enum_register_static ("GstRippleTVMode", enumvalue);
84 #define gst_rippletv_parent_class parent_class
85 G_DEFINE_TYPE (GstRippleTV, gst_rippletv, GST_TYPE_VIDEO_FILTER);
86 GST_ELEMENT_REGISTER_DEFINE (rippletv, "rippletv", GST_RANK_NONE,
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)
146 info = &GST_VIDEO_FILTER (filter)->in_info;
148 image_bgset_y (src, filter->background,
149 GST_VIDEO_INFO_WIDTH (info) * GST_VIDEO_INFO_HEIGHT (info));
150 filter->bg_is_set = TRUE;
156 image_bgsubtract_update_y (guint32 * src, gint16 * background, guint8 * diff,
169 for (i = 0; i < video_area; i++) {
170 R = ((*p) & 0xff0000) >> (16 - 1);
171 G = ((*p) & 0xff00) >> (8 - 2);
173 v = (R + G + B) - (gint) (*q);
174 *q = (gint16) (R + G + B);
175 *r = ((v + 70 * 7) >> 24) | ((70 * 7 - v) >> 24);
184 motiondetect (GstRippleTV * filter, guint32 * src)
186 guint8 *diff = filter->diff;
192 info = &GST_VIDEO_FILTER (filter)->in_info;
194 width = GST_VIDEO_INFO_WIDTH (info);
195 height = GST_VIDEO_INFO_HEIGHT (info);
197 if (!filter->bg_is_set)
198 setBackground (filter, src);
200 image_bgsubtract_update_y (src, filter->background, filter->diff,
202 p = filter->map1 + filter->map_w + 1;
203 q = filter->map2 + filter->map_w + 1;
206 for (y = filter->map_h - 2; y > 0; y--) {
207 for (x = filter->map_w - 2; x > 0; x--) {
208 h = (gint) * diff + (gint) * (diff + 1) + (gint) * (diff + width) +
209 (gint) * (diff + width + 1);
211 *p = h << (point + impact - 8);
225 drop (gint power, gint * map1, gint * map2, gint map_w, gint map_h)
230 x = fastrand () % (map_w - 4) + 2;
231 y = fastrand () % (map_h - 4) + 2;
232 p = map1 + y * map_w + x;
233 q = map2 + y * map_w + x;
236 *(p - map_w) = *(p - 1) = *(p + 1) = *(p + map_w) = power / 2;
237 *(p - map_w - 1) = *(p - map_w + 1) = *(p + map_w - 1) = *(p + map_w + 1) =
239 *(q - map_w) = *(q - 1) = *(q + 1) = *(q + map_w) = power / 2;
240 *(q - map_w - 1) = *(q - map_w + 1) = *(q + map_w - 1) = *(p + map_w + 1) =
245 raindrop (GstRippleTV * filter)
249 if (filter->period == 0) {
250 switch (filter->rain_stat) {
252 filter->period = (fastrand () >> 23) + 100;
253 filter->drop_prob = 0;
254 filter->drop_prob_increment = 0x00ffffff / filter->period;
255 filter->drop_power = (-(fastrand () >> 28) - 2) << point;
256 filter->drops_per_frame_max = 2 << (fastrand () >> 30); // 2,4,8 or 16
257 filter->rain_stat = 1;
260 filter->drop_prob = 0x00ffffff;
261 filter->drops_per_frame = 1;
262 filter->drop_prob_increment = 1;
263 filter->period = (filter->drops_per_frame_max - 1) * 16;
264 filter->rain_stat = 2;
267 filter->period = (fastrand () >> 22) + 1000;
268 filter->drop_prob_increment = 0;
269 filter->rain_stat = 3;
272 filter->period = (filter->drops_per_frame_max - 1) * 16;
273 filter->drop_prob_increment = -1;
274 filter->rain_stat = 4;
277 filter->period = (fastrand () >> 24) + 60;
278 filter->drop_prob_increment = -(filter->drop_prob / filter->period);
279 filter->rain_stat = 5;
283 filter->period = (fastrand () >> 23) + 500;
284 filter->drop_prob = 0;
285 filter->rain_stat = 0;
289 switch (filter->rain_stat) {
295 if ((fastrand () >> 8) < filter->drop_prob) {
296 drop (filter->drop_power, filter->map1, filter->map2, filter->map_w,
299 filter->drop_prob += filter->drop_prob_increment;
304 for (i = filter->drops_per_frame / 16; i > 0; i--) {
305 drop (filter->drop_power, filter->map1, filter->map2, filter->map_w,
308 filter->drops_per_frame += filter->drop_prob_increment;
315 gst_rippletv_transform_frame (GstVideoFilter * vfilter,
316 GstVideoFrame * in_frame, GstVideoFrame * out_frame)
318 GstRippleTV *filter = GST_RIPPLETV (vfilter);
323 gint m_w, m_h, v_w, v_h;
326 GstClockTime timestamp, stream_time;
328 timestamp = GST_BUFFER_TIMESTAMP (in_frame->buffer);
330 gst_segment_to_stream_time (&GST_BASE_TRANSFORM (vfilter)->segment,
331 GST_FORMAT_TIME, timestamp);
333 GST_DEBUG_OBJECT (filter, "sync to %" GST_TIME_FORMAT,
334 GST_TIME_ARGS (timestamp));
336 if (GST_CLOCK_TIME_IS_VALID (stream_time))
337 gst_object_sync_values (GST_OBJECT (filter), stream_time);
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);
351 v_w = GST_VIDEO_FRAME_WIDTH (in_frame);
352 v_h = GST_VIDEO_FRAME_HEIGHT (in_frame);
354 /* simulate surface wave */
356 /* This function is called only 30 times per second. To increase a speed
357 * of wave, iterates this loop several times. */
358 for (i = loopnum; i > 0; i--) {
359 /* wave simulation */
360 p = filter->map1 + m_w + 1;
361 q = filter->map2 + m_w + 1;
362 r = filter->map3 + m_w + 1;
363 for (y = m_h - 2; y > 0; y--) {
364 for (x = m_w - 2; x > 0; x--) {
365 h = *(p - m_w - 1) + *(p - m_w + 1) + *(p + m_w - 1) + *(p + m_w + 1)
366 + *(p - m_w) + *(p - 1) + *(p + 1) + *(p + m_w) - (*p) * 9;
369 v += h - (v >> decay);
380 /* low pass filter */
381 p = filter->map3 + m_w + 1;
382 q = filter->map2 + m_w + 1;
383 for (y = m_h - 2; y > 0; y--) {
384 for (x = m_w - 2; x > 0; x--) {
385 h = *(p - m_w) + *(p - 1) + *(p + 1) + *(p + m_w) + (*p) * 60;
395 filter->map1 = filter->map2;
401 for (y = m_h - 1; y > 0; y--) {
402 for (x = m_w - 1; x > 0; x--) {
403 /* difference of the height between two voxel. They are twiced to
404 * emphasise the wave. */
405 vp[0] = sqrtable[((p[0] - p[1]) >> (point - 1)) & 0xff];
406 vp[1] = sqrtable[((p[0] - p[m_w]) >> (point - 1)) & 0xff];
416 /* draw refracted image. The vector table is stretched. */
417 for (y = 0; y < v_h; y += 2) {
418 for (x = 0; x < v_w; x += 2) {
423 dx = CLAMP (dx, 0, (v_w - 2));
424 dy = CLAMP (dy, 0, (v_h - 2));
425 dest[0] = src[dy * v_w + dx];
429 dx = x + 1 + (h + (gint) vp[2]) / 2;
430 dx = CLAMP (dx, 0, (v_w - 2));
431 dest[1] = src[dy * v_w + dx];
433 dy = y + 1 + (v + (gint) vp[m_w * 2 + 1]) / 2;
434 dy = CLAMP (dy, 0, (v_h - 2));
435 dest[v_w] = src[dy * v_w + o_dx];
437 dest[v_w + 1] = src[dy * v_w + dx];
444 GST_OBJECT_UNLOCK (filter);
450 gst_rippletv_set_info (GstVideoFilter * vfilter, GstCaps * incaps,
451 GstVideoInfo * in_info, GstCaps * outcaps, GstVideoInfo * out_info)
453 GstRippleTV *filter = GST_RIPPLETV (vfilter);
456 width = GST_VIDEO_INFO_WIDTH (in_info);
457 height = GST_VIDEO_INFO_HEIGHT (in_info);
459 GST_OBJECT_LOCK (filter);
460 filter->map_h = height / 2 + 1;
461 filter->map_w = width / 2 + 1;
463 /* we over allocate the buffers, as the render code does not handle clipping
465 g_free (filter->map);
466 filter->map = g_new0 (gint, (1 + filter->map_h) * filter->map_w * 3);
468 filter->map1 = filter->map;
469 filter->map2 = filter->map + filter->map_w * filter->map_h;
470 filter->map3 = filter->map + filter->map_w * filter->map_h * 2;
472 g_free (filter->vtable);
473 filter->vtable = g_new0 (gint8, (1 + filter->map_h) * filter->map_w * 2);
475 g_free (filter->background);
476 filter->background = g_new0 (gint16, width * (height + 1));
478 g_free (filter->diff);
479 filter->diff = g_new0 (guint8, width * (height + 1));
480 GST_OBJECT_UNLOCK (filter);
486 gst_rippletv_start (GstBaseTransform * trans)
488 GstRippleTV *filter = GST_RIPPLETV (trans);
490 filter->bg_is_set = FALSE;
493 filter->rain_stat = 0;
494 filter->drop_prob = 0;
495 filter->drop_prob_increment = 0;
496 filter->drops_per_frame_max = 0;
497 filter->drops_per_frame = 0;
498 filter->drop_power = 0;
504 gst_rippletv_finalize (GObject * object)
506 GstRippleTV *filter = GST_RIPPLETV (object);
508 g_free (filter->map);
511 g_free (filter->vtable);
512 filter->vtable = NULL;
514 g_free (filter->background);
515 filter->background = NULL;
517 g_free (filter->diff);
520 G_OBJECT_CLASS (parent_class)->finalize (object);
524 gst_rippletv_set_property (GObject * object, guint prop_id,
525 const GValue * value, GParamSpec * pspec)
527 GstRippleTV *filter = GST_RIPPLETV (object);
529 GST_OBJECT_LOCK (filter);
532 memset (filter->map, 0,
533 filter->map_h * filter->map_w * 2 * sizeof (gint));
537 filter->mode = g_value_get_enum (value);
540 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
543 GST_OBJECT_UNLOCK (filter);
547 gst_rippletv_get_property (GObject * object, guint prop_id, GValue * value,
550 GstRippleTV *filter = GST_RIPPLETV (object);
554 g_value_set_enum (value, filter->mode);
557 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
563 gst_rippletv_class_init (GstRippleTVClass * klass)
565 GObjectClass *gobject_class = (GObjectClass *) klass;
566 GstElementClass *gstelement_class = (GstElementClass *) klass;
567 GstBaseTransformClass *trans_class = (GstBaseTransformClass *) klass;
568 GstVideoFilterClass *vfilter_class = (GstVideoFilterClass *) klass;
570 gobject_class->set_property = gst_rippletv_set_property;
571 gobject_class->get_property = gst_rippletv_get_property;
573 gobject_class->finalize = gst_rippletv_finalize;
575 g_object_class_install_property (gobject_class, PROP_RESET,
576 g_param_spec_boolean ("reset", "Reset",
577 "Reset all current ripples", FALSE,
578 G_PARAM_WRITABLE | G_PARAM_STATIC_STRINGS | GST_PARAM_CONTROLLABLE));
580 g_object_class_install_property (gobject_class, PROP_MODE,
581 g_param_spec_enum ("mode", "Mode",
582 "Mode", GST_TYPE_RIPPLETV_MODE, DEFAULT_MODE,
583 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS | GST_PARAM_CONTROLLABLE));
585 gst_element_class_set_static_metadata (gstelement_class, "RippleTV effect",
586 "Filter/Effect/Video",
587 "RippleTV does ripple mark effect on the video input",
588 "FUKUCHI, Kentarou <fukuchi@users.sourceforge.net>, "
589 "Sebastian Dröge <sebastian.droege@collabora.co.uk>");
591 gst_element_class_add_static_pad_template (gstelement_class,
592 &gst_rippletv_sink_template);
593 gst_element_class_add_static_pad_template (gstelement_class,
594 &gst_rippletv_src_template);
596 trans_class->start = GST_DEBUG_FUNCPTR (gst_rippletv_start);
598 vfilter_class->set_info = GST_DEBUG_FUNCPTR (gst_rippletv_set_info);
599 vfilter_class->transform_frame =
600 GST_DEBUG_FUNCPTR (gst_rippletv_transform_frame);
604 gst_type_mark_as_plugin_api (GST_TYPE_RIPPLETV_MODE, 0);
608 gst_rippletv_init (GstRippleTV * filter)
610 filter->mode = DEFAULT_MODE;
612 /* FIXME: remove this when memory corruption after resizes are fixed */
613 gst_pad_use_fixed_caps (GST_BASE_TRANSFORM_SRC_PAD (filter));
614 gst_pad_use_fixed_caps (GST_BASE_TRANSFORM_SINK_PAD (filter));