1 /* RTP muxer element for GStreamer
5 * Copyright (C) <2007> Nokia Corporation.
6 * Contact: Zeeshan Ali <zeeshan.ali@nokia.com>
7 * Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
8 * 2000,2005 Wim Taymans <wim@fluendo.com>
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-rtpmux
29 * The rtp muxer takes multiple RTP streams having the same clock-rate and
30 * muxes into a single stream with a single SSRC.
38 #include <gst/rtp/gstrtpbuffer.h>
41 #include "gstrtpmux.h"
43 GST_DEBUG_CATEGORY_STATIC (gst_rtp_mux_debug);
44 #define GST_CAT_DEFAULT gst_rtp_mux_debug
46 /* elementfactory information */
47 static const GstElementDetails gst_rtp_mux_details =
48 GST_ELEMENT_DETAILS ("RTP muxer",
50 "multiplex N rtp streams into one",
51 "Zeeshan Ali <first.last@nokia.com>");
56 PROP_TIMESTAMP_OFFSET,
62 #define DEFAULT_TIMESTAMP_OFFSET -1
63 #define DEFAULT_SEQNUM_OFFSET -1
64 #define DEFAULT_SSRC -1
68 gboolean have_clock_base;
72 } GstRTPMuxPadPrivate;
74 static GstStaticPadTemplate src_factory = GST_STATIC_PAD_TEMPLATE ("src",
77 GST_STATIC_CAPS ("application/x-rtp")
80 static GstStaticPadTemplate sink_factory = GST_STATIC_PAD_TEMPLATE ("sink_%d",
83 GST_STATIC_CAPS ("application/x-rtp")
86 static GstPad *gst_rtp_mux_request_new_pad (GstElement * element,
87 GstPadTemplate * templ, const gchar * name);
88 static void gst_rtp_mux_release_pad (GstElement * element, GstPad * pad);
89 static GstFlowReturn gst_rtp_mux_chain (GstPad * pad, GstBuffer * buffer);
90 static gboolean gst_rtp_mux_setcaps (GstPad * pad, GstCaps * caps);
91 static GstCaps *gst_rtp_mux_getcaps (GstPad * pad);
93 static GstStateChangeReturn gst_rtp_mux_change_state (GstElement *
94 element, GstStateChange transition);
96 static void gst_rtp_mux_set_property (GObject * object, guint prop_id,
97 const GValue * value, GParamSpec * pspec);
98 static void gst_rtp_mux_get_property (GObject * object, guint prop_id,
99 GValue * value, GParamSpec * pspec);
102 GST_BOILERPLATE (GstRTPMux, gst_rtp_mux, GstElement, GST_TYPE_ELEMENT);
105 gst_rtp_mux_base_init (gpointer g_class)
107 GstElementClass *element_class = GST_ELEMENT_CLASS (g_class);
109 gst_element_class_add_pad_template (element_class,
110 gst_static_pad_template_get (&src_factory));
111 gst_element_class_add_pad_template (element_class,
112 gst_static_pad_template_get (&sink_factory));
114 gst_element_class_set_details (element_class, &gst_rtp_mux_details);
118 gst_rtp_mux_class_init (GstRTPMuxClass * klass)
120 GObjectClass *gobject_class;
121 GstElementClass *gstelement_class;
123 gobject_class = (GObjectClass *) klass;
124 gstelement_class = (GstElementClass *) klass;
126 gobject_class->get_property = gst_rtp_mux_get_property;
127 gobject_class->set_property = gst_rtp_mux_set_property;
129 g_object_class_install_property (G_OBJECT_CLASS (klass),
130 PROP_TIMESTAMP_OFFSET, g_param_spec_int ("timestamp-offset",
132 "Offset to add to all outgoing timestamps (-1 = random)", -1,
133 G_MAXINT, DEFAULT_TIMESTAMP_OFFSET, G_PARAM_READWRITE));
134 g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_SEQNUM_OFFSET,
135 g_param_spec_int ("seqnum-offset", "Sequence number Offset",
136 "Offset to add to all outgoing seqnum (-1 = random)", -1, G_MAXINT,
137 DEFAULT_SEQNUM_OFFSET, G_PARAM_READWRITE));
138 g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_SEQNUM,
139 g_param_spec_uint ("seqnum", "Sequence number",
140 "The RTP sequence number of the last processed packet",
141 0, G_MAXUINT, 0, G_PARAM_READABLE));
142 g_object_class_install_property (G_OBJECT_CLASS (klass), PROP_SSRC,
143 g_param_spec_uint ("ssrc", "SSRC",
144 "The SSRC of the packets (-1 == random)",
145 0, G_MAXUINT, DEFAULT_SSRC, G_PARAM_READWRITE));
147 gstelement_class->request_new_pad =
148 GST_DEBUG_FUNCPTR (gst_rtp_mux_request_new_pad);
149 gstelement_class->release_pad = GST_DEBUG_FUNCPTR (gst_rtp_mux_release_pad);
150 gstelement_class->change_state = GST_DEBUG_FUNCPTR (gst_rtp_mux_change_state);
152 klass->chain_func = gst_rtp_mux_chain;
156 gst_rtp_mux_src_event (GstPad * pad, GstEvent * event)
161 gboolean result = FALSE;
162 gboolean done = FALSE;
164 rtp_mux = gst_pad_get_parent_element (pad);
165 g_return_val_if_fail (rtp_mux != NULL, FALSE);
167 iter = gst_element_iterate_sink_pads (rtp_mux);
170 switch (gst_iterator_next (iter, (gpointer) & sinkpad)) {
171 case GST_ITERATOR_OK:
172 gst_event_ref (event);
173 result |= gst_pad_push_event (sinkpad, event);
174 gst_object_unref (sinkpad);
176 case GST_ITERATOR_RESYNC:
177 gst_iterator_resync (iter);
180 case GST_ITERATOR_ERROR:
181 GST_WARNING_OBJECT (rtp_mux, "Error iterating sinkpads");
182 case GST_ITERATOR_DONE:
187 gst_iterator_free (iter);
188 gst_object_unref (rtp_mux);
189 gst_event_unref (event);
195 gst_rtp_mux_init (GstRTPMux * object, GstRTPMuxClass * g_class)
197 GstElementClass *klass = GST_ELEMENT_GET_CLASS (object);
200 gst_pad_new_from_template (gst_element_class_get_pad_template (klass,
202 gst_pad_set_event_function (object->srcpad,
203 GST_DEBUG_FUNCPTR (gst_rtp_mux_src_event));
204 gst_element_add_pad (GST_ELEMENT (object), object->srcpad);
206 object->ssrc = DEFAULT_SSRC;
207 object->ts_offset = DEFAULT_TIMESTAMP_OFFSET;
208 object->seqnum_offset = DEFAULT_SEQNUM_OFFSET;
212 gst_rtp_mux_create_sinkpad (GstRTPMux * rtp_mux, GstPadTemplate * templ,
213 const gchar * req_name)
215 GstPad *newpad = NULL;
216 GstPadTemplate *class_templ;
219 gst_element_class_get_pad_template (GST_ELEMENT_GET_CLASS (rtp_mux),
222 if (templ == class_templ) {
223 gchar *tmpname = NULL;
224 const gchar *name = NULL;
226 /* create new pad with the name */
230 name = tmpname = g_strdup_printf ("sink_%02d", rtp_mux->numpads);
231 newpad = gst_pad_new_from_template (templ, name);
236 GST_WARNING_OBJECT (rtp_mux, "this is not our template!\n");
243 gst_rtp_mux_setup_sinkpad (GstRTPMux * rtp_mux, GstPad * sinkpad)
245 GstRTPMuxClass *klass;
246 GstRTPMuxPadPrivate *padpriv = g_slice_new0 (GstRTPMuxPadPrivate);
248 klass = GST_RTP_MUX_GET_CLASS (rtp_mux);
250 /* setup some pad functions */
251 gst_pad_set_setcaps_function (sinkpad, gst_rtp_mux_setcaps);
252 gst_pad_set_getcaps_function (sinkpad, gst_rtp_mux_getcaps);
253 if (klass->chain_func)
254 gst_pad_set_chain_function (sinkpad, klass->chain_func);
255 if (klass->sink_event_func)
256 gst_pad_set_event_function (sinkpad, klass->sink_event_func);
258 /* This could break with gstreamer 0.10.9 */
259 gst_pad_set_active (sinkpad, TRUE);
261 gst_pad_set_element_private (sinkpad, padpriv);
263 /* dd the pad to the element */
264 gst_element_add_pad (GST_ELEMENT (rtp_mux), sinkpad);
268 gst_rtp_mux_request_new_pad (GstElement * element,
269 GstPadTemplate * templ, const gchar * req_name)
274 g_return_val_if_fail (templ != NULL, NULL);
275 g_return_val_if_fail (GST_IS_RTP_MUX (element), NULL);
277 rtp_mux = GST_RTP_MUX (element);
279 if (templ->direction != GST_PAD_SINK) {
280 GST_WARNING_OBJECT (rtp_mux, "request pad that is not a SINK pad");
284 newpad = gst_rtp_mux_create_sinkpad (rtp_mux, templ, req_name);
286 gst_rtp_mux_setup_sinkpad (rtp_mux, newpad);
288 GST_WARNING_OBJECT (rtp_mux, "failed to create request pad");
294 gst_rtp_mux_release_pad (GstElement * element, GstPad * pad)
296 GstRTPMuxPadPrivate *padpriv;
298 GST_OBJECT_LOCK (element);
299 padpriv = gst_pad_get_element_private (pad);
300 gst_pad_set_element_private (pad, NULL);
301 GST_OBJECT_UNLOCK (element);
303 gst_element_remove_pad (element, pad);
306 gst_caps_replace (&padpriv->out_caps, NULL);
307 g_slice_free (GstRTPMuxPadPrivate, padpriv);
311 /* Put our own clock-base on the buffer */
313 gst_rtp_mux_readjust_rtp_timestamp (GstRTPMux * rtp_mux, GstPad * pad,
317 guint32 sink_ts_base = 0;
318 GstRTPMuxPadPrivate *padpriv;
321 GST_OBJECT_LOCK (rtp_mux);
322 padpriv = gst_pad_get_element_private (pad);
323 if (padpriv && padpriv->have_clock_base)
324 sink_ts_base = padpriv->clock_base;
325 GST_OBJECT_UNLOCK (rtp_mux);
327 ts = gst_rtp_buffer_get_timestamp (buffer) - sink_ts_base + rtp_mux->ts_base;
328 GST_LOG_OBJECT (rtp_mux, "Re-adjusting RTP ts %u to %u",
329 gst_rtp_buffer_get_timestamp (buffer), ts);
330 gst_rtp_buffer_set_timestamp (buffer, ts);
334 gst_rtp_mux_chain (GstPad * pad, GstBuffer * buffer)
338 GstRTPMuxPadPrivate *padpriv;
340 rtp_mux = GST_RTP_MUX (gst_pad_get_parent (pad));
342 if (!gst_rtp_buffer_validate (buffer)) {
343 GST_ERROR_OBJECT (rtp_mux, "Invalid RTP buffer");
344 gst_object_unref (rtp_mux);
345 return GST_FLOW_ERROR;
348 buffer = gst_buffer_make_writable (buffer);
350 GST_OBJECT_LOCK (rtp_mux);
352 gst_rtp_buffer_set_seq (buffer, rtp_mux->seqnum);
353 padpriv = gst_pad_get_element_private (pad);
355 gst_buffer_set_caps (buffer, padpriv->out_caps);
356 GST_OBJECT_UNLOCK (rtp_mux);
357 gst_rtp_buffer_set_ssrc (buffer, rtp_mux->current_ssrc);
358 gst_rtp_mux_readjust_rtp_timestamp (rtp_mux, pad, buffer);
359 GST_LOG_OBJECT (rtp_mux, "Pushing packet size %d, seq=%d, ts=%u",
360 GST_BUFFER_SIZE (buffer), rtp_mux->seqnum,
361 gst_rtp_buffer_get_timestamp (buffer));
364 ret = GST_FLOW_NOT_LINKED;
365 gst_buffer_unref (buffer);
369 ret = gst_pad_push (rtp_mux->srcpad, buffer);
373 gst_object_unref (rtp_mux);
378 gst_rtp_mux_setcaps (GstPad * pad, GstCaps * caps)
381 GstStructure *structure;
382 gboolean ret = FALSE;
383 GstRTPMuxPadPrivate *padpriv;
385 rtp_mux = GST_RTP_MUX (gst_pad_get_parent (pad));
387 structure = gst_caps_get_structure (caps, 0);
392 GST_OBJECT_LOCK (rtp_mux);
393 padpriv = gst_pad_get_element_private (pad);
395 gst_structure_get_uint (structure, "clock-base", &padpriv->clock_base)) {
396 padpriv->have_clock_base = TRUE;
398 GST_OBJECT_UNLOCK (rtp_mux);
400 caps = gst_caps_copy (caps);
402 gst_caps_set_simple (caps,
403 "clock-base", G_TYPE_UINT, rtp_mux->ts_base,
404 "seqnum-base", G_TYPE_UINT, rtp_mux->seqnum_base, NULL);
406 GST_DEBUG_OBJECT (rtp_mux,
407 "setting caps %" GST_PTR_FORMAT " on src pad..", caps);
408 ret = gst_pad_set_caps (rtp_mux->srcpad, caps);
411 GST_OBJECT_LOCK (rtp_mux);
412 padpriv = gst_pad_get_element_private (pad);
414 gst_caps_replace (&padpriv->out_caps, caps);
415 GST_OBJECT_UNLOCK (rtp_mux);
417 gst_caps_unref (caps);
420 gst_object_unref (rtp_mux);
426 clear_caps (GstCaps * caps, gboolean only_clock_rate)
430 /* Lets only match on the clock-rate */
431 for (i = 0; i < gst_caps_get_size (caps); i++) {
432 GstStructure *s = gst_caps_get_structure (caps, i);
434 for (j = 0; j < gst_structure_n_fields (s); j++) {
435 const gchar *name = gst_structure_nth_field_name (s, j);
437 if (strcmp (name, "clock-rate") && (only_clock_rate ||
438 (strcmp (name, "ssrc")))) {
439 gst_structure_remove_field (s, name);
447 same_clock_rate_fold (gpointer item, GValue * ret, gpointer user_data)
449 GstPad *mypad = user_data;
453 const GstCaps *accumcaps;
457 gst_object_unref (pad);
461 peercaps = gst_pad_peer_get_caps (pad);
463 gst_object_unref (pad);
467 othercaps = gst_caps_intersect (peercaps,
468 gst_pad_get_pad_template_caps (pad));
469 gst_caps_unref (peercaps);
471 accumcaps = gst_value_get_caps (ret);
473 clear_caps (othercaps, TRUE);
475 intersect = gst_caps_intersect (accumcaps, othercaps);
477 g_value_take_boxed (ret, intersect);
479 gst_caps_unref (othercaps);
480 gst_object_unref (pad);
482 return !gst_caps_is_empty (intersect);
486 gst_rtp_mux_getcaps (GstPad * pad)
488 GstRTPMux *mux = GST_RTP_MUX (gst_pad_get_parent (pad));
489 GstCaps *caps = NULL;
490 GstIterator *iter = NULL;
492 GstIteratorResult res;
493 GstCaps *peercaps = gst_pad_peer_get_caps (mux->srcpad);
494 GstCaps *othercaps = NULL;
497 othercaps = gst_caps_intersect (peercaps,
498 gst_pad_get_pad_template_caps (pad));
499 gst_caps_unref (peercaps);
501 othercaps = gst_caps_copy (gst_pad_get_pad_template_caps (mux->srcpad));
504 clear_caps (othercaps, FALSE);
506 g_value_init (&v, GST_TYPE_CAPS);
508 iter = gst_element_iterate_sink_pads (GST_ELEMENT (mux));
510 gst_value_set_caps (&v, othercaps);
511 res = gst_iterator_fold (iter, same_clock_rate_fold, &v, pad);
512 } while (res == GST_ITERATOR_RESYNC);
513 gst_iterator_free (iter);
515 caps = (GstCaps *) gst_value_get_caps (&v);
517 if (res == GST_ITERATOR_ERROR) {
518 gst_caps_unref (caps);
519 caps = gst_caps_new_empty ();
523 gst_caps_unref (othercaps);
524 gst_object_unref (mux);
531 gst_rtp_mux_get_property (GObject * object,
532 guint prop_id, GValue * value, GParamSpec * pspec)
536 rtp_mux = GST_RTP_MUX (object);
539 case PROP_TIMESTAMP_OFFSET:
540 g_value_set_int (value, rtp_mux->ts_offset);
542 case PROP_SEQNUM_OFFSET:
543 g_value_set_int (value, rtp_mux->seqnum_offset);
546 GST_OBJECT_LOCK (rtp_mux);
547 g_value_set_uint (value, rtp_mux->seqnum);
548 GST_OBJECT_UNLOCK (rtp_mux);
551 g_value_set_uint (value, rtp_mux->ssrc);
554 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
560 gst_rtp_mux_set_property (GObject * object,
561 guint prop_id, const GValue * value, GParamSpec * pspec)
565 rtp_mux = GST_RTP_MUX (object);
568 case PROP_TIMESTAMP_OFFSET:
569 rtp_mux->ts_offset = g_value_get_int (value);
571 case PROP_SEQNUM_OFFSET:
572 rtp_mux->seqnum_offset = g_value_get_int (value);
575 rtp_mux->ssrc = g_value_get_uint (value);
578 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
584 gst_rtp_mux_ready_to_paused (GstRTPMux * rtp_mux)
586 GST_OBJECT_LOCK (rtp_mux);
588 if (rtp_mux->ssrc == -1)
589 rtp_mux->current_ssrc = g_random_int ();
591 rtp_mux->current_ssrc = rtp_mux->ssrc;
593 if (rtp_mux->seqnum_offset == -1)
594 rtp_mux->seqnum_base = g_random_int_range (0, G_MAXUINT16);
596 rtp_mux->seqnum_base = rtp_mux->seqnum_offset;
597 rtp_mux->seqnum = rtp_mux->seqnum_base;
599 if (rtp_mux->ts_offset == -1)
600 rtp_mux->ts_base = g_random_int ();
602 rtp_mux->ts_base = rtp_mux->ts_offset;
603 GST_DEBUG_OBJECT (rtp_mux, "set clock-base to %u", rtp_mux->ts_base);
605 GST_OBJECT_UNLOCK (rtp_mux);
608 static GstStateChangeReturn
609 gst_rtp_mux_change_state (GstElement * element, GstStateChange transition)
613 rtp_mux = GST_RTP_MUX (element);
615 switch (transition) {
616 case GST_STATE_CHANGE_NULL_TO_READY:
618 case GST_STATE_CHANGE_READY_TO_PAUSED:
619 gst_rtp_mux_ready_to_paused (rtp_mux);
621 case GST_STATE_CHANGE_PAUSED_TO_READY:
627 return GST_ELEMENT_CLASS (parent_class)->change_state (element, transition);
631 gst_rtp_mux_plugin_init (GstPlugin * plugin)
633 GST_DEBUG_CATEGORY_INIT (gst_rtp_mux_debug, "rtpmux", 0, "rtp muxer");
635 return gst_element_register (plugin, "rtpmux", GST_RANK_NONE,