2 * Copyright (C) 2008 Nokia Corporation. (contact <stefan.kost@nokia.com>)
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Library General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Library General Public License for more details.
14 * You should have received a copy of the GNU Library General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 * Boston, MA 02111-1307, USA.
21 * SECTION:element-output-selector
22 * @see_also: #GstOutputSelector, #GstInputSelector
24 * Direct input stream to one out of N output pads.
33 #include "gstoutputselector.h"
35 GST_DEBUG_CATEGORY_STATIC (output_selector_debug);
36 #define GST_CAT_DEFAULT output_selector_debug
38 static const GstElementDetails gst_output_selector_details =
39 GST_ELEMENT_DETAILS ("Output selector",
41 "1-to-N output stream selectoring",
42 "Stefan Kost <stefan.kost@nokia.com>");
44 static GstStaticPadTemplate gst_output_selector_sink_factory =
45 GST_STATIC_PAD_TEMPLATE ("sink",
50 static GstStaticPadTemplate gst_output_selector_src_factory =
51 GST_STATIC_PAD_TEMPLATE ("src%d",
64 GST_BOILERPLATE (GstOutputSelector, gst_output_selector, GstElement,
67 static void gst_output_selector_dispose (GObject * object);
68 static void gst_output_selector_set_property (GObject * object,
69 guint prop_id, const GValue * value, GParamSpec * pspec);
70 static void gst_output_selector_get_property (GObject * object,
71 guint prop_id, GValue * value, GParamSpec * pspec);
72 static GstPad *gst_output_selector_request_new_pad (GstElement * element,
73 GstPadTemplate * templ, const gchar * unused);
74 static void gst_output_selector_release_pad (GstElement * element,
76 static GstFlowReturn gst_output_selector_chain (GstPad * pad, GstBuffer * buf);
77 static GstFlowReturn gst_output_selector_buffer_alloc (GstPad * pad,
78 guint64 offset, guint size, GstCaps * caps, GstBuffer ** buf);
79 static GstStateChangeReturn gst_output_selector_change_state (GstElement *
80 element, GstStateChange transition);
81 static gboolean gst_output_selector_handle_sink_event (GstPad * pad,
85 gst_output_selector_base_init (gpointer g_class)
87 GstElementClass *element_class = GST_ELEMENT_CLASS (g_class);
89 gst_element_class_set_details (element_class, &gst_output_selector_details);
90 gst_element_class_add_pad_template (element_class,
91 gst_static_pad_template_get (&gst_output_selector_sink_factory));
92 gst_element_class_add_pad_template (element_class,
93 gst_static_pad_template_get (&gst_output_selector_src_factory));
97 gst_output_selector_class_init (GstOutputSelectorClass * klass)
99 GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
100 GstElementClass *gstelement_class = GST_ELEMENT_CLASS (klass);
102 parent_class = g_type_class_peek_parent (klass);
104 gobject_class->dispose = gst_output_selector_dispose;
106 gobject_class->set_property =
107 GST_DEBUG_FUNCPTR (gst_output_selector_set_property);
108 gobject_class->get_property =
109 GST_DEBUG_FUNCPTR (gst_output_selector_get_property);
111 g_object_class_install_property (gobject_class, PROP_ACTIVE_PAD,
112 g_param_spec_object ("active-pad", "Active pad",
113 "Currently active src pad", GST_TYPE_PAD, G_PARAM_READWRITE));
114 g_object_class_install_property (gobject_class, PROP_RESEND_LATEST,
115 g_param_spec_boolean ("resend-latest", "Resend latest buffer",
116 "Resend latest buffer after a switch to a new pad", FALSE,
119 gstelement_class->request_new_pad =
120 GST_DEBUG_FUNCPTR (gst_output_selector_request_new_pad);
121 gstelement_class->release_pad =
122 GST_DEBUG_FUNCPTR (gst_output_selector_release_pad);
124 gstelement_class->change_state = gst_output_selector_change_state;
126 GST_DEBUG_CATEGORY_INIT (output_selector_debug,
127 "output-selector", 0, "An output stream selector element");
131 gst_output_selector_init (GstOutputSelector * sel,
132 GstOutputSelectorClass * g_class)
135 gst_pad_new_from_static_template (&gst_output_selector_sink_factory,
137 gst_pad_set_chain_function (sel->sinkpad,
138 GST_DEBUG_FUNCPTR (gst_output_selector_chain));
139 gst_pad_set_event_function (sel->sinkpad,
140 GST_DEBUG_FUNCPTR (gst_output_selector_handle_sink_event));
141 gst_pad_set_bufferalloc_function (sel->sinkpad,
142 GST_DEBUG_FUNCPTR (gst_output_selector_buffer_alloc));
144 gst_pad_set_setcaps_function (sel->sinkpad,
145 GST_DEBUG_FUNCPTR (gst_pad_proxy_setcaps));
146 gst_pad_set_getcaps_function (sel->sinkpad,
147 GST_DEBUG_FUNCPTR (gst_pad_proxy_getcaps));
150 gst_element_add_pad (GST_ELEMENT (sel), sel->sinkpad);
152 /* srcpad management */
153 sel->active_srcpad = NULL;
155 gst_segment_init (&sel->segment, GST_FORMAT_UNDEFINED);
156 sel->pending_srcpad = NULL;
158 sel->resend_latest = FALSE;
159 sel->latest_buffer = NULL;
163 gst_output_selector_reset (GstOutputSelector * osel)
165 if (osel->pending_srcpad != NULL) {
166 gst_object_unref (osel->pending_srcpad);
167 osel->pending_srcpad = NULL;
169 if (osel->latest_buffer != NULL) {
170 gst_buffer_unref (osel->latest_buffer);
171 osel->latest_buffer = NULL;
173 gst_segment_init (&osel->segment, GST_FORMAT_UNDEFINED);
177 gst_output_selector_dispose (GObject * object)
179 GstOutputSelector *osel = GST_OUTPUT_SELECTOR (object);
181 gst_output_selector_reset (osel);
183 G_OBJECT_CLASS (parent_class)->dispose (object);
187 gst_output_selector_set_property (GObject * object, guint prop_id,
188 const GValue * value, GParamSpec * pspec)
190 GstOutputSelector *sel = GST_OUTPUT_SELECTOR (object);
193 case PROP_ACTIVE_PAD:
197 next_pad = g_value_get_object (value);
199 GST_INFO_OBJECT (sel, "Activating pad %s:%s",
200 GST_DEBUG_PAD_NAME (next_pad));
202 GST_OBJECT_LOCK (object);
203 if (next_pad != sel->active_srcpad) {
204 /* switch to new srcpad in next chain run */
205 if (sel->pending_srcpad != NULL) {
206 GST_INFO ("replacing pending switch");
207 gst_object_unref (sel->pending_srcpad);
210 gst_object_ref (next_pad);
211 sel->pending_srcpad = next_pad;
213 GST_INFO ("pad already active");
214 if (sel->pending_srcpad != NULL) {
215 gst_object_unref (sel->pending_srcpad);
216 sel->pending_srcpad = NULL;
219 GST_OBJECT_UNLOCK (object);
222 case PROP_RESEND_LATEST:{
223 sel->resend_latest = g_value_get_boolean (value);
227 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
233 gst_output_selector_get_property (GObject * object, guint prop_id,
234 GValue * value, GParamSpec * pspec)
236 GstOutputSelector *sel = GST_OUTPUT_SELECTOR (object);
239 case PROP_ACTIVE_PAD:
240 GST_OBJECT_LOCK (object);
241 g_value_set_object (value,
242 sel->pending_srcpad ? sel->pending_srcpad : sel->active_srcpad);
243 GST_OBJECT_UNLOCK (object);
245 case PROP_RESEND_LATEST:{
246 GST_OBJECT_LOCK (object);
247 g_value_set_boolean (value, sel->resend_latest);
248 GST_OBJECT_UNLOCK (object);
252 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
258 gst_output_selector_buffer_alloc (GstPad * pad, guint64 offset, guint size,
259 GstCaps * caps, GstBuffer ** buf)
261 GstOutputSelector *sel;
265 sel = GST_OUTPUT_SELECTOR (GST_PAD_PARENT (pad));
266 res = GST_FLOW_NOT_LINKED;
268 GST_OBJECT_LOCK (sel);
269 allocpad = sel->pending_srcpad ? sel->pending_srcpad : sel->active_srcpad;
271 /* if we had a previous pad we used for allocating a buffer, continue using
273 GST_DEBUG_OBJECT (sel, "using pad %s:%s for alloc",
274 GST_DEBUG_PAD_NAME (allocpad));
275 gst_object_ref (allocpad);
276 GST_OBJECT_UNLOCK (sel);
278 res = gst_pad_alloc_buffer (allocpad, offset, size, caps, buf);
279 gst_object_unref (allocpad);
281 GST_OBJECT_LOCK (sel);
283 /* fallback case, allocate a buffer of our own, add pad caps. */
284 GST_DEBUG_OBJECT (pad, "fallback buffer alloc");
288 GST_OBJECT_UNLOCK (sel);
290 GST_DEBUG_OBJECT (sel, "buffer alloc finished: %s", gst_flow_get_name (res));
296 gst_output_selector_request_new_pad (GstElement * element,
297 GstPadTemplate * templ, const gchar * name)
301 GstOutputSelector *osel;
303 osel = GST_OUTPUT_SELECTOR (element);
305 GST_DEBUG_OBJECT (osel, "requesting pad");
307 GST_OBJECT_LOCK (osel);
308 padname = g_strdup_printf ("src%d", osel->nb_srcpads++);
309 srcpad = gst_pad_new_from_template (templ, padname);
310 GST_OBJECT_UNLOCK (osel);
312 gst_pad_set_active (srcpad, TRUE);
313 gst_element_add_pad (GST_ELEMENT (osel), srcpad);
315 /* Set the first requested src pad as active by default */
316 if (osel->active_srcpad == NULL) {
317 osel->active_srcpad = srcpad;
325 gst_output_selector_release_pad (GstElement * element, GstPad * pad)
327 GstOutputSelector *osel;
329 osel = GST_OUTPUT_SELECTOR (element);
331 GST_DEBUG_OBJECT (osel, "releasing pad");
333 gst_pad_set_active (pad, FALSE);
335 gst_element_remove_pad (GST_ELEMENT_CAST (osel), pad);
339 gst_output_selector_switch (GstOutputSelector * osel)
341 gboolean res = FALSE;
343 GstSegment *seg = NULL;
344 gint64 start = 0, position = 0;
347 GST_OBJECT_LOCK (GST_OBJECT (osel));
348 GST_INFO ("switching to pad %" GST_PTR_FORMAT, osel->pending_srcpad);
349 if (gst_pad_is_linked (osel->pending_srcpad)) {
350 osel->active_srcpad = osel->pending_srcpad;
353 gst_object_unref (osel->pending_srcpad);
354 osel->pending_srcpad = NULL;
355 GST_OBJECT_UNLOCK (GST_OBJECT (osel));
357 /* Send NEWSEGMENT event and latest buffer if switching succeeded */
359 /* Send NEWSEGMENT to the pad we are going to switch to */
360 seg = &osel->segment;
361 /* If resending then mark newsegment start and position accordingly */
362 if (osel->resend_latest && osel->latest_buffer &&
363 GST_BUFFER_TIMESTAMP_IS_VALID (osel->latest_buffer)) {
364 start = position = GST_BUFFER_TIMESTAMP (osel->latest_buffer);
366 start = position = seg->last_stop;
368 ev = gst_event_new_new_segment (TRUE, seg->rate,
369 seg->format, start, seg->stop, position);
370 if (!gst_pad_push_event (osel->active_srcpad, ev)) {
371 GST_WARNING_OBJECT (osel,
372 "newsegment handling failed in %" GST_PTR_FORMAT,
373 osel->active_srcpad);
376 /* Resend latest buffer to newly switched pad */
377 if (osel->resend_latest && osel->latest_buffer) {
378 GST_INFO ("resending latest buffer");
379 gst_pad_push (osel->active_srcpad, osel->latest_buffer);
380 osel->latest_buffer = NULL;
383 GST_WARNING_OBJECT (osel, "switch failed, pad not linked");
390 gst_output_selector_chain (GstPad * pad, GstBuffer * buf)
393 GstOutputSelector *osel;
394 GstClockTime last_stop, duration;
396 osel = GST_OUTPUT_SELECTOR (gst_pad_get_parent (pad));
398 if (osel->pending_srcpad) {
400 gst_output_selector_switch (osel);
403 if (osel->latest_buffer) {
404 gst_buffer_unref (osel->latest_buffer);
405 osel->latest_buffer = NULL;
408 if (osel->resend_latest) {
409 /* Keep reference to latest buffer to resend it after switch */
410 osel->latest_buffer = gst_buffer_ref (buf);
413 /* Keep track of last stop and use it in NEWSEGMENT start after
414 switching to a new src pad */
415 last_stop = GST_BUFFER_TIMESTAMP (buf);
416 if (GST_CLOCK_TIME_IS_VALID (last_stop)) {
417 duration = GST_BUFFER_DURATION (buf);
418 if (GST_CLOCK_TIME_IS_VALID (duration)) {
419 last_stop += duration;
421 GST_LOG_OBJECT (osel, "setting last stop %" GST_TIME_FORMAT,
422 GST_TIME_ARGS (last_stop));
423 gst_segment_set_last_stop (&osel->segment, osel->segment.format, last_stop);
426 GST_LOG_OBJECT (osel, "pushing buffer to %" GST_PTR_FORMAT,
427 osel->active_srcpad);
428 res = gst_pad_push (osel->active_srcpad, buf);
429 gst_object_unref (osel);
434 static GstStateChangeReturn
435 gst_output_selector_change_state (GstElement * element,
436 GstStateChange transition)
438 GstOutputSelector *sel;
439 GstStateChangeReturn result;
441 sel = GST_OUTPUT_SELECTOR (element);
443 switch (transition) {
444 case GST_STATE_CHANGE_READY_TO_PAUSED:
450 result = GST_ELEMENT_CLASS (parent_class)->change_state (element, transition);
452 switch (transition) {
453 case GST_STATE_CHANGE_PAUSED_TO_READY:
454 gst_output_selector_reset (sel);
464 gst_output_selector_handle_sink_event (GstPad * pad, GstEvent * event)
467 GstOutputSelector *sel;
468 GstPad *output_pad = NULL;
470 sel = GST_OUTPUT_SELECTOR (gst_pad_get_parent (pad));
472 switch (GST_EVENT_TYPE (event)) {
473 case GST_EVENT_NEWSEGMENT:
478 gint64 start, stop, time;
480 gst_event_parse_new_segment_full (event, &update, &rate, &arate, &format,
481 &start, &stop, &time);
483 GST_DEBUG_OBJECT (sel,
484 "configured NEWSEGMENT update %d, rate %lf, applied rate %lf, "
485 "format %d, " "%" G_GINT64_FORMAT " -- %" G_GINT64_FORMAT ", time %"
486 G_GINT64_FORMAT, update, rate, arate, format, start, stop, time);
488 gst_segment_set_newsegment_full (&sel->segment, update,
489 rate, arate, format, start, stop, time);
491 /* Send newsegment to all src pads */
492 gst_pad_event_default (pad, event);
496 /* Send eos to all src pads */
497 gst_pad_event_default (pad, event);
500 /* Send other events to pending or active src pad */
502 sel->pending_srcpad ? sel->pending_srcpad : sel->active_srcpad;
503 res = gst_pad_push_event (output_pad, event);
507 gst_object_unref (sel);