gst/elements/gstaggregator.c

   1 /* GStreamer
   2  * Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
   3  *                    2000 Wim Taymans <wim.taymans@chello.be>
   4  *
   5  * gstaggregator.c: Aggregator element, N in 1 out
   6  *
   7  * This library is free software; you can redistribute it and/or
   8  * modify it under the terms of the GNU Library General Public
   9  * License as published by the Free Software Foundation; either
  10  * version 2 of the License, or (at your option) any later version.
  11  *
  12  * This library is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15  * Library General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU Library General Public
  18  * License along with this library; if not, write to the
  19  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  20  * Boston, MA 02111-1307, USA.
  21  */
  22
  23 #ifdef HAVE_CONFIG_H
  24 #  include "config.h"
  25 #endif
  26
  27 #include "gstaggregator.h"
  28
  29 GST_DEBUG_CATEGORY_STATIC (gst_aggregator_debug);
  30 #define GST_CAT_DEFAULT gst_aggregator_debug
  31
  32 GstElementDetails gst_aggregator_details = GST_ELEMENT_DETAILS (
  33   "Aggregator pipe fitting",
  34   "Generic",
  35   "N-to-1 pipe fitting",
  36   "Wim Taymans <wim.taymans@chello.be>"
  37 );
  38
  39 /* Aggregator signals and args */
  40 enum {
  41   /* FILL ME */
  42   LAST_SIGNAL
  43 };
  44
  45 enum {
  46   ARG_0,
  47   ARG_NUM_PADS,
  48   ARG_SILENT,
  49   ARG_SCHED,
  50   ARG_LAST_MESSAGE,
  51   /* FILL ME */
  52 };
  53
  54 GstStaticPadTemplate aggregator_src_template = GST_STATIC_PAD_TEMPLATE (
  55   "sink%d",
  56   GST_PAD_SINK,
  57   GST_PAD_REQUEST,
  58   GST_STATIC_CAPS_ANY
  59 );
  60
  61 #define GST_TYPE_AGGREGATOR_SCHED (gst_aggregator_sched_get_type())
  62 static GType
  63 gst_aggregator_sched_get_type (void)
  64 {
  65   static GType aggregator_sched_type = 0;
  66   static GEnumValue aggregator_sched[] = {
  67     { AGGREGATOR_LOOP,          "1", "Loop Based"},
  68     { AGGREGATOR_LOOP_SELECT,   "3", "Loop Based Select"},
  69     { AGGREGATOR_CHAIN,         "4", "Chain Based"},
  70     {0, NULL, NULL},
  71   };
  72   if (!aggregator_sched_type) {
  73     aggregator_sched_type = g_enum_register_static ("GstAggregatorSched", aggregator_sched);
  74   }
  75   return aggregator_sched_type;
  76 }
  77
  78 #define AGGREGATOR_IS_LOOP_BASED(ag)    ((ag)->sched != AGGREGATOR_CHAIN)
  79
  80 static void     gst_aggregator_base_init        (gpointer g_class);
  81 static void     gst_aggregator_class_init       (GstAggregatorClass *klass);
  82 static void     gst_aggregator_init             (GstAggregator *aggregator);
  83
  84 static GstPad*  gst_aggregator_request_new_pad  (GstElement *element, GstPadTemplate *temp, const
  85                                                  gchar *unused);
  86 static void     gst_aggregator_update_functions (GstAggregator *aggregator);
  87
  88 static void     gst_aggregator_set_property     (GObject *object, guint prop_id,
  89                                                  const GValue *value, GParamSpec *pspec);
  90 static void     gst_aggregator_get_property     (GObject *object, guint prop_id,
  91                                                  GValue *value, GParamSpec *pspec);
  92
  93 static void     gst_aggregator_chain            (GstPad *pad, GstData *_data);
  94 static void     gst_aggregator_loop             (GstElement *element);
  95
  96 static GstElementClass *parent_class = NULL;
  97 /*static guint gst_aggregator_signals[LAST_SIGNAL] = { 0 };*/
  98
  99 GType
 100 gst_aggregator_get_type (void)
 101 {
 102   static GType aggregator_type = 0;
 103
 104   if (!aggregator_type) {
 105     static const GTypeInfo aggregator_info = {
 106       sizeof(GstAggregatorClass),
 107       gst_aggregator_base_init,
 108       NULL,
 109       (GClassInitFunc)gst_aggregator_class_init,
 110       NULL,
 111       NULL,
 112       sizeof(GstAggregator),
 113       0,
 114       (GInstanceInitFunc)gst_aggregator_init,
 115     };
 116     aggregator_type = g_type_register_static (GST_TYPE_ELEMENT, "GstAggregator", &aggregator_info, 0);
 117
 118     GST_DEBUG_CATEGORY_INIT (gst_aggregator_debug, "aggregator", 0, "aggregator element");
 119   }
 120   return aggregator_type;
 121 }
 122
 123 static void
 124 gst_aggregator_base_init (gpointer g_class)
 125 {
 126   GstElementClass *gstelement_class = GST_ELEMENT_CLASS (g_class);
 127   gst_element_class_add_pad_template (gstelement_class,
 128       gst_static_pad_template_get (&aggregator_src_template));
 129   gst_element_class_set_details (gstelement_class, &gst_aggregator_details);
 130 }
 131 static void
 132 gst_aggregator_class_init (GstAggregatorClass *klass)
 133 {
 134   GObjectClass *gobject_class;
 135   GstElementClass *gstelement_class;
 136
 137   gobject_class = (GObjectClass*) klass;
 138   gstelement_class = (GstElementClass*) klass;
 139
 140   parent_class = g_type_class_ref (GST_TYPE_ELEMENT);
 141
 142   g_object_class_install_property (G_OBJECT_CLASS (klass), ARG_NUM_PADS,
 143     g_param_spec_int ("num_pads", "Num pads", "The number of source pads",
 144                       0, G_MAXINT, 0, G_PARAM_READABLE));
 145   g_object_class_install_property (G_OBJECT_CLASS (klass), ARG_SILENT,
 146     g_param_spec_boolean ("silent", "Silent", "Don't produce messages",
 147                       FALSE, G_PARAM_READWRITE));
 148   g_object_class_install_property (G_OBJECT_CLASS (klass), ARG_SCHED,
 149     g_param_spec_enum ("sched", "Scheduling", "The type of scheduling this element should use",
 150                       GST_TYPE_AGGREGATOR_SCHED, AGGREGATOR_CHAIN, G_PARAM_READWRITE));
 151   g_object_class_install_property (G_OBJECT_CLASS (klass), ARG_LAST_MESSAGE,
 152     g_param_spec_string ("last_message", "Last message", "The current state of the element",
 153                          NULL, G_PARAM_READABLE));
 154
 155   gobject_class->set_property = GST_DEBUG_FUNCPTR(gst_aggregator_set_property);
 156   gobject_class->get_property = GST_DEBUG_FUNCPTR(gst_aggregator_get_property);
 157
 158   gstelement_class->request_new_pad = GST_DEBUG_FUNCPTR(gst_aggregator_request_new_pad);
 159 }
 160
 161 static void
 162 gst_aggregator_init (GstAggregator *aggregator)
 163 {
 164   aggregator->srcpad = gst_pad_new ("src", GST_PAD_SRC);
 165   gst_element_add_pad (GST_ELEMENT (aggregator), aggregator->srcpad);
 166
 167   aggregator->numsinkpads = 0;
 168   aggregator->sinkpads = NULL;
 169   aggregator->silent = FALSE;
 170   aggregator->sched = AGGREGATOR_LOOP;
 171
 172   gst_aggregator_update_functions (aggregator);
 173 }
 174
 175 static GstPad*
 176 gst_aggregator_request_new_pad (GstElement *element, GstPadTemplate *templ, const gchar *unused)
 177 {
 178   gchar *name;
 179   GstPad *sinkpad;
 180   GstAggregator *aggregator;
 181
 182   g_return_val_if_fail (GST_IS_AGGREGATOR (element), NULL);
 183
 184   if (templ->direction != GST_PAD_SINK) {
 185     g_warning ("gstaggregator: request new pad that is not a sink pad\n");
 186     return NULL;
 187   }
 188
 189   aggregator = GST_AGGREGATOR (element);
 190
 191   name = g_strdup_printf ("sink%d",aggregator->numsinkpads);
 192
 193   sinkpad = gst_pad_new_from_template (templ, name);
 194   g_free (name);
 195
 196   if (!AGGREGATOR_IS_LOOP_BASED (aggregator)) {
 197     gst_pad_set_chain_function (sinkpad, gst_aggregator_chain);
 198   }
 199   gst_element_add_pad (GST_ELEMENT (aggregator), sinkpad);
 200
 201   aggregator->sinkpads = g_list_prepend (aggregator->sinkpads, sinkpad);
 202   aggregator->numsinkpads++;
 203
 204   return sinkpad;
 205 }
 206
 207 static void
 208 gst_aggregator_update_functions (GstAggregator *aggregator)
 209 {
 210   GList *pads;
 211
 212   if (AGGREGATOR_IS_LOOP_BASED (aggregator)) {
 213     gst_element_set_loop_function (GST_ELEMENT (aggregator), GST_DEBUG_FUNCPTR (gst_aggregator_loop));
 214   }
 215   else {
 216     gst_element_set_loop_function (GST_ELEMENT (aggregator), NULL);
 217   }
 218
 219   pads = aggregator->sinkpads;
 220   while (pads) {
 221     GstPad *pad = GST_PAD (pads->data);
 222
 223     if (AGGREGATOR_IS_LOOP_BASED (aggregator)) {
 224       gst_pad_set_get_function (pad, NULL);
 225     }
 226     else {
 227       gst_element_set_loop_function (GST_ELEMENT (aggregator), NULL);
 228     }
 229     pads = g_list_next (pads);
 230   }
 231 }
 232
 233 static void
 234 gst_aggregator_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec)
 235 {
 236   GstAggregator *aggregator;
 237
 238   /* it's not null if we got it, but it might not be ours */
 239   g_return_if_fail (GST_IS_AGGREGATOR (object));
 240
 241   aggregator = GST_AGGREGATOR (object);
 242
 243   switch (prop_id) {
 244     case ARG_SILENT:
 245       aggregator->silent = g_value_get_boolean (value);
 246       break;
 247     case ARG_SCHED:
 248       aggregator->sched = g_value_get_enum (value);
 249       gst_aggregator_update_functions (aggregator);
 250       break;
 251     default:
 252       break;
 253   }
 254 }
 255
 256 static void
 257 gst_aggregator_get_property (GObject *object, guint prop_id, GValue *value, GParamSpec *pspec)
 258 {
 259   GstAggregator *aggregator;
 260
 261   /* it's not null if we got it, but it might not be ours */
 262   g_return_if_fail (GST_IS_AGGREGATOR (object));
 263
 264   aggregator = GST_AGGREGATOR (object);
 265
 266   switch (prop_id) {
 267     case ARG_NUM_PADS:
 268       g_value_set_int (value, aggregator->numsinkpads);
 269       break;
 270     case ARG_SILENT:
 271       g_value_set_boolean (value, aggregator->silent);
 272       break;
 273     case ARG_SCHED:
 274       g_value_set_enum (value, aggregator->sched);
 275       break;
 276     case ARG_LAST_MESSAGE:
 277       g_value_set_string (value, aggregator->last_message);
 278       break;
 279     default:
 280       break;
 281   }
 282 }
 283
 284 static void
 285 gst_aggregator_push (GstAggregator *aggregator, GstPad *pad, GstBuffer *buf, guchar *debug)
 286 {
 287   if (!aggregator->silent) {
 288     g_free (aggregator->last_message);
 289
 290     aggregator->last_message = g_strdup_printf ("%10.10s ******* (%s:%s)a (%d bytes, %"
 291                                                 G_GUINT64_FORMAT ")",
 292             debug, GST_DEBUG_PAD_NAME (pad), GST_BUFFER_SIZE (buf), GST_BUFFER_TIMESTAMP (buf));
 293
 294     g_object_notify (G_OBJECT (aggregator), "last_message");
 295   }
 296
 297   gst_pad_push (aggregator->srcpad, GST_DATA (buf));
 298 }
 299
 300 static void
 301 gst_aggregator_loop (GstElement *element)
 302 {
 303   GstAggregator *aggregator;
 304   GstBuffer *buf;
 305   guchar *debug;
 306
 307   aggregator = GST_AGGREGATOR (element);
 308
 309   if (aggregator->sched == AGGREGATOR_LOOP) {
 310     GList *pads = aggregator->sinkpads;
 311
 312     /* we'll loop over all pads and try to pull from all
 313      * active ones */
 314     while (pads) {
 315       GstPad *pad = GST_PAD (pads->data);
 316       pads = g_list_next (pads);
 317
 318       /* we need to check is the pad is usable. IS_USABLE will check
 319        * if the pad is linked, if it is enabled (the element is
 320        * playing and the app didn't gst_pad_set_enabled (pad, FALSE))
 321        * and that the peer pad is also enabled.
 322        */
 323       if (GST_PAD_IS_USABLE (pad)) {
 324         buf = GST_BUFFER (gst_pad_pull (pad));
 325         debug = "loop";
 326
 327         /* then push it forward */
 328         gst_aggregator_push (aggregator, pad, buf, debug);
 329       }
 330     }
 331   }
 332   else {
 333     if (aggregator->sched == AGGREGATOR_LOOP_SELECT) {
 334       GstPad *pad;
 335
 336       debug = "loop_select";
 337
 338       pad = gst_pad_selectv (aggregator->sinkpads);
 339       buf = GST_BUFFER (gst_pad_pull (pad));
 340
 341       gst_aggregator_push (aggregator, pad, buf, debug);
 342     }
 343     else {
 344       g_assert_not_reached ();
 345     }
 346   }
 347 }
 348
 349 /**
 350  * gst_aggregator_chain:
 351  * @pad: the pad to follow
 352  * @buf: the buffer to pass
 353  *
 354  * Chain a buffer on a pad.
 355  */
 356 static void
 357 gst_aggregator_chain (GstPad *pad, GstData *_data)
 358 {
 359   GstBuffer *buf = GST_BUFFER (_data);
 360   GstAggregator *aggregator;
 361
 362   g_return_if_fail (pad != NULL);
 363   g_return_if_fail (GST_IS_PAD (pad));
 364   g_return_if_fail (buf != NULL);
 365
 366   aggregator = GST_AGGREGATOR (gst_pad_get_parent (pad));
 367 /*  gst_trace_add_entry (NULL, 0, buf, "aggregator buffer");*/
 368
 369   gst_aggregator_push (aggregator, pad, buf, "chain");
 370 }
 371