gstrtpL16depay.c 8.29 KB
Newer Older
1
/* GStreamer
2
 * Copyright (C) <2007> Wim Taymans <wim.taymans@gmail.com>
3 4 5 6 7 8 9 10 11
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12 13 14 15
 * Library General Public License for more details.
 *
 * You should have received a copy of the GNU Library General Public
 * License along with this library; if not, write to the
Tim-Philipp Müller's avatar
Tim-Philipp Müller committed
16 17
 * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
 * Boston, MA 02110-1301, USA.
18 19
 */

Wim Taymans's avatar
Wim Taymans committed
20 21 22 23 24 25 26 27 28 29
/**
 * SECTION:element-rtpL16depay
 * @see_also: rtpL16pay
 *
 * Extract raw audio from RTP packets according to RFC 3551.
 * For detailed information see: http://www.rfc-editor.org/rfc/rfc3551.txt
 *
 * <refsect2>
 * <title>Example pipeline</title>
 * |[
30
 * gst-launch-1.0 udpsrc caps='application/x-rtp, media=(string)audio, clock-rate=(int)44100, encoding-name=(string)L16, encoding-params=(string)1, channels=(int)1, payload=(int)96' ! rtpL16depay ! pulsesink
Wim Taymans's avatar
Wim Taymans committed
31 32 33 34 35
 * ]| This example pipeline will depayload an RTP raw audio stream. Refer to
 * the rtpL16pay example to create the RTP stream.
 * </refsect2>
 */

36 37 38
#ifdef HAVE_CONFIG_H
#include "config.h"
#endif
39

40
#include <string.h>
41
#include <stdlib.h>
42

43 44
#include <gst/audio/audio.h>

45
#include "gstrtpL16depay.h"
46
#include "gstrtpchannels.h"
47
#include "gstrtputils.h"
48 49 50

GST_DEBUG_CATEGORY_STATIC (rtpL16depay_debug);
#define GST_CAT_DEFAULT (rtpL16depay_debug)
51

52
static GstStaticPadTemplate gst_rtp_L16_depay_src_template =
Thomas Vander Stichele's avatar
Thomas Vander Stichele committed
53
GST_STATIC_PAD_TEMPLATE ("src",
David Schleef's avatar
David Schleef committed
54 55
    GST_PAD_SRC,
    GST_PAD_ALWAYS,
56
    GST_STATIC_CAPS ("audio/x-raw, "
57
        "format = (string) S16BE, "
58
        "layout = (string) interleaved, "
59
        "rate = (int) [ 1, MAX ], " "channels = (int) [ 1, MAX ]")
Thomas Vander Stichele's avatar
Thomas Vander Stichele committed
60
    );
David Schleef's avatar
David Schleef committed
61

62 63
static GstStaticPadTemplate gst_rtp_L16_depay_sink_template =
    GST_STATIC_PAD_TEMPLATE ("sink",
David Schleef's avatar
David Schleef committed
64 65
    GST_PAD_SINK,
    GST_PAD_ALWAYS,
66
    GST_STATIC_CAPS ("application/x-rtp, "
67
        "media = (string) \"audio\", " "clock-rate = (int) [ 1, MAX ], "
68 69 70 71 72 73 74 75 76 77 78 79
        /* "channels = (int) [1, MAX]"  */
        /* "emphasis = (string) ANY" */
        /* "channel-order = (string) ANY" */
        "encoding-name = (string) \"L16\";"
        "application/x-rtp, "
        "media = (string) \"audio\", "
        "payload = (int) { " GST_RTP_PAYLOAD_L16_STEREO_STRING ", "
        GST_RTP_PAYLOAD_L16_MONO_STRING " }," "clock-rate = (int) [ 1, MAX ]"
        /* "channels = (int) [1, MAX]" */
        /* "emphasis = (string) ANY" */
        /* "channel-order = (string) ANY" */
    )
Thomas Vander Stichele's avatar
Thomas Vander Stichele committed
80
    );
81

Mark Nauwelaerts's avatar
Mark Nauwelaerts committed
82
#define gst_rtp_L16_depay_parent_class parent_class
Wim Taymans's avatar
Wim Taymans committed
83
G_DEFINE_TYPE (GstRtpL16Depay, gst_rtp_L16_depay, GST_TYPE_RTP_BASE_DEPAYLOAD);
84

Wim Taymans's avatar
Wim Taymans committed
85
static gboolean gst_rtp_L16_depay_setcaps (GstRTPBaseDepayload * depayload,
86
    GstCaps * caps);
