1 /* GStreamer input selector
2 * Copyright (C) 2003 Julien Moutte <julien@moutte.net>
3 * Copyright (C) 2005 Ronald S. Bultje <rbultje@ronald.bitfreak.net>
4 * Copyright (C) 2005 Jan Schmidt <thaytan@mad.scientist.com>
5 * Copyright (C) 2007 Wim Taymans <wim.taymans@gmail.com>
6 * Copyright (C) 2007 Andy Wingo <wingo@pobox.com>
7 * Copyright (C) 2008 Nokia Corporation. (contact <stefan.kost@nokia.com>)
8 * Copyright (C) 2011 Sebastian Dröge <sebastian.droege@collabora.co.uk>
10 * This library is free software; you can redistribute it and/or
11 * modify it under the terms of the GNU Library General Public
12 * License as published by the Free Software Foundation; either
13 * version 2 of the License, or (at your option) any later version.
15 * This library is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18 * Library General Public License for more details.
20 * You should have received a copy of the GNU Library General Public
21 * License along with this library; if not, write to the
22 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
23 * Boston, MA 02111-1307, USA.
27 * SECTION:element-input-selector
28 * @see_also: #GstOutputSelector
30 * Direct one out of N input streams to the output pad.
32 * The input pads are from a GstPad subclass and have additional
33 * properties, which users may find useful, namely:
37 * "running-time": Running time of stream on pad (#gint64)
40 * "tags": The currently active tags on the pad (#GstTagList, boxed type)
43 * "active": If the pad is currently active (#gboolean)
46 * "always-ok" : Make an inactive pads return #GST_FLOW_OK instead of
47 * #GST_FLOW_NOT_LINKED
60 #include "gstinputselector.h"
62 GST_DEBUG_CATEGORY_STATIC (input_selector_debug);
63 #define GST_CAT_DEFAULT input_selector_debug
65 #if GLIB_CHECK_VERSION(2, 26, 0)
66 #define NOTIFY_MUTEX_LOCK()
67 #define NOTIFY_MUTEX_UNLOCK()
69 static GStaticRecMutex notify_mutex = G_STATIC_REC_MUTEX_INIT;
70 #define NOTIFY_MUTEX_LOCK() g_static_rec_mutex_lock (¬ify_mutex)
71 #define NOTIFY_MUTEX_UNLOCK() g_static_rec_mutex_unlock (¬ify_mutex)
74 #define GST_INPUT_SELECTOR_GET_LOCK(sel) (((GstInputSelector*)(sel))->lock)
75 #define GST_INPUT_SELECTOR_GET_COND(sel) (((GstInputSelector*)(sel))->cond)
76 #define GST_INPUT_SELECTOR_LOCK(sel) (g_mutex_lock (GST_INPUT_SELECTOR_GET_LOCK(sel)))
77 #define GST_INPUT_SELECTOR_UNLOCK(sel) (g_mutex_unlock (GST_INPUT_SELECTOR_GET_LOCK(sel)))
78 #define GST_INPUT_SELECTOR_WAIT(sel) (g_cond_wait (GST_INPUT_SELECTOR_GET_COND(sel), \
79 GST_INPUT_SELECTOR_GET_LOCK(sel)))
80 #define GST_INPUT_SELECTOR_BROADCAST(sel) (g_cond_broadcast (GST_INPUT_SELECTOR_GET_COND(sel)))
82 static GstStaticPadTemplate gst_input_selector_sink_factory =
83 GST_STATIC_PAD_TEMPLATE ("sink%d",
88 static GstStaticPadTemplate gst_input_selector_src_factory =
89 GST_STATIC_PAD_TEMPLATE ("src",
101 #define DEFAULT_PAD_ALWAYS_OK TRUE
106 PROP_PAD_RUNNING_TIME,
119 static guint gst_input_selector_signals[LAST_SIGNAL] = { 0 };
121 static inline gboolean gst_input_selector_is_active_sinkpad (GstInputSelector *
123 static GstPad *gst_input_selector_activate_sinkpad (GstInputSelector * sel,
125 static GstPad *gst_input_selector_get_linked_pad (GstInputSelector * sel,
126 GstPad * pad, gboolean strict);
128 #define GST_TYPE_SELECTOR_PAD \
129 (gst_selector_pad_get_type())
130 #define GST_SELECTOR_PAD(obj) \
131 (G_TYPE_CHECK_INSTANCE_CAST ((obj), GST_TYPE_SELECTOR_PAD, GstSelectorPad))
132 #define GST_SELECTOR_PAD_CLASS(klass) \
133 (G_TYPE_CHECK_CLASS_CAST ((klass), GST_TYPE_SELECTOR_PAD, GstSelectorPadClass))
134 #define GST_IS_SELECTOR_PAD(obj) \
135 (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GST_TYPE_SELECTOR_PAD))
136 #define GST_IS_SELECTOR_PAD_CLASS(klass) \
137 (G_TYPE_CHECK_CLASS_TYPE ((klass), GST_TYPE_SELECTOR_PAD))
138 #define GST_SELECTOR_PAD_CAST(obj) \
139 ((GstSelectorPad *)(obj))
141 typedef struct _GstSelectorPad GstSelectorPad;
142 typedef struct _GstSelectorPadClass GstSelectorPadClass;
144 struct _GstSelectorPad
148 gboolean active; /* when buffer have passed the pad */
149 gboolean pushed; /* when buffer was pushed downstream since activation */
150 gboolean eos; /* when EOS has been received */
151 gboolean eos_sent; /* when EOS was sent downstream */
152 gboolean discont; /* after switching we create a discont */
153 gboolean flushing; /* set after flush-start and before flush-stop */
155 GstSegment segment; /* the current segment on the pad */
156 GstTagList *tags; /* last tags received on the pad */
158 gboolean segment_pending;
161 struct _GstSelectorPadClass
166 GType gst_selector_pad_get_type (void);
167 static void gst_selector_pad_finalize (GObject * object);
168 static void gst_selector_pad_get_property (GObject * object,
169 guint prop_id, GValue * value, GParamSpec * pspec);
170 static void gst_selector_pad_set_property (GObject * object,
171 guint prop_id, const GValue * value, GParamSpec * pspec);
173 static gint64 gst_selector_pad_get_running_time (GstSelectorPad * pad);
174 static void gst_selector_pad_reset (GstSelectorPad * pad);
175 static gboolean gst_selector_pad_event (GstPad * pad, GstEvent * event);
176 static GstCaps *gst_selector_pad_getcaps (GstPad * pad);
177 static gboolean gst_selector_pad_acceptcaps (GstPad * pad, GstCaps * caps);
178 static GstIterator *gst_selector_pad_iterate_linked_pads (GstPad * pad);
179 static GstFlowReturn gst_selector_pad_chain (GstPad * pad, GstBuffer * buf);
181 G_DEFINE_TYPE (GstSelectorPad, gst_selector_pad, GST_TYPE_PAD);
184 gst_selector_pad_class_init (GstSelectorPadClass * klass)
186 GObjectClass *gobject_class;
188 gobject_class = (GObjectClass *) klass;
190 gobject_class->finalize = gst_selector_pad_finalize;
192 gobject_class->get_property = gst_selector_pad_get_property;
193 gobject_class->set_property = gst_selector_pad_set_property;
195 g_object_class_install_property (gobject_class, PROP_PAD_RUNNING_TIME,
196 g_param_spec_int64 ("running-time", "Running time",
197 "Running time of stream on pad", 0, G_MAXINT64, 0,
198 G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
199 g_object_class_install_property (gobject_class, PROP_PAD_TAGS,
200 g_param_spec_boxed ("tags", "Tags",
201 "The currently active tags on the pad", GST_TYPE_TAG_LIST,
202 G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
203 g_object_class_install_property (gobject_class, PROP_PAD_ACTIVE,
204 g_param_spec_boolean ("active", "Active",
205 "If the pad is currently active", FALSE,
206 G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
207 /* FIXME: better property name? */
208 g_object_class_install_property (gobject_class, PROP_PAD_ALWAYS_OK,
209 g_param_spec_boolean ("always-ok", "Always OK",
210 "Make an inactive pad return OK instead of NOT_LINKED",
211 DEFAULT_PAD_ALWAYS_OK, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
215 gst_selector_pad_init (GstSelectorPad * pad)
217 pad->always_ok = DEFAULT_PAD_ALWAYS_OK;
218 gst_selector_pad_reset (pad);
222 gst_selector_pad_finalize (GObject * object)
226 pad = GST_SELECTOR_PAD_CAST (object);
229 gst_tag_list_free (pad->tags);
231 G_OBJECT_CLASS (gst_selector_pad_parent_class)->finalize (object);
235 gst_selector_pad_set_property (GObject * object, guint prop_id,
236 const GValue * value, GParamSpec * pspec)
238 GstSelectorPad *spad = GST_SELECTOR_PAD_CAST (object);
241 case PROP_PAD_ALWAYS_OK:
242 GST_OBJECT_LOCK (object);
243 spad->always_ok = g_value_get_boolean (value);
244 GST_OBJECT_UNLOCK (object);
247 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
253 gst_selector_pad_get_property (GObject * object, guint prop_id,
254 GValue * value, GParamSpec * pspec)
256 GstSelectorPad *spad = GST_SELECTOR_PAD_CAST (object);
259 case PROP_PAD_RUNNING_TIME:
260 g_value_set_int64 (value, gst_selector_pad_get_running_time (spad));
263 GST_OBJECT_LOCK (object);
264 g_value_set_boxed (value, spad->tags);
265 GST_OBJECT_UNLOCK (object);
267 case PROP_PAD_ACTIVE:
269 GstInputSelector *sel;
271 sel = GST_INPUT_SELECTOR (gst_pad_get_parent (spad));
272 g_value_set_boolean (value, gst_input_selector_is_active_sinkpad (sel,
273 GST_PAD_CAST (spad)));
274 gst_object_unref (sel);
277 case PROP_PAD_ALWAYS_OK:
278 GST_OBJECT_LOCK (object);
279 g_value_set_boolean (value, spad->always_ok);
280 GST_OBJECT_UNLOCK (object);
283 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
289 gst_selector_pad_get_running_time (GstSelectorPad * pad)
293 GST_OBJECT_LOCK (pad);
295 gint64 last_stop = pad->segment.last_stop;
298 ret = gst_segment_to_running_time (&pad->segment, GST_FORMAT_TIME,
301 GST_OBJECT_UNLOCK (pad);
303 GST_DEBUG_OBJECT (pad, "running time: %" GST_TIME_FORMAT,
304 GST_TIME_ARGS (ret));
310 gst_selector_pad_reset (GstSelectorPad * pad)
312 GST_OBJECT_LOCK (pad);
316 pad->eos_sent = FALSE;
317 pad->segment_pending = FALSE;
318 pad->discont = FALSE;
319 pad->flushing = FALSE;
320 gst_segment_init (&pad->segment, GST_FORMAT_UNDEFINED);
321 GST_OBJECT_UNLOCK (pad);
324 /* strictly get the linked pad from the sinkpad. If the pad is active we return
325 * the srcpad else we return NULL */
327 gst_selector_pad_iterate_linked_pads (GstPad * pad)
329 GstInputSelector *sel;
334 sel = GST_INPUT_SELECTOR (gst_pad_get_parent (pad));
335 if (G_UNLIKELY (sel == NULL))
338 otherpad = gst_input_selector_get_linked_pad (sel, pad, TRUE);
339 g_value_init (&val, GST_TYPE_PAD);
340 g_value_set_object (&val, otherpad);
341 it = gst_iterator_new_single (GST_TYPE_PAD, &val);
342 g_value_unset (&val);
345 gst_object_unref (otherpad);
346 gst_object_unref (sel);
352 gst_selector_pad_event (GstPad * pad, GstEvent * event)
356 GstInputSelector *sel;
357 GstSelectorPad *selpad;
358 GstPad *prev_active_sinkpad;
359 GstPad *active_sinkpad;
361 sel = GST_INPUT_SELECTOR (gst_pad_get_parent (pad));
362 if (G_UNLIKELY (sel == NULL)) {
363 gst_event_unref (event);
366 selpad = GST_SELECTOR_PAD_CAST (pad);
368 GST_INPUT_SELECTOR_LOCK (sel);
369 prev_active_sinkpad = sel->active_sinkpad;
370 active_sinkpad = gst_input_selector_activate_sinkpad (sel, pad);
372 /* only forward if we are dealing with the active sinkpad */
373 forward = (pad == active_sinkpad);
374 GST_INPUT_SELECTOR_UNLOCK (sel);
376 if (prev_active_sinkpad != active_sinkpad && pad == active_sinkpad) {
377 NOTIFY_MUTEX_LOCK ();
378 g_object_notify (G_OBJECT (sel), "active-pad");
379 NOTIFY_MUTEX_UNLOCK ();
382 switch (GST_EVENT_TYPE (event)) {
383 case GST_EVENT_FLUSH_START:
384 /* Unblock the pad if it's waiting */
385 GST_INPUT_SELECTOR_LOCK (sel);
386 selpad->flushing = TRUE;
387 GST_INPUT_SELECTOR_BROADCAST (sel);
388 GST_INPUT_SELECTOR_UNLOCK (sel);
390 case GST_EVENT_FLUSH_STOP:
391 GST_INPUT_SELECTOR_LOCK (sel);
392 gst_selector_pad_reset (selpad);
393 sel->pending_close = FALSE;
394 GST_INPUT_SELECTOR_UNLOCK (sel);
396 case GST_EVENT_NEWSEGMENT:
401 gint64 start, stop, time;
403 gst_event_parse_new_segment_full (event, &update, &rate, &arate, &format,
404 &start, &stop, &time);
406 GST_DEBUG_OBJECT (pad,
407 "configured NEWSEGMENT update %d, rate %lf, applied rate %lf, "
409 "%" G_GINT64_FORMAT " -- %" G_GINT64_FORMAT ", time %"
410 G_GINT64_FORMAT, update, rate, arate, format, start, stop, time);
412 GST_INPUT_SELECTOR_LOCK (sel);
413 GST_OBJECT_LOCK (selpad);
414 gst_segment_set_newsegment_full (&selpad->segment, update,
415 rate, arate, format, start, stop, time);
416 GST_OBJECT_UNLOCK (selpad);
418 /* If we aren't forwarding the event because the pad is not the
419 * active_sinkpad, then set the flag on the pad
420 * that says a segment needs sending if/when that pad is activated.
421 * For all other cases, we send the event immediately, which makes
422 * sparse streams and other segment updates work correctly downstream.
425 selpad->segment_pending = TRUE;
427 GST_INPUT_SELECTOR_UNLOCK (sel);
432 GstTagList *tags, *oldtags, *newtags;
434 gst_event_parse_tag (event, &tags);
436 GST_OBJECT_LOCK (selpad);
437 oldtags = selpad->tags;
439 newtags = gst_tag_list_merge (oldtags, tags, GST_TAG_MERGE_REPLACE);
440 selpad->tags = newtags;
442 gst_tag_list_free (oldtags);
443 GST_DEBUG_OBJECT (pad, "received tags %" GST_PTR_FORMAT, newtags);
444 GST_OBJECT_UNLOCK (selpad);
446 g_object_notify (G_OBJECT (selpad), "tags");
453 selpad->eos_sent = TRUE;
457 /* If the active sinkpad is in EOS state but EOS
458 * was not sent downstream this means that the pad
459 * got EOS before it was set as active pad and that
460 * the previously active pad got EOS after it was
463 GST_INPUT_SELECTOR_LOCK (sel);
464 active_sinkpad = gst_input_selector_activate_sinkpad (sel, pad);
465 tmp = GST_SELECTOR_PAD (active_sinkpad);
466 forward = (tmp->eos && !tmp->eos_sent);
467 tmp->eos_sent = TRUE;
468 GST_INPUT_SELECTOR_UNLOCK (sel);
470 GST_DEBUG_OBJECT (pad, "received EOS");
476 GST_DEBUG_OBJECT (pad, "forwarding event");
477 res = gst_pad_push_event (sel->srcpad, event);
479 gst_event_unref (event);
481 gst_object_unref (sel);
487 gst_selector_pad_getcaps (GstPad * pad)
489 GstInputSelector *sel;
492 sel = GST_INPUT_SELECTOR (gst_pad_get_parent (pad));
493 if (G_UNLIKELY (sel == NULL))
494 return gst_caps_new_any ();
496 GST_DEBUG_OBJECT (sel, "Getting caps of srcpad peer");
497 caps = gst_pad_peer_get_caps_reffed (sel->srcpad);
499 caps = gst_caps_new_any ();
501 gst_object_unref (sel);
507 gst_selector_pad_acceptcaps (GstPad * pad, GstCaps * caps)
509 GstInputSelector *sel;
512 sel = GST_INPUT_SELECTOR (gst_pad_get_parent (pad));
513 if (G_UNLIKELY (sel == NULL))
516 GST_DEBUG_OBJECT (sel, "Checking acceptcaps of srcpad peer");
517 res = gst_pad_peer_accept_caps (sel->srcpad, caps);
518 gst_object_unref (sel);
523 /* must be called with the SELECTOR_LOCK, will block while the pad is blocked
524 * or return TRUE when flushing */
526 gst_input_selector_wait (GstInputSelector * self, GstSelectorPad * pad)
528 while (self->blocked && !self->flushing && !pad->flushing) {
529 /* we can be unlocked here when we are shutting down (flushing) or when we
531 GST_INPUT_SELECTOR_WAIT (self);
533 return self->flushing;
537 gst_selector_pad_chain (GstPad * pad, GstBuffer * buf)
539 GstInputSelector *sel;
541 GstPad *active_sinkpad;
542 GstPad *prev_active_sinkpad;
543 GstSelectorPad *selpad;
544 GstClockTime start_time;
546 GstEvent *close_event = NULL, *start_event = NULL;
551 sel = GST_INPUT_SELECTOR (gst_pad_get_parent (pad));
552 selpad = GST_SELECTOR_PAD_CAST (pad);
553 seg = &selpad->segment;
555 GST_INPUT_SELECTOR_LOCK (sel);
556 /* wait or check for flushing */
557 if (gst_input_selector_wait (sel, selpad))
560 GST_LOG_OBJECT (pad, "getting active pad");
562 prev_active_sinkpad = sel->active_sinkpad;
563 active_sinkpad = gst_input_selector_activate_sinkpad (sel, pad);
565 /* update the segment on the srcpad */
566 start_time = GST_BUFFER_TIMESTAMP (buf);
567 if (GST_CLOCK_TIME_IS_VALID (start_time)) {
568 GST_LOG_OBJECT (pad, "received start time %" GST_TIME_FORMAT,
569 GST_TIME_ARGS (start_time));
570 if (GST_BUFFER_DURATION_IS_VALID (buf))
571 GST_LOG_OBJECT (pad, "received end time %" GST_TIME_FORMAT,
572 GST_TIME_ARGS (start_time + GST_BUFFER_DURATION (buf)));
574 GST_OBJECT_LOCK (pad);
575 gst_segment_set_last_stop (seg, seg->format, start_time);
576 GST_OBJECT_UNLOCK (pad);
579 /* Ignore buffers from pads except the selected one */
580 if (pad != active_sinkpad)
583 if (G_UNLIKELY (sel->pending_close)) {
584 GstSegment *cseg = &sel->segment;
586 GST_DEBUG_OBJECT (sel,
587 "pushing close NEWSEGMENT update %d, rate %lf, applied rate %lf, "
589 "%" G_GINT64_FORMAT " -- %" G_GINT64_FORMAT ", time %"
590 G_GINT64_FORMAT, TRUE, cseg->rate, cseg->applied_rate, cseg->format,
591 cseg->start, cseg->stop, cseg->time);
593 /* create update segment */
594 close_event = gst_event_new_new_segment_full (TRUE, cseg->rate,
595 cseg->applied_rate, cseg->format, cseg->start, cseg->stop, cseg->time);
597 sel->pending_close = FALSE;
599 /* if we have a pending segment, push it out now */
600 if (G_UNLIKELY (selpad->segment_pending)) {
601 GST_DEBUG_OBJECT (pad,
602 "pushing pending NEWSEGMENT update %d, rate %lf, applied rate %lf, "
604 "%" G_GINT64_FORMAT " -- %" G_GINT64_FORMAT ", time %"
605 G_GINT64_FORMAT, FALSE, seg->rate, seg->applied_rate, seg->format,
606 seg->start, seg->stop, seg->time);
608 start_event = gst_event_new_new_segment_full (FALSE, seg->rate,
609 seg->applied_rate, seg->format, seg->start, seg->stop, seg->time);
611 selpad->segment_pending = FALSE;
613 GST_INPUT_SELECTOR_UNLOCK (sel);
615 if (prev_active_sinkpad != active_sinkpad && pad == active_sinkpad) {
616 NOTIFY_MUTEX_LOCK ();
617 g_object_notify (G_OBJECT (sel), "active-pad");
618 NOTIFY_MUTEX_UNLOCK ();
622 gst_pad_push_event (sel->srcpad, close_event);
625 gst_pad_push_event (sel->srcpad, start_event);
627 if (selpad->discont) {
628 buf = gst_buffer_make_writable (buf);
630 GST_DEBUG_OBJECT (pad, "Marking discont buffer %p", buf);
631 GST_BUFFER_FLAG_SET (buf, GST_BUFFER_FLAG_DISCONT);
632 selpad->discont = FALSE;
636 GST_LOG_OBJECT (pad, "Forwarding buffer %p", buf);
639 if ((caps = GST_BUFFER_CAPS (buf))) {
640 if (GST_PAD_CAPS (sel->srcpad) != caps)
641 gst_pad_set_caps (sel->srcpad, caps);
645 res = gst_pad_push (sel->srcpad, buf);
646 selpad->pushed = TRUE;
649 gst_object_unref (sel);
652 /* dropped buffers */
655 gboolean active_pad_pushed = GST_SELECTOR_PAD_CAST (active_sinkpad)->pushed;
657 GST_DEBUG_OBJECT (pad, "Pad not active, discard buffer %p", buf);
658 /* when we drop a buffer, we're creating a discont on this pad */
659 selpad->discont = TRUE;
660 GST_INPUT_SELECTOR_UNLOCK (sel);
661 gst_buffer_unref (buf);
663 /* figure out what to return upstream */
664 GST_OBJECT_LOCK (selpad);
665 if (selpad->always_ok || !active_pad_pushed)
668 res = GST_FLOW_NOT_LINKED;
669 GST_OBJECT_UNLOCK (selpad);
675 GST_DEBUG_OBJECT (pad, "We are flushing, discard buffer %p", buf);
676 GST_INPUT_SELECTOR_UNLOCK (sel);
677 gst_buffer_unref (buf);
678 res = GST_FLOW_WRONG_STATE;
683 static void gst_input_selector_dispose (GObject * object);
685 static void gst_input_selector_set_property (GObject * object,
686 guint prop_id, const GValue * value, GParamSpec * pspec);
687 static void gst_input_selector_get_property (GObject * object,
688 guint prop_id, GValue * value, GParamSpec * pspec);
690 static GstPad *gst_input_selector_request_new_pad (GstElement * element,
691 GstPadTemplate * templ, const gchar * unused);
692 static void gst_input_selector_release_pad (GstElement * element, GstPad * pad);
694 static GstStateChangeReturn gst_input_selector_change_state (GstElement *
695 element, GstStateChange transition);
697 static GstCaps *gst_input_selector_getcaps (GstPad * pad);
698 static gboolean gst_input_selector_event (GstPad * pad, GstEvent * event);
699 static gboolean gst_input_selector_query (GstPad * pad, GstQuery * query);
700 static gint64 gst_input_selector_block (GstInputSelector * self);
701 static void gst_input_selector_switch (GstInputSelector * self,
702 GstPad * pad, gint64 stop_time, gint64 start_time);
704 /* FIXME: create these marshallers using glib-genmarshal */
705 #define g_marshal_value_peek_object(v) (v)->data[0].v_pointer
706 #define g_marshal_value_peek_int64(v) (v)->data[0].v_int64
709 gst_input_selector_marshal_INT64__VOID (GClosure * closure,
710 GValue * return_value G_GNUC_UNUSED,
711 guint n_param_values,
712 const GValue * param_values,
713 gpointer invocation_hint G_GNUC_UNUSED, gpointer marshal_data)
715 typedef gint64 (*GMarshalFunc_INT64__VOID) (gpointer data1, gpointer data2);
716 register GMarshalFunc_INT64__VOID callback;
717 register GCClosure *cc = (GCClosure *) closure;
718 register gpointer data1, data2;
721 g_return_if_fail (return_value != NULL);
722 g_return_if_fail (n_param_values == 1);
724 if (G_CCLOSURE_SWAP_DATA (closure)) {
725 data1 = closure->data;
726 data2 = g_value_peek_pointer (param_values + 0);
728 data1 = g_value_peek_pointer (param_values + 0);
729 data2 = closure->data;
732 (GMarshalFunc_INT64__VOID) (marshal_data ? marshal_data : cc->callback);
734 v_return = callback (data1, data2);
736 g_value_set_int64 (return_value, v_return);
740 gst_input_selector_marshal_VOID__OBJECT_INT64_INT64 (GClosure * closure,
741 GValue * return_value G_GNUC_UNUSED,
742 guint n_param_values,
743 const GValue * param_values,
744 gpointer invocation_hint G_GNUC_UNUSED, gpointer marshal_data)
746 typedef void (*GMarshalFunc_VOID__OBJECT_INT64_INT64) (gpointer data1,
747 gpointer arg_1, gint64 arg_2, gint64 arg_3, gpointer data2);
748 register GMarshalFunc_VOID__OBJECT_INT64_INT64 callback;
749 register GCClosure *cc = (GCClosure *) closure;
750 register gpointer data1, data2;
752 g_return_if_fail (n_param_values == 4);
754 if (G_CCLOSURE_SWAP_DATA (closure)) {
755 data1 = closure->data;
756 data2 = g_value_peek_pointer (param_values + 0);
758 data1 = g_value_peek_pointer (param_values + 0);
759 data2 = closure->data;
762 (GMarshalFunc_VOID__OBJECT_INT64_INT64) (marshal_data ? marshal_data :
766 g_marshal_value_peek_object (param_values + 1),
767 g_marshal_value_peek_int64 (param_values + 2),
768 g_marshal_value_peek_int64 (param_values + 3), data2);
772 GST_DEBUG_CATEGORY_INIT (input_selector_debug, \
773 "input-selector", 0, "An input stream selector element");
774 #define gst_input_selector_parent_class parent_class
775 G_DEFINE_TYPE_WITH_CODE (GstInputSelector, gst_input_selector, GST_TYPE_ELEMENT,
779 gst_input_selector_class_init (GstInputSelectorClass * klass)
781 GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
782 GstElementClass *gstelement_class = GST_ELEMENT_CLASS (klass);
784 gobject_class->dispose = gst_input_selector_dispose;
786 gobject_class->set_property = gst_input_selector_set_property;
787 gobject_class->get_property = gst_input_selector_get_property;
789 g_object_class_install_property (gobject_class, PROP_N_PADS,
790 g_param_spec_uint ("n-pads", "Number of Pads",
791 "The number of sink pads", 0, G_MAXUINT, 0,
792 G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
794 g_object_class_install_property (gobject_class, PROP_ACTIVE_PAD,
795 g_param_spec_object ("active-pad", "Active pad",
796 "The currently active sink pad", GST_TYPE_PAD,
797 G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
800 * GstInputSelector::block:
801 * @inputselector: the #GstInputSelector
803 * Block all sink pads in preparation for a switch. Returns the stop time of
804 * the current switch segment, as a running time, or 0 if there is no current
805 * active pad or the current active pad never received data.
807 gst_input_selector_signals[SIGNAL_BLOCK] =
808 g_signal_new ("block", G_TYPE_FROM_CLASS (klass),
809 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
810 G_STRUCT_OFFSET (GstInputSelectorClass, block), NULL, NULL,
811 gst_input_selector_marshal_INT64__VOID, G_TYPE_INT64, 0);
813 * GstInputSelector::switch:
814 * @inputselector: the #GstInputSelector
815 * @pad: the pad to switch to
816 * @stop_time: running time at which to close the previous segment, or -1
817 * to use the running time of the previously active sink pad
818 * @start_time: running time at which to start the new segment, or -1 to
819 * use the running time of the newly active sink pad
821 * Switch to a new feed. The segment opened by the previously active pad, if
822 * any, will be closed, and a new segment opened before data flows again.
824 * This signal must be emitted when the element has been blocked via the <link
825 * linkend="GstInputSelector-block">block</link> signal.
827 * If you have a stream with only one switch element, such as an audio-only
828 * stream, a stream switch should be performed by first emitting the block
829 * signal, and then emitting the switch signal with -1 for the stop and start
832 * The intention of the @stop_time and @start_time arguments is to allow
833 * multiple switch elements to switch and maintain stream synchronization.
834 * When switching a stream with multiple feeds, you will need as many switch
835 * elements as you have feeds. For example, a feed with audio and video will
836 * have one switch element between the audio feeds and one for video.
838 * A switch over multiple switch elements should be performed as follows:
839 * First, emit the <link linkend="GstInputSelector-block">block</link>
840 * signal, collecting the returned values. The maximum running time returned
841 * by block should then be used as the time at which to close the previous
844 * Then, query the running times of the new audio and video pads that you will
845 * switch to. Naturally, these pads are on separate switch elements. Take the
846 * minimum running time for those streams and use it for the time at which to
847 * open the new segment.
849 * If @pad is the same as the current active pad, the element will cancel any
850 * previous block without adjusting segments.
853 * the signal changed from accepting the pad name to the pad object.
858 gst_input_selector_signals[SIGNAL_SWITCH] =
859 g_signal_new ("switch", G_TYPE_FROM_CLASS (klass), G_SIGNAL_RUN_LAST,
860 G_STRUCT_OFFSET (GstInputSelectorClass, switch_),
861 NULL, NULL, gst_input_selector_marshal_VOID__OBJECT_INT64_INT64,
862 G_TYPE_NONE, 3, GST_TYPE_PAD, G_TYPE_INT64, G_TYPE_INT64);
864 gst_element_class_set_details_simple (gstelement_class, "Input selector",
865 "Generic", "N-to-1 input stream selector",
866 "Julien Moutte <julien@moutte.net>, "
867 "Jan Schmidt <thaytan@mad.scientist.com>, "
868 "Wim Taymans <wim.taymans@gmail.com>");
869 gst_element_class_add_pad_template (gstelement_class,
870 gst_static_pad_template_get (&gst_input_selector_sink_factory));
871 gst_element_class_add_pad_template (gstelement_class,
872 gst_static_pad_template_get (&gst_input_selector_src_factory));
874 gstelement_class->request_new_pad = gst_input_selector_request_new_pad;
875 gstelement_class->release_pad = gst_input_selector_release_pad;
876 gstelement_class->change_state = gst_input_selector_change_state;
878 klass->block = GST_DEBUG_FUNCPTR (gst_input_selector_block);
879 /* note the underscore because switch is a keyword otherwise */
880 klass->switch_ = GST_DEBUG_FUNCPTR (gst_input_selector_switch);
884 gst_input_selector_init (GstInputSelector * sel)
886 sel->srcpad = gst_pad_new ("src", GST_PAD_SRC);
887 gst_pad_set_iterate_internal_links_function (sel->srcpad,
888 GST_DEBUG_FUNCPTR (gst_selector_pad_iterate_linked_pads));
889 gst_pad_set_getcaps_function (sel->srcpad,
890 GST_DEBUG_FUNCPTR (gst_input_selector_getcaps));
891 gst_pad_set_query_function (sel->srcpad,
892 GST_DEBUG_FUNCPTR (gst_input_selector_query));
893 gst_pad_set_event_function (sel->srcpad,
894 GST_DEBUG_FUNCPTR (gst_input_selector_event));
895 gst_element_add_pad (GST_ELEMENT (sel), sel->srcpad);
896 /* sinkpad management */
897 sel->active_sinkpad = NULL;
899 gst_segment_init (&sel->segment, GST_FORMAT_UNDEFINED);
901 sel->lock = g_mutex_new ();
902 sel->cond = g_cond_new ();
903 sel->blocked = FALSE;
907 gst_input_selector_dispose (GObject * object)
909 GstInputSelector *sel = GST_INPUT_SELECTOR (object);
911 if (sel->active_sinkpad) {
912 gst_object_unref (sel->active_sinkpad);
913 sel->active_sinkpad = NULL;
916 g_mutex_free (sel->lock);
920 g_cond_free (sel->cond);
924 G_OBJECT_CLASS (parent_class)->dispose (object);
927 /* Solve the following equation for B.timestamp, and set that as the segment
929 * B.running_time = (B.timestamp - NS.start) / NS.abs_rate + NS.accum
932 gst_segment_get_timestamp (GstSegment * segment, gint64 running_time)
934 if (running_time <= segment->accum)
935 return segment->start;
937 return (running_time - segment->accum) * ABS (segment->rate) +
942 gst_segment_set_stop (GstSegment * segment, gint64 running_time)
944 segment->stop = gst_segment_get_timestamp (segment, running_time);
945 segment->last_stop = -1;
949 gst_segment_set_start (GstSegment * segment, gint64 running_time)
951 gint64 new_start, duration;
953 new_start = gst_segment_get_timestamp (segment, running_time);
955 /* this is the duration we skipped */
956 duration = new_start - segment->start;
957 /* add the duration to the accumulated segment time */
958 segment->accum += duration;
959 /* move position in the segment */
960 segment->time += duration;
961 segment->start += duration;
964 /* this function must be called with the SELECTOR_LOCK. It returns TRUE when the
965 * active pad changed. */
967 gst_input_selector_set_active_pad (GstInputSelector * self,
968 GstPad * pad, gint64 stop_time, gint64 start_time)
970 GstSelectorPad *old, *new;
971 GstPad **active_pad_p;
973 if (pad == self->active_sinkpad)
976 old = GST_SELECTOR_PAD_CAST (self->active_sinkpad);
977 new = GST_SELECTOR_PAD_CAST (pad);
979 GST_DEBUG_OBJECT (self, "setting active pad to %s:%s",
980 GST_DEBUG_PAD_NAME (new));
982 if (!GST_CLOCK_TIME_IS_VALID (stop_time) && old) {
983 /* no stop time given, get the latest running_time on the active pad to
984 * close and open the new segment */
985 stop_time = start_time = gst_selector_pad_get_running_time (old);
986 GST_DEBUG_OBJECT (self, "using start/stop of %" GST_TIME_FORMAT,
987 GST_TIME_ARGS (start_time));
990 if (old && old->active && !self->pending_close && stop_time >= 0) {
991 /* schedule a last_stop update if one isn't already scheduled, and a
992 segment has been pushed before. */
993 memcpy (&self->segment, &old->segment, sizeof (self->segment));
995 GST_DEBUG_OBJECT (self, "setting stop_time to %" GST_TIME_FORMAT,
996 GST_TIME_ARGS (stop_time));
997 gst_segment_set_stop (&self->segment, stop_time);
998 self->pending_close = TRUE;
1001 old->pushed = FALSE;
1003 if (new && new->active && start_time >= 0) {
1004 GST_DEBUG_OBJECT (self, "setting start_time to %" GST_TIME_FORMAT,
1005 GST_TIME_ARGS (start_time));
1006 /* schedule a new segment push */
1007 gst_segment_set_start (&new->segment, start_time);
1008 new->segment_pending = TRUE;
1011 new->pushed = FALSE;
1013 active_pad_p = &self->active_sinkpad;
1014 gst_object_replace ((GstObject **) active_pad_p, GST_OBJECT_CAST (pad));
1015 GST_DEBUG_OBJECT (self, "New active pad is %" GST_PTR_FORMAT,
1016 self->active_sinkpad);
1022 gst_input_selector_set_property (GObject * object, guint prop_id,
1023 const GValue * value, GParamSpec * pspec)
1025 GstInputSelector *sel = GST_INPUT_SELECTOR (object);
1028 case PROP_ACTIVE_PAD:
1032 pad = g_value_get_object (value);
1034 GST_INPUT_SELECTOR_LOCK (sel);
1035 gst_input_selector_set_active_pad (sel, pad,
1036 GST_CLOCK_TIME_NONE, GST_CLOCK_TIME_NONE);
1037 GST_INPUT_SELECTOR_UNLOCK (sel);
1041 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
1047 gst_input_selector_get_property (GObject * object, guint prop_id,
1048 GValue * value, GParamSpec * pspec)
1050 GstInputSelector *sel = GST_INPUT_SELECTOR (object);
1054 GST_INPUT_SELECTOR_LOCK (object);
1055 g_value_set_uint (value, sel->n_pads);
1056 GST_INPUT_SELECTOR_UNLOCK (object);
1058 case PROP_ACTIVE_PAD:
1059 GST_INPUT_SELECTOR_LOCK (object);
1060 g_value_set_object (value, sel->active_sinkpad);
1061 GST_INPUT_SELECTOR_UNLOCK (object);
1064 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
1070 gst_input_selector_get_linked_pad (GstInputSelector * sel, GstPad * pad,
1073 GstPad *otherpad = NULL;
1075 GST_INPUT_SELECTOR_LOCK (sel);
1076 if (pad == sel->srcpad)
1077 otherpad = sel->active_sinkpad;
1078 else if (pad == sel->active_sinkpad || !strict)
1079 otherpad = sel->srcpad;
1081 gst_object_ref (otherpad);
1082 GST_INPUT_SELECTOR_UNLOCK (sel);
1088 gst_input_selector_event (GstPad * pad, GstEvent * event)
1090 GstInputSelector *sel;
1091 gboolean res = FALSE;
1094 sel = GST_INPUT_SELECTOR (gst_pad_get_parent (pad));
1095 if (G_UNLIKELY (sel == NULL)) {
1096 gst_event_unref (event);
1100 otherpad = gst_input_selector_get_linked_pad (sel, pad, TRUE);
1102 res = gst_pad_push_event (otherpad, event);
1104 gst_object_unref (otherpad);
1106 gst_event_unref (event);
1108 gst_object_unref (sel);
1112 /* query on the srcpad. We override this function because by default it will
1113 * only forward the query to one random sinkpad */
1115 gst_input_selector_query (GstPad * pad, GstQuery * query)
1117 gboolean res = TRUE;
1118 GstInputSelector *sel;
1121 sel = GST_INPUT_SELECTOR (gst_pad_get_parent (pad));
1122 if (G_UNLIKELY (sel == NULL))
1125 otherpad = gst_input_selector_get_linked_pad (sel, pad, TRUE);
1127 switch (GST_QUERY_TYPE (query)) {
1128 case GST_QUERY_LATENCY:
1131 GstClockTime resmin, resmax;
1138 /* assume FALSE, we become TRUE if one query succeeds */
1141 /* perform the query on all sinkpads and combine the results. We take the
1142 * max of min and the min of max for the result latency. */
1143 GST_INPUT_SELECTOR_LOCK (sel);
1144 for (walk = GST_ELEMENT_CAST (sel)->sinkpads; walk;
1145 walk = g_list_next (walk)) {
1146 GstPad *sinkpad = GST_PAD_CAST (walk->data);
1148 if (gst_pad_peer_query (sinkpad, query)) {
1149 GstClockTime min, max;
1152 /* one query succeeded, we succeed too */
1155 gst_query_parse_latency (query, &live, &min, &max);
1157 GST_DEBUG_OBJECT (sinkpad,
1158 "peer latency min %" GST_TIME_FORMAT ", max %" GST_TIME_FORMAT
1159 ", live %d", GST_TIME_ARGS (min), GST_TIME_ARGS (max), live);
1166 else if (max < resmax)
1168 if (reslive == FALSE)
1173 GST_INPUT_SELECTOR_UNLOCK (sel);
1175 gst_query_set_latency (query, reslive, resmin, resmax);
1177 GST_DEBUG_OBJECT (sel,
1178 "total latency min %" GST_TIME_FORMAT ", max %" GST_TIME_FORMAT
1179 ", live %d", GST_TIME_ARGS (resmin), GST_TIME_ARGS (resmax),
1187 res = gst_pad_peer_query (otherpad, query);
1191 gst_object_unref (otherpad);
1192 gst_object_unref (sel);
1198 gst_input_selector_getcaps (GstPad * pad)
1201 GstInputSelector *sel;
1204 sel = GST_INPUT_SELECTOR (gst_pad_get_parent (pad));
1205 if (G_UNLIKELY (sel == NULL))
1206 return gst_caps_new_any ();
1208 otherpad = gst_input_selector_get_linked_pad (sel, pad, FALSE);
1211 GST_DEBUG_OBJECT (pad, "Pad not linked, returning ANY");
1212 caps = gst_caps_new_any ();
1214 GST_DEBUG_OBJECT (pad, "Pad is linked (to %s:%s), returning peer caps",
1215 GST_DEBUG_PAD_NAME (otherpad));
1216 /* if the peer has caps, use those. If the pad is not linked, this function
1217 * returns NULL and we return ANY */
1218 if (!(caps = gst_pad_peer_get_caps_reffed (otherpad)))
1219 caps = gst_caps_new_any ();
1220 gst_object_unref (otherpad);
1223 gst_object_unref (sel);
1227 /* check if the pad is the active sinkpad */
1228 static inline gboolean
1229 gst_input_selector_is_active_sinkpad (GstInputSelector * sel, GstPad * pad)
1233 GST_INPUT_SELECTOR_LOCK (sel);
1234 res = (pad == sel->active_sinkpad);
1235 GST_INPUT_SELECTOR_UNLOCK (sel);
1240 /* Get or create the active sinkpad, must be called with SELECTOR_LOCK */
1242 gst_input_selector_activate_sinkpad (GstInputSelector * sel, GstPad * pad)
1244 GstPad *active_sinkpad;
1245 GstSelectorPad *selpad;
1247 selpad = GST_SELECTOR_PAD_CAST (pad);
1249 selpad->active = TRUE;
1250 active_sinkpad = sel->active_sinkpad;
1251 if (active_sinkpad == NULL) {
1252 /* first pad we get activity on becomes the activated pad by default */
1253 if (sel->active_sinkpad)
1254 gst_object_unref (sel->active_sinkpad);
1255 active_sinkpad = sel->active_sinkpad = gst_object_ref (pad);
1256 GST_DEBUG_OBJECT (sel, "Activating pad %s:%s", GST_DEBUG_PAD_NAME (pad));
1259 return active_sinkpad;
1263 gst_input_selector_request_new_pad (GstElement * element,
1264 GstPadTemplate * templ, const gchar * unused)
1266 GstInputSelector *sel;
1268 GstPad *sinkpad = NULL;
1270 g_return_val_if_fail (templ->direction == GST_PAD_SINK, NULL);
1272 sel = GST_INPUT_SELECTOR (element);
1274 GST_INPUT_SELECTOR_LOCK (sel);
1276 GST_LOG_OBJECT (sel, "Creating new pad %d", sel->padcount);
1277 name = g_strdup_printf ("sink%d", sel->padcount++);
1278 sinkpad = g_object_new (GST_TYPE_SELECTOR_PAD,
1279 "name", name, "direction", templ->direction, "template", templ, NULL);
1284 gst_pad_set_event_function (sinkpad,
1285 GST_DEBUG_FUNCPTR (gst_selector_pad_event));
1286 gst_pad_set_getcaps_function (sinkpad,
1287 GST_DEBUG_FUNCPTR (gst_selector_pad_getcaps));
1288 gst_pad_set_acceptcaps_function (sinkpad,
1289 GST_DEBUG_FUNCPTR (gst_selector_pad_acceptcaps));
1290 gst_pad_set_chain_function (sinkpad,
1291 GST_DEBUG_FUNCPTR (gst_selector_pad_chain));
1292 gst_pad_set_iterate_internal_links_function (sinkpad,
1293 GST_DEBUG_FUNCPTR (gst_selector_pad_iterate_linked_pads));
1295 gst_pad_set_active (sinkpad, TRUE);
1296 gst_element_add_pad (GST_ELEMENT (sel), sinkpad);
1297 GST_INPUT_SELECTOR_UNLOCK (sel);
1303 gst_input_selector_release_pad (GstElement * element, GstPad * pad)
1305 GstInputSelector *sel;
1307 sel = GST_INPUT_SELECTOR (element);
1308 GST_LOG_OBJECT (sel, "Releasing pad %s:%s", GST_DEBUG_PAD_NAME (pad));
1310 GST_INPUT_SELECTOR_LOCK (sel);
1311 /* if the pad was the active pad, makes us select a new one */
1312 if (sel->active_sinkpad == pad) {
1313 GST_DEBUG_OBJECT (sel, "Deactivating pad %s:%s", GST_DEBUG_PAD_NAME (pad));
1314 gst_object_unref (sel->active_sinkpad);
1315 sel->active_sinkpad = NULL;
1319 gst_pad_set_active (pad, FALSE);
1320 gst_element_remove_pad (GST_ELEMENT (sel), pad);
1321 GST_INPUT_SELECTOR_UNLOCK (sel);
1325 gst_input_selector_reset (GstInputSelector * sel)
1329 GST_INPUT_SELECTOR_LOCK (sel);
1330 /* clear active pad */
1331 if (sel->active_sinkpad) {
1332 gst_object_unref (sel->active_sinkpad);
1333 sel->active_sinkpad = NULL;
1336 gst_segment_init (&sel->segment, GST_FORMAT_UNDEFINED);
1337 sel->pending_close = FALSE;
1338 /* reset each of our sinkpads state */
1339 for (walk = GST_ELEMENT_CAST (sel)->sinkpads; walk; walk = g_list_next (walk)) {
1340 GstSelectorPad *selpad = GST_SELECTOR_PAD_CAST (walk->data);
1342 gst_selector_pad_reset (selpad);
1345 gst_tag_list_free (selpad->tags);
1346 selpad->tags = NULL;
1349 GST_INPUT_SELECTOR_UNLOCK (sel);
1352 static GstStateChangeReturn
1353 gst_input_selector_change_state (GstElement * element,
1354 GstStateChange transition)
1356 GstInputSelector *self = GST_INPUT_SELECTOR (element);
1357 GstStateChangeReturn result;
1359 switch (transition) {
1360 case GST_STATE_CHANGE_READY_TO_PAUSED:
1361 GST_INPUT_SELECTOR_LOCK (self);
1362 self->blocked = FALSE;
1363 self->flushing = FALSE;
1364 GST_INPUT_SELECTOR_UNLOCK (self);
1366 case GST_STATE_CHANGE_PAUSED_TO_READY:
1367 /* first unlock before we call the parent state change function, which
1368 * tries to acquire the stream lock when going to ready. */
1369 GST_INPUT_SELECTOR_LOCK (self);
1370 self->blocked = FALSE;
1371 self->flushing = TRUE;
1372 GST_INPUT_SELECTOR_BROADCAST (self);
1373 GST_INPUT_SELECTOR_UNLOCK (self);
1379 result = GST_ELEMENT_CLASS (parent_class)->change_state (element, transition);
1381 switch (transition) {
1382 case GST_STATE_CHANGE_PAUSED_TO_READY:
1383 gst_input_selector_reset (self);
1393 gst_input_selector_block (GstInputSelector * self)
1396 GstSelectorPad *spad;
1398 GST_INPUT_SELECTOR_LOCK (self);
1401 GST_WARNING_OBJECT (self, "switch already blocked");
1403 self->blocked = TRUE;
1404 spad = GST_SELECTOR_PAD_CAST (self->active_sinkpad);
1407 ret = gst_selector_pad_get_running_time (spad);
1409 GST_DEBUG_OBJECT (self, "no active pad while blocking");
1411 GST_INPUT_SELECTOR_UNLOCK (self);
1416 /* stop_time and start_time are running times */
1418 gst_input_selector_switch (GstInputSelector * self, GstPad * pad,
1419 gint64 stop_time, gint64 start_time)
1423 g_return_if_fail (self->blocked == TRUE);
1425 GST_INPUT_SELECTOR_LOCK (self);
1427 gst_input_selector_set_active_pad (self, pad, stop_time, start_time);
1429 self->blocked = FALSE;
1430 GST_INPUT_SELECTOR_BROADCAST (self);
1431 GST_INPUT_SELECTOR_UNLOCK (self);
1434 NOTIFY_MUTEX_LOCK ();
1435 g_object_notify (G_OBJECT (self), "active-pad");
1436 NOTIFY_MUTEX_UNLOCK ();