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>)
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., 59 Temple Place - Suite 330,
22 * Boston, MA 02111-1307, USA.
26 * SECTION:element-input-selector
27 * @see_also: #GstOutputSelector
29 * Direct one out of N input streams to the output pad.
38 #include "gstinputselector.h"
39 #include "gstselector-marshal.h"
41 GST_DEBUG_CATEGORY_STATIC (input_selector_debug);
42 #define GST_CAT_DEFAULT input_selector_debug
44 static const GstElementDetails gst_input_selector_details =
45 GST_ELEMENT_DETAILS ("Input selector",
47 "N-to-1 input stream selectoring",
48 "Julien Moutte <julien@moutte.net>\n"
49 "Ronald S. Bultje <rbultje@ronald.bitfreak.net>\n"
50 "Jan Schmidt <thaytan@mad.scientist.com>\n"
51 "Wim Taymans <wim.taymans@gmail.com>");
53 static GstStaticPadTemplate gst_input_selector_sink_factory =
54 GST_STATIC_PAD_TEMPLATE ("sink%d",
59 static GstStaticPadTemplate gst_input_selector_src_factory =
60 GST_STATIC_PAD_TEMPLATE ("src",
74 #define DEFAULT_PAD_ALWAYS_OK TRUE
79 PROP_PAD_RUNNING_TIME,
93 static guint gst_input_selector_signals[LAST_SIGNAL] = { 0 };
95 static gboolean gst_input_selector_is_active_sinkpad (GstInputSelector * sel,
97 static GstPad *gst_input_selector_activate_sinkpad (GstInputSelector * sel,
99 static GstPad *gst_input_selector_get_linked_pad (GstPad * pad,
101 static gboolean gst_input_selector_check_eos (GstElement * selector);
103 #define GST_TYPE_SELECTOR_PAD \
104 (gst_selector_pad_get_type())
105 #define GST_SELECTOR_PAD(obj) \
106 (G_TYPE_CHECK_INSTANCE_CAST ((obj), GST_TYPE_SELECTOR_PAD, GstSelectorPad))
107 #define GST_SELECTOR_PAD_CLASS(klass) \
108 (G_TYPE_CHECK_CLASS_CAST ((klass), GST_TYPE_SELECTOR_PAD, GstSelectorPadClass))
109 #define GST_IS_SELECTOR_PAD(obj) \
110 (G_TYPE_CHECK_INSTANCE_TYPE ((obj), GST_TYPE_SELECTOR_PAD))
111 #define GST_IS_SELECTOR_PAD_CLASS(klass) \
112 (G_TYPE_CHECK_CLASS_TYPE ((klass), GST_TYPE_SELECTOR_PAD))
113 #define GST_SELECTOR_PAD_CAST(obj) \
114 ((GstSelectorPad *)(obj))
116 typedef struct _GstSelectorPad GstSelectorPad;
117 typedef struct _GstSelectorPadClass GstSelectorPadClass;
119 struct _GstSelectorPad
123 gboolean active; /* when buffer have passed the pad */
124 gboolean eos; /* when EOS has been received */
125 gboolean discont; /* after switching we create a discont */
127 GstSegment segment; /* the current segment on the pad */
128 GstTagList *tags; /* last tags received on the pad */
130 gboolean segment_pending;
133 struct _GstSelectorPadClass
138 static void gst_selector_pad_class_init (GstSelectorPadClass * klass);
139 static void gst_selector_pad_init (GstSelectorPad * pad);
140 static void gst_selector_pad_finalize (GObject * object);
141 static void gst_selector_pad_get_property (GObject * object,
142 guint prop_id, GValue * value, GParamSpec * pspec);
143 static void gst_selector_pad_set_property (GObject * object,
144 guint prop_id, const GValue * value, GParamSpec * pspec);
146 static GstPadClass *selector_pad_parent_class = NULL;
148 static gint64 gst_selector_pad_get_running_time (GstSelectorPad * pad);
149 static void gst_selector_pad_reset (GstSelectorPad * pad);
150 static gboolean gst_selector_pad_event (GstPad * pad, GstEvent * event);
151 static GstCaps *gst_selector_pad_getcaps (GstPad * pad);
152 static GstIterator *gst_selector_pad_iterate_linked_pads (GstPad * pad);
153 static GstFlowReturn gst_selector_pad_chain (GstPad * pad, GstBuffer * buf);
154 static GstFlowReturn gst_selector_pad_bufferalloc (GstPad * pad,
155 guint64 offset, guint size, GstCaps * caps, GstBuffer ** buf);
158 gst_selector_pad_get_type (void)
160 static GType selector_pad_type = 0;
162 if (!selector_pad_type) {
163 static const GTypeInfo selector_pad_info = {
164 sizeof (GstSelectorPadClass),
167 (GClassInitFunc) gst_selector_pad_class_init,
170 sizeof (GstSelectorPad),
172 (GInstanceInitFunc) gst_selector_pad_init,
176 g_type_register_static (GST_TYPE_PAD, "GstSelectorPad",
177 &selector_pad_info, 0);
179 return selector_pad_type;
183 gst_selector_pad_class_init (GstSelectorPadClass * klass)
185 GObjectClass *gobject_class;
187 gobject_class = (GObjectClass *) klass;
189 selector_pad_parent_class = g_type_class_peek_parent (klass);
191 gobject_class->finalize = gst_selector_pad_finalize;
193 gobject_class->get_property =
194 GST_DEBUG_FUNCPTR (gst_selector_pad_get_property);
195 gobject_class->set_property =
196 GST_DEBUG_FUNCPTR (gst_selector_pad_set_property);
198 g_object_class_install_property (gobject_class, PROP_PAD_RUNNING_TIME,
199 g_param_spec_int64 ("running-time", "Running time",
200 "Running time of stream on pad", 0, G_MAXINT64, 0, G_PARAM_READABLE));
201 g_object_class_install_property (gobject_class, PROP_PAD_TAGS,
202 g_param_spec_boxed ("tags", "Tags",
203 "The currently active tags on the pad", GST_TYPE_TAG_LIST,
205 g_object_class_install_property (gobject_class, PROP_PAD_ACTIVE,
206 g_param_spec_boolean ("active", "Active",
207 "If the pad is currently active", FALSE, G_PARAM_READABLE));
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));
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 (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);
315 pad->segment_pending = FALSE;
316 pad->discont = FALSE;
317 gst_segment_init (&pad->segment, GST_FORMAT_UNDEFINED);
318 GST_OBJECT_UNLOCK (pad);
321 /* strictly get the linked pad from the sinkpad. If the pad is active we return
322 * the srcpad else we return NULL */
329 } GstSelectorIterator;
332 _iterate_free (GstIterator * it)
334 GstSelectorIterator *sit = (GstSelectorIterator *) it;
336 gst_object_unref (sit->pad);
340 static GstIteratorResult
341 _iterate_next (GstIterator * it, gpointer * result)
343 GstSelectorIterator *sit = (GstSelectorIterator *) it;
346 GstPad *res = gst_input_selector_get_linked_pad (sit->pad, TRUE);
350 return GST_ITERATOR_OK;
354 return GST_ITERATOR_DONE;
357 static GstIteratorItem
358 _iterate_item (GstIterator * it, gpointer item)
360 return GST_ITERATOR_ITEM_PASS;
364 _iterate_resync (GstIterator * it)
366 GstSelectorIterator *sit = (GstSelectorIterator *) it;
372 gst_selector_pad_iterate_linked_pads (GstPad * pad)
374 GstInputSelector *sel = GST_INPUT_SELECTOR (gst_pad_get_parent (pad));
375 GstSelectorIterator *it = (GstSelectorIterator *)
376 gst_iterator_new (sizeof (GstSelectorIterator),
379 &GST_ELEMENT_CAST (sel)->pads_cookie,
380 _iterate_next, _iterate_item, _iterate_resync, _iterate_free);
382 it->pad = gst_object_ref (pad);
385 gst_object_unref (sel);
387 return (GstIterator *) it;
391 gst_selector_pad_event (GstPad * pad, GstEvent * event)
394 gboolean forward = TRUE;
395 GstInputSelector *sel;
396 GstSelectorPad *selpad;
397 GstPad *prev_active_sinkpad;
398 GstPad *active_sinkpad;
400 sel = GST_INPUT_SELECTOR (gst_pad_get_parent (pad));
401 selpad = GST_SELECTOR_PAD_CAST (pad);
403 GST_INPUT_SELECTOR_LOCK (sel);
404 prev_active_sinkpad = sel->active_sinkpad;
405 active_sinkpad = gst_input_selector_activate_sinkpad (sel, pad);
407 /* only forward if we are dealing with the active sinkpad or if select_all
409 if (pad != active_sinkpad && !sel->select_all)
411 GST_INPUT_SELECTOR_UNLOCK (sel);
413 if (prev_active_sinkpad != active_sinkpad && pad == active_sinkpad)
414 g_object_notify (G_OBJECT (sel), "active-pad");
416 switch (GST_EVENT_TYPE (event)) {
417 case GST_EVENT_FLUSH_START:
418 /* FIXME, flush out the waiter */
420 case GST_EVENT_FLUSH_STOP:
421 GST_INPUT_SELECTOR_LOCK (sel);
422 gst_selector_pad_reset (selpad);
423 sel->pending_close = FALSE;
424 GST_INPUT_SELECTOR_UNLOCK (sel);
426 case GST_EVENT_NEWSEGMENT:
431 gint64 start, stop, time;
433 gst_event_parse_new_segment_full (event, &update, &rate, &arate, &format,
434 &start, &stop, &time);
436 GST_DEBUG_OBJECT (pad,
437 "configured NEWSEGMENT update %d, rate %lf, applied rate %lf, "
439 "%" G_GINT64_FORMAT " -- %" G_GINT64_FORMAT ", time %"
440 G_GINT64_FORMAT, update, rate, arate, format, start, stop, time);
442 GST_INPUT_SELECTOR_LOCK (sel);
443 GST_OBJECT_LOCK (selpad);
444 gst_segment_set_newsegment_full (&selpad->segment, update,
445 rate, arate, format, start, stop, time);
446 GST_OBJECT_UNLOCK (selpad);
448 /* If we aren't forwarding the event (because the pad is not the
449 * active_sinkpad, and select_all is not set, then set the flag on the
450 * that says a segment needs sending if/when that pad is activated.
451 * For all other cases, we send the event immediately, which makes
452 * sparse streams and other segment updates work correctly downstream.
455 selpad->segment_pending = TRUE;
457 GST_INPUT_SELECTOR_UNLOCK (sel);
462 GstTagList *tags, *oldtags, *newtags;
464 gst_event_parse_tag (event, &tags);
466 GST_OBJECT_LOCK (selpad);
467 oldtags = selpad->tags;
469 newtags = gst_tag_list_merge (oldtags, tags, GST_TAG_MERGE_REPLACE);
470 selpad->tags = newtags;
472 gst_tag_list_free (oldtags);
473 GST_DEBUG_OBJECT (pad, "received tags %" GST_PTR_FORMAT, newtags);
474 GST_OBJECT_UNLOCK (selpad);
476 g_object_notify (G_OBJECT (selpad), "tags");
481 GST_DEBUG_OBJECT (pad, "received EOS");
482 /* don't forward eos in select_all mode until all sink pads have eos */
483 if (sel->select_all && !gst_input_selector_check_eos (GST_ELEMENT (sel))) {
491 GST_DEBUG_OBJECT (pad, "forwarding event");
492 res = gst_pad_push_event (sel->srcpad, event);
494 gst_event_unref (event);
496 gst_object_unref (sel);
502 gst_selector_pad_getcaps (GstPad * pad)
504 GstInputSelector *sel;
507 sel = GST_INPUT_SELECTOR (gst_pad_get_parent (pad));
509 GST_DEBUG_OBJECT (sel, "Getting caps of srcpad peer");
510 caps = gst_pad_peer_get_caps (sel->srcpad);
512 caps = gst_caps_new_any ();
514 gst_object_unref (sel);
520 gst_selector_pad_bufferalloc (GstPad * pad, guint64 offset,
521 guint size, GstCaps * caps, GstBuffer ** buf)
523 GstInputSelector *sel;
524 GstFlowReturn result;
525 GstPad *active_sinkpad;
526 GstPad *prev_active_sinkpad;
527 GstSelectorPad *selpad;
529 sel = GST_INPUT_SELECTOR (gst_pad_get_parent (pad));
530 selpad = GST_SELECTOR_PAD_CAST (pad);
532 GST_DEBUG_OBJECT (pad, "received alloc");
534 GST_INPUT_SELECTOR_LOCK (sel);
535 prev_active_sinkpad = sel->active_sinkpad;
536 active_sinkpad = gst_input_selector_activate_sinkpad (sel, pad);
538 if (pad != active_sinkpad)
541 GST_INPUT_SELECTOR_UNLOCK (sel);
543 if (prev_active_sinkpad != active_sinkpad && pad == active_sinkpad)
544 g_object_notify (G_OBJECT (sel), "active-pad");
546 result = gst_pad_alloc_buffer (sel->srcpad, offset, size, caps, buf);
549 gst_object_unref (sel);
556 GST_INPUT_SELECTOR_UNLOCK (sel);
558 /* unselected pad, perform fallback alloc or return unlinked when
560 GST_OBJECT_LOCK (selpad);
561 if (selpad->always_ok) {
562 GST_DEBUG_OBJECT (pad, "Not selected, performing fallback allocation");
564 result = GST_FLOW_OK;
566 GST_DEBUG_OBJECT (pad, "Not selected, return NOT_LINKED");
567 result = GST_FLOW_NOT_LINKED;
569 GST_OBJECT_UNLOCK (selpad);
575 /* must be called with the SELECTOR_LOCK, will block while the pad is blocked
576 * or return TRUE when flushing */
578 gst_input_selector_wait (GstInputSelector * self, GstPad * pad)
580 while (self->blocked && !self->flushing) {
581 /* we can be unlocked here when we are shutting down (flushing) or when we
583 GST_INPUT_SELECTOR_WAIT (self);
585 return self->flushing;
589 gst_selector_pad_chain (GstPad * pad, GstBuffer * buf)
591 GstInputSelector *sel;
593 GstPad *active_sinkpad;
594 GstPad *prev_active_sinkpad;
595 GstSelectorPad *selpad;
596 GstClockTime end_time, duration;
598 GstEvent *close_event = NULL, *start_event = NULL;
600 sel = GST_INPUT_SELECTOR (gst_pad_get_parent (pad));
601 selpad = GST_SELECTOR_PAD_CAST (pad);
602 seg = &selpad->segment;
604 GST_INPUT_SELECTOR_LOCK (sel);
605 /* wait or check for flushing */
606 if (gst_input_selector_wait (sel, pad))
609 GST_DEBUG_OBJECT (pad, "getting active pad");
611 prev_active_sinkpad = sel->active_sinkpad;
612 active_sinkpad = gst_input_selector_activate_sinkpad (sel, pad);
614 /* update the segment on the srcpad */
615 end_time = GST_BUFFER_TIMESTAMP (buf);
616 if (GST_CLOCK_TIME_IS_VALID (end_time)) {
617 duration = GST_BUFFER_DURATION (buf);
618 if (GST_CLOCK_TIME_IS_VALID (duration))
619 end_time += duration;
620 GST_DEBUG_OBJECT (pad, "received end time %" GST_TIME_FORMAT,
621 GST_TIME_ARGS (end_time));
623 GST_OBJECT_LOCK (pad);
624 gst_segment_set_last_stop (seg, seg->format, end_time);
625 GST_OBJECT_UNLOCK (pad);
628 /* Ignore buffers from pads except the selected one */
629 if (pad != active_sinkpad)
632 if (G_UNLIKELY (sel->pending_close)) {
633 GstSegment *cseg = &sel->segment;
635 GST_DEBUG_OBJECT (sel,
636 "pushing NEWSEGMENT update %d, rate %lf, applied rate %lf, "
638 "%" G_GINT64_FORMAT " -- %" G_GINT64_FORMAT ", time %"
639 G_GINT64_FORMAT, TRUE, cseg->rate, cseg->applied_rate, cseg->format,
640 cseg->start, cseg->stop, cseg->time);
642 /* create update segment */
643 close_event = gst_event_new_new_segment_full (TRUE, cseg->rate,
644 cseg->applied_rate, cseg->format, cseg->start, cseg->stop, cseg->time);
646 sel->pending_close = FALSE;
648 /* if we have a pending segment, push it out now */
649 if (G_UNLIKELY (selpad->segment_pending)) {
650 GST_DEBUG_OBJECT (pad,
651 "pushing NEWSEGMENT update %d, rate %lf, applied rate %lf, "
653 "%" G_GINT64_FORMAT " -- %" G_GINT64_FORMAT ", time %"
654 G_GINT64_FORMAT, FALSE, seg->rate, seg->applied_rate, seg->format,
655 seg->start, seg->stop, seg->time);
657 start_event = gst_event_new_new_segment_full (FALSE, seg->rate,
658 seg->applied_rate, seg->format, seg->start, seg->stop, seg->time);
660 selpad->segment_pending = FALSE;
662 GST_INPUT_SELECTOR_UNLOCK (sel);
664 if (prev_active_sinkpad != active_sinkpad && pad == active_sinkpad)
665 g_object_notify (G_OBJECT (sel), "active-pad");
668 gst_pad_push_event (sel->srcpad, close_event);
671 gst_pad_push_event (sel->srcpad, start_event);
673 if (selpad->discont) {
674 buf = gst_buffer_make_metadata_writable (buf);
676 GST_DEBUG_OBJECT (pad, "Marking discont buffer %p", buf);
677 GST_BUFFER_FLAG_SET (buf, GST_BUFFER_FLAG_DISCONT);
678 selpad->discont = FALSE;
682 GST_DEBUG_OBJECT (pad, "Forwarding buffer %p from pad %s:%s", buf,
683 GST_DEBUG_PAD_NAME (pad));
685 res = gst_pad_push (sel->srcpad, buf);
688 gst_object_unref (sel);
691 /* dropped buffers */
694 GST_DEBUG_OBJECT (pad, "Pad not active, discard buffer %p", buf);
695 /* when we drop a buffer, we're creating a discont on this pad */
696 selpad->discont = TRUE;
697 GST_INPUT_SELECTOR_UNLOCK (sel);
698 gst_buffer_unref (buf);
700 /* figure out what to return upstream */
701 GST_OBJECT_LOCK (selpad);
702 if (selpad->always_ok)
705 res = GST_FLOW_NOT_LINKED;
706 GST_OBJECT_UNLOCK (selpad);
712 GST_DEBUG_OBJECT (pad, "We are flushing, discard buffer %p", buf);
713 GST_INPUT_SELECTOR_UNLOCK (sel);
714 gst_buffer_unref (buf);
715 res = GST_FLOW_WRONG_STATE;
720 static void gst_input_selector_init (GstInputSelector * sel);
721 static void gst_input_selector_base_init (GstInputSelectorClass * klass);
722 static void gst_input_selector_class_init (GstInputSelectorClass * klass);
724 static void gst_input_selector_dispose (GObject * object);
726 static void gst_input_selector_set_property (GObject * object,
727 guint prop_id, const GValue * value, GParamSpec * pspec);
728 static void gst_input_selector_get_property (GObject * object,
729 guint prop_id, GValue * value, GParamSpec * pspec);
731 static GstPad *gst_input_selector_request_new_pad (GstElement * element,
732 GstPadTemplate * templ, const gchar * unused);
733 static void gst_input_selector_release_pad (GstElement * element, GstPad * pad);
735 static GstStateChangeReturn gst_input_selector_change_state (GstElement *
736 element, GstStateChange transition);
738 static GstCaps *gst_input_selector_getcaps (GstPad * pad);
739 static gboolean gst_input_selector_event (GstPad * pad, GstEvent * event);
740 static gboolean gst_input_selector_query (GstPad * pad, GstQuery * query);
741 static gint64 gst_input_selector_block (GstInputSelector * self);
742 static void gst_input_selector_switch (GstInputSelector * self,
743 GstPad * pad, gint64 stop_time, gint64 start_time);
745 static GstElementClass *parent_class = NULL;
748 gst_input_selector_get_type (void)
750 static GType input_selector_type = 0;
752 if (!input_selector_type) {
753 static const GTypeInfo input_selector_info = {
754 sizeof (GstInputSelectorClass),
755 (GBaseInitFunc) gst_input_selector_base_init,
757 (GClassInitFunc) gst_input_selector_class_init,
760 sizeof (GstInputSelector),
762 (GInstanceInitFunc) gst_input_selector_init,
764 input_selector_type =
765 g_type_register_static (GST_TYPE_ELEMENT,
766 "GstInputSelector", &input_selector_info, 0);
767 GST_DEBUG_CATEGORY_INIT (input_selector_debug,
768 "input-selector", 0, "An input stream selector element");
771 return input_selector_type;
775 gst_input_selector_base_init (GstInputSelectorClass * klass)
777 GstElementClass *element_class = GST_ELEMENT_CLASS (klass);
779 gst_element_class_set_details (element_class, &gst_input_selector_details);
780 gst_element_class_add_pad_template (element_class,
781 gst_static_pad_template_get (&gst_input_selector_sink_factory));
782 gst_element_class_add_pad_template (element_class,
783 gst_static_pad_template_get (&gst_input_selector_src_factory));
787 gst_input_selector_class_init (GstInputSelectorClass * klass)
789 GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
790 GstElementClass *gstelement_class = GST_ELEMENT_CLASS (klass);
792 parent_class = g_type_class_peek_parent (klass);
794 gobject_class->dispose = gst_input_selector_dispose;
796 gobject_class->set_property =
797 GST_DEBUG_FUNCPTR (gst_input_selector_set_property);
798 gobject_class->get_property =
799 GST_DEBUG_FUNCPTR (gst_input_selector_get_property);
801 g_object_class_install_property (gobject_class, PROP_N_PADS,
802 g_param_spec_uint ("n-pads", "Number of Pads",
803 "The number of sink pads", 0, G_MAXUINT, 0, G_PARAM_READABLE));
805 g_object_class_install_property (gobject_class, PROP_ACTIVE_PAD,
806 g_param_spec_object ("active-pad", "Active pad",
807 "The currently active sink pad", GST_TYPE_PAD, G_PARAM_READWRITE));
809 g_object_class_install_property (gobject_class, PROP_SELECT_ALL,
810 g_param_spec_boolean ("select-all", "Select all mode",
811 "Forwards data from all input pads", FALSE, G_PARAM_READWRITE));
814 * GstInputSelector::block:
815 * @inputselector: the #GstInputSelector
817 * Block all sink pads in preparation for a switch. Returns the stop time of
818 * the current switch segment, as a running time, or 0 if there is no current
819 * active pad or the current active pad never received data.
821 gst_input_selector_signals[SIGNAL_BLOCK] =
822 g_signal_new ("block", G_TYPE_FROM_CLASS (klass),
823 G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION,
824 G_STRUCT_OFFSET (GstInputSelectorClass, block), NULL, NULL,
825 gst_selector_marshal_INT64__VOID, G_TYPE_INT64, 0);
827 * GstInputSelector::switch:
828 * @inputselector: the #GstInputSelector
829 * @pad: the pad to switch to
830 * @stop_time: running time at which to close the previous segment, or -1
831 * to use the running time of the previously active sink pad
832 * @start_time: running time at which to start the new segment, or -1 to
833 * use the running time of the newly active sink pad
835 * Switch to a new feed. The segment opened by the previously active pad, if
836 * any, will be closed, and a new segment opened before data flows again.
838 * This signal must be emitted when the element has been blocked via the <link
839 * linkend="GstInputSelector-block">block</link> signal.
841 * If you have a stream with only one switch element, such as an audio-only
842 * stream, a stream switch should be performed by first emitting the block
843 * signal, and then emitting the switch signal with -1 for the stop and start
846 * The intention of the @stop_time and @start_time arguments is to allow
847 * multiple switch elements to switch and maintain stream synchronization.
848 * When switching a stream with multiple feeds, you will need as many switch
849 * elements as you have feeds. For example, a feed with audio and video will
850 * have one switch element between the audio feeds and one for video.
852 * A switch over multiple switch elements should be performed as follows:
853 * First, emit the <link linkend="GstInputSelector-block">block</link>
854 * signal, collecting the returned values. The maximum running time returned
855 * by block should then be used as the time at which to close the previous
858 * Then, query the running times of the new audio and video pads that you will
859 * switch to. Naturally, these pads are on separate switch elements. Take the
860 * minimum running time for those streams and use it for the time at which to
861 * open the new segment.
863 * If @pad is the same as the current active pad, the element will cancel any
864 * previous block without adjusting segments.
867 * the signal changed from accepting the pad name to the pad object.
872 gst_input_selector_signals[SIGNAL_SWITCH] =
873 g_signal_new ("switch", G_TYPE_FROM_CLASS (klass), G_SIGNAL_RUN_LAST,
874 G_STRUCT_OFFSET (GstInputSelectorClass, switch_),
875 NULL, NULL, gst_selector_marshal_VOID__OBJECT_INT64_INT64,
876 G_TYPE_NONE, 3, GST_TYPE_PAD, G_TYPE_INT64, G_TYPE_INT64);
878 gstelement_class->request_new_pad = gst_input_selector_request_new_pad;
879 gstelement_class->release_pad = gst_input_selector_release_pad;
880 gstelement_class->change_state = gst_input_selector_change_state;
882 klass->block = GST_DEBUG_FUNCPTR (gst_input_selector_block);
883 /* note the underscore because switch is a keyword otherwise */
884 klass->switch_ = GST_DEBUG_FUNCPTR (gst_input_selector_switch);
888 gst_input_selector_init (GstInputSelector * sel)
890 sel->srcpad = gst_pad_new ("src", GST_PAD_SRC);
891 gst_pad_set_iterate_internal_links_function (sel->srcpad,
892 GST_DEBUG_FUNCPTR (gst_selector_pad_iterate_linked_pads));
893 gst_pad_set_getcaps_function (sel->srcpad,
894 GST_DEBUG_FUNCPTR (gst_input_selector_getcaps));
895 gst_pad_set_query_function (sel->srcpad,
896 GST_DEBUG_FUNCPTR (gst_input_selector_query));
897 gst_pad_set_event_function (sel->srcpad,
898 GST_DEBUG_FUNCPTR (gst_input_selector_event));
899 gst_element_add_pad (GST_ELEMENT (sel), sel->srcpad);
900 /* sinkpad management */
901 sel->active_sinkpad = NULL;
903 gst_segment_init (&sel->segment, GST_FORMAT_UNDEFINED);
905 sel->lock = g_mutex_new ();
906 sel->cond = g_cond_new ();
907 sel->blocked = FALSE;
909 sel->select_all = FALSE;
913 gst_input_selector_dispose (GObject * object)
915 GstInputSelector *sel = GST_INPUT_SELECTOR (object);
917 if (sel->active_sinkpad) {
918 gst_object_unref (sel->active_sinkpad);
919 sel->active_sinkpad = NULL;
922 g_mutex_free (sel->lock);
926 g_cond_free (sel->cond);
930 G_OBJECT_CLASS (parent_class)->dispose (object);
933 /* Solve the following equation for B.timestamp, and set that as the segment
935 * B.running_time = (B.timestamp - NS.start) / NS.abs_rate + NS.accum
938 gst_segment_get_timestamp (GstSegment * segment, gint64 running_time)
940 return (running_time - segment->accum) * segment->abs_rate + segment->start;
944 gst_segment_set_stop (GstSegment * segment, gint64 running_time)
946 segment->stop = gst_segment_get_timestamp (segment, running_time);
947 segment->last_stop = -1;
951 gst_segment_set_start (GstSegment * segment, gint64 running_time)
953 gint64 new_start, duration;
955 new_start = gst_segment_get_timestamp (segment, running_time);
957 /* this is the duration we skipped */
958 duration = new_start - segment->start;
959 /* add the duration to the accumulated segment time */
960 segment->accum += duration;
961 /* move position in the segment */
962 segment->time += duration;
963 segment->start += duration;
966 /* this function must be called with the SELECTOR_LOCK. It returns TRUE when the
967 * active pad changed. */
969 gst_input_selector_set_active_pad (GstInputSelector * self,
970 GstPad * pad, gint64 stop_time, gint64 start_time)
972 GstSelectorPad *old, *new;
973 GstPad **active_pad_p;
975 if (pad == self->active_sinkpad)
978 old = GST_SELECTOR_PAD_CAST (self->active_sinkpad);
979 new = GST_SELECTOR_PAD_CAST (pad);
981 GST_DEBUG_OBJECT (self, "setting active pad to %s:%s",
982 GST_DEBUG_PAD_NAME (new));
984 if (stop_time == -1 && old) {
985 /* no stop time given, get the latest running_time on the active pad to
986 * close and open the new segment */
987 stop_time = start_time = gst_selector_pad_get_running_time (old);
988 GST_DEBUG_OBJECT (self, "using start/stop of %" G_GINT64_FORMAT,
992 if (old && old->active && !self->pending_close && stop_time >= 0) {
993 /* schedule a last_stop update if one isn't already scheduled, and a
994 segment has been pushed before. */
995 memcpy (&self->segment, &old->segment, sizeof (self->segment));
997 GST_DEBUG_OBJECT (self, "setting stop_time to %" G_GINT64_FORMAT,
999 gst_segment_set_stop (&self->segment, stop_time);
1000 self->pending_close = TRUE;
1003 if (new && new->active && start_time >= 0) {
1004 GST_DEBUG_OBJECT (self, "setting start_time to %" G_GINT64_FORMAT,
1006 /* schedule a new segment push */
1007 gst_segment_set_start (&new->segment, start_time);
1008 new->segment_pending = TRUE;
1011 active_pad_p = &self->active_sinkpad;
1012 gst_object_replace ((GstObject **) active_pad_p, GST_OBJECT_CAST (pad));
1013 GST_DEBUG_OBJECT (self, "New active pad is %" GST_PTR_FORMAT,
1014 self->active_sinkpad);
1020 gst_input_selector_set_property (GObject * object, guint prop_id,
1021 const GValue * value, GParamSpec * pspec)
1023 GstInputSelector *sel = GST_INPUT_SELECTOR (object);
1026 case PROP_ACTIVE_PAD:
1030 pad = g_value_get_object (value);
1032 GST_INPUT_SELECTOR_LOCK (sel);
1033 gst_input_selector_set_active_pad (sel, pad,
1034 GST_CLOCK_TIME_NONE, GST_CLOCK_TIME_NONE);
1035 GST_INPUT_SELECTOR_UNLOCK (sel);
1038 case PROP_SELECT_ALL:
1039 GST_INPUT_SELECTOR_LOCK (object);
1040 sel->select_all = g_value_get_boolean (value);
1041 GST_INPUT_SELECTOR_UNLOCK (object);
1044 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
1050 gst_input_selector_get_property (GObject * object, guint prop_id,
1051 GValue * value, GParamSpec * pspec)
1053 GstInputSelector *sel = GST_INPUT_SELECTOR (object);
1057 GST_INPUT_SELECTOR_LOCK (object);
1058 g_value_set_uint (value, sel->n_pads);
1059 GST_INPUT_SELECTOR_UNLOCK (object);
1061 case PROP_ACTIVE_PAD:
1062 GST_INPUT_SELECTOR_LOCK (object);
1063 g_value_set_object (value, sel->active_sinkpad);
1064 GST_INPUT_SELECTOR_UNLOCK (object);
1066 case PROP_SELECT_ALL:
1067 GST_INPUT_SELECTOR_LOCK (object);
1068 g_value_set_boolean (value, sel->select_all);
1069 GST_INPUT_SELECTOR_UNLOCK (object);
1072 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
1078 gst_input_selector_get_linked_pad (GstPad * pad, gboolean strict)
1080 GstInputSelector *sel;
1081 GstPad *otherpad = NULL;
1083 sel = GST_INPUT_SELECTOR (gst_pad_get_parent (pad));
1085 GST_INPUT_SELECTOR_LOCK (sel);
1086 if (pad == sel->srcpad)
1087 otherpad = sel->active_sinkpad;
1088 else if (pad == sel->active_sinkpad || !strict)
1089 otherpad = sel->srcpad;
1091 gst_object_ref (otherpad);
1092 GST_INPUT_SELECTOR_UNLOCK (sel);
1094 gst_object_unref (sel);
1100 gst_input_selector_event (GstPad * pad, GstEvent * event)
1102 gboolean res = FALSE;
1105 otherpad = gst_input_selector_get_linked_pad (pad, TRUE);
1108 res = gst_pad_push_event (otherpad, event);
1110 gst_object_unref (otherpad);
1112 gst_event_unref (event);
1116 /* query on the srcpad. We override this function because by default it will
1117 * only forward the query to one random sinkpad */
1119 gst_input_selector_query (GstPad * pad, GstQuery * query)
1121 gboolean res = TRUE;
1122 GstInputSelector *sel;
1125 sel = GST_INPUT_SELECTOR (gst_pad_get_parent (pad));
1127 otherpad = gst_input_selector_get_linked_pad (pad, TRUE);
1129 switch (GST_QUERY_TYPE (query)) {
1130 case GST_QUERY_LATENCY:
1133 GstClockTime resmin, resmax;
1140 /* assume FALSE, we become TRUE if one query succeeds */
1143 /* perform the query on all sinkpads and combine the results. We take the
1144 * max of min and the min of max for the result latency. */
1145 GST_INPUT_SELECTOR_LOCK (sel);
1146 for (walk = GST_ELEMENT_CAST (sel)->sinkpads; walk;
1147 walk = g_list_next (walk)) {
1148 GstPad *sinkpad = GST_PAD_CAST (walk->data);
1150 if (gst_pad_peer_query (sinkpad, query)) {
1151 GstClockTime min, max;
1154 /* one query succeeded, we succeed too */
1157 gst_query_parse_latency (query, &live, &min, &max);
1159 GST_DEBUG_OBJECT (sinkpad,
1160 "peer latency min %" GST_TIME_FORMAT ", max %" GST_TIME_FORMAT
1161 ", live %d", GST_TIME_ARGS (min), GST_TIME_ARGS (max), live);
1168 else if (max < resmax)
1170 if (reslive == FALSE)
1175 GST_INPUT_SELECTOR_UNLOCK (sel);
1177 gst_query_set_latency (query, reslive, resmin, resmax);
1179 GST_DEBUG_OBJECT (sel,
1180 "total latency min %" GST_TIME_FORMAT ", max %" GST_TIME_FORMAT
1181 ", live %d", GST_TIME_ARGS (resmin), GST_TIME_ARGS (resmax),
1189 res = gst_pad_peer_query (otherpad, query);
1193 gst_object_unref (otherpad);
1194 gst_object_unref (sel);
1200 gst_input_selector_getcaps (GstPad * pad)
1206 parent = gst_object_get_parent (GST_OBJECT (pad));
1208 otherpad = gst_input_selector_get_linked_pad (pad, FALSE);
1211 if (GST_INPUT_SELECTOR (parent)->select_all) {
1212 GST_DEBUG_OBJECT (parent,
1213 "Pad %s:%s not linked, returning merge of caps",
1214 GST_DEBUG_PAD_NAME (pad));
1215 caps = gst_pad_proxy_getcaps (pad);
1217 GST_DEBUG_OBJECT (parent,
1218 "Pad %s:%s not linked, returning ANY", GST_DEBUG_PAD_NAME (pad));
1219 caps = gst_caps_new_any ();
1222 GST_DEBUG_OBJECT (parent,
1223 "Pad %s:%s is linked (to %s:%s), returning peer caps",
1224 GST_DEBUG_PAD_NAME (pad), GST_DEBUG_PAD_NAME (otherpad));
1225 /* if the peer has caps, use those. If the pad is not linked, this function
1226 * returns NULL and we return ANY */
1227 if (!(caps = gst_pad_peer_get_caps (otherpad)))
1228 caps = gst_caps_new_any ();
1229 gst_object_unref (otherpad);
1232 gst_object_unref (parent);
1236 /* check if the pad is the active sinkpad */
1238 gst_input_selector_is_active_sinkpad (GstInputSelector * sel, GstPad * pad)
1240 GstSelectorPad *selpad;
1243 selpad = GST_SELECTOR_PAD_CAST (pad);
1245 GST_INPUT_SELECTOR_LOCK (sel);
1246 res = (pad == sel->active_sinkpad);
1247 GST_INPUT_SELECTOR_UNLOCK (sel);
1252 /* Get or create the active sinkpad, must be called with SELECTOR_LOCK */
1254 gst_input_selector_activate_sinkpad (GstInputSelector * sel, GstPad * pad)
1256 GstPad *active_sinkpad;
1257 GstSelectorPad *selpad;
1259 selpad = GST_SELECTOR_PAD_CAST (pad);
1261 selpad->active = TRUE;
1262 active_sinkpad = sel->active_sinkpad;
1263 if (active_sinkpad == NULL || sel->select_all) {
1264 /* first pad we get activity on becomes the activated pad by default, if we
1265 * select all, we also remember the last used pad. */
1266 if (sel->active_sinkpad)
1267 gst_object_unref (sel->active_sinkpad);
1268 active_sinkpad = sel->active_sinkpad = gst_object_ref (pad);
1269 GST_DEBUG_OBJECT (sel, "Activating pad %s:%s", GST_DEBUG_PAD_NAME (pad));
1272 return active_sinkpad;
1276 gst_input_selector_request_new_pad (GstElement * element,
1277 GstPadTemplate * templ, const gchar * unused)
1279 GstInputSelector *sel;
1281 GstPad *sinkpad = NULL;
1283 g_return_val_if_fail (templ->direction == GST_PAD_SINK, NULL);
1285 sel = GST_INPUT_SELECTOR (element);
1287 GST_INPUT_SELECTOR_LOCK (sel);
1289 GST_LOG_OBJECT (sel, "Creating new pad %d", sel->padcount);
1290 name = g_strdup_printf ("sink%d", sel->padcount++);
1291 sinkpad = g_object_new (GST_TYPE_SELECTOR_PAD,
1292 "name", name, "direction", templ->direction, "template", templ, NULL);
1297 gst_pad_set_event_function (sinkpad,
1298 GST_DEBUG_FUNCPTR (gst_selector_pad_event));
1299 gst_pad_set_getcaps_function (sinkpad,
1300 GST_DEBUG_FUNCPTR (gst_selector_pad_getcaps));
1301 gst_pad_set_chain_function (sinkpad,
1302 GST_DEBUG_FUNCPTR (gst_selector_pad_chain));
1303 gst_pad_set_iterate_internal_links_function (sinkpad,
1304 GST_DEBUG_FUNCPTR (gst_selector_pad_iterate_linked_pads));
1305 gst_pad_set_bufferalloc_function (sinkpad,
1306 GST_DEBUG_FUNCPTR (gst_selector_pad_bufferalloc));
1308 gst_pad_set_active (sinkpad, TRUE);
1309 gst_element_add_pad (GST_ELEMENT (sel), sinkpad);
1310 GST_INPUT_SELECTOR_UNLOCK (sel);
1316 gst_input_selector_release_pad (GstElement * element, GstPad * pad)
1318 GstInputSelector *sel;
1320 sel = GST_INPUT_SELECTOR (element);
1321 GST_LOG_OBJECT (sel, "Releasing pad %s:%s", GST_DEBUG_PAD_NAME (pad));
1323 GST_INPUT_SELECTOR_LOCK (sel);
1324 /* if the pad was the active pad, makes us select a new one */
1325 if (sel->active_sinkpad == pad) {
1326 GST_DEBUG_OBJECT (sel, "Deactivating pad %s:%s", GST_DEBUG_PAD_NAME (pad));
1327 gst_object_unref (sel->active_sinkpad);
1328 sel->active_sinkpad = NULL;
1332 gst_pad_set_active (pad, FALSE);
1333 gst_element_remove_pad (GST_ELEMENT (sel), pad);
1334 GST_INPUT_SELECTOR_UNLOCK (sel);
1338 gst_input_selector_reset (GstInputSelector * sel)
1342 GST_INPUT_SELECTOR_LOCK (sel);
1343 /* clear active pad */
1344 if (sel->active_sinkpad) {
1345 gst_object_unref (sel->active_sinkpad);
1346 sel->active_sinkpad = NULL;
1349 gst_segment_init (&sel->segment, GST_FORMAT_UNDEFINED);
1350 sel->pending_close = FALSE;
1351 /* reset each of our sinkpads state */
1352 for (walk = GST_ELEMENT_CAST (sel)->sinkpads; walk; walk = g_list_next (walk)) {
1353 GstSelectorPad *selpad = GST_SELECTOR_PAD_CAST (walk->data);
1355 gst_selector_pad_reset (selpad);
1358 gst_tag_list_free (selpad->tags);
1359 selpad->tags = NULL;
1362 GST_INPUT_SELECTOR_UNLOCK (sel);
1365 static GstStateChangeReturn
1366 gst_input_selector_change_state (GstElement * element,
1367 GstStateChange transition)
1369 GstInputSelector *self = GST_INPUT_SELECTOR (element);
1370 GstStateChangeReturn result;
1372 switch (transition) {
1373 case GST_STATE_CHANGE_READY_TO_PAUSED:
1374 GST_INPUT_SELECTOR_LOCK (self);
1375 self->blocked = FALSE;
1376 self->flushing = FALSE;
1377 GST_INPUT_SELECTOR_UNLOCK (self);
1379 case GST_STATE_CHANGE_PAUSED_TO_READY:
1380 /* first unlock before we call the parent state change function, which
1381 * tries to acquire the stream lock when going to ready. */
1382 GST_INPUT_SELECTOR_LOCK (self);
1383 self->blocked = FALSE;
1384 self->flushing = TRUE;
1385 GST_INPUT_SELECTOR_BROADCAST (self);
1386 GST_INPUT_SELECTOR_UNLOCK (self);
1392 result = GST_ELEMENT_CLASS (parent_class)->change_state (element, transition);
1394 switch (transition) {
1395 case GST_STATE_CHANGE_PAUSED_TO_READY:
1396 gst_input_selector_reset (self);
1406 gst_input_selector_block (GstInputSelector * self)
1409 GstSelectorPad *spad;
1411 GST_INPUT_SELECTOR_LOCK (self);
1414 GST_WARNING_OBJECT (self, "switch already blocked");
1416 self->blocked = TRUE;
1417 spad = GST_SELECTOR_PAD_CAST (self->active_sinkpad);
1420 ret = gst_selector_pad_get_running_time (spad);
1422 GST_DEBUG_OBJECT (self, "no active pad while blocking");
1424 GST_INPUT_SELECTOR_UNLOCK (self);
1429 /* stop_time and start_time are running times */
1431 gst_input_selector_switch (GstInputSelector * self, GstPad * pad,
1432 gint64 stop_time, gint64 start_time)
1436 g_return_if_fail (self->blocked == TRUE);
1438 GST_INPUT_SELECTOR_LOCK (self);
1440 gst_input_selector_set_active_pad (self, pad, stop_time, start_time);
1442 self->blocked = FALSE;
1443 GST_INPUT_SELECTOR_BROADCAST (self);
1444 GST_INPUT_SELECTOR_UNLOCK (self);
1447 g_object_notify (G_OBJECT (self), "active-pad");
1451 gst_input_selector_check_eos (GstElement * selector)
1453 GstIterator *it = gst_element_iterate_sink_pads (selector);
1454 GstIteratorResult ires;
1456 gboolean done = FALSE, is_eos = FALSE;
1457 GstSelectorPad *pad;
1460 ires = gst_iterator_next (it, &item);
1462 case GST_ITERATOR_DONE:
1463 GST_INFO_OBJECT (selector, "all sink pads have eos");
1467 case GST_ITERATOR_OK:
1468 pad = GST_SELECTOR_PAD_CAST (item);
1472 gst_object_unref (pad);
1474 case GST_ITERATOR_RESYNC:
1475 gst_iterator_resync (it);
1482 gst_iterator_free (it);