1 /* RTP DTMF muxer element for GStreamer
5 * Copyright (C) <2007-2010> Nokia Corporation.
6 * Contact: Zeeshan Ali <zeeshan.ali@nokia.com>
7 * Copyright (C) <2007-2010> Collabora Ltd
8 * Contact: Olivier Crete <olivier.crete@collabora.co.uk>
9 * Copyright (C) 1999,2000 Erik Walthinsen <omega@cse.ogi.edu>
10 * 2000,2005 Wim Taymans <wim@fluendo.com>
12 * This library is free software; you can redistribute it and/or
13 * modify it under the terms of the GNU Library General Public
14 * License as published by the Free Software Foundation; either
15 * version 2 of the License, or (at your option) any later version.
17 * This library is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
20 * Library General Public License for more details.
22 * You should have received a copy of the GNU Library General Public
23 * License along with this library; if not, write to the
24 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
25 * Boston, MA 02111-1307, USA.
29 * SECTION:element-rtpdtmfmux
30 * @see_also: rtpdtmfsrc, dtmfsrc, rtpmux
32 * The RTP "DTMF" Muxer muxes multiple RTP streams into a valid RTP
33 * stream. It does exactly what it's parent (#rtpmux) does, except
34 * that it prevent buffers coming over a regular sink_%%d pad from going through
35 * for the duration of buffers that came in a priority_sink_%%d pad.
45 #include "gstrtpdtmfmux.h"
47 GST_DEBUG_CATEGORY_STATIC (gst_rtp_dtmf_mux_debug);
48 #define GST_CAT_DEFAULT gst_rtp_dtmf_mux_debug
56 static GstStaticPadTemplate priority_sink_factory =
57 GST_STATIC_PAD_TEMPLATE ("priority_sink_%d",
60 GST_STATIC_CAPS ("application/x-rtp"));
62 // static guint gst_rtpdtmfmux_signals[LAST_SIGNAL] = { 0 };
64 static GstPad *gst_rtp_dtmf_mux_request_new_pad (GstElement * element,
65 GstPadTemplate * templ, const gchar * name);
66 static GstStateChangeReturn gst_rtp_dtmf_mux_change_state (GstElement * element,
67 GstStateChange transition);
69 static GstFlowReturn gst_rtp_dtmf_mux_chain (GstPad * pad, GstBuffer * buffer);
71 GST_BOILERPLATE (GstRTPDTMFMux, gst_rtp_dtmf_mux, GstRTPMux, GST_TYPE_RTP_MUX);
74 gst_rtp_dtmf_mux_init (GstRTPDTMFMux * object, GstRTPDTMFMuxClass * g_class)
79 gst_rtp_dtmf_mux_base_init (gpointer g_class)
81 GstElementClass *element_class = GST_ELEMENT_CLASS (g_class);
83 gst_element_class_add_pad_template (element_class,
84 gst_static_pad_template_get (&priority_sink_factory));
86 gst_element_class_set_details_simple (element_class, "RTP muxer",
88 "mixes RTP DTMF streams into other RTP streams",
89 "Zeeshan Ali <first.last@nokia.com>");
93 gst_rtp_dtmf_mux_class_init (GstRTPDTMFMuxClass * klass)
95 GObjectClass *gobject_class;
96 GstElementClass *gstelement_class;
97 GstRTPMuxClass *gstrtpmux_class;
99 gobject_class = (GObjectClass *) klass;
100 gstelement_class = (GstElementClass *) klass;
101 gstrtpmux_class = (GstRTPMuxClass *) klass;
103 gstelement_class->request_new_pad =
104 GST_DEBUG_FUNCPTR (gst_rtp_dtmf_mux_request_new_pad);
105 gstelement_class->change_state =
106 GST_DEBUG_FUNCPTR (gst_rtp_dtmf_mux_change_state);
107 gstrtpmux_class->chain_func = GST_DEBUG_FUNCPTR (gst_rtp_dtmf_mux_chain);
111 gst_rtp_dtmf_mux_chain (GstPad * pad, GstBuffer * buffer)
114 GstFlowReturn ret = GST_FLOW_ERROR;
115 GstRTPMuxPadPrivate *padpriv = NULL;
116 GstClockTime running_ts;
118 mux = GST_RTP_DTMF_MUX (gst_pad_get_parent (pad));
120 running_ts = GST_BUFFER_TIMESTAMP (buffer);
122 GST_OBJECT_LOCK (mux);
123 if (GST_CLOCK_TIME_IS_VALID (running_ts)) {
124 padpriv = gst_pad_get_element_private (pad);
125 if (padpriv && padpriv->segment.format == GST_FORMAT_TIME)
126 running_ts = gst_segment_to_running_time (&padpriv->segment,
127 GST_FORMAT_TIME, GST_BUFFER_TIMESTAMP (buffer));
129 if (padpriv && padpriv->priority) {
130 if (GST_BUFFER_DURATION_IS_VALID (buffer)) {
131 if (GST_CLOCK_TIME_IS_VALID (mux->last_priority_end))
132 mux->last_priority_end =
133 MAX (running_ts + GST_BUFFER_DURATION (buffer),
134 mux->last_priority_end);
136 mux->last_priority_end = running_ts + GST_BUFFER_DURATION (buffer);
137 GST_LOG_OBJECT (mux, "Got buffer %p on priority pad %s,"
138 " blocking regular pads until %" GST_TIME_FORMAT, buffer,
139 GST_PAD_NAME (pad), GST_TIME_ARGS (mux->last_priority_end));
141 GST_WARNING_OBJECT (mux, "Buffer %p on pad %s has an invalid duration,"
142 " not blocking other pad", buffer, GST_PAD_NAME (pad));
145 if (GST_CLOCK_TIME_IS_VALID (mux->last_priority_end) &&
146 running_ts < mux->last_priority_end) {
147 GST_LOG_OBJECT (mux, "Dropping buffer %p because running time"
148 " %" GST_TIME_FORMAT " < %" GST_TIME_FORMAT, buffer,
149 GST_TIME_ARGS (running_ts), GST_TIME_ARGS (mux->last_priority_end));
154 GST_LOG_OBJECT (mux, "Buffer %p on pad %s has an invalid timestamp,"
155 " letting through", GST_PAD_NAME (pad));
157 GST_OBJECT_UNLOCK (mux);
159 if (parent_class->chain_func)
160 ret = parent_class->chain_func (pad, buffer);
162 gst_buffer_unref (buffer);
166 gst_object_unref (mux);
170 gst_buffer_unref (buffer);
172 GST_OBJECT_UNLOCK (mux);
178 gst_rtp_dtmf_mux_request_new_pad (GstElement * element, GstPadTemplate * templ,
183 pad = GST_CALL_PARENT_WITH_DEFAULT (GST_ELEMENT_CLASS, request_new_pad,
184 (element, templ, name), NULL);
187 GstRTPMuxPadPrivate *padpriv;
189 GST_OBJECT_LOCK (element);
190 padpriv = gst_pad_get_element_private (pad);
192 if (gst_element_class_get_pad_template (GST_ELEMENT_GET_CLASS (element),
193 "priority_sink_%d") == gst_pad_get_pad_template (pad))
194 padpriv->priority = TRUE;
195 GST_OBJECT_UNLOCK (element);
202 static GstStateChangeReturn
203 gst_rtp_dtmf_mux_change_state (GstElement * element, GstStateChange transition)
205 GstStateChangeReturn ret;
206 GstRTPDTMFMux *mux = GST_RTP_DTMF_MUX (element);
208 switch (transition) {
209 case GST_STATE_CHANGE_READY_TO_PAUSED:
211 GST_OBJECT_LOCK (mux);
212 mux->last_priority_end = GST_CLOCK_TIME_NONE;
213 GST_OBJECT_UNLOCK (mux);
220 ret = GST_ELEMENT_CLASS (parent_class)->change_state (element, transition);
226 gst_rtp_dtmf_mux_plugin_init (GstPlugin * plugin)
228 GST_DEBUG_CATEGORY_INIT (gst_rtp_dtmf_mux_debug, "rtpdtmfmux", 0,
231 return gst_element_register (plugin, "rtpdtmfmux", GST_RANK_NONE,
232 GST_TYPE_RTP_DTMF_MUX);