gstrtpL16depay.c 8.41 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 30 31 32 33 34 35
/**
 * 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>
 * |[
 * gst-launch 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
 * ]| 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 48 49

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

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

61 62
static GstStaticPadTemplate gst_rtp_L16_depay_sink_template =
    GST_STATIC_PAD_TEMPLATE ("sink",
David Schleef's avatar
David Schleef committed
63 64
    GST_PAD_SINK,
    GST_PAD_ALWAYS,
65
    GST_STATIC_CAPS ("application/x-rtp, "
66
        "media = (string) \"audio\", " "clock-rate = (int) [ 1, MAX ], "
67 68 69 70 71 72 73 74 75 76 77 78
        /* "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
79
    );
80

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

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

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

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

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

Mark Nauwelaerts's avatar
Mark Nauwelaerts committed
101 102 103 104 105
  gst_element_class_add_pad_template (gstelement_class,
      gst_static_pad_template_get (&gst_rtp_L16_depay_src_template));
  gst_element_class_add_pad_template (gstelement_class,
      gst_static_pad_template_get (&gst_rtp_L16_depay_sink_template));

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

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

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

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

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

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

  return def;
134 135
}

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

149
  rtpL16depay = GST_RTP_L16_DEPAY (depayload);
150

151
  structure = gst_caps_get_structure (caps, 0);
152

153 154 155 156 157 158
  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
159
      break;
160 161 162
    case GST_RTP_PAYLOAD_L16_MONO:
      channels = 1;
      clock_rate = 44100;
Thomas Vander Stichele's avatar
Thomas Vander Stichele committed
163 164
      break;
    default:
Wim Taymans's avatar
Wim Taymans committed
165
      /* no fixed mapping, we need clock-rate */
166 167 168
      channels = 0;
      clock_rate = 0;
      break;
169 170
  }

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

177 178 179 180 181
  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
182 183
      /* channels defaults to 1 otherwise */
      channels = 1;
184 185
    }
  }
186 187 188

  depayload->clock_rate = clock_rate;

189 190 191 192 193 194
  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;
195

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

  order = gst_rtp_channels_get_by_order (channels, channel_order);
200
  rtpL16depay->order = order;
201
  if (order) {
202 203 204
    memcpy (info->position, order->pos,
        sizeof (GstAudioChannelPosition) * channels);
    gst_audio_channel_positions_to_valid_order (info->position, info->channels);
205 206 207 208 209
  } 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 */
210
    gst_rtp_channels_create_default (channels, info->position);
211 212
  }

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

217 218 219 220 221 222 223 224
  return res;

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

227
static GstBuffer *
Wim Taymans's avatar
Wim Taymans committed
228
gst_rtp_L16_depay_process (GstRTPBaseDepayload * depayload, GstBuffer * buf)
229
{
230
  GstRtpL16Depay *rtpL16depay;
231
  GstBuffer *outbuf;
232 233
  gint payload_len;
  gboolean marker;
234
  GstRTPBuffer rtp = { NULL };
235

236
  rtpL16depay = GST_RTP_L16_DEPAY (depayload);
237

Mark Nauwelaerts's avatar
Mark Nauwelaerts committed
238 239
  gst_rtp_buffer_map (buf, GST_MAP_READ, &rtp);
  payload_len = gst_rtp_buffer_get_payload_len (&rtp);
Thomas Vander Stichele's avatar
Thomas Vander Stichele committed
240

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

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

Mark Nauwelaerts's avatar
Mark Nauwelaerts committed
246 247
  outbuf = gst_rtp_buffer_get_payload_buffer (&rtp);
  marker = gst_rtp_buffer_get_marker (&rtp);
248

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

254 255 256 257 258 259 260 261
  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;
  }

Mark Nauwelaerts's avatar
Mark Nauwelaerts committed
262 263
  gst_rtp_buffer_unmap (&rtp);

264 265 266
  return outbuf;

  /* ERRORS */
267 268 269 270
empty_packet:
  {
    GST_ELEMENT_WARNING (rtpL16depay, STREAM, DECODE,
        ("Empty Payload."), (NULL));
Mark Nauwelaerts's avatar
Mark Nauwelaerts committed
271
    gst_rtp_buffer_unmap (&rtp);
272 273
    return NULL;
  }
274 275 276 277 278 279 280
reorder_failed:
  {
    GST_ELEMENT_ERROR (rtpL16depay, STREAM, DECODE,
        ("Channel reordering failed."), (NULL));
    gst_rtp_buffer_unmap (&rtp);
    return NULL;
  }
281 282 283
}

gboolean
284
gst_rtp_L16_depay_plugin_init (GstPlugin * plugin)
285
{
286
  return gst_element_register (plugin, "rtpL16depay",
287
      GST_RANK_SECONDARY, GST_TYPE_RTP_L16_DEPAY);
288
}