gstrtpbvpay.c 6.68 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
/* GStreamer
 * Copyright (C) <2009> Wim Taymans <wim.taymans@gmail.com>
 *
 * 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
 * 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
 */

20 21 22 23 24 25 26 27 28 29
/**
 * SECTION:element-rtpbvpay
 * @see_also: rtpbvdepay
 *
 * Payload BroadcomVoice audio into RTP packets according to RFC 4298.
 * For detailed information see: http://www.rfc-editor.org/rfc/rfc4298.txt
 *
 * Last reviewed on 2013-04-25 (1.1.0)
 */

30 31 32 33 34 35 36 37 38 39 40 41 42
#ifdef HAVE_CONFIG_H
#  include "config.h"
#endif

#include <stdlib.h>
#include <string.h>

#include <gst/rtp/gstrtpbuffer.h>
#include "gstrtpbvpay.h"

GST_DEBUG_CATEGORY_STATIC (rtpbvpay_debug);
#define GST_CAT_DEFAULT (rtpbvpay_debug)

43
static GstStaticPadTemplate gst_rtp_bv_pay_sink_template =
44 45 46 47 48 49
GST_STATIC_PAD_TEMPLATE ("sink",
    GST_PAD_SINK,
    GST_PAD_ALWAYS,
    GST_STATIC_CAPS ("audio/x-bv, " "mode = (int) {16, 32}")
    );

50
static GstStaticPadTemplate gst_rtp_bv_pay_src_template =
51 52 53 54 55 56 57 58 59 60 61 62 63 64 65
    GST_STATIC_PAD_TEMPLATE ("src",
    GST_PAD_SRC,
    GST_PAD_ALWAYS,
    GST_STATIC_CAPS ("application/x-rtp, "
        "media = (string) \"audio\", "
        "payload = (int) " GST_RTP_PAYLOAD_DYNAMIC_STRING ", "
        "clock-rate = (int) 8000, "
        "encoding-name = (string) \"BV16\";"
        "application/x-rtp, "
        "media = (string) \"audio\", "
        "payload = (int) " GST_RTP_PAYLOAD_DYNAMIC_STRING ", "
        "clock-rate = (int) 16000, " "encoding-name = (string) \"BV32\"")
    );


Wim Taymans's avatar
Wim Taymans committed
66
static GstCaps *gst_rtp_bv_pay_sink_getcaps (GstRTPBasePayload * payload,
67
    GstPad * pad, GstCaps * filter);
Wim Taymans's avatar
Wim Taymans committed
68
static gboolean gst_rtp_bv_pay_sink_setcaps (GstRTPBasePayload * payload,
69 70
    GstCaps * caps);

71
#define gst_rtp_bv_pay_parent_class parent_class
Wim Taymans's avatar
Wim Taymans committed
72
G_DEFINE_TYPE (GstRTPBVPay, gst_rtp_bv_pay, GST_TYPE_RTP_BASE_AUDIO_PAYLOAD);
73 74

static void
75
gst_rtp_bv_pay_class_init (GstRTPBVPayClass * klass)
76
{
77
  GstElementClass *gstelement_class;
Wim Taymans's avatar
Wim Taymans committed
78
  GstRTPBasePayloadClass *gstrtpbasepayload_class;
79 80 81

  GST_DEBUG_CATEGORY_INIT (rtpbvpay_debug, "rtpbvpay", 0,
      "BroadcomVoice audio RTP payloader");
82

83
  gstelement_class = (GstElementClass *) klass;
Wim Taymans's avatar
Wim Taymans committed
84
  gstrtpbasepayload_class = (GstRTPBasePayloadClass *) klass;
85 86

  gst_element_class_add_pad_template (gstelement_class,
87
      gst_static_pad_template_get (&gst_rtp_bv_pay_sink_template));
88
  gst_element_class_add_pad_template (gstelement_class,
89
      gst_static_pad_template_get (&gst_rtp_bv_pay_src_template));
90

91
  gst_element_class_set_static_metadata (gstelement_class, "RTP BV Payloader",
Wim Taymans's avatar
Wim Taymans committed
92
      "Codec/Payloader/Network/RTP",
93 94
      "Packetize BroadcomVoice audio streams into RTP packets (RFC 4298)",
      "Wim Taymans <wim.taymans@collabora.co.uk>");
95

Wim Taymans's avatar
Wim Taymans committed
96 97
  gstrtpbasepayload_class->set_caps = gst_rtp_bv_pay_sink_setcaps;
  gstrtpbasepayload_class->get_caps = gst_rtp_bv_pay_sink_getcaps;
98 99 100
}

static void
101
gst_rtp_bv_pay_init (GstRTPBVPay * rtpbvpay)
102
{
Wim Taymans's avatar
Wim Taymans committed
103
  GstRTPBaseAudioPayload *rtpbaseaudiopayload;
104

Wim Taymans's avatar
Wim Taymans committed
105
  rtpbaseaudiopayload = GST_RTP_BASE_AUDIO_PAYLOAD (rtpbvpay);
106 107 108

  rtpbvpay->mode = -1;

Wim Taymans's avatar
Wim Taymans committed
109 110
  /* tell rtpbaseaudiopayload that this is a frame based codec */
  gst_rtp_base_audio_payload_set_frame_based (rtpbaseaudiopayload);
111 112 113
}

