aggregator: Use the event_full function for GstAggregatorPads
[platform/upstream/gstreamer.git] / libs / gst / base / gstaggregator.c
1 /* GStreamer aggregator base class
2  * Copyright (C) 2014 Mathieu Duponchelle <mathieu.duponchelle@opencreed.com>
3  * Copyright (C) 2014 Thibault Saunier <tsaunier@gnome.org>
4  *
5  * gstaggregator.c:
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., 51 Franklin St, Fifth Floor,
20  * Boston, MA 02110-1301, USA.
21  */
22 /**
23  * SECTION: gstaggregator
24  * @short_description: manages a set of pads with the purpose of
25  * aggregating their buffers.
26  * @see_also: gstcollectpads for historical reasons.
27  *
28  * Manages a set of pads with the purpose of aggregating their buffers.
29  * Control is given to the subclass when all pads have data.
30  * <itemizedlist>
31  *  <listitem><para>
32  *    Base class for mixers and muxers. Subclasses should at least implement
33  *    the #GstAggregatorClass.aggregate() virtual method.
34  *  </para></listitem>
35  *  <listitem><para>
36  *    When data is queued on all pads, tha aggregate vmethod is called.
37  *  </para></listitem>
38  *  <listitem><para>
39  *    One can peek at the data on any given GstAggregatorPad with the
40  *    gst_aggregator_pad_get_buffer () method, and take ownership of it
41  *    with the gst_aggregator_pad_steal_buffer () method. When a buffer
42  *    has been taken with steal_buffer (), a new buffer can be queued
43  *    on that pad.
44  *  </para></listitem>
45  *  <listitem><para>
46  *    If the subclass wishes to push a buffer downstream in its aggregate
47  *    implementation, it should do so through the
48  *    gst_aggregator_finish_buffer () method. This method will take care
49  *    of sending and ordering mandatory events such as stream start, caps
50  *    and segment.
51  *  </para></listitem>
52  *  <listitem><para>
53  *    Same goes for EOS events, which should not be pushed directly by the
54  *    subclass, it should instead return GST_FLOW_EOS in its aggregate
55  *    implementation.
56  *  </para></listitem>
57  *  <listitem><para>
58  *    Note that the aggregator logic regarding gap event handling is to turn
59  *    these into gap buffers with matching PTS and duration. It will also
60  *    flag these buffers with GST_BUFFER_FLAG_GAP and GST_BUFFER_FLAG_DROPPABLE
61  *    to ease their identification and subsequent processing.
62  *  </para></listitem>
63  * </itemizedlist>
64  */
65
66 #ifdef HAVE_CONFIG_H
67 #  include "config.h"
68 #endif
69
70 #include <string.h>             /* strlen */
71
72 #include "gstaggregator.h"
73
74 typedef enum
75 {
76   GST_AGGREGATOR_START_TIME_SELECTION_ZERO,
77   GST_AGGREGATOR_START_TIME_SELECTION_FIRST,
78   GST_AGGREGATOR_START_TIME_SELECTION_SET
79 } GstAggregatorStartTimeSelection;
80
81 static GType
82 gst_aggregator_start_time_selection_get_type (void)
83 {
84   static GType gtype = 0;
85
86   if (gtype == 0) {
87     static const GEnumValue values[] = {
88       {GST_AGGREGATOR_START_TIME_SELECTION_ZERO,
89           "Start at 0 running time (default)", "zero"},
90       {GST_AGGREGATOR_START_TIME_SELECTION_FIRST,
91           "Start at first observed input running time", "first"},
92       {GST_AGGREGATOR_START_TIME_SELECTION_SET,
93           "Set start time with start-time property", "set"},
94       {0, NULL, NULL}
95     };
96
97     gtype = g_enum_register_static ("GstAggregatorStartTimeSelection", values);
98   }
99   return gtype;
100 }
101
102 /*  Might become API */
103 static void gst_aggregator_merge_tags (GstAggregator * aggregator,
104     const GstTagList * tags, GstTagMergeMode mode);
105 static void gst_aggregator_set_latency_property (GstAggregator * agg,
106     gint64 latency);
107 static gint64 gst_aggregator_get_latency_property (GstAggregator * agg);
108
109
110 /* Locking order, locks in this element must always be taken in this order
111  *
112  * standard sink pad stream lock -> GST_PAD_STREAM_LOCK (aggpad)
113  * Aggregator pad flush lock -> PAD_FLUSH_LOCK(aggpad)
114  * standard src pad stream lock -> GST_PAD_STREAM_LOCK (srcpad)
115  * Aggregator src lock -> SRC_LOCK(agg) w/ SRC_WAIT/BROADCAST
116  * standard element object lock -> GST_OBJECT_LOCK(agg)
117  * Aggregator pad lock -> PAD_LOCK (aggpad) w/ PAD_WAIT/BROADCAST_EVENT(aggpad)
118  * standard src pad object lock -> GST_OBJECT_LOCK(srcpad)
119  * standard sink pad object lock -> GST_OBJECT_LOCK(aggpad)
120  */
121
122
123 static GstClockTime gst_aggregator_get_latency_unlocked (GstAggregator * self);
124
125 GST_DEBUG_CATEGORY_STATIC (aggregator_debug);
126 #define GST_CAT_DEFAULT aggregator_debug
127
128 /* GstAggregatorPad definitions */
129 #define PAD_LOCK(pad)   G_STMT_START {                                  \
130   GST_TRACE_OBJECT (pad, "Taking PAD lock from thread %p",              \
131         g_thread_self());                                               \
132   g_mutex_lock(&pad->priv->lock);                                       \
133   GST_TRACE_OBJECT (pad, "Took PAD lock from thread %p",                \
134         g_thread_self());                                               \
135   } G_STMT_END
136
137 #define PAD_UNLOCK(pad)  G_STMT_START {                                 \
138   GST_TRACE_OBJECT (pad, "Releasing PAD lock from thread %p",           \
139       g_thread_self());                                                 \
140   g_mutex_unlock(&pad->priv->lock);                                     \
141   GST_TRACE_OBJECT (pad, "Release PAD lock from thread %p",             \
142         g_thread_self());                                               \
143   } G_STMT_END
144
145
146 #define PAD_WAIT_EVENT(pad)   G_STMT_START {                            \
147   GST_LOG_OBJECT (pad, "Waiting for buffer to be consumed thread %p",   \
148         g_thread_self());                                               \
149   g_cond_wait(&(((GstAggregatorPad* )pad)->priv->event_cond),           \
150       (&((GstAggregatorPad*)pad)->priv->lock));                         \
151   GST_LOG_OBJECT (pad, "DONE Waiting for buffer to be consumed on thread %p", \
152         g_thread_self());                                               \
153   } G_STMT_END
154
155 #define PAD_BROADCAST_EVENT(pad) G_STMT_START {                        \
156   GST_LOG_OBJECT (pad, "Signaling buffer consumed from thread %p",     \
157         g_thread_self());                                              \
158   g_cond_broadcast(&(((GstAggregatorPad* )pad)->priv->event_cond));    \
159   } G_STMT_END
160
161
162 #define PAD_FLUSH_LOCK(pad)     G_STMT_START {                          \
163   GST_TRACE_OBJECT (pad, "Taking lock from thread %p",                  \
164         g_thread_self());                                               \
165   g_mutex_lock(&pad->priv->flush_lock);                                 \
166   GST_TRACE_OBJECT (pad, "Took lock from thread %p",                    \
167         g_thread_self());                                               \
168   } G_STMT_END
169
170 #define PAD_FLUSH_UNLOCK(pad)   G_STMT_START {                          \
171   GST_TRACE_OBJECT (pad, "Releasing lock from thread %p",               \
172         g_thread_self());                                               \
173   g_mutex_unlock(&pad->priv->flush_lock);                               \
174   GST_TRACE_OBJECT (pad, "Release lock from thread %p",                 \
175         g_thread_self());                                               \
176   } G_STMT_END
177
178 #define SRC_LOCK(self)   G_STMT_START {                             \
179   GST_TRACE_OBJECT (self, "Taking src lock from thread %p",         \
180       g_thread_self());                                             \
181   g_mutex_lock(&self->priv->src_lock);                              \
182   GST_TRACE_OBJECT (self, "Took src lock from thread %p",           \
183         g_thread_self());                                           \
184   } G_STMT_END
185
186 #define SRC_UNLOCK(self)  G_STMT_START {                            \
187   GST_TRACE_OBJECT (self, "Releasing src lock from thread %p",      \
188         g_thread_self());                                           \
189   g_mutex_unlock(&self->priv->src_lock);                            \
190   GST_TRACE_OBJECT (self, "Released src lock from thread %p",       \
191         g_thread_self());                                           \
192   } G_STMT_END
193
194 #define SRC_WAIT(self) G_STMT_START {                               \
195   GST_LOG_OBJECT (self, "Waiting for src on thread %p",             \
196         g_thread_self());                                           \
197   g_cond_wait(&(self->priv->src_cond), &(self->priv->src_lock));    \
198   GST_LOG_OBJECT (self, "DONE Waiting for src on thread %p",        \
199         g_thread_self());                                           \
200   } G_STMT_END
201
202 #define SRC_BROADCAST(self) G_STMT_START {                          \
203     GST_LOG_OBJECT (self, "Signaling src from thread %p",           \
204         g_thread_self());                                           \
205     if (self->priv->aggregate_id)                                   \
206       gst_clock_id_unschedule (self->priv->aggregate_id);           \
207     g_cond_broadcast(&(self->priv->src_cond));                      \
208   } G_STMT_END
209
210 struct _GstAggregatorPadPrivate
211 {
212   /* Following fields are protected by the PAD_LOCK */
213   GstFlowReturn flow_return;
214   gboolean pending_flush_start;
215   gboolean pending_flush_stop;
216   gboolean pending_eos;
217
218   gboolean first_buffer;
219
220   GQueue buffers;
221   guint num_buffers;
222   GstClockTime head_position;
223   GstClockTime tail_position;
224   GstClockTime head_time;
225   GstClockTime tail_time;
226   GstClockTime time_level;
227
228   gboolean eos;
229
230   GMutex lock;
231   GCond event_cond;
232   /* This lock prevents a flush start processing happening while
233    * the chain function is also happening.
234    */
235   GMutex flush_lock;
236 };
237
238 static gboolean
239 gst_aggregator_pad_flush (GstAggregatorPad * aggpad, GstAggregator * agg)
240 {
241   GstAggregatorPadClass *klass = GST_AGGREGATOR_PAD_GET_CLASS (aggpad);
242
243   PAD_LOCK (aggpad);
244   aggpad->priv->pending_eos = FALSE;
245   aggpad->priv->eos = FALSE;
246   aggpad->priv->flow_return = GST_FLOW_OK;
247   GST_OBJECT_LOCK (aggpad);
248   gst_segment_init (&aggpad->segment, GST_FORMAT_UNDEFINED);
249   gst_segment_init (&aggpad->clip_segment, GST_FORMAT_UNDEFINED);
250   GST_OBJECT_UNLOCK (aggpad);
251   aggpad->priv->head_position = GST_CLOCK_TIME_NONE;
252   aggpad->priv->tail_position = GST_CLOCK_TIME_NONE;
253   aggpad->priv->head_time = GST_CLOCK_TIME_NONE;
254   aggpad->priv->tail_time = GST_CLOCK_TIME_NONE;
255   aggpad->priv->time_level = 0;
256   PAD_UNLOCK (aggpad);
257
258   if (klass->flush)
259     return klass->flush (aggpad, agg);
260
261   return TRUE;
262 }
263
264 /*************************************
265  * GstAggregator implementation  *
266  *************************************/
267 static GstElementClass *aggregator_parent_class = NULL;
268
269 /* All members are protected by the object lock unless otherwise noted */
270
271 struct _GstAggregatorPrivate
272 {
273   gint max_padserial;
274
275   /* Our state is >= PAUSED */
276   gboolean running;             /* protected by src_lock */
277
278   gint seqnum;
279   gboolean send_stream_start;   /* protected by srcpad stream lock */
280   gboolean send_segment;
281   gboolean flush_seeking;
282   gboolean pending_flush_start;
283   gboolean send_eos;            /* protected by srcpad stream lock */
284
285   GstCaps *srccaps;             /* protected by the srcpad stream lock */
286
287   GstTagList *tags;
288   gboolean tags_changed;
289
290   gboolean peer_latency_live;   /* protected by src_lock */
291   GstClockTime peer_latency_min;        /* protected by src_lock */
292   GstClockTime peer_latency_max;        /* protected by src_lock */
293   gboolean has_peer_latency;    /* protected by src_lock */
294
295   GstClockTime sub_latency_min; /* protected by src_lock */
296   GstClockTime sub_latency_max; /* protected by src_lock */
297
298   /* aggregate */
299   GstClockID aggregate_id;      /* protected by src_lock */
300   GMutex src_lock;
301   GCond src_cond;
302
303   gboolean first_buffer;        /* protected by object lock */
304   GstAggregatorStartTimeSelection start_time_selection;
305   GstClockTime start_time;
306
307   /* properties */
308   gint64 latency;               /* protected by both src_lock and all pad locks */
309 };
310
311 typedef struct
312 {
313   GstEvent *event;
314   gboolean result;
315   gboolean flush;
316   gboolean only_to_active_pads;
317
318   gboolean one_actually_seeked;
319 } EventData;
320
321 #define DEFAULT_LATENCY              0
322 #define DEFAULT_START_TIME_SELECTION GST_AGGREGATOR_START_TIME_SELECTION_ZERO
323 #define DEFAULT_START_TIME           (-1)
324
325 enum
326 {
327   PROP_0,
328   PROP_LATENCY,
329   PROP_START_TIME_SELECTION,
330   PROP_START_TIME,
331   PROP_LAST
332 };
333
334 static GstFlowReturn gst_aggregator_pad_chain_internal (GstAggregator * self,
335     GstAggregatorPad * aggpad, GstBuffer * buffer, gboolean head);
336
337 /**
338  * gst_aggregator_iterate_sinkpads:
339  * @self: The #GstAggregator
340  * @func: (scope call): The function to call.
341  * @user_data: (closure): The data to pass to @func.
342  *
343  * Iterate the sinkpads of aggregator to call a function on them.
344  *
345  * This method guarantees that @func will be called only once for each
346  * sink pad.
347  */
348 gboolean
349 gst_aggregator_iterate_sinkpads (GstAggregator * self,
350     GstAggregatorPadForeachFunc func, gpointer user_data)
351 {
352   gboolean result = FALSE;
353   GstIterator *iter;
354   gboolean done = FALSE;
355   GValue item = { 0, };
356   GList *seen_pads = NULL;
357
358   iter = gst_element_iterate_sink_pads (GST_ELEMENT (self));
359
360   if (!iter)
361     goto no_iter;
362
363   while (!done) {
364     switch (gst_iterator_next (iter, &item)) {
365       case GST_ITERATOR_OK:
366       {
367         GstAggregatorPad *pad;
368
369         pad = g_value_get_object (&item);
370
371         /* if already pushed, skip. FIXME, find something faster to tag pads */
372         if (pad == NULL || g_list_find (seen_pads, pad)) {
373           g_value_reset (&item);
374           break;
375         }
376
377         GST_LOG_OBJECT (pad, "calling function %s on pad",
378             GST_DEBUG_FUNCPTR_NAME (func));
379
380         result = func (self, pad, user_data);
381
382         done = !result;
383
384         seen_pads = g_list_prepend (seen_pads, pad);
385
386         g_value_reset (&item);
387         break;
388       }
389       case GST_ITERATOR_RESYNC:
390         gst_iterator_resync (iter);
391         break;
392       case GST_ITERATOR_ERROR:
393         GST_ERROR_OBJECT (self,
394             "Could not iterate over internally linked pads");
395         done = TRUE;
396         break;
397       case GST_ITERATOR_DONE:
398         done = TRUE;
399         break;
400     }
401   }
402   g_value_unset (&item);
403   gst_iterator_free (iter);
404
405   if (seen_pads == NULL) {
406     GST_DEBUG_OBJECT (self, "No pad seen");
407     return FALSE;
408   }
409
410   g_list_free (seen_pads);
411
412 no_iter:
413   return result;
414 }
415
416 static gboolean
417 gst_aggregator_pad_queue_is_empty (GstAggregatorPad * pad)
418 {
419   return (g_queue_peek_tail (&pad->priv->buffers) == NULL);
420 }
421
422 static gboolean
423 gst_aggregator_check_pads_ready (GstAggregator * self)
424 {
425   GstAggregatorPad *pad;
426   GList *l, *sinkpads;
427   gboolean have_data = TRUE;
428
429   GST_LOG_OBJECT (self, "checking pads");
430
431   GST_OBJECT_LOCK (self);
432
433   sinkpads = GST_ELEMENT_CAST (self)->sinkpads;
434   if (sinkpads == NULL)
435     goto no_sinkpads;
436
437   for (l = sinkpads; l != NULL; l = l->next) {
438     pad = l->data;
439
440     PAD_LOCK (pad);
441
442     if (gst_aggregator_pad_queue_is_empty (pad)) {
443       if (!pad->priv->eos) {
444         have_data = FALSE;
445
446         /* If not live we need data on all pads, so leave the loop */
447         if (!self->priv->peer_latency_live) {
448           PAD_UNLOCK (pad);
449           goto pad_not_ready;
450         }
451       }
452     } else if (self->priv->peer_latency_live) {
453       /* In live mode, having a single pad with buffers is enough to
454        * generate a start time from it. In non-live mode all pads need
455        * to have a buffer
456        */
457       self->priv->first_buffer = FALSE;
458     }
459
460     PAD_UNLOCK (pad);
461   }
462
463   if (!have_data)
464     goto pad_not_ready;
465
466   self->priv->first_buffer = FALSE;
467
468   GST_OBJECT_UNLOCK (self);
469   GST_LOG_OBJECT (self, "pads are ready");
470   return TRUE;
471
472 no_sinkpads:
473   {
474     GST_LOG_OBJECT (self, "pads not ready: no sink pads");
475     GST_OBJECT_UNLOCK (self);
476     return FALSE;
477   }
478 pad_not_ready:
479   {
480     GST_LOG_OBJECT (pad, "pad not ready to be aggregated yet");
481     GST_OBJECT_UNLOCK (self);
482     return FALSE;
483   }
484 }
485
486 static void
487 gst_aggregator_reset_flow_values (GstAggregator * self)
488 {
489   GST_OBJECT_LOCK (self);
490   self->priv->send_stream_start = TRUE;
491   self->priv->send_segment = TRUE;
492   gst_segment_init (&self->segment, GST_FORMAT_TIME);
493   self->priv->first_buffer = TRUE;
494   GST_OBJECT_UNLOCK (self);
495 }
496
497 static inline void
498 gst_aggregator_push_mandatory_events (GstAggregator * self)
499 {
500   GstAggregatorPrivate *priv = self->priv;
501   GstEvent *segment = NULL;
502   GstEvent *tags = NULL;
503
504   if (self->priv->send_stream_start) {
505     gchar s_id[32];
506
507     GST_INFO_OBJECT (self, "pushing stream start");
508     /* stream-start (FIXME: create id based on input ids) */
509     g_snprintf (s_id, sizeof (s_id), "agg-%08x", g_random_int ());
510     if (!gst_pad_push_event (self->srcpad, gst_event_new_stream_start (s_id))) {
511       GST_WARNING_OBJECT (self->srcpad, "Sending stream start event failed");
512     }
513     self->priv->send_stream_start = FALSE;
514   }
515
516   if (self->priv->srccaps) {
517
518     GST_INFO_OBJECT (self, "pushing caps: %" GST_PTR_FORMAT,
519         self->priv->srccaps);
520     if (!gst_pad_push_event (self->srcpad,
521             gst_event_new_caps (self->priv->srccaps))) {
522       GST_WARNING_OBJECT (self->srcpad, "Sending caps event failed");
523     }
524     gst_caps_unref (self->priv->srccaps);
525     self->priv->srccaps = NULL;
526   }
527
528   GST_OBJECT_LOCK (self);
529   if (self->priv->send_segment && !self->priv->flush_seeking) {
530     segment = gst_event_new_segment (&self->segment);
531
532     if (!self->priv->seqnum)
533       self->priv->seqnum = gst_event_get_seqnum (segment);
534     else
535       gst_event_set_seqnum (segment, self->priv->seqnum);
536     self->priv->send_segment = FALSE;
537
538     GST_DEBUG_OBJECT (self, "pushing segment %" GST_PTR_FORMAT, segment);
539   }
540
541   if (priv->tags && priv->tags_changed && !self->priv->flush_seeking) {
542     tags = gst_event_new_tag (gst_tag_list_ref (priv->tags));
543     priv->tags_changed = FALSE;
544   }
545   GST_OBJECT_UNLOCK (self);
546
547   if (segment)
548     gst_pad_push_event (self->srcpad, segment);
549   if (tags)
550     gst_pad_push_event (self->srcpad, tags);
551
552 }
553
554 /**
555  * gst_aggregator_set_src_caps:
556  * @self: The #GstAggregator
557  * @caps: The #GstCaps to set on the src pad.
558  *
559  * Sets the caps to be used on the src pad.
560  */
561 void
562 gst_aggregator_set_src_caps (GstAggregator * self, GstCaps * caps)
563 {
564   GST_PAD_STREAM_LOCK (self->srcpad);
565   gst_caps_replace (&self->priv->srccaps, caps);
566   gst_aggregator_push_mandatory_events (self);
567   GST_PAD_STREAM_UNLOCK (self->srcpad);
568 }
569
570 /**
571  * gst_aggregator_finish_buffer:
572  * @self: The #GstAggregator
573  * @buffer: (transfer full): the #GstBuffer to push.
574  *
575  * This method will push the provided output buffer downstream. If needed,
576  * mandatory events such as stream-start, caps, and segment events will be
577  * sent before pushing the buffer.
578  */
579 GstFlowReturn
580 gst_aggregator_finish_buffer (GstAggregator * self, GstBuffer * buffer)
581 {
582   gst_aggregator_push_mandatory_events (self);
583
584   GST_OBJECT_LOCK (self);
585   if (!self->priv->flush_seeking && gst_pad_is_active (self->srcpad)) {
586     GST_TRACE_OBJECT (self, "pushing buffer %" GST_PTR_FORMAT, buffer);
587     GST_OBJECT_UNLOCK (self);
588     return gst_pad_push (self->srcpad, buffer);
589   } else {
590     GST_INFO_OBJECT (self, "Not pushing (active: %i, flushing: %i)",
591         self->priv->flush_seeking, gst_pad_is_active (self->srcpad));
592     GST_OBJECT_UNLOCK (self);
593     gst_buffer_unref (buffer);
594     return GST_FLOW_OK;
595   }
596 }
597
598 static void
599 gst_aggregator_push_eos (GstAggregator * self)
600 {
601   GstEvent *event;
602   gst_aggregator_push_mandatory_events (self);
603
604   event = gst_event_new_eos ();
605
606   GST_OBJECT_LOCK (self);
607   self->priv->send_eos = FALSE;
608   gst_event_set_seqnum (event, self->priv->seqnum);
609   GST_OBJECT_UNLOCK (self);
610
611   gst_pad_push_event (self->srcpad, event);
612 }
613
614 static GstClockTime
615 gst_aggregator_get_next_time (GstAggregator * self)
616 {
617   GstAggregatorClass *klass = GST_AGGREGATOR_GET_CLASS (self);
618
619   if (klass->get_next_time)
620     return klass->get_next_time (self);
621
622   return GST_CLOCK_TIME_NONE;
623 }
624
625 static gboolean
626 gst_aggregator_wait_and_check (GstAggregator * self, gboolean * timeout)
627 {
628   GstClockTime latency;
629   GstClockTime start;
630   gboolean res;
631
632   *timeout = FALSE;
633
634   SRC_LOCK (self);
635
636   latency = gst_aggregator_get_latency_unlocked (self);
637
638   if (gst_aggregator_check_pads_ready (self)) {
639     GST_DEBUG_OBJECT (self, "all pads have data");
640     SRC_UNLOCK (self);
641
642     return TRUE;
643   }
644
645   /* Before waiting, check if we're actually still running */
646   if (!self->priv->running || !self->priv->send_eos) {
647     SRC_UNLOCK (self);
648
649     return FALSE;
650   }
651
652   start = gst_aggregator_get_next_time (self);
653
654   /* If we're not live, or if we use the running time
655    * of the first buffer as start time, we wait until
656    * all pads have buffers.
657    * Otherwise (i.e. if we are live!), we wait on the clock
658    * and if a pad does not have a buffer in time we ignore
659    * that pad.
660    */
661   GST_OBJECT_LOCK (self);
662   if (!GST_CLOCK_TIME_IS_VALID (latency) ||
663       !GST_IS_CLOCK (GST_ELEMENT_CLOCK (self)) ||
664       !GST_CLOCK_TIME_IS_VALID (start) ||
665       (self->priv->first_buffer
666           && self->priv->start_time_selection ==
667           GST_AGGREGATOR_START_TIME_SELECTION_FIRST)) {
668     /* We wake up here when something happened, and below
669      * then check if we're ready now. If we return FALSE,
670      * we will be directly called again.
671      */
672     GST_OBJECT_UNLOCK (self);
673     SRC_WAIT (self);
674   } else {
675     GstClockTime base_time, time;
676     GstClock *clock;
677     GstClockReturn status;
678     GstClockTimeDiff jitter;
679
680     GST_DEBUG_OBJECT (self, "got subclass start time: %" GST_TIME_FORMAT,
681         GST_TIME_ARGS (start));
682
683     base_time = GST_ELEMENT_CAST (self)->base_time;
684     clock = gst_object_ref (GST_ELEMENT_CLOCK (self));
685     GST_OBJECT_UNLOCK (self);
686
687     time = base_time + start;
688     time += latency;
689
690     GST_DEBUG_OBJECT (self, "possibly waiting for clock to reach %"
691         GST_TIME_FORMAT " (base %" GST_TIME_FORMAT " start %" GST_TIME_FORMAT
692         " latency %" GST_TIME_FORMAT " current %" GST_TIME_FORMAT ")",
693         GST_TIME_ARGS (time),
694         GST_TIME_ARGS (base_time),
695         GST_TIME_ARGS (start), GST_TIME_ARGS (latency),
696         GST_TIME_ARGS (gst_clock_get_time (clock)));
697
698     self->priv->aggregate_id = gst_clock_new_single_shot_id (clock, time);
699     gst_object_unref (clock);
700     SRC_UNLOCK (self);
701
702     jitter = 0;
703     status = gst_clock_id_wait (self->priv->aggregate_id, &jitter);
704
705     SRC_LOCK (self);
706     if (self->priv->aggregate_id) {
707       gst_clock_id_unref (self->priv->aggregate_id);
708       self->priv->aggregate_id = NULL;
709     }
710
711     GST_DEBUG_OBJECT (self,
712         "clock returned %d (jitter: %" GST_STIME_FORMAT ")",
713         status, GST_STIME_ARGS (jitter));
714
715     /* we timed out */
716     if (status == GST_CLOCK_OK || status == GST_CLOCK_EARLY) {
717       SRC_UNLOCK (self);
718       *timeout = TRUE;
719       return TRUE;
720     }
721   }
722
723   res = gst_aggregator_check_pads_ready (self);
724   SRC_UNLOCK (self);
725
726   return res;
727 }
728
729 static gboolean
730 check_events (GstAggregator * self, GstAggregatorPad * pad, gpointer user_data)
731 {
732   GstEvent *event = NULL;
733   GstAggregatorClass *klass = NULL;
734   gboolean *processed_event = user_data;
735
736   do {
737     event = NULL;
738
739     PAD_LOCK (pad);
740     if (gst_aggregator_pad_queue_is_empty (pad) && pad->priv->pending_eos) {
741       pad->priv->pending_eos = FALSE;
742       pad->priv->eos = TRUE;
743     }
744     if (GST_IS_EVENT (g_queue_peek_tail (&pad->priv->buffers))) {
745       event = g_queue_pop_tail (&pad->priv->buffers);
746       PAD_BROADCAST_EVENT (pad);
747     }
748     PAD_UNLOCK (pad);
749     if (event) {
750       if (processed_event)
751         *processed_event = TRUE;
752       if (klass == NULL)
753         klass = GST_AGGREGATOR_GET_CLASS (self);
754
755       GST_LOG_OBJECT (pad, "Processing %" GST_PTR_FORMAT, event);
756       klass->sink_event (self, pad, event);
757     }
758   } while (event != NULL);
759
760   return TRUE;
761 }
762
763 static void
764 gst_aggregator_pad_set_flushing (GstAggregatorPad * aggpad,
765     GstFlowReturn flow_return, gboolean full)
766 {
767   GList *item;
768
769   PAD_LOCK (aggpad);
770   if (flow_return == GST_FLOW_NOT_LINKED)
771     aggpad->priv->flow_return = MIN (flow_return, aggpad->priv->flow_return);
772   else
773     aggpad->priv->flow_return = flow_return;
774
775   item = g_queue_peek_head_link (&aggpad->priv->buffers);
776   while (item) {
777     GList *next = item->next;
778
779     /* In partial flush, we do like the pad, we get rid of non-sticky events
780      * and EOS/SEGMENT.
781      */
782     if (full || GST_IS_BUFFER (item->data) ||
783         GST_EVENT_TYPE (item->data) == GST_EVENT_EOS ||
784         GST_EVENT_TYPE (item->data) == GST_EVENT_SEGMENT ||
785         !GST_EVENT_IS_STICKY (item->data)) {
786       gst_mini_object_unref (item->data);
787       g_queue_delete_link (&aggpad->priv->buffers, item);
788     }
789     item = next;
790   }
791   aggpad->priv->num_buffers = 0;
792
793   PAD_BROADCAST_EVENT (aggpad);
794   PAD_UNLOCK (aggpad);
795 }
796
797 static void
798 gst_aggregator_aggregate_func (GstAggregator * self)
799 {
800   GstAggregatorPrivate *priv = self->priv;
801   GstAggregatorClass *klass = GST_AGGREGATOR_GET_CLASS (self);
802   gboolean timeout = FALSE;
803
804   if (self->priv->running == FALSE) {
805     GST_DEBUG_OBJECT (self, "Not running anymore");
806     return;
807   }
808
809   GST_LOG_OBJECT (self, "Checking aggregate");
810   while (priv->send_eos && priv->running) {
811     GstFlowReturn flow_return;
812     gboolean processed_event = FALSE;
813
814     gst_aggregator_iterate_sinkpads (self, check_events, NULL);
815
816     if (!gst_aggregator_wait_and_check (self, &timeout))
817       continue;
818
819     gst_aggregator_iterate_sinkpads (self, check_events, &processed_event);
820     if (processed_event)
821       continue;
822
823     GST_TRACE_OBJECT (self, "Actually aggregating!");
824     flow_return = klass->aggregate (self, timeout);
825
826     GST_OBJECT_LOCK (self);
827     if (flow_return == GST_FLOW_FLUSHING && priv->flush_seeking) {
828       /* We don't want to set the pads to flushing, but we want to
829        * stop the thread, so just break here */
830       GST_OBJECT_UNLOCK (self);
831       break;
832     }
833     GST_OBJECT_UNLOCK (self);
834
835     if (flow_return == GST_FLOW_EOS || flow_return == GST_FLOW_ERROR) {
836       gst_aggregator_push_eos (self);
837     }
838
839     GST_LOG_OBJECT (self, "flow return is %s", gst_flow_get_name (flow_return));
840
841     if (flow_return != GST_FLOW_OK) {
842       GList *item;
843
844       GST_OBJECT_LOCK (self);
845       for (item = GST_ELEMENT (self)->sinkpads; item; item = item->next) {
846         GstAggregatorPad *aggpad = GST_AGGREGATOR_PAD (item->data);
847
848         gst_aggregator_pad_set_flushing (aggpad, flow_return, TRUE);
849       }
850       GST_OBJECT_UNLOCK (self);
851       break;
852     }
853   }
854
855   /* Pause the task here, the only ways to get here are:
856    * 1) We're stopping, in which case the task is stopped anyway
857    * 2) We got a flow error above, in which case it might take
858    *    some time to forward the flow return upstream and we
859    *    would otherwise call the task function over and over
860    *    again without doing anything
861    */
862   gst_pad_pause_task (self->srcpad);
863 }
864
865 static gboolean
866 gst_aggregator_start (GstAggregator * self)
867 {
868   GstAggregatorClass *klass;
869   gboolean result;
870
871   self->priv->send_stream_start = TRUE;
872   self->priv->send_segment = TRUE;
873   self->priv->send_eos = TRUE;
874   self->priv->srccaps = NULL;
875
876   klass = GST_AGGREGATOR_GET_CLASS (self);
877
878   if (klass->start)
879     result = klass->start (self);
880   else
881     result = TRUE;
882
883   return result;
884 }
885
886 static gboolean
887 _check_pending_flush_stop (GstAggregatorPad * pad)
888 {
889   gboolean res;
890
891   PAD_LOCK (pad);
892   res = (!pad->priv->pending_flush_stop && !pad->priv->pending_flush_start);
893   PAD_UNLOCK (pad);
894
895   return res;
896 }
897
898 static gboolean
899 gst_aggregator_stop_srcpad_task (GstAggregator * self, GstEvent * flush_start)
900 {
901   gboolean res = TRUE;
902
903   GST_INFO_OBJECT (self, "%s srcpad task",
904       flush_start ? "Pausing" : "Stopping");
905
906   SRC_LOCK (self);
907   self->priv->running = FALSE;
908   SRC_BROADCAST (self);
909   SRC_UNLOCK (self);
910
911   if (flush_start) {
912     res = gst_pad_push_event (self->srcpad, flush_start);
913   }
914
915   gst_pad_stop_task (self->srcpad);
916
917   return res;
918 }
919
920 static void
921 gst_aggregator_start_srcpad_task (GstAggregator * self)
922 {
923   GST_INFO_OBJECT (self, "Starting srcpad task");
924
925   self->priv->running = TRUE;
926   gst_pad_start_task (GST_PAD (self->srcpad),
927       (GstTaskFunction) gst_aggregator_aggregate_func, self, NULL);
928 }
929
930 static GstFlowReturn
931 gst_aggregator_flush (GstAggregator * self)
932 {
933   GstFlowReturn ret = GST_FLOW_OK;
934   GstAggregatorPrivate *priv = self->priv;
935   GstAggregatorClass *klass = GST_AGGREGATOR_GET_CLASS (self);
936
937   GST_DEBUG_OBJECT (self, "Flushing everything");
938   GST_OBJECT_LOCK (self);
939   priv->send_segment = TRUE;
940   priv->flush_seeking = FALSE;
941   priv->tags_changed = FALSE;
942   GST_OBJECT_UNLOCK (self);
943   if (klass->flush)
944     ret = klass->flush (self);
945
946   return ret;
947 }
948
949
950 /* Called with GstAggregator's object lock held */
951
952 static gboolean
953 gst_aggregator_all_flush_stop_received_locked (GstAggregator * self)
954 {
955   GList *tmp;
956   GstAggregatorPad *tmppad;
957
958   for (tmp = GST_ELEMENT (self)->sinkpads; tmp; tmp = tmp->next) {
959     tmppad = (GstAggregatorPad *) tmp->data;
960
961     if (_check_pending_flush_stop (tmppad) == FALSE) {
962       GST_DEBUG_OBJECT (tmppad, "Is not last %i -- %i",
963           tmppad->priv->pending_flush_start, tmppad->priv->pending_flush_stop);
964       return FALSE;
965     }
966   }
967
968   return TRUE;
969 }
970
971 static void
972 gst_aggregator_flush_start (GstAggregator * self, GstAggregatorPad * aggpad,
973     GstEvent * event)
974 {
975   GstAggregatorPrivate *priv = self->priv;
976   GstAggregatorPadPrivate *padpriv = aggpad->priv;
977
978   gst_aggregator_pad_set_flushing (aggpad, GST_FLOW_FLUSHING, FALSE);
979
980   PAD_FLUSH_LOCK (aggpad);
981   PAD_LOCK (aggpad);
982   if (padpriv->pending_flush_start) {
983     GST_DEBUG_OBJECT (aggpad, "Expecting FLUSH_STOP now");
984
985     padpriv->pending_flush_start = FALSE;
986     padpriv->pending_flush_stop = TRUE;
987   }
988   PAD_UNLOCK (aggpad);
989
990   GST_OBJECT_LOCK (self);
991   if (priv->flush_seeking) {
992     /* If flush_seeking we forward the first FLUSH_START */
993     if (priv->pending_flush_start) {
994       priv->pending_flush_start = FALSE;
995       GST_OBJECT_UNLOCK (self);
996
997       GST_INFO_OBJECT (self, "Flushing, pausing srcpad task");
998       gst_aggregator_stop_srcpad_task (self, event);
999
1000       GST_INFO_OBJECT (self, "Getting STREAM_LOCK while seeking");
1001       GST_PAD_STREAM_LOCK (self->srcpad);
1002       GST_LOG_OBJECT (self, "GOT STREAM_LOCK");
1003       event = NULL;
1004     } else {
1005       GST_OBJECT_UNLOCK (self);
1006       gst_event_unref (event);
1007     }
1008   } else {
1009     GST_OBJECT_UNLOCK (self);
1010     gst_event_unref (event);
1011   }
1012   PAD_FLUSH_UNLOCK (aggpad);
1013 }
1014
1015 /* Must be called with the the PAD_LOCK held */
1016 static void
1017 update_time_level (GstAggregatorPad * aggpad, gboolean head)
1018 {
1019   if (head) {
1020     if (GST_CLOCK_TIME_IS_VALID (aggpad->priv->head_position) &&
1021         aggpad->clip_segment.format == GST_FORMAT_TIME)
1022       aggpad->priv->head_time =
1023           gst_segment_to_running_time (&aggpad->clip_segment,
1024           GST_FORMAT_TIME, aggpad->priv->head_position);
1025     else
1026       aggpad->priv->head_time = GST_CLOCK_TIME_NONE;
1027   } else {
1028     if (GST_CLOCK_TIME_IS_VALID (aggpad->priv->tail_position) &&
1029         aggpad->segment.format == GST_FORMAT_TIME)
1030       aggpad->priv->tail_time =
1031           gst_segment_to_running_time (&aggpad->segment,
1032           GST_FORMAT_TIME, aggpad->priv->tail_position);
1033     else
1034       aggpad->priv->tail_time = aggpad->priv->head_time;
1035   }
1036
1037   if (aggpad->priv->head_time == GST_CLOCK_TIME_NONE ||
1038       aggpad->priv->tail_time == GST_CLOCK_TIME_NONE) {
1039     aggpad->priv->time_level = 0;
1040     return;
1041   }
1042
1043   if (aggpad->priv->tail_time > aggpad->priv->head_time)
1044     aggpad->priv->time_level = 0;
1045   else
1046     aggpad->priv->time_level = aggpad->priv->head_time -
1047         aggpad->priv->tail_time;
1048 }
1049
1050
1051 /* GstAggregator vmethods default implementations */
1052 static gboolean
1053 gst_aggregator_default_sink_event (GstAggregator * self,
1054     GstAggregatorPad * aggpad, GstEvent * event)
1055 {
1056   gboolean res = TRUE;
1057   GstPad *pad = GST_PAD (aggpad);
1058   GstAggregatorPrivate *priv = self->priv;
1059
1060   switch (GST_EVENT_TYPE (event)) {
1061     case GST_EVENT_FLUSH_START:
1062     {
1063       gst_aggregator_flush_start (self, aggpad, event);
1064       /* We forward only in one case: right after flush_seeking */
1065       event = NULL;
1066       goto eat;
1067     }
1068     case GST_EVENT_FLUSH_STOP:
1069     {
1070       GST_DEBUG_OBJECT (aggpad, "Got FLUSH_STOP");
1071
1072       gst_aggregator_pad_flush (aggpad, self);
1073       GST_OBJECT_LOCK (self);
1074       if (priv->flush_seeking) {
1075         g_atomic_int_set (&aggpad->priv->pending_flush_stop, FALSE);
1076         if (gst_aggregator_all_flush_stop_received_locked (self)) {
1077           GST_OBJECT_UNLOCK (self);
1078           /* That means we received FLUSH_STOP/FLUSH_STOP on
1079            * all sinkpads -- Seeking is Done... sending FLUSH_STOP */
1080           gst_aggregator_flush (self);
1081           gst_pad_push_event (self->srcpad, event);
1082           event = NULL;
1083           SRC_LOCK (self);
1084           priv->send_eos = TRUE;
1085           SRC_BROADCAST (self);
1086           SRC_UNLOCK (self);
1087
1088           GST_INFO_OBJECT (self, "Releasing source pad STREAM_LOCK");
1089           GST_PAD_STREAM_UNLOCK (self->srcpad);
1090           gst_aggregator_start_srcpad_task (self);
1091         } else {
1092           GST_OBJECT_UNLOCK (self);
1093         }
1094       } else {
1095         GST_OBJECT_UNLOCK (self);
1096       }
1097
1098       aggpad->priv->first_buffer = TRUE;
1099
1100       /* We never forward the event */
1101       goto eat;
1102     }
1103     case GST_EVENT_EOS:
1104     {
1105       GST_DEBUG_OBJECT (aggpad, "EOS");
1106
1107       /* We still have a buffer, and we don't want the subclass to have to
1108        * check for it. Mark pending_eos, eos will be set when steal_buffer is
1109        * called
1110        */
1111       SRC_LOCK (self);
1112       PAD_LOCK (aggpad);
1113       if (gst_aggregator_pad_queue_is_empty (aggpad)) {
1114         aggpad->priv->eos = TRUE;
1115       } else {
1116         aggpad->priv->pending_eos = TRUE;
1117       }
1118       PAD_UNLOCK (aggpad);
1119
1120       SRC_BROADCAST (self);
1121       SRC_UNLOCK (self);
1122       goto eat;
1123     }
1124     case GST_EVENT_SEGMENT:
1125     {
1126       PAD_LOCK (aggpad);
1127       GST_OBJECT_LOCK (aggpad);
1128       gst_event_copy_segment (event, &aggpad->segment);
1129       update_time_level (aggpad, FALSE);
1130       GST_OBJECT_UNLOCK (aggpad);
1131       PAD_UNLOCK (aggpad);
1132
1133       GST_OBJECT_LOCK (self);
1134       self->priv->seqnum = gst_event_get_seqnum (event);
1135       GST_OBJECT_UNLOCK (self);
1136       goto eat;
1137     }
1138     case GST_EVENT_STREAM_START:
1139     {
1140       goto eat;
1141     }
1142     case GST_EVENT_GAP:
1143     {
1144       GstClockTime pts, endpts;
1145       GstClockTime duration;
1146       GstBuffer *gapbuf;
1147
1148       gst_event_parse_gap (event, &pts, &duration);
1149       gapbuf = gst_buffer_new ();
1150
1151       if (GST_CLOCK_TIME_IS_VALID (duration))
1152         endpts = pts + duration;
1153       else
1154         endpts = GST_CLOCK_TIME_NONE;
1155
1156       GST_OBJECT_LOCK (aggpad);
1157       res = gst_segment_clip (&aggpad->segment, GST_FORMAT_TIME, pts, endpts,
1158           &pts, &endpts);
1159       GST_OBJECT_UNLOCK (aggpad);
1160
1161       if (!res) {
1162         GST_WARNING_OBJECT (self, "GAP event outside segment, dropping");
1163         goto eat;
1164       }
1165
1166       if (GST_CLOCK_TIME_IS_VALID (endpts) && GST_CLOCK_TIME_IS_VALID (pts))
1167         duration = endpts - pts;
1168       else
1169         duration = GST_CLOCK_TIME_NONE;
1170
1171       GST_BUFFER_PTS (gapbuf) = pts;
1172       GST_BUFFER_DURATION (gapbuf) = duration;
1173       GST_BUFFER_FLAG_SET (gapbuf, GST_BUFFER_FLAG_GAP);
1174       GST_BUFFER_FLAG_SET (gapbuf, GST_BUFFER_FLAG_DROPPABLE);
1175
1176       if (gst_aggregator_pad_chain_internal (self, aggpad, gapbuf, FALSE) !=
1177           GST_FLOW_OK) {
1178         GST_WARNING_OBJECT (self, "Failed to chain gap buffer");
1179         res = FALSE;
1180       }
1181
1182       goto eat;
1183     }
1184     case GST_EVENT_TAG:
1185     {
1186       GstTagList *tags;
1187
1188       gst_event_parse_tag (event, &tags);
1189
1190       if (gst_tag_list_get_scope (tags) == GST_TAG_SCOPE_STREAM) {
1191         gst_aggregator_merge_tags (self, tags, GST_TAG_MERGE_REPLACE);
1192         gst_event_unref (event);
1193         event = NULL;
1194         goto eat;
1195       }
1196       break;
1197     }
1198     default:
1199     {
1200       break;
1201     }
1202   }
1203
1204   GST_DEBUG_OBJECT (pad, "Forwarding event: %" GST_PTR_FORMAT, event);
1205   return gst_pad_event_default (pad, GST_OBJECT (self), event);
1206
1207 eat:
1208   GST_DEBUG_OBJECT (pad, "Eating event: %" GST_PTR_FORMAT, event);
1209   if (event)
1210     gst_event_unref (event);
1211
1212   return res;
1213 }
1214
1215 static inline gboolean
1216 gst_aggregator_stop_pad (GstAggregator * self, GstAggregatorPad * pad,
1217     gpointer unused_udata)
1218 {
1219   gst_aggregator_pad_flush (pad, self);
1220
1221   return TRUE;
1222 }
1223
1224 static gboolean
1225 gst_aggregator_stop (GstAggregator * agg)
1226 {
1227   GstAggregatorClass *klass;
1228   gboolean result;
1229
1230   gst_aggregator_reset_flow_values (agg);
1231
1232   gst_aggregator_iterate_sinkpads (agg, gst_aggregator_stop_pad, NULL);
1233
1234   klass = GST_AGGREGATOR_GET_CLASS (agg);
1235
1236   if (klass->stop)
1237     result = klass->stop (agg);
1238   else
1239     result = TRUE;
1240
1241   agg->priv->has_peer_latency = FALSE;
1242   agg->priv->peer_latency_live = FALSE;
1243   agg->priv->peer_latency_min = agg->priv->peer_latency_max = FALSE;
1244
1245   if (agg->priv->tags)
1246     gst_tag_list_unref (agg->priv->tags);
1247   agg->priv->tags = NULL;
1248
1249   return result;
1250 }
1251
1252 /* GstElement vmethods implementations */
1253 static GstStateChangeReturn
1254 gst_aggregator_change_state (GstElement * element, GstStateChange transition)
1255 {
1256   GstStateChangeReturn ret;
1257   GstAggregator *self = GST_AGGREGATOR (element);
1258
1259   switch (transition) {
1260     case GST_STATE_CHANGE_READY_TO_PAUSED:
1261       if (!gst_aggregator_start (self))
1262         goto error_start;
1263       break;
1264     default:
1265       break;
1266   }
1267
1268   if ((ret =
1269           GST_ELEMENT_CLASS (aggregator_parent_class)->change_state (element,
1270               transition)) == GST_STATE_CHANGE_FAILURE)
1271     goto failure;
1272
1273
1274   switch (transition) {
1275     case GST_STATE_CHANGE_PAUSED_TO_READY:
1276       if (!gst_aggregator_stop (self)) {
1277         /* What to do in this case? Error out? */
1278         GST_ERROR_OBJECT (self, "Subclass failed to stop.");
1279       }
1280       break;
1281     default:
1282       break;
1283   }
1284
1285   return ret;
1286
1287 /* ERRORS */
1288 failure:
1289   {
1290     GST_ERROR_OBJECT (element, "parent failed state change");
1291     return ret;
1292   }
1293 error_start:
1294   {
1295     GST_ERROR_OBJECT (element, "Subclass failed to start");
1296     return GST_STATE_CHANGE_FAILURE;
1297   }
1298 }
1299
1300 static void
1301 gst_aggregator_release_pad (GstElement * element, GstPad * pad)
1302 {
1303   GstAggregator *self = GST_AGGREGATOR (element);
1304   GstAggregatorPad *aggpad = GST_AGGREGATOR_PAD (pad);
1305
1306   GST_INFO_OBJECT (pad, "Removing pad");
1307
1308   SRC_LOCK (self);
1309   gst_aggregator_pad_set_flushing (aggpad, GST_FLOW_FLUSHING, TRUE);
1310   gst_element_remove_pad (element, pad);
1311
1312   self->priv->has_peer_latency = FALSE;
1313   SRC_BROADCAST (self);
1314   SRC_UNLOCK (self);
1315 }
1316
1317 static GstAggregatorPad *
1318 gst_aggregator_default_create_new_pad (GstAggregator * self,
1319     GstPadTemplate * templ, const gchar * req_name, const GstCaps * caps)
1320 {
1321   GstAggregatorPad *agg_pad;
1322   GstAggregatorPrivate *priv = self->priv;
1323   gint serial = 0;
1324   gchar *name = NULL;
1325
1326   if (templ->direction != GST_PAD_SINK ||
1327       g_strcmp0 (templ->name_template, "sink_%u") != 0)
1328     goto not_sink;
1329
1330   GST_OBJECT_LOCK (self);
1331   if (req_name == NULL || strlen (req_name) < 6
1332       || !g_str_has_prefix (req_name, "sink_")) {
1333     /* no name given when requesting the pad, use next available int */
1334     serial = ++priv->max_padserial;
1335   } else {
1336     /* parse serial number from requested padname */
1337     serial = g_ascii_strtoull (&req_name[5], NULL, 10);
1338     if (serial > priv->max_padserial)
1339       priv->max_padserial = serial;
1340   }
1341
1342   name = g_strdup_printf ("sink_%u", serial);
1343   agg_pad = g_object_new (GST_AGGREGATOR_GET_CLASS (self)->sinkpads_type,
1344       "name", name, "direction", GST_PAD_SINK, "template", templ, NULL);
1345   g_free (name);
1346
1347   GST_OBJECT_UNLOCK (self);
1348
1349   return agg_pad;
1350
1351   /* errors */
1352 not_sink:
1353   {
1354     GST_WARNING_OBJECT (self, "request new pad that is not a SINK pad\n");
1355     return NULL;
1356   }
1357 }
1358
1359 static GstPad *
1360 gst_aggregator_request_new_pad (GstElement * element,
1361     GstPadTemplate * templ, const gchar * req_name, const GstCaps * caps)
1362 {
1363   GstAggregator *self;
1364   GstAggregatorPad *agg_pad;
1365   GstAggregatorClass *klass = GST_AGGREGATOR_GET_CLASS (element);
1366   GstAggregatorPrivate *priv = GST_AGGREGATOR (element)->priv;
1367
1368   self = GST_AGGREGATOR (element);
1369
1370   agg_pad = klass->create_new_pad (self, templ, req_name, caps);
1371   if (!agg_pad) {
1372     GST_ERROR_OBJECT (element, "Couldn't create new pad");
1373     return NULL;
1374   }
1375
1376   GST_DEBUG_OBJECT (element, "Adding pad %s", GST_PAD_NAME (agg_pad));
1377   self->priv->has_peer_latency = FALSE;
1378
1379   if (priv->running)
1380     gst_pad_set_active (GST_PAD (agg_pad), TRUE);
1381
1382   /* add the pad to the element */
1383   gst_element_add_pad (element, GST_PAD (agg_pad));
1384
1385   return GST_PAD (agg_pad);
1386 }
1387
1388 /* Must be called with SRC_LOCK held */
1389
1390 static gboolean
1391 gst_aggregator_query_latency_unlocked (GstAggregator * self, GstQuery * query)
1392 {
1393   gboolean query_ret, live;
1394   GstClockTime our_latency, min, max;
1395
1396   query_ret = gst_pad_query_default (self->srcpad, GST_OBJECT (self), query);
1397
1398   if (!query_ret) {
1399     GST_WARNING_OBJECT (self, "Latency query failed");
1400     return FALSE;
1401   }
1402
1403   gst_query_parse_latency (query, &live, &min, &max);
1404
1405   our_latency = self->priv->latency;
1406
1407   if (G_UNLIKELY (!GST_CLOCK_TIME_IS_VALID (min))) {
1408     GST_ERROR_OBJECT (self, "Invalid minimum latency %" GST_TIME_FORMAT
1409         ". Please file a bug at " PACKAGE_BUGREPORT ".", GST_TIME_ARGS (min));
1410     return FALSE;
1411   }
1412
1413   if (min > max && GST_CLOCK_TIME_IS_VALID (max)) {
1414     GST_ELEMENT_WARNING (self, CORE, CLOCK, (NULL),
1415         ("Impossible to configure latency: max %" GST_TIME_FORMAT " < min %"
1416             GST_TIME_FORMAT ". Add queues or other buffering elements.",
1417             GST_TIME_ARGS (max), GST_TIME_ARGS (min)));
1418     return FALSE;
1419   }
1420
1421   self->priv->peer_latency_live = live;
1422   self->priv->peer_latency_min = min;
1423   self->priv->peer_latency_max = max;
1424   self->priv->has_peer_latency = TRUE;
1425
1426   /* add our own */
1427   min += our_latency;
1428   min += self->priv->sub_latency_min;
1429   if (GST_CLOCK_TIME_IS_VALID (self->priv->sub_latency_max)
1430       && GST_CLOCK_TIME_IS_VALID (max))
1431     max += self->priv->sub_latency_max + our_latency;
1432   else
1433     max = GST_CLOCK_TIME_NONE;
1434
1435   SRC_BROADCAST (self);
1436
1437   GST_DEBUG_OBJECT (self, "configured latency live:%s min:%" G_GINT64_FORMAT
1438       " max:%" G_GINT64_FORMAT, live ? "true" : "false", min, max);
1439
1440   gst_query_set_latency (query, live, min, max);
1441
1442   return query_ret;
1443 }
1444
1445 /*
1446  * MUST be called with the src_lock held.
1447  *
1448  * See  gst_aggregator_get_latency() for doc
1449  */
1450 static GstClockTime
1451 gst_aggregator_get_latency_unlocked (GstAggregator * self)
1452 {
1453   GstClockTime latency;
1454
1455   g_return_val_if_fail (GST_IS_AGGREGATOR (self), 0);
1456
1457   if (!self->priv->has_peer_latency) {
1458     GstQuery *query = gst_query_new_latency ();
1459     gboolean ret;
1460
1461     ret = gst_aggregator_query_latency_unlocked (self, query);
1462     gst_query_unref (query);
1463     if (!ret)
1464       return GST_CLOCK_TIME_NONE;
1465   }
1466
1467   if (!self->priv->has_peer_latency || !self->priv->peer_latency_live)
1468     return GST_CLOCK_TIME_NONE;
1469
1470   /* latency_min is never GST_CLOCK_TIME_NONE by construction */
1471   latency = self->priv->peer_latency_min;
1472
1473   /* add our own */
1474   latency += self->priv->latency;
1475   latency += self->priv->sub_latency_min;
1476
1477   return latency;
1478 }
1479
1480 /**
1481  * gst_aggregator_get_latency:
1482  * @self: a #GstAggregator
1483  *
1484  * Retrieves the latency values reported by @self in response to the latency
1485  * query, or %GST_CLOCK_TIME_NONE if there is not live source connected and the element
1486  * will not wait for the clock.
1487  *
1488  * Typically only called by subclasses.
1489  *
1490  * Returns: The latency or %GST_CLOCK_TIME_NONE if the element does not sync
1491  */
1492 GstClockTime
1493 gst_aggregator_get_latency (GstAggregator * self)
1494 {
1495   GstClockTime ret;
1496
1497   SRC_LOCK (self);
1498   ret = gst_aggregator_get_latency_unlocked (self);
1499   SRC_UNLOCK (self);
1500
1501   return ret;
1502 }
1503
1504 static gboolean
1505 gst_aggregator_send_event (GstElement * element, GstEvent * event)
1506 {
1507   GstAggregator *self = GST_AGGREGATOR (element);
1508
1509   GST_STATE_LOCK (element);
1510   if (GST_EVENT_TYPE (event) == GST_EVENT_SEEK &&
1511       GST_STATE (element) < GST_STATE_PAUSED) {
1512     gdouble rate;
1513     GstFormat fmt;
1514     GstSeekFlags flags;
1515     GstSeekType start_type, stop_type;
1516     gint64 start, stop;
1517
1518     gst_event_parse_seek (event, &rate, &fmt, &flags, &start_type,
1519         &start, &stop_type, &stop);
1520
1521     GST_OBJECT_LOCK (self);
1522     gst_segment_do_seek (&self->segment, rate, fmt, flags, start_type, start,
1523         stop_type, stop, NULL);
1524     self->priv->seqnum = gst_event_get_seqnum (event);
1525     self->priv->first_buffer = FALSE;
1526     GST_OBJECT_UNLOCK (self);
1527
1528     GST_DEBUG_OBJECT (element, "Storing segment %" GST_PTR_FORMAT, event);
1529   }
1530   GST_STATE_UNLOCK (element);
1531
1532
1533   return GST_ELEMENT_CLASS (aggregator_parent_class)->send_event (element,
1534       event);
1535 }
1536
1537 static gboolean
1538 gst_aggregator_default_src_query (GstAggregator * self, GstQuery * query)
1539 {
1540   gboolean res = TRUE;
1541
1542   switch (GST_QUERY_TYPE (query)) {
1543     case GST_QUERY_SEEKING:
1544     {
1545       GstFormat format;
1546
1547       /* don't pass it along as some (file)sink might claim it does
1548        * whereas with a collectpads in between that will not likely work */
1549       gst_query_parse_seeking (query, &format, NULL, NULL, NULL);
1550       gst_query_set_seeking (query, format, FALSE, 0, -1);
1551       res = TRUE;
1552
1553       break;
1554     }
1555     case GST_QUERY_LATENCY:
1556       SRC_LOCK (self);
1557       res = gst_aggregator_query_latency_unlocked (self, query);
1558       SRC_UNLOCK (self);
1559       break;
1560     default:
1561       return gst_pad_query_default (self->srcpad, GST_OBJECT (self), query);
1562   }
1563
1564   return res;
1565 }
1566
1567 static gboolean
1568 gst_aggregator_event_forward_func (GstPad * pad, gpointer user_data)
1569 {
1570   EventData *evdata = user_data;
1571   gboolean ret = TRUE;
1572   GstPad *peer = gst_pad_get_peer (pad);
1573   GstAggregatorPad *aggpad = GST_AGGREGATOR_PAD (pad);
1574
1575   if (peer) {
1576     if (evdata->only_to_active_pads && aggpad->priv->first_buffer) {
1577       GST_DEBUG_OBJECT (pad, "not sending event to inactive pad");
1578       ret = TRUE;
1579     } else {
1580       ret = gst_pad_send_event (peer, gst_event_ref (evdata->event));
1581       GST_DEBUG_OBJECT (pad, "return of event push is %d", ret);
1582       gst_object_unref (peer);
1583     }
1584   }
1585
1586   if (ret == FALSE) {
1587     if (GST_EVENT_TYPE (evdata->event) == GST_EVENT_SEEK) {
1588       GstQuery *seeking = gst_query_new_seeking (GST_FORMAT_TIME);
1589
1590       GST_DEBUG_OBJECT (pad, "Event %" GST_PTR_FORMAT " failed", evdata->event);
1591
1592       if (gst_pad_query (peer, seeking)) {
1593         gboolean seekable;
1594
1595         gst_query_parse_seeking (seeking, NULL, &seekable, NULL, NULL);
1596
1597         if (seekable == FALSE) {
1598           GST_INFO_OBJECT (pad,
1599               "Source not seekable, We failed but it does not matter!");
1600
1601           ret = TRUE;
1602         }
1603       } else {
1604         GST_ERROR_OBJECT (pad, "Query seeking FAILED");
1605       }
1606
1607       gst_query_unref (seeking);
1608     }
1609
1610     if (evdata->flush) {
1611       PAD_LOCK (aggpad);
1612       aggpad->priv->pending_flush_start = FALSE;
1613       aggpad->priv->pending_flush_stop = FALSE;
1614       PAD_UNLOCK (aggpad);
1615     }
1616   } else {
1617     evdata->one_actually_seeked = TRUE;
1618   }
1619
1620   evdata->result &= ret;
1621
1622   /* Always send to all pads */
1623   return FALSE;
1624 }
1625
1626 static EventData
1627 gst_aggregator_forward_event_to_all_sinkpads (GstAggregator * self,
1628     GstEvent * event, gboolean flush, gboolean only_to_active_pads)
1629 {
1630   EventData evdata;
1631
1632   evdata.event = event;
1633   evdata.result = TRUE;
1634   evdata.flush = flush;
1635   evdata.one_actually_seeked = FALSE;
1636   evdata.only_to_active_pads = only_to_active_pads;
1637
1638   /* We first need to set all pads as flushing in a first pass
1639    * as flush_start flush_stop is sometimes sent synchronously
1640    * while we send the seek event */
1641   if (flush) {
1642     GList *l;
1643
1644     GST_OBJECT_LOCK (self);
1645     for (l = GST_ELEMENT_CAST (self)->sinkpads; l != NULL; l = l->next) {
1646       GstAggregatorPad *pad = l->data;
1647
1648       PAD_LOCK (pad);
1649       pad->priv->pending_flush_start = TRUE;
1650       pad->priv->pending_flush_stop = FALSE;
1651       PAD_UNLOCK (pad);
1652     }
1653     GST_OBJECT_UNLOCK (self);
1654   }
1655
1656   gst_pad_forward (self->srcpad, gst_aggregator_event_forward_func, &evdata);
1657
1658   gst_event_unref (event);
1659
1660   return evdata;
1661 }
1662
1663 static gboolean
1664 gst_aggregator_do_seek (GstAggregator * self, GstEvent * event)
1665 {
1666   gdouble rate;
1667   GstFormat fmt;
1668   GstSeekFlags flags;
1669   GstSeekType start_type, stop_type;
1670   gint64 start, stop;
1671   gboolean flush;
1672   EventData evdata;
1673   GstAggregatorPrivate *priv = self->priv;
1674
1675   gst_event_parse_seek (event, &rate, &fmt, &flags, &start_type,
1676       &start, &stop_type, &stop);
1677
1678   GST_INFO_OBJECT (self, "starting SEEK");
1679
1680   flush = flags & GST_SEEK_FLAG_FLUSH;
1681
1682   GST_OBJECT_LOCK (self);
1683   if (flush) {
1684     priv->pending_flush_start = TRUE;
1685     priv->flush_seeking = TRUE;
1686   }
1687
1688   gst_segment_do_seek (&self->segment, rate, fmt, flags, start_type, start,
1689       stop_type, stop, NULL);
1690
1691   /* Seeking sets a position */
1692   self->priv->first_buffer = FALSE;
1693   GST_OBJECT_UNLOCK (self);
1694
1695   /* forward the seek upstream */
1696   evdata =
1697       gst_aggregator_forward_event_to_all_sinkpads (self, event, flush, FALSE);
1698   event = NULL;
1699
1700   if (!evdata.result || !evdata.one_actually_seeked) {
1701     GST_OBJECT_LOCK (self);
1702     priv->flush_seeking = FALSE;
1703     priv->pending_flush_start = FALSE;
1704     GST_OBJECT_UNLOCK (self);
1705   }
1706
1707   GST_INFO_OBJECT (self, "seek done, result: %d", evdata.result);
1708
1709   return evdata.result;
1710 }
1711
1712 static gboolean
1713 gst_aggregator_default_src_event (GstAggregator * self, GstEvent * event)
1714 {
1715   EventData evdata;
1716   gboolean res = TRUE;
1717
1718   switch (GST_EVENT_TYPE (event)) {
1719     case GST_EVENT_SEEK:
1720     {
1721       gst_event_ref (event);
1722       res = gst_aggregator_do_seek (self, event);
1723       gst_event_unref (event);
1724       event = NULL;
1725       goto done;
1726     }
1727     case GST_EVENT_NAVIGATION:
1728     {
1729       /* navigation is rather pointless. */
1730       res = FALSE;
1731       gst_event_unref (event);
1732       goto done;
1733     }
1734     default:
1735     {
1736       break;
1737     }
1738   }
1739
1740   /* Don't forward QOS events to pads that had no active buffer yet. Otherwise
1741    * they will receive a QOS event that has earliest_time=0 (because we can't
1742    * have negative timestamps), and consider their buffer as too late */
1743   evdata =
1744       gst_aggregator_forward_event_to_all_sinkpads (self, event, FALSE,
1745       GST_EVENT_TYPE (event) == GST_EVENT_QOS);
1746   res = evdata.result;
1747
1748 done:
1749   return res;
1750 }
1751
1752 static gboolean
1753 gst_aggregator_src_pad_event_func (GstPad * pad, GstObject * parent,
1754     GstEvent * event)
1755 {
1756   GstAggregatorClass *klass = GST_AGGREGATOR_GET_CLASS (parent);
1757
1758   return klass->src_event (GST_AGGREGATOR (parent), event);
1759 }
1760
1761 static gboolean
1762 gst_aggregator_src_pad_query_func (GstPad * pad, GstObject * parent,
1763     GstQuery * query)
1764 {
1765   GstAggregatorClass *klass = GST_AGGREGATOR_GET_CLASS (parent);
1766
1767   return klass->src_query (GST_AGGREGATOR (parent), query);
1768 }
1769
1770 static gboolean
1771 gst_aggregator_src_pad_activate_mode_func (GstPad * pad,
1772     GstObject * parent, GstPadMode mode, gboolean active)
1773 {
1774   GstAggregator *self = GST_AGGREGATOR (parent);
1775   GstAggregatorClass *klass = GST_AGGREGATOR_GET_CLASS (parent);
1776
1777   if (klass->src_activate) {
1778     if (klass->src_activate (self, mode, active) == FALSE) {
1779       return FALSE;
1780     }
1781   }
1782
1783   if (active == TRUE) {
1784     switch (mode) {
1785       case GST_PAD_MODE_PUSH:
1786       {
1787         GST_INFO_OBJECT (pad, "Activating pad!");
1788         gst_aggregator_start_srcpad_task (self);
1789         return TRUE;
1790       }
1791       default:
1792       {
1793         GST_ERROR_OBJECT (pad, "Only supported mode is PUSH");
1794         return FALSE;
1795       }
1796     }
1797   }
1798
1799   /* deactivating */
1800   GST_INFO_OBJECT (self, "Deactivating srcpad");
1801   gst_aggregator_stop_srcpad_task (self, FALSE);
1802
1803   return TRUE;
1804 }
1805
1806 static gboolean
1807 gst_aggregator_default_sink_query (GstAggregator * self,
1808     GstAggregatorPad * aggpad, GstQuery * query)
1809 {
1810   GstPad *pad = GST_PAD (aggpad);
1811
1812   return gst_pad_query_default (pad, GST_OBJECT (self), query);
1813 }
1814
1815 static void
1816 gst_aggregator_finalize (GObject * object)
1817 {
1818   GstAggregator *self = (GstAggregator *) object;
1819
1820   g_mutex_clear (&self->priv->src_lock);
1821   g_cond_clear (&self->priv->src_cond);
1822
1823   G_OBJECT_CLASS (aggregator_parent_class)->finalize (object);
1824 }
1825
1826 /*
1827  * gst_aggregator_set_latency_property:
1828  * @agg: a #GstAggregator
1829  * @latency: the new latency value (in nanoseconds).
1830  *
1831  * Sets the new latency value to @latency. This value is used to limit the
1832  * amount of time a pad waits for data to appear before considering the pad
1833  * as unresponsive.
1834  */
1835 static void
1836 gst_aggregator_set_latency_property (GstAggregator * self, gint64 latency)
1837 {
1838   gboolean changed;
1839
1840   g_return_if_fail (GST_IS_AGGREGATOR (self));
1841   g_return_if_fail (GST_CLOCK_TIME_IS_VALID (latency));
1842
1843   SRC_LOCK (self);
1844   changed = (self->priv->latency != latency);
1845
1846   if (changed) {
1847     GList *item;
1848
1849     GST_OBJECT_LOCK (self);
1850     /* First lock all the pads */
1851     for (item = GST_ELEMENT_CAST (self)->sinkpads; item; item = item->next) {
1852       GstAggregatorPad *aggpad = GST_AGGREGATOR_PAD (item->data);
1853       PAD_LOCK (aggpad);
1854     }
1855
1856     self->priv->latency = latency;
1857
1858     SRC_BROADCAST (self);
1859
1860     /* Now wake up the pads */
1861     for (item = GST_ELEMENT_CAST (self)->sinkpads; item; item = item->next) {
1862       GstAggregatorPad *aggpad = GST_AGGREGATOR_PAD (item->data);
1863       PAD_BROADCAST_EVENT (aggpad);
1864       PAD_UNLOCK (aggpad);
1865     }
1866     GST_OBJECT_UNLOCK (self);
1867   }
1868
1869   SRC_UNLOCK (self);
1870
1871   if (changed)
1872     gst_element_post_message (GST_ELEMENT_CAST (self),
1873         gst_message_new_latency (GST_OBJECT_CAST (self)));
1874 }
1875
1876 /*
1877  * gst_aggregator_get_latency_property:
1878  * @agg: a #GstAggregator
1879  *
1880  * Gets the latency value. See gst_aggregator_set_latency for
1881  * more details.
1882  *
1883  * Returns: The time in nanoseconds to wait for data to arrive on a sink pad
1884  * before a pad is deemed unresponsive. A value of -1 means an
1885  * unlimited time.
1886  */
1887 static gint64
1888 gst_aggregator_get_latency_property (GstAggregator * agg)
1889 {
1890   gint64 res;
1891
1892   g_return_val_if_fail (GST_IS_AGGREGATOR (agg), -1);
1893
1894   GST_OBJECT_LOCK (agg);
1895   res = agg->priv->latency;
1896   GST_OBJECT_UNLOCK (agg);
1897
1898   return res;
1899 }
1900
1901 static void
1902 gst_aggregator_set_property (GObject * object, guint prop_id,
1903     const GValue * value, GParamSpec * pspec)
1904 {
1905   GstAggregator *agg = GST_AGGREGATOR (object);
1906
1907   switch (prop_id) {
1908     case PROP_LATENCY:
1909       gst_aggregator_set_latency_property (agg, g_value_get_int64 (value));
1910       break;
1911     case PROP_START_TIME_SELECTION:
1912       agg->priv->start_time_selection = g_value_get_enum (value);
1913       break;
1914     case PROP_START_TIME:
1915       agg->priv->start_time = g_value_get_uint64 (value);
1916       break;
1917     default:
1918       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
1919       break;
1920   }
1921 }
1922
1923 static void
1924 gst_aggregator_get_property (GObject * object, guint prop_id,
1925     GValue * value, GParamSpec * pspec)
1926 {
1927   GstAggregator *agg = GST_AGGREGATOR (object);
1928
1929   switch (prop_id) {
1930     case PROP_LATENCY:
1931       g_value_set_int64 (value, gst_aggregator_get_latency_property (agg));
1932       break;
1933     case PROP_START_TIME_SELECTION:
1934       g_value_set_enum (value, agg->priv->start_time_selection);
1935       break;
1936     case PROP_START_TIME:
1937       g_value_set_uint64 (value, agg->priv->start_time);
1938       break;
1939     default:
1940       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
1941       break;
1942   }
1943 }
1944
1945 /* GObject vmethods implementations */
1946 static void
1947 gst_aggregator_class_init (GstAggregatorClass * klass)
1948 {
1949   GObjectClass *gobject_class = (GObjectClass *) klass;
1950   GstElementClass *gstelement_class = (GstElementClass *) klass;
1951
1952   aggregator_parent_class = g_type_class_peek_parent (klass);
1953   g_type_class_add_private (klass, sizeof (GstAggregatorPrivate));
1954
1955   GST_DEBUG_CATEGORY_INIT (aggregator_debug, "aggregator",
1956       GST_DEBUG_FG_MAGENTA, "GstAggregator");
1957
1958   klass->sinkpads_type = GST_TYPE_AGGREGATOR_PAD;
1959
1960   klass->sink_event = gst_aggregator_default_sink_event;
1961   klass->sink_query = gst_aggregator_default_sink_query;
1962
1963   klass->src_event = gst_aggregator_default_src_event;
1964   klass->src_query = gst_aggregator_default_src_query;
1965
1966   klass->create_new_pad = gst_aggregator_default_create_new_pad;
1967
1968   gstelement_class->request_new_pad =
1969       GST_DEBUG_FUNCPTR (gst_aggregator_request_new_pad);
1970   gstelement_class->send_event = GST_DEBUG_FUNCPTR (gst_aggregator_send_event);
1971   gstelement_class->release_pad =
1972       GST_DEBUG_FUNCPTR (gst_aggregator_release_pad);
1973   gstelement_class->change_state =
1974       GST_DEBUG_FUNCPTR (gst_aggregator_change_state);
1975
1976   gobject_class->set_property = gst_aggregator_set_property;
1977   gobject_class->get_property = gst_aggregator_get_property;
1978   gobject_class->finalize = gst_aggregator_finalize;
1979
1980   g_object_class_install_property (gobject_class, PROP_LATENCY,
1981       g_param_spec_int64 ("latency", "Buffer latency",
1982           "Additional latency in live mode to allow upstream "
1983           "to take longer to produce buffers for the current "
1984           "position (in nanoseconds)", 0,
1985           (G_MAXLONG == G_MAXINT64) ? G_MAXINT64 : (G_MAXLONG * GST_SECOND - 1),
1986           DEFAULT_LATENCY, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
1987
1988   g_object_class_install_property (gobject_class, PROP_START_TIME_SELECTION,
1989       g_param_spec_enum ("start-time-selection", "Start Time Selection",
1990           "Decides which start time is output",
1991           gst_aggregator_start_time_selection_get_type (),
1992           DEFAULT_START_TIME_SELECTION,
1993           G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
1994
1995   g_object_class_install_property (gobject_class, PROP_START_TIME,
1996       g_param_spec_uint64 ("start-time", "Start Time",
1997           "Start time to use if start-time-selection=set", 0,
1998           G_MAXUINT64,
1999           DEFAULT_START_TIME, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
2000
2001   GST_DEBUG_REGISTER_FUNCPTR (gst_aggregator_stop_pad);
2002 }
2003
2004 static void
2005 gst_aggregator_init (GstAggregator * self, GstAggregatorClass * klass)
2006 {
2007   GstPadTemplate *pad_template;
2008   GstAggregatorPrivate *priv;
2009
2010   g_return_if_fail (klass->aggregate != NULL);
2011
2012   self->priv =
2013       G_TYPE_INSTANCE_GET_PRIVATE (self, GST_TYPE_AGGREGATOR,
2014       GstAggregatorPrivate);
2015
2016   priv = self->priv;
2017
2018   pad_template =
2019       gst_element_class_get_pad_template (GST_ELEMENT_CLASS (klass), "src");
2020   g_return_if_fail (pad_template != NULL);
2021
2022   priv->max_padserial = -1;
2023   priv->tags_changed = FALSE;
2024
2025   self->priv->peer_latency_live = FALSE;
2026   self->priv->peer_latency_min = self->priv->sub_latency_min = 0;
2027   self->priv->peer_latency_max = self->priv->sub_latency_max = 0;
2028   self->priv->has_peer_latency = FALSE;
2029   gst_aggregator_reset_flow_values (self);
2030
2031   self->srcpad = gst_pad_new_from_template (pad_template, "src");
2032
2033   gst_pad_set_event_function (self->srcpad,
2034       GST_DEBUG_FUNCPTR (gst_aggregator_src_pad_event_func));
2035   gst_pad_set_query_function (self->srcpad,
2036       GST_DEBUG_FUNCPTR (gst_aggregator_src_pad_query_func));
2037   gst_pad_set_activatemode_function (self->srcpad,
2038       GST_DEBUG_FUNCPTR (gst_aggregator_src_pad_activate_mode_func));
2039
2040   gst_element_add_pad (GST_ELEMENT (self), self->srcpad);
2041
2042   self->priv->latency = DEFAULT_LATENCY;
2043   self->priv->start_time_selection = DEFAULT_START_TIME_SELECTION;
2044   self->priv->start_time = DEFAULT_START_TIME;
2045
2046   g_mutex_init (&self->priv->src_lock);
2047   g_cond_init (&self->priv->src_cond);
2048 }
2049
2050 /* we can't use G_DEFINE_ABSTRACT_TYPE because we need the klass in the _init
2051  * method to get to the padtemplates */
2052 GType
2053 gst_aggregator_get_type (void)
2054 {
2055   static volatile gsize type = 0;
2056
2057   if (g_once_init_enter (&type)) {
2058     GType _type;
2059     static const GTypeInfo info = {
2060       sizeof (GstAggregatorClass),
2061       NULL,
2062       NULL,
2063       (GClassInitFunc) gst_aggregator_class_init,
2064       NULL,
2065       NULL,
2066       sizeof (GstAggregator),
2067       0,
2068       (GInstanceInitFunc) gst_aggregator_init,
2069     };
2070
2071     _type = g_type_register_static (GST_TYPE_ELEMENT,
2072         "GstAggregator", &info, G_TYPE_FLAG_ABSTRACT);
2073     g_once_init_leave (&type, _type);
2074   }
2075   return type;
2076 }
2077
2078 /* Must be called with SRC lock and PAD lock held */
2079 static gboolean
2080 gst_aggregator_pad_has_space (GstAggregator * self, GstAggregatorPad * aggpad)
2081 {
2082   /* Empty queue always has space */
2083   if (g_queue_get_length (&aggpad->priv->buffers) == 0)
2084     return TRUE;
2085
2086   /* We also want at least two buffers, one is being processed and one is ready
2087    * for the next iteration when we operate in live mode. */
2088   if (self->priv->peer_latency_live && aggpad->priv->num_buffers < 2)
2089     return TRUE;
2090
2091   /* zero latency, if there is a buffer, it's full */
2092   if (self->priv->latency == 0)
2093     return FALSE;
2094
2095   /* Allow no more buffers than the latency */
2096   return (aggpad->priv->time_level <= self->priv->latency);
2097 }
2098
2099 /* Must be called with the PAD_LOCK held */
2100 static void
2101 apply_buffer (GstAggregatorPad * aggpad, GstBuffer * buffer, gboolean head)
2102 {
2103   GstClockTime timestamp;
2104
2105   if (GST_BUFFER_DTS_IS_VALID (buffer))
2106     timestamp = GST_BUFFER_DTS (buffer);
2107   else
2108     timestamp = GST_BUFFER_PTS (buffer);
2109
2110   if (timestamp == GST_CLOCK_TIME_NONE) {
2111     if (head)
2112       timestamp = aggpad->priv->head_position;
2113     else
2114       timestamp = aggpad->priv->tail_position;
2115   }
2116
2117   /* add duration */
2118   if (GST_BUFFER_DURATION_IS_VALID (buffer))
2119     timestamp += GST_BUFFER_DURATION (buffer);
2120
2121   if (head)
2122     aggpad->priv->head_position = timestamp;
2123   else
2124     aggpad->priv->tail_position = timestamp;
2125
2126   update_time_level (aggpad, head);
2127 }
2128
2129 static GstFlowReturn
2130 gst_aggregator_pad_chain_internal (GstAggregator * self,
2131     GstAggregatorPad * aggpad, GstBuffer * buffer, gboolean head)
2132 {
2133   GstBuffer *actual_buf = buffer;
2134   GstAggregatorClass *aggclass = GST_AGGREGATOR_GET_CLASS (self);
2135   GstFlowReturn flow_return;
2136   GstClockTime buf_pts;
2137
2138   GST_DEBUG_OBJECT (aggpad, "Start chaining a buffer %" GST_PTR_FORMAT, buffer);
2139
2140   PAD_FLUSH_LOCK (aggpad);
2141
2142   PAD_LOCK (aggpad);
2143   flow_return = aggpad->priv->flow_return;
2144   if (flow_return != GST_FLOW_OK)
2145     goto flushing;
2146
2147   if (aggpad->priv->pending_eos == TRUE)
2148     goto eos;
2149
2150   PAD_UNLOCK (aggpad);
2151
2152   if (aggclass->clip && head) {
2153     aggclass->clip (self, aggpad, buffer, &actual_buf);
2154   }
2155
2156   if (actual_buf == NULL) {
2157     GST_LOG_OBJECT (actual_buf, "Buffer dropped by clip function");
2158     goto done;
2159   }
2160
2161   buf_pts = GST_BUFFER_PTS (actual_buf);
2162
2163   aggpad->priv->first_buffer = FALSE;
2164
2165   for (;;) {
2166     SRC_LOCK (self);
2167     GST_OBJECT_LOCK (self);
2168     PAD_LOCK (aggpad);
2169     if (gst_aggregator_pad_has_space (self, aggpad)
2170         && aggpad->priv->flow_return == GST_FLOW_OK) {
2171       if (head)
2172         g_queue_push_head (&aggpad->priv->buffers, actual_buf);
2173       else
2174         g_queue_push_tail (&aggpad->priv->buffers, actual_buf);
2175       apply_buffer (aggpad, actual_buf, head);
2176       aggpad->priv->num_buffers++;
2177       actual_buf = buffer = NULL;
2178       SRC_BROADCAST (self);
2179       break;
2180     }
2181
2182     flow_return = aggpad->priv->flow_return;
2183     if (flow_return != GST_FLOW_OK) {
2184       GST_OBJECT_UNLOCK (self);
2185       SRC_UNLOCK (self);
2186       goto flushing;
2187     }
2188     GST_DEBUG_OBJECT (aggpad, "Waiting for buffer to be consumed");
2189     GST_OBJECT_UNLOCK (self);
2190     SRC_UNLOCK (self);
2191     PAD_WAIT_EVENT (aggpad);
2192
2193     PAD_UNLOCK (aggpad);
2194   }
2195
2196   if (self->priv->first_buffer) {
2197     GstClockTime start_time;
2198
2199     switch (self->priv->start_time_selection) {
2200       case GST_AGGREGATOR_START_TIME_SELECTION_ZERO:
2201       default:
2202         start_time = 0;
2203         break;
2204       case GST_AGGREGATOR_START_TIME_SELECTION_FIRST:
2205         GST_OBJECT_LOCK (aggpad);
2206         if (aggpad->segment.format == GST_FORMAT_TIME) {
2207           start_time = buf_pts;
2208           if (start_time != -1) {
2209             start_time = MAX (start_time, aggpad->segment.start);
2210             start_time =
2211                 gst_segment_to_running_time (&aggpad->segment, GST_FORMAT_TIME,
2212                 start_time);
2213           }
2214         } else {
2215           start_time = 0;
2216           GST_WARNING_OBJECT (aggpad,
2217               "Ignoring request of selecting the first start time "
2218               "as the segment is a %s segment instead of a time segment",
2219               gst_format_get_name (aggpad->segment.format));
2220         }
2221         GST_OBJECT_UNLOCK (aggpad);
2222         break;
2223       case GST_AGGREGATOR_START_TIME_SELECTION_SET:
2224         start_time = self->priv->start_time;
2225         if (start_time == -1)
2226           start_time = 0;
2227         break;
2228     }
2229
2230     if (start_time != -1) {
2231       if (self->segment.position == -1)
2232         self->segment.position = start_time;
2233       else
2234         self->segment.position = MIN (start_time, self->segment.position);
2235
2236       GST_DEBUG_OBJECT (self, "Selecting start time %" GST_TIME_FORMAT,
2237           GST_TIME_ARGS (start_time));
2238     }
2239   }
2240
2241   PAD_UNLOCK (aggpad);
2242   GST_OBJECT_UNLOCK (self);
2243   SRC_UNLOCK (self);
2244
2245 done:
2246
2247   PAD_FLUSH_UNLOCK (aggpad);
2248
2249   GST_DEBUG_OBJECT (aggpad, "Done chaining");
2250
2251   return flow_return;
2252
2253 flushing:
2254   PAD_UNLOCK (aggpad);
2255   PAD_FLUSH_UNLOCK (aggpad);
2256
2257   GST_DEBUG_OBJECT (aggpad, "Pad is %s, dropping buffer",
2258       gst_flow_get_name (flow_return));
2259   if (buffer)
2260     gst_buffer_unref (buffer);
2261
2262   return flow_return;
2263
2264 eos:
2265   PAD_UNLOCK (aggpad);
2266   PAD_FLUSH_UNLOCK (aggpad);
2267
2268   gst_buffer_unref (buffer);
2269   GST_DEBUG_OBJECT (aggpad, "We are EOS already...");
2270
2271   return GST_FLOW_EOS;
2272 }
2273
2274 static GstFlowReturn
2275 gst_aggregator_pad_chain (GstPad * pad, GstObject * object, GstBuffer * buffer)
2276 {
2277   return gst_aggregator_pad_chain_internal (GST_AGGREGATOR_CAST (object),
2278       GST_AGGREGATOR_PAD_CAST (pad), buffer, TRUE);
2279 }
2280
2281 static gboolean
2282 gst_aggregator_pad_query_func (GstPad * pad, GstObject * parent,
2283     GstQuery * query)
2284 {
2285   GstAggregatorPad *aggpad = GST_AGGREGATOR_PAD (pad);
2286   GstAggregatorClass *klass = GST_AGGREGATOR_GET_CLASS (parent);
2287
2288   if (GST_QUERY_IS_SERIALIZED (query)) {
2289     PAD_LOCK (aggpad);
2290
2291     while (!gst_aggregator_pad_queue_is_empty (aggpad)
2292         && aggpad->priv->flow_return == GST_FLOW_OK) {
2293       GST_DEBUG_OBJECT (aggpad, "Waiting for buffer to be consumed");
2294       PAD_WAIT_EVENT (aggpad);
2295     }
2296
2297     if (aggpad->priv->flow_return != GST_FLOW_OK)
2298       goto flushing;
2299
2300     PAD_UNLOCK (aggpad);
2301   }
2302
2303   return klass->sink_query (GST_AGGREGATOR (parent),
2304       GST_AGGREGATOR_PAD (pad), query);
2305
2306 flushing:
2307   GST_DEBUG_OBJECT (aggpad, "Pad is %s, dropping query",
2308       gst_flow_get_name (aggpad->priv->flow_return));
2309   PAD_UNLOCK (aggpad);
2310   return FALSE;
2311 }
2312
2313 static GstFlowReturn
2314 gst_aggregator_pad_event_func (GstPad * pad, GstObject * parent,
2315     GstEvent * event)
2316 {
2317   GstFlowReturn ret = GST_FLOW_OK;
2318   GstAggregator *self = GST_AGGREGATOR (parent);
2319   GstAggregatorPad *aggpad = GST_AGGREGATOR_PAD (pad);
2320   GstAggregatorClass *klass = GST_AGGREGATOR_GET_CLASS (parent);
2321
2322   if (GST_EVENT_IS_SERIALIZED (event) && GST_EVENT_TYPE (event) != GST_EVENT_EOS
2323       /* && GST_EVENT_TYPE (event) != GST_EVENT_SEGMENT_DONE */ ) {
2324     SRC_LOCK (self);
2325     PAD_LOCK (aggpad);
2326
2327     if (aggpad->priv->flow_return != GST_FLOW_OK
2328         && GST_EVENT_TYPE (event) != GST_EVENT_FLUSH_STOP) {
2329       ret = aggpad->priv->flow_return;
2330       goto flushing;
2331     }
2332
2333     if (GST_EVENT_TYPE (event) == GST_EVENT_SEGMENT) {
2334       GST_OBJECT_LOCK (aggpad);
2335       gst_event_copy_segment (event, &aggpad->clip_segment);
2336       aggpad->priv->head_position = aggpad->clip_segment.position;
2337       update_time_level (aggpad, TRUE);
2338       GST_OBJECT_UNLOCK (aggpad);
2339     }
2340
2341     if (!gst_aggregator_pad_queue_is_empty (aggpad) &&
2342         GST_EVENT_TYPE (event) != GST_EVENT_FLUSH_STOP) {
2343       GST_DEBUG_OBJECT (aggpad, "Store event in queue: %" GST_PTR_FORMAT,
2344           event);
2345       g_queue_push_head (&aggpad->priv->buffers, event);
2346       event = NULL;
2347       SRC_BROADCAST (self);
2348     }
2349     PAD_UNLOCK (aggpad);
2350     SRC_UNLOCK (self);
2351   }
2352
2353   if (event) {
2354     if (!klass->sink_event (self, aggpad, event)) {
2355       /* Copied from GstPad to convert boolean to a GstFlowReturn in
2356        * the event handling func */
2357       switch (GST_EVENT_TYPE (event)) {
2358         case GST_EVENT_CAPS:
2359           ret = GST_FLOW_NOT_NEGOTIATED;
2360           break;
2361         default:
2362           ret = GST_FLOW_ERROR;
2363           break;
2364       }
2365     }
2366   }
2367
2368   return ret;
2369
2370 flushing:
2371   GST_DEBUG_OBJECT (aggpad, "Pad is %s, dropping event",
2372       gst_flow_get_name (aggpad->priv->flow_return));
2373   PAD_UNLOCK (aggpad);
2374   SRC_UNLOCK (self);
2375   if (GST_EVENT_IS_STICKY (event))
2376     gst_pad_store_sticky_event (pad, event);
2377   gst_event_unref (event);
2378
2379   return ret;
2380 }
2381
2382 static gboolean
2383 gst_aggregator_pad_activate_mode_func (GstPad * pad,
2384     GstObject * parent, GstPadMode mode, gboolean active)
2385 {
2386   GstAggregator *self = GST_AGGREGATOR (parent);
2387   GstAggregatorPad *aggpad = GST_AGGREGATOR_PAD (pad);
2388
2389   if (active == FALSE) {
2390     SRC_LOCK (self);
2391     gst_aggregator_pad_set_flushing (aggpad, GST_FLOW_FLUSHING, TRUE);
2392     SRC_BROADCAST (self);
2393     SRC_UNLOCK (self);
2394   } else {
2395     PAD_LOCK (aggpad);
2396     aggpad->priv->flow_return = GST_FLOW_OK;
2397     PAD_BROADCAST_EVENT (aggpad);
2398     PAD_UNLOCK (aggpad);
2399   }
2400
2401   return TRUE;
2402 }
2403
2404 /***********************************
2405  * GstAggregatorPad implementation  *
2406  ************************************/
2407 G_DEFINE_TYPE (GstAggregatorPad, gst_aggregator_pad, GST_TYPE_PAD);
2408
2409 static void
2410 gst_aggregator_pad_constructed (GObject * object)
2411 {
2412   GstPad *pad = GST_PAD (object);
2413
2414   gst_pad_set_chain_function (pad,
2415       GST_DEBUG_FUNCPTR (gst_aggregator_pad_chain));
2416   gst_pad_set_event_full_function_full (pad,
2417       GST_DEBUG_FUNCPTR (gst_aggregator_pad_event_func),
2418       NULL, NULL);
2419   gst_pad_set_query_function (pad,
2420       GST_DEBUG_FUNCPTR (gst_aggregator_pad_query_func));
2421   gst_pad_set_activatemode_function (pad,
2422       GST_DEBUG_FUNCPTR (gst_aggregator_pad_activate_mode_func));
2423 }
2424
2425 static void
2426 gst_aggregator_pad_finalize (GObject * object)
2427 {
2428   GstAggregatorPad *pad = (GstAggregatorPad *) object;
2429
2430   g_cond_clear (&pad->priv->event_cond);
2431   g_mutex_clear (&pad->priv->flush_lock);
2432   g_mutex_clear (&pad->priv->lock);
2433
2434   G_OBJECT_CLASS (gst_aggregator_pad_parent_class)->finalize (object);
2435 }
2436
2437 static void
2438 gst_aggregator_pad_dispose (GObject * object)
2439 {
2440   GstAggregatorPad *pad = (GstAggregatorPad *) object;
2441
2442   gst_aggregator_pad_set_flushing (pad, GST_FLOW_FLUSHING, TRUE);
2443
2444   G_OBJECT_CLASS (gst_aggregator_pad_parent_class)->dispose (object);
2445 }
2446
2447 static void
2448 gst_aggregator_pad_class_init (GstAggregatorPadClass * klass)
2449 {
2450   GObjectClass *gobject_class = (GObjectClass *) klass;
2451
2452   g_type_class_add_private (klass, sizeof (GstAggregatorPadPrivate));
2453
2454   gobject_class->constructed = gst_aggregator_pad_constructed;
2455   gobject_class->finalize = gst_aggregator_pad_finalize;
2456   gobject_class->dispose = gst_aggregator_pad_dispose;
2457 }
2458
2459 static void
2460 gst_aggregator_pad_init (GstAggregatorPad * pad)
2461 {
2462   pad->priv =
2463       G_TYPE_INSTANCE_GET_PRIVATE (pad, GST_TYPE_AGGREGATOR_PAD,
2464       GstAggregatorPadPrivate);
2465
2466   g_queue_init (&pad->priv->buffers);
2467   g_cond_init (&pad->priv->event_cond);
2468
2469   g_mutex_init (&pad->priv->flush_lock);
2470   g_mutex_init (&pad->priv->lock);
2471
2472   pad->priv->first_buffer = TRUE;
2473 }
2474
2475 /**
2476  * gst_aggregator_pad_steal_buffer:
2477  * @pad: the pad to get buffer from
2478  *
2479  * Steal the ref to the buffer currently queued in @pad.
2480  *
2481  * Returns: (transfer full): The buffer in @pad or NULL if no buffer was
2482  *   queued. You should unref the buffer after usage.
2483  */
2484 GstBuffer *
2485 gst_aggregator_pad_steal_buffer (GstAggregatorPad * pad)
2486 {
2487   GstBuffer *buffer = NULL;
2488
2489   PAD_LOCK (pad);
2490   if (GST_IS_BUFFER (g_queue_peek_tail (&pad->priv->buffers)))
2491     buffer = g_queue_pop_tail (&pad->priv->buffers);
2492
2493   if (buffer) {
2494     apply_buffer (pad, buffer, FALSE);
2495     pad->priv->num_buffers--;
2496     GST_TRACE_OBJECT (pad, "Consuming buffer");
2497     if (gst_aggregator_pad_queue_is_empty (pad) && pad->priv->pending_eos) {
2498       pad->priv->pending_eos = FALSE;
2499       pad->priv->eos = TRUE;
2500     }
2501     PAD_BROADCAST_EVENT (pad);
2502     GST_DEBUG_OBJECT (pad, "Consumed: %" GST_PTR_FORMAT, buffer);
2503   }
2504   PAD_UNLOCK (pad);
2505
2506   return buffer;
2507 }
2508
2509 /**
2510  * gst_aggregator_pad_drop_buffer:
2511  * @pad: the pad where to drop any pending buffer
2512  *
2513  * Drop the buffer currently queued in @pad.
2514  *
2515  * Returns: TRUE if there was a buffer queued in @pad, or FALSE if not.
2516  */
2517 gboolean
2518 gst_aggregator_pad_drop_buffer (GstAggregatorPad * pad)
2519 {
2520   GstBuffer *buf;
2521
2522   buf = gst_aggregator_pad_steal_buffer (pad);
2523
2524   if (buf == NULL)
2525     return FALSE;
2526
2527   gst_buffer_unref (buf);
2528   return TRUE;
2529 }
2530
2531 /**
2532  * gst_aggregator_pad_get_buffer:
2533  * @pad: the pad to get buffer from
2534  *
2535  * Returns: (transfer full): A reference to the buffer in @pad or
2536  * NULL if no buffer was queued. You should unref the buffer after
2537  * usage.
2538  */
2539 GstBuffer *
2540 gst_aggregator_pad_get_buffer (GstAggregatorPad * pad)
2541 {
2542   GstBuffer *buffer = NULL;
2543
2544   PAD_LOCK (pad);
2545   buffer = g_queue_peek_tail (&pad->priv->buffers);
2546   /* The tail should always be a buffer, because if it is an event,
2547    * it will be consumed immeditaly in gst_aggregator_steal_buffer */
2548
2549   if (GST_IS_BUFFER (buffer))
2550     gst_buffer_ref (buffer);
2551   else
2552     buffer = NULL;
2553   PAD_UNLOCK (pad);
2554
2555   return buffer;
2556 }
2557
2558 gboolean
2559 gst_aggregator_pad_is_eos (GstAggregatorPad * pad)
2560 {
2561   gboolean is_eos;
2562
2563   PAD_LOCK (pad);
2564   is_eos = pad->priv->eos;
2565   PAD_UNLOCK (pad);
2566
2567   return is_eos;
2568 }
2569
2570 /**
2571  * gst_aggregator_merge_tags:
2572  * @self: a #GstAggregator
2573  * @tags: a #GstTagList to merge
2574  * @mode: the #GstTagMergeMode to use
2575  *
2576  * Adds tags to so-called pending tags, which will be processed
2577  * before pushing out data downstream.
2578  *
2579  * Note that this is provided for convenience, and the subclass is
2580  * not required to use this and can still do tag handling on its own.
2581  *
2582  * MT safe.
2583  */
2584 void
2585 gst_aggregator_merge_tags (GstAggregator * self,
2586     const GstTagList * tags, GstTagMergeMode mode)
2587 {
2588   GstTagList *otags;
2589
2590   g_return_if_fail (GST_IS_AGGREGATOR (self));
2591   g_return_if_fail (tags == NULL || GST_IS_TAG_LIST (tags));
2592
2593   /* FIXME Check if we can use OBJECT lock here! */
2594   GST_OBJECT_LOCK (self);
2595   if (tags)
2596     GST_DEBUG_OBJECT (self, "merging tags %" GST_PTR_FORMAT, tags);
2597   otags = self->priv->tags;
2598   self->priv->tags = gst_tag_list_merge (self->priv->tags, tags, mode);
2599   if (otags)
2600     gst_tag_list_unref (otags);
2601   self->priv->tags_changed = TRUE;
2602   GST_OBJECT_UNLOCK (self);
2603 }
2604
2605 /**
2606  * gst_aggregator_set_latency:
2607  * @self: a #GstAggregator
2608  * @min_latency: minimum latency
2609  * @max_latency: maximum latency
2610  *
2611  * Lets #GstAggregator sub-classes tell the baseclass what their internal
2612  * latency is. Will also post a LATENCY message on the bus so the pipeline
2613  * can reconfigure its global latency.
2614  */
2615 void
2616 gst_aggregator_set_latency (GstAggregator * self,
2617     GstClockTime min_latency, GstClockTime max_latency)
2618 {
2619   gboolean changed = FALSE;
2620
2621   g_return_if_fail (GST_IS_AGGREGATOR (self));
2622   g_return_if_fail (GST_CLOCK_TIME_IS_VALID (min_latency));
2623   g_return_if_fail (max_latency >= min_latency);
2624
2625   SRC_LOCK (self);
2626   if (self->priv->sub_latency_min != min_latency) {
2627     self->priv->sub_latency_min = min_latency;
2628     changed = TRUE;
2629   }
2630   if (self->priv->sub_latency_max != max_latency) {
2631     self->priv->sub_latency_max = max_latency;
2632     changed = TRUE;
2633   }
2634
2635   if (changed)
2636     SRC_BROADCAST (self);
2637   SRC_UNLOCK (self);
2638
2639   if (changed) {
2640     gst_element_post_message (GST_ELEMENT_CAST (self),
2641         gst_message_new_latency (GST_OBJECT_CAST (self)));
2642   }
2643 }