2 * Copyright (C) 2006 Edward Hervey <edward@fluendo.com>
3 * Copyright (C) 2007 Jan Schmidt <jan@fluendo.com>
4 * Copyright (C) 2007 Wim Taymans <wim@fluendo.com>
5 * Copyright (C) 2011 Sebastian Dröge <sebastian.droege@collabora.co.uk>
9 * This library is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU Library General Public
11 * License as published by the Free Software Foundation; either
12 * version 2 of the License, or (at your option) any later version.
14 * This library is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 * Library General Public License for more details.
19 * You should have received a copy of the GNU Library General Public
20 * License along with this library; if not, write to the
21 * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
22 * Boston, MA 02110-1301, USA.
26 * SECTION:element-multiqueue
27 * @see_also: #GstQueue
31 * Multiqueue is similar to a normal #GstQueue with the following additional
35 * <itemizedlist><title>Multiple streamhandling</title>
37 * The element handles queueing data on more than one stream at once. To
38 * achieve such a feature it has request sink pads (sink%u) and
39 * 'sometimes' src pads (src%u).
41 * When requesting a given sinkpad with gst_element_request_pad(),
42 * the associated srcpad for that stream will be created.
43 * Example: requesting sink1 will generate src1.
48 * <itemizedlist><title>Non-starvation on multiple streams</title>
50 * If more than one stream is used with the element, the streams' queues
51 * will be dynamically grown (up to a limit), in order to ensure that no
52 * stream is risking data starvation. This guarantees that at any given
53 * time there are at least N bytes queued and available for each individual
56 * If an EOS event comes through a srcpad, the associated queue will be
57 * considered as 'not-empty' in the queue-size-growing algorithm.
62 * <itemizedlist><title>Non-linked srcpads graceful handling</title>
64 * In order to better support dynamic switching between streams, the multiqueue
65 * (unlike the current GStreamer queue) continues to push buffers on non-linked
66 * pads rather than shutting down.
68 * In addition, to prevent a non-linked stream from very quickly consuming all
69 * available buffers and thus 'racing ahead' of the other streams, the element
70 * must ensure that buffers and inlined events for a non-linked stream are pushed
71 * in the same order as they were received, relative to the other streams
72 * controlled by the element. This means that a buffer cannot be pushed to a
73 * non-linked pad any sooner than buffers in any other stream which were received
81 * Data is queued until one of the limits specified by the
82 * #GstMultiQueue:max-size-buffers, #GstMultiQueue:max-size-bytes and/or
83 * #GstMultiQueue:max-size-time properties has been reached. Any attempt to push
84 * more buffers into the queue will block the pushing thread until more space
85 * becomes available. #GstMultiQueue:extra-size-buffers,
88 * #GstMultiQueue:extra-size-bytes and #GstMultiQueue:extra-size-time are
92 * The default queue size limits are 5 buffers, 10MB of data, or
93 * two second worth of data, whichever is reached first. Note that the number
94 * of buffers will dynamically grow depending on the fill level of
98 * The #GstMultiQueue::underrun signal is emitted when all of the queues
99 * are empty. The #GstMultiQueue::overrun signal is emitted when one of the
101 * Both signals are emitted from the context of the streaming thread.
112 #include "gstmultiqueue.h"
113 #include <gst/glib-compat-private.h>
117 * @sinkpad: associated sink #GstPad
118 * @srcpad: associated source #GstPad
120 * Structure containing all information and properties about
123 typedef struct _GstSingleQueue GstSingleQueue;
125 struct _GstSingleQueue
127 /* unique identifier of the queue */
130 GstMultiQueue *mqueue;
135 /* flowreturn of previous srcpad push */
136 GstFlowReturn srcresult;
137 /* If something was actually pushed on
138 * this pad after flushing/pad activation
139 * and the srcresult corresponds to something
145 GstSegment sink_segment;
146 GstSegment src_segment;
147 gboolean has_src_segment; /* preferred over initializing the src_segment to
148 * UNDEFINED as this doesn't requires adding ifs
149 * in every segment usage */
151 /* position of src/sink */
152 GstClockTime sinktime, srctime;
153 /* TRUE if either position needs to be recalculated */
154 gboolean sink_tainted, src_tainted;
158 GstDataQueueSize max_size, extra_size;
159 GstClockTime cur_time;
163 /* Protected by global lock */
164 guint32 nextid; /* ID of the next object waiting to be pushed */
165 guint32 oldid; /* ID of the last object pushed (last in a series) */
166 guint32 last_oldid; /* Previously observed old_id, reset to MAXUINT32 on flush */
167 GstClockTime next_time; /* End running time of next buffer to be pushed */
168 GstClockTime last_time; /* Start running time of last pushed buffer */
169 GCond turn; /* SingleQueue turn waiting conditional */
171 /* for serialized queries */
174 GstQuery *last_handled_query;
178 /* Extension of GstDataQueueItem structure for our usage */
179 typedef struct _GstMultiQueueItem GstMultiQueueItem;
181 struct _GstMultiQueueItem
183 GstMiniObject *object;
188 GDestroyNotify destroy;
194 static GstSingleQueue *gst_single_queue_new (GstMultiQueue * mqueue, guint id);
195 static void gst_single_queue_free (GstSingleQueue * squeue);
197 static void wake_up_next_non_linked (GstMultiQueue * mq);
198 static void compute_high_id (GstMultiQueue * mq);
199 static void compute_high_time (GstMultiQueue * mq);
200 static void single_queue_overrun_cb (GstDataQueue * dq, GstSingleQueue * sq);
201 static void single_queue_underrun_cb (GstDataQueue * dq, GstSingleQueue * sq);
203 static void update_buffering (GstMultiQueue * mq, GstSingleQueue * sq);
204 static void gst_multi_queue_post_buffering (GstMultiQueue * mq);
206 static void gst_single_queue_flush_queue (GstSingleQueue * sq, gboolean full);
208 static GstStaticPadTemplate sinktemplate = GST_STATIC_PAD_TEMPLATE ("sink_%u",
211 GST_STATIC_CAPS_ANY);
213 static GstStaticPadTemplate srctemplate = GST_STATIC_PAD_TEMPLATE ("src_%u",
216 GST_STATIC_CAPS_ANY);
218 GST_DEBUG_CATEGORY_STATIC (multi_queue_debug);
219 #define GST_CAT_DEFAULT (multi_queue_debug)
221 /* Signals and args */
229 /* default limits, we try to keep up to 2 seconds of data and if there is not
230 * time, up to 10 MB. The number of buffers is dynamically scaled to make sure
231 * there is data in the queues. Normally, the byte and time limits are not hit
232 * in theses conditions. */
233 #define DEFAULT_MAX_SIZE_BYTES 10 * 1024 * 1024 /* 10 MB */
234 #define DEFAULT_MAX_SIZE_BUFFERS 5
235 #define DEFAULT_MAX_SIZE_TIME 2 * GST_SECOND
237 /* second limits. When we hit one of the above limits we are probably dealing
238 * with a badly muxed file and we scale the limits to these emergency values.
239 * This is currently not yet implemented.
240 * Since we dynamically scale the queue buffer size up to the limits but avoid
241 * going above the max-size-buffers when we can, we don't really need this
242 * aditional extra size. */
243 #define DEFAULT_EXTRA_SIZE_BYTES 10 * 1024 * 1024 /* 10 MB */
244 #define DEFAULT_EXTRA_SIZE_BUFFERS 5
245 #define DEFAULT_EXTRA_SIZE_TIME 3 * GST_SECOND
247 #define DEFAULT_USE_BUFFERING FALSE
248 #define DEFAULT_LOW_PERCENT 10
249 #define DEFAULT_HIGH_PERCENT 99
250 #define DEFAULT_SYNC_BY_RUNNING_TIME FALSE
255 PROP_EXTRA_SIZE_BYTES,
256 PROP_EXTRA_SIZE_BUFFERS,
257 PROP_EXTRA_SIZE_TIME,
259 PROP_MAX_SIZE_BUFFERS,
264 PROP_SYNC_BY_RUNNING_TIME,
268 #define GST_MULTI_QUEUE_MUTEX_LOCK(q) G_STMT_START { \
269 g_mutex_lock (&q->qlock); \
272 #define GST_MULTI_QUEUE_MUTEX_UNLOCK(q) G_STMT_START { \
273 g_mutex_unlock (&q->qlock); \
276 #define SET_PERCENT(mq, perc) G_STMT_START { \
277 if (perc != mq->percent) { \
278 mq->percent = perc; \
279 mq->percent_changed = TRUE; \
280 GST_DEBUG_OBJECT (mq, "buffering %d percent", perc); \
284 static void gst_multi_queue_finalize (GObject * object);
285 static void gst_multi_queue_set_property (GObject * object,
286 guint prop_id, const GValue * value, GParamSpec * pspec);
287 static void gst_multi_queue_get_property (GObject * object,
288 guint prop_id, GValue * value, GParamSpec * pspec);
290 static GstPad *gst_multi_queue_request_new_pad (GstElement * element,
291 GstPadTemplate * temp, const gchar * name, const GstCaps * caps);
292 static void gst_multi_queue_release_pad (GstElement * element, GstPad * pad);
293 static GstStateChangeReturn gst_multi_queue_change_state (GstElement *
294 element, GstStateChange transition);
296 static void gst_multi_queue_loop (GstPad * pad);
299 GST_DEBUG_CATEGORY_INIT (multi_queue_debug, "multiqueue", 0, "multiqueue element");
300 #define gst_multi_queue_parent_class parent_class
301 G_DEFINE_TYPE_WITH_CODE (GstMultiQueue, gst_multi_queue, GST_TYPE_ELEMENT,
304 static guint gst_multi_queue_signals[LAST_SIGNAL] = { 0 };
307 gst_multi_queue_class_init (GstMultiQueueClass * klass)
309 GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
310 GstElementClass *gstelement_class = GST_ELEMENT_CLASS (klass);
312 gobject_class->set_property = gst_multi_queue_set_property;
313 gobject_class->get_property = gst_multi_queue_get_property;
318 * GstMultiQueue::underrun:
319 * @multiqueue: the multiqueue instance
321 * This signal is emitted from the streaming thread when there is
322 * no data in any of the queues inside the multiqueue instance (underrun).
324 * This indicates either starvation or EOS from the upstream data sources.
326 gst_multi_queue_signals[SIGNAL_UNDERRUN] =
327 g_signal_new ("underrun", G_TYPE_FROM_CLASS (klass), G_SIGNAL_RUN_FIRST,
328 G_STRUCT_OFFSET (GstMultiQueueClass, underrun), NULL, NULL,
329 g_cclosure_marshal_VOID__VOID, G_TYPE_NONE, 0);
332 * GstMultiQueue::overrun:
333 * @multiqueue: the multiqueue instance
335 * Reports that one of the queues in the multiqueue is full (overrun).
336 * A queue is full if the total amount of data inside it (num-buffers, time,
337 * size) is higher than the boundary values which can be set through the
338 * GObject properties.
340 * This can be used as an indicator of pre-roll.
342 gst_multi_queue_signals[SIGNAL_OVERRUN] =
343 g_signal_new ("overrun", G_TYPE_FROM_CLASS (klass), G_SIGNAL_RUN_FIRST,
344 G_STRUCT_OFFSET (GstMultiQueueClass, overrun), NULL, NULL,
345 g_cclosure_marshal_VOID__VOID, G_TYPE_NONE, 0);
349 g_object_class_install_property (gobject_class, PROP_MAX_SIZE_BYTES,
350 g_param_spec_uint ("max-size-bytes", "Max. size (kB)",
351 "Max. amount of data in the queue (bytes, 0=disable)",
352 0, G_MAXUINT, DEFAULT_MAX_SIZE_BYTES,
353 G_PARAM_READWRITE | GST_PARAM_MUTABLE_PLAYING |
354 G_PARAM_STATIC_STRINGS));
355 g_object_class_install_property (gobject_class, PROP_MAX_SIZE_BUFFERS,
356 g_param_spec_uint ("max-size-buffers", "Max. size (buffers)",
357 "Max. number of buffers in the queue (0=disable)", 0, G_MAXUINT,
358 DEFAULT_MAX_SIZE_BUFFERS,
359 G_PARAM_READWRITE | GST_PARAM_MUTABLE_PLAYING |
360 G_PARAM_STATIC_STRINGS));
361 g_object_class_install_property (gobject_class, PROP_MAX_SIZE_TIME,
362 g_param_spec_uint64 ("max-size-time", "Max. size (ns)",
363 "Max. amount of data in the queue (in ns, 0=disable)", 0, G_MAXUINT64,
364 DEFAULT_MAX_SIZE_TIME, G_PARAM_READWRITE | GST_PARAM_MUTABLE_PLAYING |
365 G_PARAM_STATIC_STRINGS));
367 g_object_class_install_property (gobject_class, PROP_EXTRA_SIZE_BYTES,
368 g_param_spec_uint ("extra-size-bytes", "Extra Size (kB)",
369 "Amount of data the queues can grow if one of them is empty (bytes, 0=disable)"
370 " (NOT IMPLEMENTED)",
371 0, G_MAXUINT, DEFAULT_EXTRA_SIZE_BYTES,
372 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
373 g_object_class_install_property (gobject_class, PROP_EXTRA_SIZE_BUFFERS,
374 g_param_spec_uint ("extra-size-buffers", "Extra Size (buffers)",
375 "Amount of buffers the queues can grow if one of them is empty (0=disable)"
376 " (NOT IMPLEMENTED)",
377 0, G_MAXUINT, DEFAULT_EXTRA_SIZE_BUFFERS,
378 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
379 g_object_class_install_property (gobject_class, PROP_EXTRA_SIZE_TIME,
380 g_param_spec_uint64 ("extra-size-time", "Extra Size (ns)",
381 "Amount of time the queues can grow if one of them is empty (in ns, 0=disable)"
382 " (NOT IMPLEMENTED)",
383 0, G_MAXUINT64, DEFAULT_EXTRA_SIZE_TIME,
384 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
387 * GstMultiQueue:use-buffering
389 * Enable the buffering option in multiqueue so that BUFFERING messages are
390 * emitted based on low-/high-percent thresholds.
392 g_object_class_install_property (gobject_class, PROP_USE_BUFFERING,
393 g_param_spec_boolean ("use-buffering", "Use buffering",
394 "Emit GST_MESSAGE_BUFFERING based on low-/high-percent thresholds",
395 DEFAULT_USE_BUFFERING, G_PARAM_READWRITE | GST_PARAM_MUTABLE_PLAYING |
396 G_PARAM_STATIC_STRINGS));
398 * GstMultiQueue:low-percent
400 * Low threshold percent for buffering to start.
402 g_object_class_install_property (gobject_class, PROP_LOW_PERCENT,
403 g_param_spec_int ("low-percent", "Low percent",
404 "Low threshold for buffering to start", 0, 100,
405 DEFAULT_LOW_PERCENT, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
407 * GstMultiQueue:high-percent
409 * High threshold percent for buffering to finish.
411 g_object_class_install_property (gobject_class, PROP_HIGH_PERCENT,
412 g_param_spec_int ("high-percent", "High percent",
413 "High threshold for buffering to finish", 0, 100,
414 DEFAULT_HIGH_PERCENT, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
417 * GstMultiQueue:sync-by-running-time
419 * If enabled multiqueue will synchronize deactivated or not-linked streams
420 * to the activated and linked streams by taking the running time.
421 * Otherwise multiqueue will synchronize the deactivated or not-linked
422 * streams by keeping the order in which buffers and events arrived compared
423 * to active and linked streams.
425 g_object_class_install_property (gobject_class, PROP_SYNC_BY_RUNNING_TIME,
426 g_param_spec_boolean ("sync-by-running-time", "Sync By Running Time",
427 "Synchronize deactivated or not-linked streams by running time",
428 DEFAULT_SYNC_BY_RUNNING_TIME,
429 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
431 gobject_class->finalize = gst_multi_queue_finalize;
433 gst_element_class_set_static_metadata (gstelement_class,
435 "Generic", "Multiple data queue", "Edward Hervey <edward@fluendo.com>");
436 gst_element_class_add_pad_template (gstelement_class,
437 gst_static_pad_template_get (&sinktemplate));
438 gst_element_class_add_pad_template (gstelement_class,
439 gst_static_pad_template_get (&srctemplate));
441 gstelement_class->request_new_pad =
442 GST_DEBUG_FUNCPTR (gst_multi_queue_request_new_pad);
443 gstelement_class->release_pad =
444 GST_DEBUG_FUNCPTR (gst_multi_queue_release_pad);
445 gstelement_class->change_state =
446 GST_DEBUG_FUNCPTR (gst_multi_queue_change_state);
450 gst_multi_queue_init (GstMultiQueue * mqueue)
452 mqueue->nbqueues = 0;
453 mqueue->queues = NULL;
455 mqueue->max_size.bytes = DEFAULT_MAX_SIZE_BYTES;
456 mqueue->max_size.visible = DEFAULT_MAX_SIZE_BUFFERS;
457 mqueue->max_size.time = DEFAULT_MAX_SIZE_TIME;
459 mqueue->extra_size.bytes = DEFAULT_EXTRA_SIZE_BYTES;
460 mqueue->extra_size.visible = DEFAULT_EXTRA_SIZE_BUFFERS;
461 mqueue->extra_size.time = DEFAULT_EXTRA_SIZE_TIME;
463 mqueue->use_buffering = DEFAULT_USE_BUFFERING;
464 mqueue->low_percent = DEFAULT_LOW_PERCENT;
465 mqueue->high_percent = DEFAULT_HIGH_PERCENT;
467 mqueue->sync_by_running_time = DEFAULT_SYNC_BY_RUNNING_TIME;
471 mqueue->high_time = GST_CLOCK_TIME_NONE;
473 g_mutex_init (&mqueue->qlock);
474 g_mutex_init (&mqueue->buffering_post_lock);
478 gst_multi_queue_finalize (GObject * object)
480 GstMultiQueue *mqueue = GST_MULTI_QUEUE (object);
482 g_list_foreach (mqueue->queues, (GFunc) gst_single_queue_free, NULL);
483 g_list_free (mqueue->queues);
484 mqueue->queues = NULL;
485 mqueue->queues_cookie++;
487 /* free/unref instance data */
488 g_mutex_clear (&mqueue->qlock);
489 g_mutex_clear (&mqueue->buffering_post_lock);
491 G_OBJECT_CLASS (parent_class)->finalize (object);
494 #define SET_CHILD_PROPERTY(mq,format) G_STMT_START { \
495 GList * tmp = mq->queues; \
497 GstSingleQueue *q = (GstSingleQueue*)tmp->data; \
498 q->max_size.format = mq->max_size.format; \
499 update_buffering (mq, q); \
500 gst_data_queue_limits_changed (q->queue); \
501 tmp = g_list_next(tmp); \
506 gst_multi_queue_set_property (GObject * object, guint prop_id,
507 const GValue * value, GParamSpec * pspec)
509 GstMultiQueue *mq = GST_MULTI_QUEUE (object);
512 case PROP_MAX_SIZE_BYTES:
513 GST_MULTI_QUEUE_MUTEX_LOCK (mq);
514 mq->max_size.bytes = g_value_get_uint (value);
515 SET_CHILD_PROPERTY (mq, bytes);
516 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
517 gst_multi_queue_post_buffering (mq);
519 case PROP_MAX_SIZE_BUFFERS:
522 gint new_size = g_value_get_uint (value);
524 GST_MULTI_QUEUE_MUTEX_LOCK (mq);
526 mq->max_size.visible = new_size;
530 GstDataQueueSize size;
531 GstSingleQueue *q = (GstSingleQueue *) tmp->data;
532 gst_data_queue_get_level (q->queue, &size);
534 GST_DEBUG_OBJECT (mq, "Queue %d: Requested buffers size: %d,"
535 " current: %d, current max %d", q->id, new_size, size.visible,
536 q->max_size.visible);
538 /* do not reduce max size below current level if the single queue
539 * has grown because of empty queue */
541 q->max_size.visible = new_size;
542 } else if (q->max_size.visible == 0) {
543 q->max_size.visible = MAX (new_size, size.visible);
544 } else if (new_size > size.visible) {
545 q->max_size.visible = new_size;
547 update_buffering (mq, q);
548 gst_data_queue_limits_changed (q->queue);
549 tmp = g_list_next (tmp);
552 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
553 gst_multi_queue_post_buffering (mq);
557 case PROP_MAX_SIZE_TIME:
558 GST_MULTI_QUEUE_MUTEX_LOCK (mq);
559 mq->max_size.time = g_value_get_uint64 (value);
560 SET_CHILD_PROPERTY (mq, time);
561 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
562 gst_multi_queue_post_buffering (mq);
564 case PROP_EXTRA_SIZE_BYTES:
565 mq->extra_size.bytes = g_value_get_uint (value);
567 case PROP_EXTRA_SIZE_BUFFERS:
568 mq->extra_size.visible = g_value_get_uint (value);
570 case PROP_EXTRA_SIZE_TIME:
571 mq->extra_size.time = g_value_get_uint64 (value);
573 case PROP_USE_BUFFERING:
574 mq->use_buffering = g_value_get_boolean (value);
575 if (!mq->use_buffering && mq->buffering) {
576 GST_MULTI_QUEUE_MUTEX_LOCK (mq);
577 mq->buffering = FALSE;
578 GST_DEBUG_OBJECT (mq, "buffering 100 percent");
579 SET_PERCENT (mq, 100);
580 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
583 if (mq->use_buffering) {
586 GST_MULTI_QUEUE_MUTEX_LOCK (mq);
590 GstSingleQueue *q = (GstSingleQueue *) tmp->data;
591 update_buffering (mq, q);
592 gst_data_queue_limits_changed (q->queue);
593 tmp = g_list_next (tmp);
596 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
598 gst_multi_queue_post_buffering (mq);
600 case PROP_LOW_PERCENT:
601 mq->low_percent = g_value_get_int (value);
603 case PROP_HIGH_PERCENT:
604 mq->high_percent = g_value_get_int (value);
606 case PROP_SYNC_BY_RUNNING_TIME:
607 mq->sync_by_running_time = g_value_get_boolean (value);
610 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
616 gst_multi_queue_get_property (GObject * object, guint prop_id,
617 GValue * value, GParamSpec * pspec)
619 GstMultiQueue *mq = GST_MULTI_QUEUE (object);
621 GST_MULTI_QUEUE_MUTEX_LOCK (mq);
624 case PROP_EXTRA_SIZE_BYTES:
625 g_value_set_uint (value, mq->extra_size.bytes);
627 case PROP_EXTRA_SIZE_BUFFERS:
628 g_value_set_uint (value, mq->extra_size.visible);
630 case PROP_EXTRA_SIZE_TIME:
631 g_value_set_uint64 (value, mq->extra_size.time);
633 case PROP_MAX_SIZE_BYTES:
634 g_value_set_uint (value, mq->max_size.bytes);
636 case PROP_MAX_SIZE_BUFFERS:
637 g_value_set_uint (value, mq->max_size.visible);
639 case PROP_MAX_SIZE_TIME:
640 g_value_set_uint64 (value, mq->max_size.time);
642 case PROP_USE_BUFFERING:
643 g_value_set_boolean (value, mq->use_buffering);
645 case PROP_LOW_PERCENT:
646 g_value_set_int (value, mq->low_percent);
648 case PROP_HIGH_PERCENT:
649 g_value_set_int (value, mq->high_percent);
651 case PROP_SYNC_BY_RUNNING_TIME:
652 g_value_set_boolean (value, mq->sync_by_running_time);
655 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
659 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
663 gst_multi_queue_iterate_internal_links (GstPad * pad, GstObject * parent)
665 GstIterator *it = NULL;
667 GstSingleQueue *squeue;
668 GstMultiQueue *mq = GST_MULTI_QUEUE (parent);
671 GST_MULTI_QUEUE_MUTEX_LOCK (mq);
672 squeue = gst_pad_get_element_private (pad);
676 if (squeue->sinkpad == pad)
677 opad = gst_object_ref (squeue->srcpad);
678 else if (squeue->srcpad == pad)
679 opad = gst_object_ref (squeue->sinkpad);
683 g_value_init (&val, GST_TYPE_PAD);
684 g_value_set_object (&val, opad);
685 it = gst_iterator_new_single (GST_TYPE_PAD, &val);
686 g_value_unset (&val);
688 gst_object_unref (opad);
691 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
702 gst_multi_queue_request_new_pad (GstElement * element, GstPadTemplate * temp,
703 const gchar * name, const GstCaps * caps)
705 GstMultiQueue *mqueue = GST_MULTI_QUEUE (element);
706 GstSingleQueue *squeue;
710 sscanf (name + 4, "_%u", &temp_id);
711 GST_LOG_OBJECT (element, "name : %s (id %d)", GST_STR_NULL (name), temp_id);
714 /* Create a new single queue, add the sink and source pad and return the sink pad */
715 squeue = gst_single_queue_new (mqueue, temp_id);
717 GST_DEBUG_OBJECT (mqueue, "Returning pad %s:%s",
718 GST_DEBUG_PAD_NAME (squeue->sinkpad));
720 return squeue ? squeue->sinkpad : NULL;
724 gst_multi_queue_release_pad (GstElement * element, GstPad * pad)
726 GstMultiQueue *mqueue = GST_MULTI_QUEUE (element);
727 GstSingleQueue *sq = NULL;
730 GST_LOG_OBJECT (element, "pad %s:%s", GST_DEBUG_PAD_NAME (pad));
732 GST_MULTI_QUEUE_MUTEX_LOCK (mqueue);
733 /* Find which single queue it belongs to, knowing that it should be a sinkpad */
734 for (tmp = mqueue->queues; tmp; tmp = g_list_next (tmp)) {
735 sq = (GstSingleQueue *) tmp->data;
737 if (sq->sinkpad == pad)
742 GST_WARNING_OBJECT (mqueue, "That pad doesn't belong to this element ???");
743 GST_MULTI_QUEUE_MUTEX_UNLOCK (mqueue);
747 /* FIXME: The removal of the singlequeue should probably not happen until it
748 * finishes draining */
750 /* remove it from the list */
751 mqueue->queues = g_list_delete_link (mqueue->queues, tmp);
752 mqueue->queues_cookie++;
754 /* FIXME : recompute next-non-linked */
755 GST_MULTI_QUEUE_MUTEX_UNLOCK (mqueue);
757 /* delete SingleQueue */
758 gst_data_queue_set_flushing (sq->queue, TRUE);
760 gst_pad_set_active (sq->srcpad, FALSE);
761 gst_pad_set_active (sq->sinkpad, FALSE);
762 gst_pad_set_element_private (sq->srcpad, NULL);
763 gst_pad_set_element_private (sq->sinkpad, NULL);
764 gst_element_remove_pad (element, sq->srcpad);
765 gst_element_remove_pad (element, sq->sinkpad);
766 gst_single_queue_free (sq);
769 static GstStateChangeReturn
770 gst_multi_queue_change_state (GstElement * element, GstStateChange transition)
772 GstMultiQueue *mqueue = GST_MULTI_QUEUE (element);
773 GstSingleQueue *sq = NULL;
774 GstStateChangeReturn result;
776 switch (transition) {
777 case GST_STATE_CHANGE_READY_TO_PAUSED:{
780 /* Set all pads to non-flushing */
781 GST_MULTI_QUEUE_MUTEX_LOCK (mqueue);
782 for (tmp = mqueue->queues; tmp; tmp = g_list_next (tmp)) {
783 sq = (GstSingleQueue *) tmp->data;
784 sq->flushing = FALSE;
787 /* the visible limit might not have been set on single queues that have grown because of other queueus were empty */
788 SET_CHILD_PROPERTY (mqueue, visible);
790 GST_MULTI_QUEUE_MUTEX_UNLOCK (mqueue);
791 gst_multi_queue_post_buffering (mqueue);
795 case GST_STATE_CHANGE_PAUSED_TO_READY:{
798 /* Un-wait all waiting pads */
799 GST_MULTI_QUEUE_MUTEX_LOCK (mqueue);
800 for (tmp = mqueue->queues; tmp; tmp = g_list_next (tmp)) {
801 sq = (GstSingleQueue *) tmp->data;
803 g_cond_signal (&sq->turn);
805 sq->last_query = FALSE;
806 g_cond_signal (&sq->query_handled);
808 GST_MULTI_QUEUE_MUTEX_UNLOCK (mqueue);
815 result = GST_ELEMENT_CLASS (parent_class)->change_state (element, transition);
817 switch (transition) {
826 gst_single_queue_flush (GstMultiQueue * mq, GstSingleQueue * sq, gboolean flush,
831 GST_DEBUG_OBJECT (mq, "flush %s queue %d", (flush ? "start" : "stop"),
835 GST_MULTI_QUEUE_MUTEX_LOCK (mq);
836 sq->srcresult = GST_FLOW_FLUSHING;
837 gst_data_queue_set_flushing (sq->queue, TRUE);
841 /* wake up non-linked task */
842 GST_LOG_OBJECT (mq, "SingleQueue %d : waking up eventually waiting task",
844 g_cond_signal (&sq->turn);
845 sq->last_query = FALSE;
846 g_cond_signal (&sq->query_handled);
847 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
849 GST_LOG_OBJECT (mq, "SingleQueue %d : pausing task", sq->id);
850 result = gst_pad_pause_task (sq->srcpad);
851 sq->sink_tainted = sq->src_tainted = TRUE;
853 gst_single_queue_flush_queue (sq, full);
855 GST_MULTI_QUEUE_MUTEX_LOCK (mq);
856 gst_segment_init (&sq->sink_segment, GST_FORMAT_TIME);
857 gst_segment_init (&sq->src_segment, GST_FORMAT_TIME);
858 sq->has_src_segment = FALSE;
859 /* All pads start off not-linked for a smooth kick-off */
860 sq->srcresult = GST_FLOW_OK;
863 sq->max_size.visible = mq->max_size.visible;
867 sq->last_oldid = G_MAXUINT32;
868 sq->next_time = GST_CLOCK_TIME_NONE;
869 sq->last_time = GST_CLOCK_TIME_NONE;
870 gst_data_queue_set_flushing (sq->queue, FALSE);
872 /* Reset high time to be recomputed next */
873 mq->high_time = GST_CLOCK_TIME_NONE;
875 sq->flushing = FALSE;
876 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
878 GST_LOG_OBJECT (mq, "SingleQueue %d : starting task", sq->id);
880 gst_pad_start_task (sq->srcpad, (GstTaskFunction) gst_multi_queue_loop,
886 /* WITH LOCK TAKEN */
888 get_percentage (GstSingleQueue * sq)
890 GstDataQueueSize size;
893 gst_data_queue_get_level (sq->queue, &size);
895 GST_DEBUG_OBJECT (sq->mqueue,
896 "queue %d: visible %u/%u, bytes %u/%u, time %" G_GUINT64_FORMAT "/%"
897 G_GUINT64_FORMAT, sq->id, size.visible, sq->max_size.visible,
898 size.bytes, sq->max_size.bytes, sq->cur_time, sq->max_size.time);
900 /* get bytes and time percentages and take the max */
901 if (sq->is_eos || sq->srcresult == GST_FLOW_NOT_LINKED) {
905 if (sq->max_size.time > 0) {
906 tmp = (sq->cur_time * 100) / sq->max_size.time;
907 percent = MAX (percent, tmp);
909 if (sq->max_size.bytes > 0) {
910 tmp = (size.bytes * 100) / sq->max_size.bytes;
911 percent = MAX (percent, tmp);
918 /* WITH LOCK TAKEN */
920 update_buffering (GstMultiQueue * mq, GstSingleQueue * sq)
924 /* nothing to dowhen we are not in buffering mode */
925 if (!mq->use_buffering)
928 percent = get_percentage (sq);
931 if (percent >= mq->high_percent) {
932 mq->buffering = FALSE;
934 /* make sure it increases */
935 percent = MAX (mq->percent, percent);
937 SET_PERCENT (mq, percent);
940 gboolean is_buffering = TRUE;
942 for (iter = mq->queues; iter; iter = g_list_next (iter)) {
943 GstSingleQueue *oq = (GstSingleQueue *) iter->data;
945 if (get_percentage (oq) >= mq->high_percent) {
946 is_buffering = FALSE;
952 if (is_buffering && percent < mq->low_percent) {
953 mq->buffering = TRUE;
954 SET_PERCENT (mq, percent);
960 gst_multi_queue_post_buffering (GstMultiQueue * mq)
962 GstMessage *msg = NULL;
964 g_mutex_lock (&mq->buffering_post_lock);
965 GST_MULTI_QUEUE_MUTEX_LOCK (mq);
966 if (mq->percent_changed) {
967 gint percent = mq->percent;
969 mq->percent_changed = FALSE;
971 percent = percent * 100 / mq->high_percent;
976 GST_DEBUG_OBJECT (mq, "Going to post buffering: %d%%", percent);
977 msg = gst_message_new_buffering (GST_OBJECT_CAST (mq), percent);
979 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
982 gst_element_post_message (GST_ELEMENT_CAST (mq), msg);
984 g_mutex_unlock (&mq->buffering_post_lock);
987 /* calculate the diff between running time on the sink and src of the queue.
988 * This is the total amount of time in the queue.
991 update_time_level (GstMultiQueue * mq, GstSingleQueue * sq)
993 gint64 sink_time, src_time;
995 if (sq->sink_tainted) {
996 sink_time = sq->sinktime =
997 gst_segment_to_running_time (&sq->sink_segment, GST_FORMAT_TIME,
998 sq->sink_segment.position);
1000 if (G_UNLIKELY (sink_time != GST_CLOCK_TIME_NONE))
1001 /* if we have a time, we become untainted and use the time */
1002 sq->sink_tainted = FALSE;
1004 sink_time = sq->sinktime;
1006 if (sq->src_tainted) {
1007 GstSegment *segment;
1010 if (sq->has_src_segment) {
1011 segment = &sq->src_segment;
1012 position = sq->src_segment.position;
1015 * If the src pad had no segment yet, use the sink segment
1016 * to avoid signalling overrun if the received sink segment has a
1017 * a position > max-size-time while the src pad time would be the default=0
1019 * This can happen when switching pads on chained/adaptive streams and the
1020 * new chain has a segment with a much larger position
1022 segment = &sq->sink_segment;
1023 position = sq->sink_segment.position;
1026 src_time = sq->srctime =
1027 gst_segment_to_running_time (segment, GST_FORMAT_TIME, position);
1028 /* if we have a time, we become untainted and use the time */
1029 if (G_UNLIKELY (src_time != GST_CLOCK_TIME_NONE))
1030 sq->src_tainted = FALSE;
1032 src_time = sq->srctime;
1034 GST_DEBUG_OBJECT (mq,
1035 "queue %d, sink %" GST_TIME_FORMAT ", src %" GST_TIME_FORMAT, sq->id,
1036 GST_TIME_ARGS (sink_time), GST_TIME_ARGS (src_time));
1038 /* This allows for streams with out of order timestamping - sometimes the
1039 * emerging timestamp is later than the arriving one(s) */
1040 if (G_LIKELY (sink_time != -1 && src_time != -1 && sink_time > src_time))
1041 sq->cur_time = sink_time - src_time;
1045 /* updating the time level can change the buffering state */
1046 update_buffering (mq, sq);
1051 /* take a SEGMENT event and apply the values to segment, updating the time
1052 * level of queue. */
1054 apply_segment (GstMultiQueue * mq, GstSingleQueue * sq, GstEvent * event,
1055 GstSegment * segment)
1057 gst_event_copy_segment (event, segment);
1059 /* now configure the values, we use these to track timestamps on the
1061 if (segment->format != GST_FORMAT_TIME) {
1062 /* non-time format, pretent the current time segment is closed with a
1063 * 0 start and unknown stop time. */
1064 segment->format = GST_FORMAT_TIME;
1069 GST_MULTI_QUEUE_MUTEX_LOCK (mq);
1071 if (segment == &sq->sink_segment)
1072 sq->sink_tainted = TRUE;
1074 sq->has_src_segment = TRUE;
1075 sq->src_tainted = TRUE;
1078 GST_DEBUG_OBJECT (mq,
1079 "queue %d, configured SEGMENT %" GST_SEGMENT_FORMAT, sq->id, segment);
1081 /* segment can update the time level of the queue */
1082 update_time_level (mq, sq);
1084 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
1085 gst_multi_queue_post_buffering (mq);
1088 /* take a buffer and update segment, updating the time level of the queue. */
1090 apply_buffer (GstMultiQueue * mq, GstSingleQueue * sq, GstClockTime timestamp,
1091 GstClockTime duration, GstSegment * segment)
1093 GST_MULTI_QUEUE_MUTEX_LOCK (mq);
1095 /* if no timestamp is set, assume it's continuous with the previous
1097 if (timestamp == GST_CLOCK_TIME_NONE)
1098 timestamp = segment->position;
1101 if (duration != GST_CLOCK_TIME_NONE)
1102 timestamp += duration;
1104 GST_DEBUG_OBJECT (mq, "queue %d, position updated to %" GST_TIME_FORMAT,
1105 sq->id, GST_TIME_ARGS (timestamp));
1107 segment->position = timestamp;
1109 if (segment == &sq->sink_segment)
1110 sq->sink_tainted = TRUE;
1112 sq->src_tainted = TRUE;
1114 /* calc diff with other end */
1115 update_time_level (mq, sq);
1116 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
1117 gst_multi_queue_post_buffering (mq);
1121 apply_gap (GstMultiQueue * mq, GstSingleQueue * sq, GstEvent * event,
1122 GstSegment * segment)
1124 GstClockTime timestamp;
1125 GstClockTime duration;
1127 GST_MULTI_QUEUE_MUTEX_LOCK (mq);
1129 gst_event_parse_gap (event, ×tamp, &duration);
1131 if (GST_CLOCK_TIME_IS_VALID (timestamp)) {
1133 if (GST_CLOCK_TIME_IS_VALID (duration)) {
1134 timestamp += duration;
1137 segment->position = timestamp;
1139 if (segment == &sq->sink_segment)
1140 sq->sink_tainted = TRUE;
1142 sq->src_tainted = TRUE;
1144 /* calc diff with other end */
1145 update_time_level (mq, sq);
1148 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
1149 gst_multi_queue_post_buffering (mq);
1153 get_running_time (GstSegment * segment, GstMiniObject * object, gboolean end)
1155 GstClockTime time = GST_CLOCK_TIME_NONE;
1157 if (GST_IS_BUFFER (object)) {
1158 GstBuffer *buf = GST_BUFFER_CAST (object);
1160 if (GST_BUFFER_TIMESTAMP_IS_VALID (buf)) {
1161 time = GST_BUFFER_TIMESTAMP (buf);
1162 if (end && GST_BUFFER_DURATION_IS_VALID (buf))
1163 time += GST_BUFFER_DURATION (buf);
1164 if (time > segment->stop)
1165 time = segment->stop;
1166 time = gst_segment_to_running_time (segment, GST_FORMAT_TIME, time);
1168 } else if (GST_IS_BUFFER_LIST (object)) {
1169 GstBufferList *list = GST_BUFFER_LIST_CAST (object);
1173 n = gst_buffer_list_length (list);
1174 for (i = 0; i < n; i++) {
1175 buf = gst_buffer_list_get (list, i);
1176 if (GST_BUFFER_TIMESTAMP_IS_VALID (buf)) {
1177 time = GST_BUFFER_TIMESTAMP (buf);
1178 if (end && GST_BUFFER_DURATION_IS_VALID (buf))
1179 time += GST_BUFFER_DURATION (buf);
1180 if (time > segment->stop)
1181 time = segment->stop;
1182 time = gst_segment_to_running_time (segment, GST_FORMAT_TIME, time);
1189 } else if (GST_IS_EVENT (object)) {
1190 GstEvent *event = GST_EVENT_CAST (object);
1192 /* For newsegment events return the running time of the start position */
1193 if (GST_EVENT_TYPE (event) == GST_EVENT_SEGMENT) {
1194 const GstSegment *new_segment;
1196 gst_event_parse_segment (event, &new_segment);
1197 if (new_segment->format == GST_FORMAT_TIME) {
1199 gst_segment_to_running_time (new_segment, GST_FORMAT_TIME,
1200 new_segment->start);
1209 static GstFlowReturn
1210 gst_single_queue_push_one (GstMultiQueue * mq, GstSingleQueue * sq,
1211 GstMiniObject * object, gboolean * allow_drop)
1213 GstFlowReturn result = sq->srcresult;
1215 if (GST_IS_BUFFER (object)) {
1217 GstClockTime timestamp, duration;
1219 buffer = GST_BUFFER_CAST (object);
1220 timestamp = GST_BUFFER_TIMESTAMP (buffer);
1221 duration = GST_BUFFER_DURATION (buffer);
1223 apply_buffer (mq, sq, timestamp, duration, &sq->src_segment);
1225 /* Applying the buffer may have made the queue non-full again, unblock it if needed */
1226 gst_data_queue_limits_changed (sq->queue);
1228 if (G_UNLIKELY (*allow_drop)) {
1229 GST_DEBUG_OBJECT (mq,
1230 "SingleQueue %d : Dropping EOS buffer %p with ts %" GST_TIME_FORMAT,
1231 sq->id, buffer, GST_TIME_ARGS (timestamp));
1232 gst_buffer_unref (buffer);
1234 GST_DEBUG_OBJECT (mq,
1235 "SingleQueue %d : Pushing buffer %p with ts %" GST_TIME_FORMAT,
1236 sq->id, buffer, GST_TIME_ARGS (timestamp));
1237 result = gst_pad_push (sq->srcpad, buffer);
1239 } else if (GST_IS_EVENT (object)) {
1242 event = GST_EVENT_CAST (object);
1244 switch (GST_EVENT_TYPE (event)) {
1246 result = GST_FLOW_EOS;
1247 if (G_UNLIKELY (*allow_drop))
1248 *allow_drop = FALSE;
1250 case GST_EVENT_SEGMENT:
1251 apply_segment (mq, sq, event, &sq->src_segment);
1252 /* Applying the segment may have made the queue non-full again, unblock it if needed */
1253 gst_data_queue_limits_changed (sq->queue);
1254 if (G_UNLIKELY (*allow_drop)) {
1255 result = GST_FLOW_OK;
1256 *allow_drop = FALSE;
1260 apply_gap (mq, sq, event, &sq->src_segment);
1261 /* Applying the gap may have made the queue non-full again, unblock it if needed */
1262 gst_data_queue_limits_changed (sq->queue);
1268 if (G_UNLIKELY (*allow_drop)) {
1269 GST_DEBUG_OBJECT (mq,
1270 "SingleQueue %d : Dropping EOS event %p of type %s",
1271 sq->id, event, GST_EVENT_TYPE_NAME (event));
1272 gst_event_unref (event);
1274 GST_DEBUG_OBJECT (mq,
1275 "SingleQueue %d : Pushing event %p of type %s",
1276 sq->id, event, GST_EVENT_TYPE_NAME (event));
1278 gst_pad_push_event (sq->srcpad, event);
1280 } else if (GST_IS_QUERY (object)) {
1284 query = GST_QUERY_CAST (object);
1286 if (G_UNLIKELY (*allow_drop)) {
1287 GST_DEBUG_OBJECT (mq,
1288 "SingleQueue %d : Dropping EOS query %p", sq->id, query);
1289 gst_query_unref (query);
1292 res = gst_pad_peer_query (sq->srcpad, query);
1295 GST_MULTI_QUEUE_MUTEX_LOCK (mq);
1296 sq->last_query = res;
1297 sq->last_handled_query = query;
1298 g_cond_signal (&sq->query_handled);
1299 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
1301 g_warning ("Unexpected object in singlequeue %u (refcounting problem?)",
1309 static GstMiniObject *
1310 gst_multi_queue_item_steal_object (GstMultiQueueItem * item)
1315 item->object = NULL;
1321 gst_multi_queue_item_destroy (GstMultiQueueItem * item)
1323 if (!item->is_query && item->object)
1324 gst_mini_object_unref (item->object);
1325 g_slice_free (GstMultiQueueItem, item);
1328 /* takes ownership of passed mini object! */
1329 static GstMultiQueueItem *
1330 gst_multi_queue_buffer_item_new (GstMiniObject * object, guint32 curid)
1332 GstMultiQueueItem *item;
1334 item = g_slice_new (GstMultiQueueItem);
1335 item->object = object;
1336 item->destroy = (GDestroyNotify) gst_multi_queue_item_destroy;
1337 item->posid = curid;
1338 item->is_query = GST_IS_QUERY (object);
1340 item->size = gst_buffer_get_size (GST_BUFFER_CAST (object));
1341 item->duration = GST_BUFFER_DURATION (object);
1342 if (item->duration == GST_CLOCK_TIME_NONE)
1344 item->visible = TRUE;
1348 static GstMultiQueueItem *
1349 gst_multi_queue_mo_item_new (GstMiniObject * object, guint32 curid)
1351 GstMultiQueueItem *item;
1353 item = g_slice_new (GstMultiQueueItem);
1354 item->object = object;
1355 item->destroy = (GDestroyNotify) gst_multi_queue_item_destroy;
1356 item->posid = curid;
1357 item->is_query = GST_IS_QUERY (object);
1361 item->visible = FALSE;
1365 /* Each main loop attempts to push buffers until the return value
1366 * is not-linked. not-linked pads are not allowed to push data beyond
1367 * any linked pads, so they don't 'rush ahead of the pack'.
1370 gst_multi_queue_loop (GstPad * pad)
1373 GstMultiQueueItem *item;
1374 GstDataQueueItem *sitem;
1376 GstMiniObject *object = NULL;
1378 GstFlowReturn result;
1379 GstClockTime next_time;
1381 gboolean do_update_buffering = FALSE;
1382 gboolean dropping = FALSE;
1384 sq = (GstSingleQueue *) gst_pad_get_element_private (pad);
1388 GST_DEBUG_OBJECT (mq, "SingleQueue %d : trying to pop an object", sq->id);
1393 /* Get something from the queue, blocking until that happens, or we get
1395 if (!(gst_data_queue_pop (sq->queue, &sitem)))
1398 item = (GstMultiQueueItem *) sitem;
1399 newid = item->posid;
1401 /* steal the object and destroy the item */
1402 object = gst_multi_queue_item_steal_object (item);
1403 gst_multi_queue_item_destroy (item);
1405 is_buffer = GST_IS_BUFFER (object);
1407 /* Get running time of the item. Events will have GST_CLOCK_TIME_NONE */
1408 next_time = get_running_time (&sq->src_segment, object, TRUE);
1410 GST_LOG_OBJECT (mq, "SingleQueue %d : newid:%d , oldid:%d",
1411 sq->id, newid, sq->last_oldid);
1413 /* If we're not-linked, we do some extra work because we might need to
1414 * wait before pushing. If we're linked but there's a gap in the IDs,
1415 * or it's the first loop, or we just passed the previous highid,
1416 * we might need to wake some sleeping pad up, so there's extra work
1418 GST_MULTI_QUEUE_MUTEX_LOCK (mq);
1419 if (sq->srcresult == GST_FLOW_NOT_LINKED
1420 || (sq->last_oldid == G_MAXUINT32) || (newid != (sq->last_oldid + 1))
1421 || sq->last_oldid > mq->highid) {
1422 GST_LOG_OBJECT (mq, "CHECKING sq->srcresult: %s",
1423 gst_flow_get_name (sq->srcresult));
1425 /* Check again if we're flushing after the lock is taken,
1426 * the flush flag might have been changed in the meantime */
1428 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
1432 /* Update the nextid so other threads know when to wake us up */
1434 sq->next_time = next_time;
1436 /* Update the oldid (the last ID we output) for highid tracking */
1437 if (sq->last_oldid != G_MAXUINT32)
1438 sq->oldid = sq->last_oldid;
1440 if (sq->srcresult == GST_FLOW_NOT_LINKED) {
1441 /* Go to sleep until it's time to push this buffer */
1443 /* Recompute the highid */
1444 compute_high_id (mq);
1445 /* Recompute the high time */
1446 compute_high_time (mq);
1448 while (((mq->sync_by_running_time && next_time != GST_CLOCK_TIME_NONE &&
1449 (mq->high_time == GST_CLOCK_TIME_NONE
1450 || next_time >= mq->high_time))
1451 || (!mq->sync_by_running_time && newid > mq->highid))
1452 && sq->srcresult == GST_FLOW_NOT_LINKED) {
1454 GST_DEBUG_OBJECT (mq,
1455 "queue %d sleeping for not-linked wakeup with "
1456 "newid %u, highid %u, next_time %" GST_TIME_FORMAT
1457 ", high_time %" GST_TIME_FORMAT, sq->id, newid, mq->highid,
1458 GST_TIME_ARGS (next_time), GST_TIME_ARGS (mq->high_time));
1460 /* Wake up all non-linked pads before we sleep */
1461 wake_up_next_non_linked (mq);
1464 g_cond_wait (&sq->turn, &mq->qlock);
1468 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
1472 /* Recompute the high time */
1473 compute_high_time (mq);
1475 GST_DEBUG_OBJECT (mq, "queue %d woken from sleeping for not-linked "
1476 "wakeup with newid %u, highid %u, next_time %" GST_TIME_FORMAT
1477 ", high_time %" GST_TIME_FORMAT, sq->id, newid, mq->highid,
1478 GST_TIME_ARGS (next_time), GST_TIME_ARGS (mq->high_time));
1481 /* Re-compute the high_id in case someone else pushed */
1482 compute_high_id (mq);
1484 compute_high_id (mq);
1485 /* Wake up all non-linked pads */
1486 wake_up_next_non_linked (mq);
1488 /* We're done waiting, we can clear the nextid and nexttime */
1490 sq->next_time = GST_CLOCK_TIME_NONE;
1492 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
1497 GST_LOG_OBJECT (mq, "BEFORE PUSHING sq->srcresult: %s",
1498 gst_flow_get_name (sq->srcresult));
1500 /* Update time stats */
1501 GST_MULTI_QUEUE_MUTEX_LOCK (mq);
1502 next_time = get_running_time (&sq->src_segment, object, FALSE);
1503 if (next_time != GST_CLOCK_TIME_NONE) {
1504 if (sq->last_time == GST_CLOCK_TIME_NONE || sq->last_time < next_time)
1505 sq->last_time = next_time;
1506 if (mq->high_time == GST_CLOCK_TIME_NONE || mq->high_time <= next_time) {
1507 /* Wake up all non-linked pads now that we advanced the high time */
1508 mq->high_time = next_time;
1509 wake_up_next_non_linked (mq);
1512 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
1514 /* Try to push out the new object */
1515 result = gst_single_queue_push_one (mq, sq, object, &dropping);
1518 /* Check if we pushed something already and if this is
1519 * now a switch from an active to a non-active stream.
1521 * If it is, we reset all the waiting streams, let them
1522 * push another buffer to see if they're now active again.
1523 * This allows faster switching between streams and prevents
1524 * deadlocks if downstream does any waiting too.
1526 GST_MULTI_QUEUE_MUTEX_LOCK (mq);
1527 if (sq->pushed && sq->srcresult == GST_FLOW_OK
1528 && result == GST_FLOW_NOT_LINKED) {
1531 GST_LOG_OBJECT (mq, "SingleQueue %d : Changed from active to non-active",
1534 compute_high_id (mq);
1535 do_update_buffering = TRUE;
1537 /* maybe no-one is waiting */
1538 if (mq->numwaiting > 0) {
1539 /* Else figure out which singlequeue(s) need waking up */
1540 for (tmp = mq->queues; tmp; tmp = g_list_next (tmp)) {
1541 GstSingleQueue *sq2 = (GstSingleQueue *) tmp->data;
1543 if (sq2->srcresult == GST_FLOW_NOT_LINKED) {
1544 GST_LOG_OBJECT (mq, "Waking up singlequeue %d", sq2->id);
1545 sq2->pushed = FALSE;
1546 sq2->srcresult = GST_FLOW_OK;
1547 g_cond_signal (&sq2->turn);
1556 /* now hold on a bit;
1557 * can not simply throw this result to upstream, because
1558 * that might already be onto another segment, so we have to make
1559 * sure we are relaying the correct info wrt proper segment */
1560 if (result == GST_FLOW_EOS && !dropping &&
1561 sq->srcresult != GST_FLOW_NOT_LINKED) {
1562 GST_DEBUG_OBJECT (mq, "starting EOS drop on sq %d", sq->id);
1564 /* pretend we have not seen EOS yet for upstream's sake */
1565 result = sq->srcresult;
1566 } else if (dropping && gst_data_queue_is_empty (sq->queue)) {
1567 /* queue empty, so stop dropping
1568 * we can commit the result we have now,
1569 * which is either OK after a segment, or EOS */
1570 GST_DEBUG_OBJECT (mq, "committed EOS drop on sq %d", sq->id);
1572 result = GST_FLOW_EOS;
1574 sq->srcresult = result;
1575 sq->last_oldid = newid;
1577 if (do_update_buffering)
1578 update_buffering (mq, sq);
1580 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
1581 gst_multi_queue_post_buffering (mq);
1586 if (result != GST_FLOW_OK && result != GST_FLOW_NOT_LINKED
1587 && result != GST_FLOW_EOS)
1590 GST_LOG_OBJECT (mq, "AFTER PUSHING sq->srcresult: %s",
1591 gst_flow_get_name (sq->srcresult));
1593 GST_MULTI_QUEUE_MUTEX_LOCK (mq);
1594 if (mq->numwaiting > 0 && sq->srcresult == GST_FLOW_EOS) {
1595 compute_high_time (mq);
1596 compute_high_id (mq);
1597 wake_up_next_non_linked (mq);
1599 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
1606 gst_mini_object_unref (object);
1608 /* Need to make sure wake up any sleeping pads when we exit */
1609 GST_MULTI_QUEUE_MUTEX_LOCK (mq);
1610 compute_high_time (mq);
1611 compute_high_id (mq);
1612 wake_up_next_non_linked (mq);
1613 sq->last_query = FALSE;
1614 g_cond_signal (&sq->query_handled);
1616 /* Post an error message if we got EOS while downstream
1617 * has returned an error flow return. After EOS there
1618 * will be no further buffer which could propagate the
1620 if (sq->is_eos && sq->srcresult < GST_FLOW_EOS) {
1621 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
1622 GST_ELEMENT_ERROR (mq, STREAM, FAILED,
1623 ("Internal data stream error."),
1624 ("streaming stopped, reason %s", gst_flow_get_name (sq->srcresult)));
1626 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
1629 /* upstream needs to see fatal result ASAP to shut things down,
1630 * but might be stuck in one of our other full queues;
1631 * so empty this one and trigger dynamic queue growth. At
1632 * this point the srcresult is not OK, NOT_LINKED
1633 * or EOS, i.e. a real failure */
1634 gst_single_queue_flush_queue (sq, FALSE);
1635 single_queue_underrun_cb (sq->queue, sq);
1636 gst_data_queue_set_flushing (sq->queue, TRUE);
1637 gst_pad_pause_task (sq->srcpad);
1638 GST_CAT_LOG_OBJECT (multi_queue_debug, mq,
1639 "SingleQueue[%d] task paused, reason:%s",
1640 sq->id, gst_flow_get_name (sq->srcresult));
1646 * gst_multi_queue_chain:
1648 * This is similar to GstQueue's chain function, except:
1649 * _ we don't have leak behaviours,
1650 * _ we push with a unique id (curid)
1652 static GstFlowReturn
1653 gst_multi_queue_chain (GstPad * pad, GstObject * parent, GstBuffer * buffer)
1657 GstMultiQueueItem *item;
1659 GstClockTime timestamp, duration;
1661 sq = gst_pad_get_element_private (pad);
1664 /* if eos, we are always full, so avoid hanging incoming indefinitely */
1668 /* Get a unique incrementing id */
1669 curid = g_atomic_int_add ((gint *) & mq->counter, 1);
1671 GST_LOG_OBJECT (mq, "SingleQueue %d : about to enqueue buffer %p with id %d",
1672 sq->id, buffer, curid);
1674 item = gst_multi_queue_buffer_item_new (GST_MINI_OBJECT_CAST (buffer), curid);
1676 timestamp = GST_BUFFER_TIMESTAMP (buffer);
1677 duration = GST_BUFFER_DURATION (buffer);
1679 if (!(gst_data_queue_push (sq->queue, (GstDataQueueItem *) item)))
1682 /* update time level, we must do this after pushing the data in the queue so
1683 * that we never end up filling the queue first. */
1684 apply_buffer (mq, sq, timestamp, duration, &sq->sink_segment);
1687 return sq->srcresult;
1692 GST_LOG_OBJECT (mq, "SingleQueue %d : exit because task paused, reason: %s",
1693 sq->id, gst_flow_get_name (sq->srcresult));
1694 gst_multi_queue_item_destroy (item);
1699 GST_DEBUG_OBJECT (mq, "we are EOS, dropping buffer, return EOS");
1700 gst_buffer_unref (buffer);
1701 return GST_FLOW_EOS;
1706 gst_multi_queue_sink_activate_mode (GstPad * pad, GstObject * parent,
1707 GstPadMode mode, gboolean active)
1713 sq = (GstSingleQueue *) gst_pad_get_element_private (pad);
1714 mq = (GstMultiQueue *) gst_pad_get_parent (pad);
1716 /* mq is NULL if the pad is activated/deactivated before being
1717 * added to the multiqueue */
1719 GST_MULTI_QUEUE_MUTEX_LOCK (mq);
1722 case GST_PAD_MODE_PUSH:
1724 /* All pads start off linked until they push one buffer */
1725 sq->srcresult = GST_FLOW_OK;
1727 gst_data_queue_set_flushing (sq->queue, FALSE);
1729 sq->srcresult = GST_FLOW_FLUSHING;
1730 sq->last_query = FALSE;
1731 g_cond_signal (&sq->query_handled);
1732 gst_data_queue_set_flushing (sq->queue, TRUE);
1734 /* Wait until streaming thread has finished */
1736 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
1737 GST_PAD_STREAM_LOCK (pad);
1739 GST_MULTI_QUEUE_MUTEX_LOCK (mq);
1740 gst_data_queue_flush (sq->queue);
1742 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
1743 GST_PAD_STREAM_UNLOCK (pad);
1745 GST_MULTI_QUEUE_MUTEX_LOCK (mq);
1755 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
1756 gst_object_unref (mq);
1763 gst_multi_queue_sink_event (GstPad * pad, GstObject * parent, GstEvent * event)
1768 GstMultiQueueItem *item;
1771 GstEvent *sref = NULL;
1773 sq = (GstSingleQueue *) gst_pad_get_element_private (pad);
1774 mq = (GstMultiQueue *) parent;
1776 type = GST_EVENT_TYPE (event);
1779 case GST_EVENT_FLUSH_START:
1780 GST_DEBUG_OBJECT (mq, "SingleQueue %d : received flush start event",
1783 res = gst_pad_push_event (sq->srcpad, event);
1785 gst_single_queue_flush (mq, sq, TRUE, FALSE);
1788 case GST_EVENT_FLUSH_STOP:
1789 GST_DEBUG_OBJECT (mq, "SingleQueue %d : received flush stop event",
1792 res = gst_pad_push_event (sq->srcpad, event);
1794 gst_single_queue_flush (mq, sq, FALSE, FALSE);
1797 case GST_EVENT_SEGMENT:
1799 /* take ref because the queue will take ownership and we need the event
1800 * afterwards to update the segment */
1801 sref = gst_event_ref (event);
1805 if (!(GST_EVENT_IS_SERIALIZED (event))) {
1806 res = gst_pad_push_event (sq->srcpad, event);
1812 /* if eos, we are always full, so avoid hanging incoming indefinitely */
1816 /* Get an unique incrementing id. */
1817 curid = g_atomic_int_add ((gint *) & mq->counter, 1);
1819 item = gst_multi_queue_mo_item_new ((GstMiniObject *) event, curid);
1821 GST_DEBUG_OBJECT (mq,
1822 "SingleQueue %d : Enqueuing event %p of type %s with id %d",
1823 sq->id, event, GST_EVENT_TYPE_NAME (event), curid);
1825 if (!(res = gst_data_queue_push (sq->queue, (GstDataQueueItem *) item)))
1828 /* mark EOS when we received one, we must do that after putting the
1829 * buffer in the queue because EOS marks the buffer as filled. */
1832 GST_MULTI_QUEUE_MUTEX_LOCK (mq);
1835 /* Post an error message if we got EOS while downstream
1836 * has returned an error flow return. After EOS there
1837 * will be no further buffer which could propagate the
1839 if (sq->srcresult < GST_FLOW_EOS) {
1840 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
1841 GST_ELEMENT_ERROR (mq, STREAM, FAILED,
1842 ("Internal data stream error."),
1843 ("streaming stopped, reason %s",
1844 gst_flow_get_name (sq->srcresult)));
1846 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
1849 /* EOS affects the buffering state */
1850 GST_MULTI_QUEUE_MUTEX_LOCK (mq);
1851 update_buffering (mq, sq);
1852 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
1853 single_queue_overrun_cb (sq->queue, sq);
1854 gst_multi_queue_post_buffering (mq);
1856 case GST_EVENT_SEGMENT:
1857 apply_segment (mq, sq, sref, &sq->sink_segment);
1858 gst_event_unref (sref);
1859 /* a new segment allows us to accept more buffers if we got EOS
1860 * from downstream */
1861 GST_MULTI_QUEUE_MUTEX_LOCK (mq);
1862 sq->srcresult = GST_FLOW_OK;
1863 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
1866 apply_gap (mq, sq, sref, &sq->sink_segment);
1867 gst_event_unref (sref);
1876 GST_LOG_OBJECT (mq, "SingleQueue %d : exit because task paused, reason: %s",
1877 sq->id, gst_flow_get_name (sq->srcresult));
1879 gst_event_unref (sref);
1880 gst_multi_queue_item_destroy (item);
1885 GST_DEBUG_OBJECT (mq, "we are EOS, dropping event, return FALSE");
1886 gst_event_unref (event);
1893 gst_multi_queue_sink_query (GstPad * pad, GstObject * parent, GstQuery * query)
1899 sq = (GstSingleQueue *) gst_pad_get_element_private (pad);
1900 mq = (GstMultiQueue *) parent;
1902 switch (GST_QUERY_TYPE (query)) {
1904 if (GST_QUERY_IS_SERIALIZED (query)) {
1906 GstMultiQueueItem *item;
1908 GST_MULTI_QUEUE_MUTEX_LOCK (mq);
1909 if (sq->srcresult != GST_FLOW_OK)
1912 /* serialized events go in the queue. We need to be certain that we
1913 * don't cause deadlocks waiting for the query return value. We check if
1914 * the queue is empty (nothing is blocking downstream and the query can
1915 * be pushed for sure) or we are not buffering. If we are buffering,
1916 * the pipeline waits to unblock downstream until our queue fills up
1917 * completely, which can not happen if we block on the query..
1918 * Therefore we only potentially block when we are not buffering. */
1919 if (!mq->use_buffering || gst_data_queue_is_empty (sq->queue)) {
1920 /* Get an unique incrementing id. */
1921 curid = g_atomic_int_add ((gint *) & mq->counter, 1);
1923 item = gst_multi_queue_mo_item_new ((GstMiniObject *) query, curid);
1925 GST_DEBUG_OBJECT (mq,
1926 "SingleQueue %d : Enqueuing query %p of type %s with id %d",
1927 sq->id, query, GST_QUERY_TYPE_NAME (query), curid);
1928 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
1929 res = gst_data_queue_push (sq->queue, (GstDataQueueItem *) item);
1930 GST_MULTI_QUEUE_MUTEX_LOCK (mq);
1931 /* it might be that the query has been taken out of the queue
1932 * while we were unlocked. So, we need to check if the last
1933 * handled query is the same one than the one we just
1934 * pushed. If it is, we don't need to wait for the condition
1935 * variable, otherwise we wait for the condition variable to
1937 if (sq->last_handled_query != query)
1938 g_cond_wait (&sq->query_handled, &mq->qlock);
1939 res = sq->last_query;
1940 sq->last_handled_query = NULL;
1942 GST_DEBUG_OBJECT (mq, "refusing query, we are buffering and the "
1943 "queue is not empty");
1946 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
1948 /* default handling */
1949 res = gst_pad_query_default (pad, parent, query);
1957 GST_DEBUG_OBJECT (mq, "Flushing");
1958 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
1964 gst_multi_queue_src_activate_mode (GstPad * pad, GstObject * parent,
1965 GstPadMode mode, gboolean active)
1971 sq = (GstSingleQueue *) gst_pad_get_element_private (pad);
1974 GST_DEBUG_OBJECT (mq, "SingleQueue %d", sq->id);
1977 case GST_PAD_MODE_PUSH:
1979 result = gst_single_queue_flush (mq, sq, FALSE, TRUE);
1981 result = gst_single_queue_flush (mq, sq, TRUE, TRUE);
1982 /* make sure streaming finishes */
1983 result |= gst_pad_stop_task (pad);
1994 gst_multi_queue_src_event (GstPad * pad, GstObject * parent, GstEvent * event)
1996 GstSingleQueue *sq = gst_pad_get_element_private (pad);
1997 GstMultiQueue *mq = sq->mqueue;
2000 switch (GST_EVENT_TYPE (event)) {
2001 case GST_EVENT_RECONFIGURE:
2002 GST_MULTI_QUEUE_MUTEX_LOCK (mq);
2003 if (sq->srcresult == GST_FLOW_NOT_LINKED) {
2004 sq->srcresult = GST_FLOW_OK;
2005 g_cond_signal (&sq->turn);
2007 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
2009 ret = gst_pad_push_event (sq->sinkpad, event);
2012 ret = gst_pad_push_event (sq->sinkpad, event);
2020 gst_multi_queue_src_query (GstPad * pad, GstObject * parent, GstQuery * query)
2024 /* FIXME, Handle position offset depending on queue size */
2025 switch (GST_QUERY_TYPE (query)) {
2027 /* default handling */
2028 res = gst_pad_query_default (pad, parent, query);
2035 * Next-non-linked functions
2038 /* WITH LOCK TAKEN */
2040 wake_up_next_non_linked (GstMultiQueue * mq)
2044 /* maybe no-one is waiting */
2045 if (mq->numwaiting < 1)
2048 /* Else figure out which singlequeue(s) need waking up */
2049 for (tmp = mq->queues; tmp; tmp = g_list_next (tmp)) {
2050 GstSingleQueue *sq = (GstSingleQueue *) tmp->data;
2052 if (sq->srcresult == GST_FLOW_NOT_LINKED) {
2053 if ((mq->sync_by_running_time && mq->high_time != GST_CLOCK_TIME_NONE
2054 && sq->next_time != GST_CLOCK_TIME_NONE
2055 && sq->next_time >= mq->high_time)
2056 || (sq->nextid != 0 && sq->nextid <= mq->highid)) {
2057 GST_LOG_OBJECT (mq, "Waking up singlequeue %d", sq->id);
2058 g_cond_signal (&sq->turn);
2064 /* WITH LOCK TAKEN */
2066 compute_high_id (GstMultiQueue * mq)
2068 /* The high-id is either the highest id among the linked pads, or if all
2069 * pads are not-linked, it's the lowest not-linked pad */
2071 guint32 lowest = G_MAXUINT32;
2072 guint32 highid = G_MAXUINT32;
2074 for (tmp = mq->queues; tmp; tmp = g_list_next (tmp)) {
2075 GstSingleQueue *sq = (GstSingleQueue *) tmp->data;
2077 GST_LOG_OBJECT (mq, "inspecting sq:%d , nextid:%d, oldid:%d, srcresult:%s",
2078 sq->id, sq->nextid, sq->oldid, gst_flow_get_name (sq->srcresult));
2080 if (sq->srcresult == GST_FLOW_NOT_LINKED) {
2081 /* No need to consider queues which are not waiting */
2082 if (sq->nextid == 0) {
2083 GST_LOG_OBJECT (mq, "sq:%d is not waiting - ignoring", sq->id);
2087 if (sq->nextid < lowest)
2088 lowest = sq->nextid;
2089 } else if (sq->srcresult != GST_FLOW_EOS) {
2090 /* If we don't have a global highid, or the global highid is lower than
2091 * this single queue's last outputted id, store the queue's one,
2092 * unless the singlequeue is at EOS (srcresult = EOS) */
2093 if ((highid == G_MAXUINT32) || (sq->oldid > highid))
2098 if (highid == G_MAXUINT32 || lowest < highid)
2099 mq->highid = lowest;
2101 mq->highid = highid;
2103 GST_LOG_OBJECT (mq, "Highid is now : %u, lowest non-linked %u", mq->highid,
2107 /* WITH LOCK TAKEN */
2109 compute_high_time (GstMultiQueue * mq)
2111 /* The high-id is either the highest id among the linked pads, or if all
2112 * pads are not-linked, it's the lowest not-linked pad */
2114 GstClockTime highest = GST_CLOCK_TIME_NONE;
2115 GstClockTime lowest = GST_CLOCK_TIME_NONE;
2117 for (tmp = mq->queues; tmp; tmp = g_list_next (tmp)) {
2118 GstSingleQueue *sq = (GstSingleQueue *) tmp->data;
2121 "inspecting sq:%d , next_time:%" GST_TIME_FORMAT ", last_time:%"
2122 GST_TIME_FORMAT ", srcresult:%s", sq->id, GST_TIME_ARGS (sq->next_time),
2123 GST_TIME_ARGS (sq->last_time), gst_flow_get_name (sq->srcresult));
2125 if (sq->srcresult == GST_FLOW_NOT_LINKED) {
2126 /* No need to consider queues which are not waiting */
2127 if (sq->next_time == GST_CLOCK_TIME_NONE) {
2128 GST_LOG_OBJECT (mq, "sq:%d is not waiting - ignoring", sq->id);
2132 if (lowest == GST_CLOCK_TIME_NONE || sq->next_time < lowest)
2133 lowest = sq->next_time;
2134 } else if (sq->srcresult != GST_FLOW_EOS) {
2135 /* If we don't have a global highid, or the global highid is lower than
2136 * this single queue's last outputted id, store the queue's one,
2137 * unless the singlequeue is at EOS (srcresult = EOS) */
2138 if (highest == GST_CLOCK_TIME_NONE || sq->last_time > highest)
2139 highest = sq->last_time;
2143 mq->high_time = highest;
2146 "High time is now : %" GST_TIME_FORMAT ", lowest non-linked %"
2147 GST_TIME_FORMAT, GST_TIME_ARGS (mq->high_time), GST_TIME_ARGS (lowest));
2150 #define IS_FILLED(q, format, value) (((q)->max_size.format) != 0 && \
2151 ((q)->max_size.format) <= (value))
2154 * GstSingleQueue functions
2157 single_queue_overrun_cb (GstDataQueue * dq, GstSingleQueue * sq)
2159 GstMultiQueue *mq = sq->mqueue;
2161 GstDataQueueSize size;
2162 gboolean filled = TRUE;
2163 gboolean empty_found = FALSE;
2165 gst_data_queue_get_level (sq->queue, &size);
2168 "Single Queue %d: EOS %d, visible %u/%u, bytes %u/%u, time %"
2169 G_GUINT64_FORMAT "/%" G_GUINT64_FORMAT, sq->id, sq->is_eos, size.visible,
2170 sq->max_size.visible, size.bytes, sq->max_size.bytes, sq->cur_time,
2173 GST_MULTI_QUEUE_MUTEX_LOCK (mq);
2175 /* check if we reached the hard time/bytes limits */
2176 if (sq->is_eos || IS_FILLED (sq, bytes, size.bytes) ||
2177 IS_FILLED (sq, time, sq->cur_time)) {
2181 /* Search for empty queues */
2182 for (tmp = mq->queues; tmp; tmp = g_list_next (tmp)) {
2183 GstSingleQueue *oq = (GstSingleQueue *) tmp->data;
2188 if (oq->srcresult == GST_FLOW_NOT_LINKED) {
2189 GST_LOG_OBJECT (mq, "Queue %d is not-linked", oq->id);
2193 GST_LOG_OBJECT (mq, "Checking Queue %d", oq->id);
2194 if (gst_data_queue_is_empty (oq->queue)) {
2195 GST_LOG_OBJECT (mq, "Queue %d is empty", oq->id);
2201 /* if hard limits are not reached then we allow one more buffer in the full
2202 * queue, but only if any of the other singelqueues are empty */
2204 if (IS_FILLED (sq, visible, size.visible)) {
2205 sq->max_size.visible = size.visible + 1;
2206 GST_DEBUG_OBJECT (mq,
2207 "Bumping single queue %d max visible to %d",
2208 sq->id, sq->max_size.visible);
2214 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
2216 /* Overrun is always forwarded, since this is blocking the upstream element */
2218 GST_DEBUG_OBJECT (mq, "Queue %d is filled, signalling overrun", sq->id);
2219 g_signal_emit (mq, gst_multi_queue_signals[SIGNAL_OVERRUN], 0);
2224 single_queue_underrun_cb (GstDataQueue * dq, GstSingleQueue * sq)
2226 gboolean empty = TRUE;
2227 GstMultiQueue *mq = sq->mqueue;
2230 if (sq->srcresult == GST_FLOW_NOT_LINKED) {
2231 GST_LOG_OBJECT (mq, "Single Queue %d is empty but not-linked", sq->id);
2235 "Single Queue %d is empty, Checking other single queues", sq->id);
2238 GST_MULTI_QUEUE_MUTEX_LOCK (mq);
2239 for (tmp = mq->queues; tmp; tmp = g_list_next (tmp)) {
2240 GstSingleQueue *oq = (GstSingleQueue *) tmp->data;
2242 if (gst_data_queue_is_full (oq->queue)) {
2243 GstDataQueueSize size;
2245 gst_data_queue_get_level (oq->queue, &size);
2246 if (IS_FILLED (oq, visible, size.visible)) {
2247 oq->max_size.visible = size.visible + 1;
2248 GST_DEBUG_OBJECT (mq,
2249 "queue %d is filled, bumping its max visible to %d", oq->id,
2250 oq->max_size.visible);
2251 gst_data_queue_limits_changed (oq->queue);
2254 if (!gst_data_queue_is_empty (oq->queue))
2257 GST_MULTI_QUEUE_MUTEX_UNLOCK (mq);
2260 GST_DEBUG_OBJECT (mq, "All queues are empty, signalling it");
2261 g_signal_emit (mq, gst_multi_queue_signals[SIGNAL_UNDERRUN], 0);
2266 single_queue_check_full (GstDataQueue * dataq, guint visible, guint bytes,
2267 guint64 time, GstSingleQueue * sq)
2270 GstMultiQueue *mq = sq->mqueue;
2272 GST_DEBUG_OBJECT (mq,
2273 "queue %d: visible %u/%u, bytes %u/%u, time %" G_GUINT64_FORMAT "/%"
2274 G_GUINT64_FORMAT, sq->id, visible, sq->max_size.visible, bytes,
2275 sq->max_size.bytes, sq->cur_time, sq->max_size.time);
2277 /* we are always filled on EOS */
2281 /* we never go past the max visible items unless we are in buffering mode */
2282 if (!mq->use_buffering && IS_FILLED (sq, visible, visible))
2285 /* check time or bytes */
2286 res = IS_FILLED (sq, time, sq->cur_time) || IS_FILLED (sq, bytes, bytes);
2292 gst_single_queue_flush_queue (GstSingleQueue * sq, gboolean full)
2294 GstDataQueueItem *sitem;
2295 GstMultiQueueItem *mitem;
2296 gboolean was_flushing = FALSE;
2298 while (!gst_data_queue_is_empty (sq->queue)) {
2299 GstMiniObject *data;
2301 /* FIXME: If this fails here although the queue is not empty,
2302 * we're flushing... but we want to rescue all sticky
2303 * events nonetheless.
2305 if (!gst_data_queue_pop (sq->queue, &sitem)) {
2306 was_flushing = TRUE;
2307 gst_data_queue_set_flushing (sq->queue, FALSE);
2311 mitem = (GstMultiQueueItem *) sitem;
2313 data = sitem->object;
2315 if (!full && !mitem->is_query && GST_IS_EVENT (data)
2316 && GST_EVENT_IS_STICKY (data)
2317 && GST_EVENT_TYPE (data) != GST_EVENT_SEGMENT
2318 && GST_EVENT_TYPE (data) != GST_EVENT_EOS) {
2319 gst_pad_store_sticky_event (sq->srcpad, GST_EVENT_CAST (data));
2322 sitem->destroy (sitem);
2325 gst_data_queue_flush (sq->queue);
2327 gst_data_queue_set_flushing (sq->queue, TRUE);
2329 GST_MULTI_QUEUE_MUTEX_LOCK (sq->mqueue);
2330 update_buffering (sq->mqueue, sq);
2331 GST_MULTI_QUEUE_MUTEX_UNLOCK (sq->mqueue);
2332 gst_multi_queue_post_buffering (sq->mqueue);
2336 gst_single_queue_free (GstSingleQueue * sq)
2339 gst_data_queue_flush (sq->queue);
2340 g_object_unref (sq->queue);
2341 g_cond_clear (&sq->turn);
2342 g_cond_clear (&sq->query_handled);
2346 static GstSingleQueue *
2347 gst_single_queue_new (GstMultiQueue * mqueue, guint id)
2352 guint temp_id = (id == -1) ? 0 : id;
2354 GST_MULTI_QUEUE_MUTEX_LOCK (mqueue);
2356 /* Find an unused queue ID, if possible the passed one */
2357 for (tmp = mqueue->queues; tmp; tmp = g_list_next (tmp)) {
2358 GstSingleQueue *sq2 = (GstSingleQueue *) tmp->data;
2359 /* This works because the IDs are sorted in ascending order */
2360 if (sq2->id == temp_id) {
2361 /* If this ID was requested by the caller return NULL,
2362 * otherwise just get us the next one */
2364 temp_id = sq2->id + 1;
2367 } else if (sq2->id > temp_id) {
2372 sq = g_new0 (GstSingleQueue, 1);
2376 mqueue->queues = g_list_insert_before (mqueue->queues, tmp, sq);
2377 mqueue->queues_cookie++;
2379 /* copy over max_size and extra_size so we don't need to take the lock
2380 * any longer when checking if the queue is full. */
2381 sq->max_size.visible = mqueue->max_size.visible;
2382 sq->max_size.bytes = mqueue->max_size.bytes;
2383 sq->max_size.time = mqueue->max_size.time;
2385 sq->extra_size.visible = mqueue->extra_size.visible;
2386 sq->extra_size.bytes = mqueue->extra_size.bytes;
2387 sq->extra_size.time = mqueue->extra_size.time;
2389 GST_DEBUG_OBJECT (mqueue, "Creating GstSingleQueue id:%d", sq->id);
2391 sq->mqueue = mqueue;
2392 sq->srcresult = GST_FLOW_FLUSHING;
2394 sq->queue = gst_data_queue_new ((GstDataQueueCheckFullFunction)
2395 single_queue_check_full,
2396 (GstDataQueueFullCallback) single_queue_overrun_cb,
2397 (GstDataQueueEmptyCallback) single_queue_underrun_cb, sq);
2399 sq->flushing = FALSE;
2400 gst_segment_init (&sq->sink_segment, GST_FORMAT_TIME);
2401 gst_segment_init (&sq->src_segment, GST_FORMAT_TIME);
2405 sq->next_time = GST_CLOCK_TIME_NONE;
2406 sq->last_time = GST_CLOCK_TIME_NONE;
2407 g_cond_init (&sq->turn);
2408 g_cond_init (&sq->query_handled);
2410 sq->sinktime = GST_CLOCK_TIME_NONE;
2411 sq->srctime = GST_CLOCK_TIME_NONE;
2412 sq->sink_tainted = TRUE;
2413 sq->src_tainted = TRUE;
2415 name = g_strdup_printf ("sink_%u", sq->id);
2416 sq->sinkpad = gst_pad_new_from_static_template (&sinktemplate, name);
2419 gst_pad_set_chain_function (sq->sinkpad,
2420 GST_DEBUG_FUNCPTR (gst_multi_queue_chain));
2421 gst_pad_set_activatemode_function (sq->sinkpad,
2422 GST_DEBUG_FUNCPTR (gst_multi_queue_sink_activate_mode));
2423 gst_pad_set_event_function (sq->sinkpad,
2424 GST_DEBUG_FUNCPTR (gst_multi_queue_sink_event));
2425 gst_pad_set_query_function (sq->sinkpad,
2426 GST_DEBUG_FUNCPTR (gst_multi_queue_sink_query));
2427 gst_pad_set_iterate_internal_links_function (sq->sinkpad,
2428 GST_DEBUG_FUNCPTR (gst_multi_queue_iterate_internal_links));
2429 GST_OBJECT_FLAG_SET (sq->sinkpad, GST_PAD_FLAG_PROXY_CAPS);
2431 name = g_strdup_printf ("src_%u", sq->id);
2432 sq->srcpad = gst_pad_new_from_static_template (&srctemplate, name);
2435 gst_pad_set_activatemode_function (sq->srcpad,
2436 GST_DEBUG_FUNCPTR (gst_multi_queue_src_activate_mode));
2437 gst_pad_set_event_function (sq->srcpad,
2438 GST_DEBUG_FUNCPTR (gst_multi_queue_src_event));
2439 gst_pad_set_query_function (sq->srcpad,
2440 GST_DEBUG_FUNCPTR (gst_multi_queue_src_query));
2441 gst_pad_set_iterate_internal_links_function (sq->srcpad,
2442 GST_DEBUG_FUNCPTR (gst_multi_queue_iterate_internal_links));
2443 GST_OBJECT_FLAG_SET (sq->srcpad, GST_PAD_FLAG_PROXY_CAPS);
2445 gst_pad_set_element_private (sq->sinkpad, (gpointer) sq);
2446 gst_pad_set_element_private (sq->srcpad, (gpointer) sq);
2448 GST_MULTI_QUEUE_MUTEX_UNLOCK (mqueue);
2450 /* only activate the pads when we are not in the NULL state
2451 * and add the pad under the state_lock to prevend state changes
2452 * between activating and adding */
2453 g_rec_mutex_lock (GST_STATE_GET_LOCK (mqueue));
2454 if (GST_STATE_TARGET (mqueue) != GST_STATE_NULL) {
2455 gst_pad_set_active (sq->srcpad, TRUE);
2456 gst_pad_set_active (sq->sinkpad, TRUE);
2458 gst_element_add_pad (GST_ELEMENT (mqueue), sq->srcpad);
2459 gst_element_add_pad (GST_ELEMENT (mqueue), sq->sinkpad);
2460 g_rec_mutex_unlock (GST_STATE_GET_LOCK (mqueue));
2462 GST_DEBUG_OBJECT (mqueue, "GstSingleQueue [%d] created and pads added",