static gboolean
Wim Taymans's avatar
Wim Taymans committed
114
gst_rtp_bv_pay_sink_setcaps (GstRTPBasePayload * rtpbasepayload, GstCaps * caps)
115 116
{
  GstRTPBVPay *rtpbvpay;
Wim Taymans's avatar
Wim Taymans committed
117
  GstRTPBaseAudioPayload *rtpbaseaudiopayload;
118 119 120 121
  gint mode;
  GstStructure *structure;
  const char *payload_name;

Wim Taymans's avatar
Wim Taymans committed
122 123
  rtpbvpay = GST_RTP_BV_PAY (rtpbasepayload);
  rtpbaseaudiopayload = GST_RTP_BASE_AUDIO_PAYLOAD (rtpbasepayload);
124 125 126 127 128 129 130 131 132 133 134 135 136 137

  structure = gst_caps_get_structure (caps, 0);

  payload_name = gst_structure_get_name (structure);
  if (g_ascii_strcasecmp ("audio/x-bv", payload_name))
    goto wrong_caps;

  if (!gst_structure_get_int (structure, "mode", &mode))
    goto no_mode;

  if (mode != 16 && mode != 32)
    goto wrong_mode;

  if (mode == 16) {
Wim Taymans's avatar
Wim Taymans committed
138
    gst_rtp_base_payload_set_options (rtpbasepayload, "audio", TRUE, "BV16",
139
        8000);
Wim Taymans's avatar
Wim Taymans committed
140
    rtpbasepayload->clock_rate = 8000;
141
  } else {
Wim Taymans's avatar
Wim Taymans committed
142
    gst_rtp_base_payload_set_options (rtpbasepayload, "audio", TRUE, "BV32",
143
        16000);
Wim Taymans's avatar
Wim Taymans committed
144
    rtpbasepayload->clock_rate = 16000;
145 146 147
  }

  /* set options for this frame based audio codec */
Wim Taymans's avatar
Wim Taymans committed
148
  gst_rtp_base_audio_payload_set_frame_options (rtpbaseaudiopayload,
149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185
      mode, mode == 16 ? 10 : 20);

  if (mode != rtpbvpay->mode && rtpbvpay->mode != -1)
    goto mode_changed;

  rtpbvpay->mode = mode;

  return TRUE;

  /* ERRORS */
wrong_caps:
  {
    GST_ERROR_OBJECT (rtpbvpay, "expected audio/x-bv, received %s",
        payload_name);
    return FALSE;
  }
no_mode:
  {
    GST_ERROR_OBJECT (rtpbvpay, "did not receive a mode");
    return FALSE;
  }
wrong_mode:
  {
    GST_ERROR_OBJECT (rtpbvpay, "mode must be 16 or 32, received %d", mode);
    return FALSE;
  }
mode_changed:
  {
    GST_ERROR_OBJECT (rtpbvpay, "Mode has changed from %d to %d! "
        "Mode cannot change while streaming", rtpbvpay->mode, mode);
    return FALSE;
  }
}

/* we return the padtemplate caps with the mode field fixated to a value if we
 * can */
static GstCaps *
Wim Taymans's avatar
Wim Taymans committed
186
gst_rtp_bv_pay_sink_getcaps (GstRTPBasePayload * rtppayload, GstPad * pad,
187
    GstCaps * filter)
188 189 190 191
{
  GstCaps *otherpadcaps;
  GstCaps *caps;

Wim Taymans's avatar
Wim Taymans committed
192
  caps = gst_pad_get_pad_template_caps (pad);
193

Wim Taymans's avatar
Wim Taymans committed
194
  otherpadcaps = gst_pad_get_allowed_caps (rtppayload->srcpad);
195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213
  if (otherpadcaps) {
    if (!gst_caps_is_empty (otherpadcaps)) {
      GstStructure *structure;
      const gchar *mode_str;
      gint mode;

      structure = gst_caps_get_structure (otherpadcaps, 0);

      /* construct mode, if we can */
      mode_str = gst_structure_get_string (structure, "encoding-name");
      if (mode_str) {
        if (!strcmp (mode_str, "BV16"))
          mode = 16;
        else if (!strcmp (mode_str, "BV32"))
          mode = 32;
        else
          mode = -1;

        if (mode == 16 || mode == 32) {
Wim Taymans's avatar
Wim Taymans committed
214
          caps = gst_caps_make_writable (caps);
215 216 217 218 219 220 221 222 223 224 225 226 227 228
          structure = gst_caps_get_structure (caps, 0);
          gst_structure_set (structure, "mode", G_TYPE_INT, mode, NULL);
        }
      }
    }
    gst_caps_unref (otherpadcaps);
  }
  return caps;
}

gboolean
gst_rtp_bv_pay_plugin_init (GstPlugin * plugin)
{
  return gst_element_register (plugin, "rtpbvpay",
229
      GST_RANK_SECONDARY, GST_TYPE_RTP_BV_PAY);
230
}