gstsparrow.c

   1 /* GStreamer
   2  * Copyright (C) <1999> Erik Walthinsen <omega@cse.ogi.edu>
   3  * Copyright (C) <2003> David Schleef <ds@schleef.org>
   4  * Copyright (C) <2010> Douglas Bagnall <douglas@halo.gen.nz>
   5  *
   6  * This library is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Library General Public
   8  * License as published by the Free Software Foundation; either
   9  * version 2 of the License, or (at your option) any later version.
  10  *
  11  * This library is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * Library General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Library General Public
  17  * License along with this library; if not, write to the
  18  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  19  * Boston, MA 02111-1307, USA.
  20  */
  21
  22
  23 /**
  24  * SECTION:element-sparrow
  25  *
  26  * Performs sparrow correction on a video stream.
  27  *
  28  * <refsect2>
  29  * <title>Example launch line</title>
  30  * |[
  31  * gst-launch videotestsrc ! ffmpegcolorspace ! sparrow ! ximagesink
  32  * ]|
  33  * </refsect2>
  34  */
  35
  36 #include "sparrow.h"
  37 #include "gstsparrow.h"
  38 #include <gst/video/gstvideofilter.h>
  39 #include <gst/video/video.h>
  40 GST_DEBUG_CATEGORY (sparrow_debug);
  41
  42 #include <string.h>
  43 #include <math.h>
  44
  45 /* static_functions */
  46 static void gst_sparrow_base_init(gpointer g_class);
  47 static void gst_sparrow_class_init(GstSparrowClass *g_class);
  48 static void gst_sparrow_init(GstSparrow *sparrow, GstSparrowClass *g_class);
  49 static void gst_sparrow_set_property(GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec);
  50 static void gst_sparrow_get_property(GObject *object, guint prop_id, GValue *value, GParamSpec *pspec);
  51 static gboolean gst_sparrow_set_caps(GstBaseTransform *base, GstCaps *incaps, GstCaps *outcaps);
  52 static GstFlowReturn gst_sparrow_transform(GstBaseTransform *base, GstBuffer *inbuf, GstBuffer *outbuf);
  53 static gboolean plugin_init(GstPlugin *plugin);
  54
  55
  56 //#include <sparrow.c>
  57 #include <sparrow.h>
  58
  59
  60 /* the capabilities of the inputs and outputs.
  61  *
  62  * Use RGB, not YUV, because inverting video is trivial in RGB, not so in YUV
  63  */
  64 static GstStaticPadTemplate sink_factory = GST_STATIC_PAD_TEMPLATE ("sink",
  65     GST_PAD_SINK,
  66     GST_PAD_ALWAYS,
  67     GST_STATIC_CAPS (
  68       GST_VIDEO_CAPS_xBGR "; " GST_VIDEO_CAPS_xRGB "; "
  69       GST_VIDEO_CAPS_BGRx "; " GST_VIDEO_CAPS_RGBx)
  70     );
  71
  72 static GstStaticPadTemplate src_factory = GST_STATIC_PAD_TEMPLATE ("src",
  73     GST_PAD_SRC,
  74     GST_PAD_ALWAYS,
  75     GST_STATIC_CAPS (
  76       GST_VIDEO_CAPS_xBGR "; " GST_VIDEO_CAPS_xRGB "; "
  77       GST_VIDEO_CAPS_BGRx "; " GST_VIDEO_CAPS_RGBx)
  78     );
  79
  80
  81 GST_BOILERPLATE (GstSparrow, gst_sparrow, GstVideoFilter, GST_TYPE_VIDEO_FILTER);
  82
  83 /* plugin_init    - registers plugin (once)
  84    XXX_base_init  - for the gobject class (once)
  85    XXX_class_init - for global state (once)
  86    XXX_init       - for each plugin instance
  87 */
  88
  89 static void
  90 gst_sparrow_base_init (gpointer g_class)
  91 {
  92   GstElementClass *element_class = GST_ELEMENT_CLASS (g_class);
  93
  94   gst_element_class_set_details_simple (element_class, "Video sparrow correction",
  95       "Filter/Effect/Video",
  96       "Adds sparrows to a video stream",
  97       "Douglas Bagnall <douglas@halo.gen.nz>");
  98
  99   gst_element_class_add_pad_template (element_class,
 100       gst_static_pad_template_get (&sink_factory));
 101   gst_element_class_add_pad_template (element_class,
 102       gst_static_pad_template_get (&src_factory));
 103
 104   GST_INFO("gst base init\n");
 105 }
 106
 107
 108 /* Clean up */
 109 static void
 110 gst_sparrow_finalize (GObject * obj){
 111   GST_DEBUG("in gst_sparrow_finalize!\n");
 112   GstSparrow *sparrow = GST_SPARROW(obj);
 113   sparrow_finalise(sparrow);
 114 }
 115
 116 static void
 117 gst_sparrow_class_init (GstSparrowClass * g_class)
 118 {
 119   GObjectClass *gobject_class;
 120   GstBaseTransformClass *trans_class;
 121
 122   gobject_class = G_OBJECT_CLASS (g_class);
 123   trans_class = GST_BASE_TRANSFORM_CLASS (g_class);
 124
 125   gobject_class->set_property = gst_sparrow_set_property;
 126   gobject_class->get_property = gst_sparrow_get_property;
 127   gobject_class->finalize = GST_DEBUG_FUNCPTR (gst_sparrow_finalize);
 128
 129   g_object_class_install_property (gobject_class, PROP_DEBUG,
 130       g_param_spec_boolean ("debug", "Debug", "save PPM files of internal state [off]",
 131           DEFAULT_PROP_DEBUG,
 132           G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 133
 134   g_object_class_install_property (gobject_class, PROP_TIMER,
 135       g_param_spec_boolean ("timer", "Timer", "Time each transform [off]",
 136           DEFAULT_PROP_TIMER,
 137           G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 138
 139   g_object_class_install_property (gobject_class, PROP_RNG_SEED,
 140       g_param_spec_uint ("rngseed", "RNGSeed", "Seed for the random number generator [-1, meaning auto]",
 141           0, (guint32)-1, (guint32)DEFAULT_PROP_RNG_SEED,
 142           G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 143
 144   g_object_class_install_property (gobject_class, PROP_COLOUR,
 145       g_param_spec_uint ("colour", "Colour", "Colour for calibration (" QUOTE(SPARROW_GREEN)
 146           " for green, " QUOTE(SPARROW_MAGENTA) "for magenta) [" QUOTE(DEFAULT_PROP_COLOUR) "]",
 147           0, SPARROW_LAST_COLOUR - 1, (guint32)DEFAULT_PROP_COLOUR,
 148           G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 149
 150   g_object_class_install_property (gobject_class, PROP_RELOAD,
 151       g_param_spec_string ("reload", "Reload", "reload calibration from this file, don't calibrate [None]",
 152           DEFAULT_PROP_RELOAD, G_PARAM_READWRITE));
 153
 154   g_object_class_install_property (gobject_class, PROP_SAVE,
 155       g_param_spec_string ("save", "Save", "save calibration details to this file [None]",
 156           DEFAULT_PROP_SAVE, G_PARAM_READWRITE));
 157
 158   trans_class->set_caps = GST_DEBUG_FUNCPTR (gst_sparrow_set_caps);
 159   trans_class->transform = GST_DEBUG_FUNCPTR (gst_sparrow_transform);
 160   GST_INFO("gst class init\n");
 161 }
 162
 163 static void
 164 gst_sparrow_init (GstSparrow * sparrow, GstSparrowClass * g_class)
 165 {
 166   GST_INFO("gst sparrow init\n");
 167   /*disallow resizing */
 168   gst_pad_use_fixed_caps(GST_BASE_TRANSFORM_SRC_PAD(sparrow));
 169 }
 170
 171 static inline void
 172 set_string_prop(const GValue *value, const char **target){
 173   const char *s = g_value_dup_string(value);
 174   size_t len = strlen(s);
 175   if(len){
 176     *target = s;
 177   }
 178 }
 179
 180 static void
 181 gst_sparrow_set_property (GObject * object, guint prop_id, const GValue * value,
 182     GParamSpec * pspec)
 183 {
 184   GstSparrow *sparrow;
 185
 186   g_return_if_fail (GST_IS_SPARROW (object));
 187   sparrow = GST_SPARROW (object);
 188
 189   GST_DEBUG("gst_sparrow_set_property\n");
 190   if (value){
 191     switch (prop_id) {
 192     case PROP_DEBUG:
 193       sparrow->debug = g_value_get_boolean(value);
 194       GST_DEBUG("debug_value is %d\n", sparrow->debug);
 195       break;
 196     case PROP_TIMER:
 197       sparrow->use_timer = g_value_get_boolean(value);
 198       GST_DEBUG("timer_value is %d\n", sparrow->use_timer);
 199       break;
 200     case PROP_RNG_SEED:
 201       sparrow->rng_seed = g_value_get_uint(value);
 202       GST_DEBUG("rng seed is %d\n", sparrow->rng_seed);
 203       break;
 204     case PROP_COLOUR:
 205       sparrow->colour = g_value_get_uint(value);
 206       GST_DEBUG("colour is %d\n", sparrow->rng_seed);
 207       break;
 208     case PROP_RELOAD:
 209       set_string_prop(value, &sparrow->reload);
 210       GST_DEBUG("reload is %s\n", sparrow->reload);
 211       break;
 212     case PROP_SAVE:
 213       set_string_prop(value, &sparrow->save);
 214       GST_DEBUG("save is %s\n", sparrow->save);
 215       break;
 216     default:
 217       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
 218       break;
 219     }
 220   }
 221 }
 222
 223 static void
 224 gst_sparrow_get_property (GObject * object, guint prop_id, GValue * value,
 225     GParamSpec * pspec)
 226 {
 227   GstSparrow *sparrow;
 228
 229   g_return_if_fail (GST_IS_SPARROW (object));
 230   sparrow = GST_SPARROW (object);
 231
 232   switch (prop_id) {
 233     case PROP_DEBUG:
 234       g_value_set_boolean(value, sparrow->debug);
 235       break;
 236     case PROP_TIMER:
 237       g_value_set_boolean(value, sparrow->use_timer);
 238       break;
 239     case PROP_RNG_SEED:
 240       g_value_set_uint(value, sparrow->rng_seed);
 241       break;
 242     case PROP_COLOUR:
 243       g_value_set_uint(value, sparrow->colour);
 244       break;
 245     case PROP_RELOAD:
 246       g_value_set_string(value, sparrow->reload);
 247       break;
 248     case PROP_SAVE:
 249       g_value_set_string(value, sparrow->save);
 250       break;
 251     default:
 252       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
 253       break;
 254   }
 255 }
 256
 257
 258
 259 static gboolean
 260 gst_sparrow_set_caps (GstBaseTransform * base, GstCaps * incaps, GstCaps * outcaps)
 261 {
 262   GST_INFO("set_caps\n");
 263   GstSparrow *sparrow = GST_SPARROW(base);
 264
 265   GST_DEBUG_OBJECT (sparrow,
 266       "set_caps: \nin %" GST_PTR_FORMAT " \nout %" GST_PTR_FORMAT, incaps, outcaps);
 267
 268   /* set_caps gets called after set_property, so it is a good place for hooks
 269      that depend on properties and that need to be run before everything
 270      starts. */
 271
 272   return sparrow_init(sparrow, incaps, outcaps);
 273 }
 274
 275
 276
 277 static GstFlowReturn
 278 gst_sparrow_transform (GstBaseTransform * base, GstBuffer * inbuf,
 279     GstBuffer * outbuf)
 280 {
 281   GstSparrow *sparrow = GST_SPARROW(base);
 282   guint8 *indata = GST_BUFFER_DATA(inbuf);
 283   guint8 *outdata = GST_BUFFER_DATA(outbuf);
 284   guint insize = GST_BUFFER_SIZE(inbuf);
 285   guint outsize = GST_BUFFER_SIZE(outbuf);
 286
 287   if (insize != sparrow->in.size || outsize != sparrow->out.size)
 288     goto wrong_size;
 289
 290   sparrow_transform(sparrow, indata, outdata);
 291   return GST_FLOW_OK;
 292
 293   /* ERRORS */
 294 wrong_size:
 295   {
 296     GST_ELEMENT_ERROR (sparrow, STREAM, FORMAT,
 297         (NULL), ("Invalid buffer size(s)\nIN:  size %d, expected %d\nOUT: size %d, expected %d",
 298             insize, sparrow->in.size, outsize, sparrow->out.size));
 299     return GST_FLOW_ERROR;
 300   }
 301 }
 302
 303
 304 static gboolean
 305 plugin_init (GstPlugin * plugin)
 306 {
 307   GST_DEBUG_CATEGORY_INIT (sparrow_debug, "sparrow", 0, "sparrow");
 308   GST_INFO("gst plugin init\n");
 309
 310   return gst_element_register (plugin, "sparrow", GST_RANK_NONE, GST_TYPE_SPARROW);
 311 }
 312
 313 GST_PLUGIN_DEFINE (GST_VERSION_MAJOR,
 314     GST_VERSION_MINOR,
 315     "sparrow",
 316     "Add sparrows to video streams",
 317     plugin_init, VERSION, GST_LICENSE, GST_PACKAGE_NAME, GST_PACKAGE_ORIGIN);
 318
 319
 320