Wim Taymans's avatar
Wim Taymans committed
87
static GstBuffer *gst_rtp_L16_depay_process (GstRTPBaseDepayload * depayload,
88
    GstRTPBuffer * rtp);
89 90

static void
91
gst_rtp_L16_depay_class_init (GstRtpL16DepayClass * klass)
92
{
Mark Nauwelaerts's avatar
Mark Nauwelaerts committed
93
  GstElementClass *gstelement_class;
Wim Taymans's avatar
Wim Taymans committed
94
  GstRTPBaseDepayloadClass *gstrtpbasedepayload_class;
95

Mark Nauwelaerts's avatar
Mark Nauwelaerts committed
96
  gstelement_class = (GstElementClass *) klass;
Wim Taymans's avatar
Wim Taymans committed
97
  gstrtpbasedepayload_class = (GstRTPBaseDepayloadClass *) klass;
98

Wim Taymans's avatar
Wim Taymans committed
99
  gstrtpbasedepayload_class->set_caps = gst_rtp_L16_depay_setcaps;
100
  gstrtpbasedepayload_class->process_rtp_packet = gst_rtp_L16_depay_process;
101

102 103 104 105
  gst_element_class_add_static_pad_template (gstelement_class,
      &gst_rtp_L16_depay_src_template);
  gst_element_class_add_static_pad_template (gstelement_class,
      &gst_rtp_L16_depay_sink_template);
Mark Nauwelaerts's avatar
Mark Nauwelaerts committed
106

107
  gst_element_class_set_static_metadata (gstelement_class,
Mark Nauwelaerts's avatar
Mark Nauwelaerts committed
108 109 110 111
      "RTP audio depayloader", "Codec/Depayloader/Network/RTP",
      "Extracts raw audio from RTP packets",
      "Zeeshan Ali <zak147@yahoo.com>," "Wim Taymans <wim.taymans@gmail.com>");

112 113
  GST_DEBUG_CATEGORY_INIT (rtpL16depay_debug, "rtpL16depay", 0,
      "Raw Audio RTP Depayloader");
114 115 116
}

static void
Mark Nauwelaerts's avatar
Mark Nauwelaerts committed
117
gst_rtp_L16_depay_init (GstRtpL16Depay * rtpL16depay)
118 119 120
{
}

121 122 123
static gint
gst_rtp_L16_depay_parse_int (GstStructure * structure, const gchar * field,
    gint def)
124
{
125 126
  const gchar *str;
  gint res;
127

128 129
  if ((str = gst_structure_get_string (structure, field)))
    return atoi (str);
130

131 132 133 134
  if (gst_structure_get_int (structure, field, &res))
    return res;

  return def;
135 136
}

