gst/rtp/gstrtpbvpay.c

   1 /* GStreamer
   2  * Copyright (C) <2009> Wim Taymans <wim.taymans@gmail.com>
   3  *
   4  * This library is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Library General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2 of the License, or (at your option) any later version.
   8  *
   9  * This library is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * Library General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Library General Public
  15  * License along with this library; if not, write to the
  16  * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
  17  * Boston, MA 02110-1301, USA.
  18  */
  19
  20 /**
  21  * SECTION:element-rtpbvpay
  22  * @see_also: rtpbvdepay
  23  *
  24  * Payload BroadcomVoice audio into RTP packets according to RFC 4298.
  25  * For detailed information see: http://www.rfc-editor.org/rfc/rfc4298.txt
  26  *
  27  * Last reviewed on 2013-04-25 (1.1.0)
  28  */
  29
  30 #ifdef HAVE_CONFIG_H
  31 #  include "config.h"
  32 #endif
  33
  34 #include <stdlib.h>
  35 #include <string.h>
  36
  37 #include <gst/rtp/gstrtpbuffer.h>
  38 #include "gstrtpbvpay.h"
  39
  40 GST_DEBUG_CATEGORY_STATIC (rtpbvpay_debug);
  41 #define GST_CAT_DEFAULT (rtpbvpay_debug)
  42
  43 static GstStaticPadTemplate gst_rtp_bv_pay_sink_template =
  44 GST_STATIC_PAD_TEMPLATE ("sink",
  45     GST_PAD_SINK,
  46     GST_PAD_ALWAYS,
  47     GST_STATIC_CAPS ("audio/x-bv, " "mode = (int) {16, 32}")
  48     );
  49
  50 static GstStaticPadTemplate gst_rtp_bv_pay_src_template =
  51     GST_STATIC_PAD_TEMPLATE ("src",
  52     GST_PAD_SRC,
  53     GST_PAD_ALWAYS,
  54     GST_STATIC_CAPS ("application/x-rtp, "
  55         "media = (string) \"audio\", "
  56         "payload = (int) " GST_RTP_PAYLOAD_DYNAMIC_STRING ", "
  57         "clock-rate = (int) 8000, "
  58         "encoding-name = (string) \"BV16\";"
  59         "application/x-rtp, "
  60         "media = (string) \"audio\", "
  61         "payload = (int) " GST_RTP_PAYLOAD_DYNAMIC_STRING ", "
  62         "clock-rate = (int) 16000, " "encoding-name = (string) \"BV32\"")
  63     );
  64
  65
  66 static GstCaps *gst_rtp_bv_pay_sink_getcaps (GstRTPBasePayload * payload,
  67     GstPad * pad, GstCaps * filter);
  68 static gboolean gst_rtp_bv_pay_sink_setcaps (GstRTPBasePayload * payload,
  69     GstCaps * caps);
  70
  71 #define gst_rtp_bv_pay_parent_class parent_class
  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;
  78   GstRTPBasePayloadClass *gstrtpbasepayload_class;
  79
  80   GST_DEBUG_CATEGORY_INIT (rtpbvpay_debug, "rtpbvpay", 0,
  81       "BroadcomVoice audio RTP payloader");
  82
  83   gstelement_class = (GstElementClass *) klass;
  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",
  92       "Codec/Payloader/Network/RTP",
  93       "Packetize BroadcomVoice audio streams into RTP packets (RFC 4298)",
  94       "Wim Taymans <wim.taymans@collabora.co.uk>");
  95
  96   gstrtpbasepayload_class->set_caps = gst_rtp_bv_pay_sink_setcaps;
  97   gstrtpbasepayload_class->get_caps = gst_rtp_bv_pay_sink_getcaps;
  98 }
  99
 100 static void
 101 gst_rtp_bv_pay_init (GstRTPBVPay * rtpbvpay)
 102 {
 103   GstRTPBaseAudioPayload *rtpbaseaudiopayload;
 104
 105   rtpbaseaudiopayload = GST_RTP_BASE_AUDIO_PAYLOAD (rtpbvpay);
 106
 107   rtpbvpay->mode = -1;
 108
 109   /* tell rtpbaseaudiopayload that this is a frame based codec */
 110   gst_rtp_base_audio_payload_set_frame_based (rtpbaseaudiopayload);
 111 }
 112
 113 static gboolean
 114 gst_rtp_bv_pay_sink_setcaps (GstRTPBasePayload * rtpbasepayload, GstCaps * caps)
 115 {
 116   GstRTPBVPay *rtpbvpay;
 117   GstRTPBaseAudioPayload *rtpbaseaudiopayload;
 118   gint mode;
 119   GstStructure *structure;
 120   const char *payload_name;
 121
 122   rtpbvpay = GST_RTP_BV_PAY (rtpbasepayload);
 123   rtpbaseaudiopayload = GST_RTP_BASE_AUDIO_PAYLOAD (rtpbasepayload);
 124
 125   structure = gst_caps_get_structure (caps, 0);
 126
 127   payload_name = gst_structure_get_name (structure);
 128   if (g_ascii_strcasecmp ("audio/x-bv", payload_name))
 129     goto wrong_caps;
 130
 131   if (!gst_structure_get_int (structure, "mode", &mode))
 132     goto no_mode;
 133
 134   if (mode != 16 && mode != 32)
 135     goto wrong_mode;
 136
 137   if (mode == 16) {
 138     gst_rtp_base_payload_set_options (rtpbasepayload, "audio", TRUE, "BV16",
 139         8000);
 140     rtpbasepayload->clock_rate = 8000;
 141   } else {
 142     gst_rtp_base_payload_set_options (rtpbasepayload, "audio", TRUE, "BV32",
 143         16000);
 144     rtpbasepayload->clock_rate = 16000;
 145   }
 146
 147   /* set options for this frame based audio codec */
 148   gst_rtp_base_audio_payload_set_frame_options (rtpbaseaudiopayload,
 149       mode, mode == 16 ? 10 : 20);
 150
 151   if (mode != rtpbvpay->mode && rtpbvpay->mode != -1)
 152     goto mode_changed;
 153
 154   rtpbvpay->mode = mode;
 155
 156   return TRUE;
 157
 158   /* ERRORS */
 159 wrong_caps:
 160   {
 161     GST_ERROR_OBJECT (rtpbvpay, "expected audio/x-bv, received %s",
 162         payload_name);
 163     return FALSE;
 164   }
 165 no_mode:
 166   {
 167     GST_ERROR_OBJECT (rtpbvpay, "did not receive a mode");
 168     return FALSE;
 169   }
 170 wrong_mode:
 171   {
 172     GST_ERROR_OBJECT (rtpbvpay, "mode must be 16 or 32, received %d", mode);
 173     return FALSE;
 174   }
 175 mode_changed:
 176   {
 177     GST_ERROR_OBJECT (rtpbvpay, "Mode has changed from %d to %d! "
 178         "Mode cannot change while streaming", rtpbvpay->mode, mode);
 179     return FALSE;
 180   }
 181 }
 182
 183 /* we return the padtemplate caps with the mode field fixated to a value if we
 184  * can */
 185 static GstCaps *
 186 gst_rtp_bv_pay_sink_getcaps (GstRTPBasePayload * rtppayload, GstPad * pad,
 187     GstCaps * filter)
 188 {
 189   GstCaps *otherpadcaps;
 190   GstCaps *caps;
 191
 192   caps = gst_pad_get_pad_template_caps (pad);
 193
 194   otherpadcaps = gst_pad_get_allowed_caps (rtppayload->srcpad);
 195   if (otherpadcaps) {
 196     if (!gst_caps_is_empty (otherpadcaps)) {
 197       GstStructure *structure;
 198       const gchar *mode_str;
 199       gint mode;
 200
 201       structure = gst_caps_get_structure (otherpadcaps, 0);
 202
 203       /* construct mode, if we can */
 204       mode_str = gst_structure_get_string (structure, "encoding-name");
 205       if (mode_str) {
 206         if (!strcmp (mode_str, "BV16"))
 207           mode = 16;
 208         else if (!strcmp (mode_str, "BV32"))
 209           mode = 32;
 210         else
 211           mode = -1;
 212
 213         if (mode == 16 || mode == 32) {
 214           caps = gst_caps_make_writable (caps);
 215           structure = gst_caps_get_structure (caps, 0);
 216           gst_structure_set (structure, "mode", G_TYPE_INT, mode, NULL);
 217         }
 218       }
 219     }
 220     gst_caps_unref (otherpadcaps);
 221   }
 222   return caps;
 223 }
 224
 225 gboolean
 226 gst_rtp_bv_pay_plugin_init (GstPlugin * plugin)
 227 {
 228   return gst_element_register (plugin, "rtpbvpay",
 229       GST_RANK_SECONDARY, GST_TYPE_RTP_BV_PAY);
 230 }