137
static gboolean
Wim Taymans's avatar
Wim Taymans committed
138
gst_rtp_L16_depay_setcaps (GstRTPBaseDepayload * depayload, GstCaps * caps)
139
{
140 141 142 143 144
  GstStructure *structure;
  GstRtpL16Depay *rtpL16depay;
  gint clock_rate, payload;
  gint channels;
  GstCaps *srccaps;
145
  gboolean res;
146 147
  const gchar *channel_order;
  const GstRTPChannelOrder *order;
148
  GstAudioInfo *info;
David Schleef's avatar
David Schleef committed
149

150
  rtpL16depay = GST_RTP_L16_DEPAY (depayload);
151

152
  structure = gst_caps_get_structure (caps, 0);
153

154 155 156 157 158 159
  payload = 96;
  gst_structure_get_int (structure, "payload", &payload);
  switch (payload) {
    case GST_RTP_PAYLOAD_L16_STEREO:
      channels = 2;
      clock_rate = 44100;
Thomas Vander Stichele's avatar
Thomas Vander Stichele committed
160
      break;
161 162 163
    case GST_RTP_PAYLOAD_L16_MONO:
      channels = 1;
      clock_rate = 44100;
Thomas Vander Stichele's avatar
Thomas Vander Stichele committed
164 165
      break;
    default:
Wim Taymans's avatar
Wim Taymans committed
166
      /* no fixed mapping, we need clock-rate */
167 168 169
      channels = 0;
      clock_rate = 0;
      break;
170 171
  }

172 173 174
  /* caps can overwrite defaults */
  clock_rate =
      gst_rtp_L16_depay_parse_int (structure, "clock-rate", clock_rate);
175 176 177
  if (clock_rate == 0)
    goto no_clockrate;

178 179 180 181 182
  channels =
      gst_rtp_L16_depay_parse_int (structure, "encoding-params", channels);
  if (channels == 0) {
    channels = gst_rtp_L16_depay_parse_int (structure, "channels", channels);
    if (channels == 0) {
Wim Taymans's avatar
Wim Taymans committed
183 184
      /* channels defaults to 1 otherwise */
      channels = 1;
185 186
    }
  }
187 188 189

  depayload->clock_rate = clock_rate;

190 191 192 193 194 195
  info = &rtpL16depay->info;
  gst_audio_info_init (info);
  info->finfo = gst_audio_format_get_info (GST_AUDIO_FORMAT_S16BE);
  info->rate = clock_rate;
  info->channels = channels;
  info->bpf = (info->finfo->width / 8) * channels;
196

197 198 199 200
  /* add channel positions */
  channel_order = gst_structure_get_string (structure, "channel-order");

  order = gst_rtp_channels_get_by_order (channels, channel_order);
201
  rtpL16depay->order = order;
202
  if (order) {
203 204 205
    memcpy (info->position, order->pos,
        sizeof (GstAudioChannelPosition) * channels);
    gst_audio_channel_positions_to_valid_order (info->position, info->channels);
206 207 208 209 210
  } else {
    GST_ELEMENT_WARNING (rtpL16depay, STREAM, DECODE,
        (NULL), ("Unknown channel order '%s' for %d channels",
            GST_STR_NULL (channel_order), channels));
    /* create default NONE layout */
211
    gst_rtp_channels_create_default (channels, info->position);
212 213
  }

214
  srccaps = gst_audio_info_to_caps (info);
215
  res = gst_pad_set_caps (depayload->srcpad, srccaps);
216 217
  gst_caps_unref (srccaps);

218 219 220 221 222 223 224 225
  return res;

  /* ERRORS */
no_clockrate:
  {
    GST_ERROR_OBJECT (depayload, "no clock-rate specified");
    return FALSE;
  }
226 227
}

228
static GstBuffer *
229
gst_rtp_L16_depay_process (GstRTPBaseDepayload * depayload, GstRTPBuffer * rtp)
230
{
231
  GstRtpL16Depay *rtpL16depay;
232
  GstBuffer *outbuf;
233 234
  gint payload_len;
  gboolean marker;
235

236
  rtpL16depay = GST_RTP_L16_DEPAY (depayload);
237

238
  payload_len = gst_rtp_buffer_get_payload_len (rtp);
Thomas Vander Stichele's avatar
Thomas Vander Stichele committed
239

240 241
  if (payload_len <= 0)
    goto empty_packet;
Thomas Vander Stichele's avatar
Thomas Vander Stichele committed
242

243
  GST_DEBUG_OBJECT (rtpL16depay, "got payload of %d bytes", payload_len);
244

245 246
  outbuf = gst_rtp_buffer_get_payload_buffer (rtp);
  marker = gst_rtp_buffer_get_marker (rtp);
247

248
  if (marker) {
249 250
    /* mark talk spurt with RESYNC */
    GST_BUFFER_FLAG_SET (outbuf, GST_BUFFER_FLAG_RESYNC);
251 252
  }

253 254 255 256 257 258 259 260
  outbuf = gst_buffer_make_writable (outbuf);
  if (rtpL16depay->order &&
      !gst_audio_buffer_reorder_channels (outbuf,
          rtpL16depay->info.finfo->format, rtpL16depay->info.channels,
          rtpL16depay->info.position, rtpL16depay->order->pos)) {
    goto reorder_failed;
  }

261
  gst_rtp_drop_non_audio_meta (rtpL16depay, outbuf);
262

263 264 265
  return outbuf;

  /* ERRORS */
266 267 268 269 270 271
empty_packet:
  {
    GST_ELEMENT_WARNING (rtpL16depay, STREAM, DECODE,
        ("Empty Payload."), (NULL));
    return NULL;
  }
272 273 274 275 276 277
reorder_failed:
  {
    GST_ELEMENT_ERROR (rtpL16depay, STREAM, DECODE,
        ("Channel reordering failed."), (NULL));
    return NULL;
  }
278 279 280
}

gboolean
281
gst_rtp_L16_depay_plugin_init (GstPlugin * plugin)
282
{
283
  return gst_element_register (plugin, "rtpL16depay",
284
      GST_RANK_SECONDARY, GST_TYPE_RTP_L16_DEPAY);
285
}