Blame gst-libs/gst/rtp/gstrtpmeta.c

Packit Service 4387a0
/* GStreamer
Packit Service 4387a0
 * Copyright (C) <2016> Stian Selnes <stian@pexip.com>
Packit Service 4387a0
 *
Packit Service 4387a0
 * This library is free software; you can redistribute it and/or
Packit Service 4387a0
 * modify it under the terms of the GNU Library General Public
Packit Service 4387a0
 * License as published by the Free Software Foundation; either
Packit Service 4387a0
 * version 2 of the License, or (at your option) any later version.
Packit Service 4387a0
 *
Packit Service 4387a0
 * This library is distributed in the hope that it will be useful,
Packit Service 4387a0
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
Packit Service 4387a0
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Packit Service 4387a0
 * Library General Public License for more details.
Packit Service 4387a0
 *
Packit Service 4387a0
 * You should have received a copy of the GNU Library General Public
Packit Service 4387a0
 * License along with this library; if not, write to the
Packit Service 4387a0
 * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
Packit Service 4387a0
 * Boston, MA 02110-1301, USA.
Packit Service 4387a0
 */
Packit Service 4387a0
Packit Service 4387a0
#ifdef HAVE_CONFIG_H
Packit Service 4387a0
#include "config.h"
Packit Service 4387a0
#endif
Packit Service 4387a0
Packit Service 4387a0
#include "gstrtpmeta.h"
Packit Service 4387a0
#include <string.h>
Packit Service 4387a0
Packit Service 4387a0
/**
Packit Service 4387a0
 * SECTION:gstrtpmeta
Packit Service 4387a0
 * @title: GstMeta for RTP
Packit Service 4387a0
 * @short_description: RTP related GstMeta
Packit Service 4387a0
 *
Packit Service 4387a0
 */
Packit Service 4387a0
Packit Service 4387a0
/**
Packit Service 4387a0
 * gst_buffer_add_rtp_source_meta:
Packit Service 4387a0
 * @buffer: a #GstBuffer
Packit Service 4387a0
 * @ssrc: (allow-none) (transfer none): pointer to the SSRC
Packit Service 4387a0
 * @csrc: (allow-none) (transfer none): pointer to the CSRCs
Packit Service 4387a0
 * @csrc_count: number of elements in @csrc
Packit Service 4387a0
 *
Packit Service 4387a0
 * Attaches RTP source information to @buffer.
Packit Service 4387a0
 *
Packit Service 4387a0
 * Returns: (transfer none): the #GstRTPSourceMeta on @buffer.
Packit Service 4387a0
 *
Packit Service 4387a0
 * Since: 1.16
Packit Service 4387a0
 */
Packit Service 4387a0
GstRTPSourceMeta *
Packit Service 4387a0
gst_buffer_add_rtp_source_meta (GstBuffer * buffer, const guint32 * ssrc,
Packit Service 4387a0
    const guint * csrc, guint csrc_count)
Packit Service 4387a0
{
Packit Service 4387a0
  gint i;
Packit Service 4387a0
  GstRTPSourceMeta *meta;
Packit Service 4387a0
Packit Service 4387a0
  g_return_val_if_fail (buffer != NULL, NULL);
Packit Service 4387a0
  g_return_val_if_fail (csrc_count <= GST_RTP_SOURCE_META_MAX_CSRC_COUNT, NULL);
Packit Service 4387a0
  g_return_val_if_fail (csrc_count == 0 || csrc != NULL, NULL);
Packit Service 4387a0
Packit Service 4387a0
  meta = (GstRTPSourceMeta *) gst_buffer_add_meta (buffer,
Packit Service 4387a0
      GST_RTP_SOURCE_META_INFO, NULL);
Packit Service 4387a0
  if (!meta)
Packit Service 4387a0
    return NULL;
Packit Service 4387a0
Packit Service 4387a0
  if (ssrc != NULL) {
Packit Service 4387a0
    meta->ssrc = *ssrc;
Packit Service 4387a0
    meta->ssrc_valid = TRUE;
Packit Service 4387a0
  } else {
Packit Service 4387a0
    meta->ssrc_valid = FALSE;
Packit Service 4387a0
  }
Packit Service 4387a0
Packit Service 4387a0
  meta->csrc_count = csrc_count;
Packit Service 4387a0
  for (i = 0; i < csrc_count; i++) {
Packit Service 4387a0
    meta->csrc[i] = csrc[i];
Packit Service 4387a0
  }
Packit Service 4387a0
Packit Service 4387a0
  return meta;
Packit Service 4387a0
}
Packit Service 4387a0
Packit Service 4387a0
/**
Packit Service 4387a0
 * gst_buffer_get_rtp_source_meta:
Packit Service 4387a0
 * @buffer: a #GstBuffer
Packit Service 4387a0
 *
Packit Service 4387a0
 * Find the #GstRTPSourceMeta on @buffer.
Packit Service 4387a0
 *
Packit Service 4387a0
 * Returns: (transfer none): the #GstRTPSourceMeta or %NULL when there
Packit Service 4387a0
 * is no such metadata on @buffer.
Packit Service 4387a0
 *
Packit Service 4387a0
 * Since: 1.16
Packit Service 4387a0
 */
Packit Service 4387a0
GstRTPSourceMeta *
Packit Service 4387a0
gst_buffer_get_rtp_source_meta (GstBuffer * buffer)
Packit Service 4387a0
{
Packit Service 4387a0
  return (GstRTPSourceMeta *) gst_buffer_get_meta (buffer,
Packit Service 4387a0
      gst_rtp_source_meta_api_get_type ());
Packit Service 4387a0
}
Packit Service 4387a0
Packit Service 4387a0
static gboolean
Packit Service 4387a0
gst_rtp_source_meta_transform (GstBuffer * dst, GstMeta * meta,
Packit Service 4387a0
    GstBuffer * src, GQuark type, gpointer data)
Packit Service 4387a0
{
Packit Service 4387a0
  if (GST_META_TRANSFORM_IS_COPY (type)) {
Packit Service 4387a0
    GstRTPSourceMeta *smeta = (GstRTPSourceMeta *) meta;
Packit Service 4387a0
    GstRTPSourceMeta *dmeta;
Packit Service 4387a0
    guint32 *ssrc = smeta->ssrc_valid ? &smeta->ssrc : NULL;
Packit Service 4387a0
Packit Service 4387a0
    dmeta = gst_buffer_add_rtp_source_meta (dst, ssrc, smeta->csrc,
Packit Service 4387a0
        smeta->csrc_count);
Packit Service 4387a0
    if (dmeta == NULL)
Packit Service 4387a0
      return FALSE;
Packit Service 4387a0
  } else {
Packit Service 4387a0
    /* return FALSE, if transform type is not supported */
Packit Service 4387a0
    return FALSE;
Packit Service 4387a0
  }
Packit Service 4387a0
Packit Service 4387a0
  return TRUE;
Packit Service 4387a0
}
Packit Service 4387a0
Packit Service 4387a0
/**
Packit Service 4387a0
 * gst_rtp_source_meta_get_source_count:
Packit Service 4387a0
 * @meta: a #GstRTPSourceMeta
Packit Service 4387a0
 *
Packit Service 4387a0
 * Count the total number of RTP sources found in @meta, both SSRC and CSRC.
Packit Service 4387a0
 *
Packit Service 4387a0
 * Returns: The number of RTP sources
Packit Service 4387a0
 *
Packit Service 4387a0
 * Since: 1.16
Packit Service 4387a0
 */
Packit Service 4387a0
guint
Packit Service 4387a0
gst_rtp_source_meta_get_source_count (const GstRTPSourceMeta * meta)
Packit Service 4387a0
{
Packit Service 4387a0
  /* Never return more than a count of 15 so that the returned value
Packit Service 4387a0
   * conveniently can be used as argument 'csrc_count' in
Packit Service 4387a0
   * gst_rtp_buffer-functions. */
Packit Service 4387a0
  guint ssrc_count = meta->ssrc_valid ? 1 : 0;
Packit Service 4387a0
  return MIN (meta->csrc_count + ssrc_count, 15);
Packit Service 4387a0
}
Packit Service 4387a0
Packit Service 4387a0
/**
Packit Service 4387a0
 * gst_rtp_source_meta_set_ssrc:
Packit Service 4387a0
 * @meta: a #GstRTPSourceMeta
Packit Service 4387a0
 * @ssrc: (allow-none) (transfer none): pointer to the SSRC
Packit Service 4387a0
 *
Packit Service 4387a0
 * Sets @ssrc in @meta. If @ssrc is %NULL the ssrc of @meta will be unset.
Packit Service 4387a0
 *
Packit Service 4387a0
 * Returns: %TRUE on success, %FALSE otherwise.
Packit Service 4387a0
 *
Packit Service 4387a0
 * Since: 1.16
Packit Service 4387a0
 **/
Packit Service 4387a0
gboolean
Packit Service 4387a0
gst_rtp_source_meta_set_ssrc (GstRTPSourceMeta * meta, guint32 * ssrc)
Packit Service 4387a0
{
Packit Service 4387a0
  if (ssrc != NULL) {
Packit Service 4387a0
    meta->ssrc = *ssrc;
Packit Service 4387a0
    meta->ssrc_valid = TRUE;
Packit Service 4387a0
  } else {
Packit Service 4387a0
    meta->ssrc_valid = FALSE;
Packit Service 4387a0
  }
Packit Service 4387a0
Packit Service 4387a0
  return TRUE;
Packit Service 4387a0
}
Packit Service 4387a0
Packit Service 4387a0
/**
Packit Service 4387a0
 * gst_rtp_source_meta_append_csrc:
Packit Service 4387a0
 * @meta: a #GstRTPSourceMeta
Packit Service 4387a0
 * @csrc: the csrcs to append
Packit Service 4387a0
 * @csrc_count: number of elements in @csrc
Packit Service 4387a0
 *
Packit Service 4387a0
 * Appends @csrc to the list of contributing sources in @meta.
Packit Service 4387a0
 *
Packit Service 4387a0
 * Returns: %TRUE if all elements in @csrc was added, %FALSE otherwise.
Packit Service 4387a0
 *
Packit Service 4387a0
 * Since: 1.16
Packit Service 4387a0
 **/
Packit Service 4387a0
gboolean
Packit Service 4387a0
gst_rtp_source_meta_append_csrc (GstRTPSourceMeta * meta, const guint32 * csrc,
Packit Service 4387a0
    guint csrc_count)
Packit Service 4387a0
{
Packit Service 4387a0
  gint i;
Packit Service 4387a0
  guint new_csrc_count = meta->csrc_count + csrc_count;
Packit Service 4387a0
Packit Service 4387a0
  if (new_csrc_count > GST_RTP_SOURCE_META_MAX_CSRC_COUNT)
Packit Service 4387a0
    return FALSE;
Packit Service 4387a0
Packit Service 4387a0
  for (i = 0; i < csrc_count; i++)
Packit Service 4387a0
    meta->csrc[meta->csrc_count + i] = csrc[i];
Packit Service 4387a0
  meta->csrc_count = new_csrc_count;
Packit Service 4387a0
Packit Service 4387a0
  return TRUE;
Packit Service 4387a0
}
Packit Service 4387a0
Packit Service 4387a0
GType
Packit Service 4387a0
gst_rtp_source_meta_api_get_type (void)
Packit Service 4387a0
{
Packit Service 4387a0
  static volatile GType type = 0;
Packit Service 4387a0
  static const gchar *tags[] = { NULL };
Packit Service 4387a0
Packit Service 4387a0
  if (g_once_init_enter (&type)) {
Packit Service 4387a0
    GType _type = gst_meta_api_type_register ("GstRTPSourceMetaAPI", tags);
Packit Service 4387a0
    g_once_init_leave (&type, _type);
Packit Service 4387a0
  }
Packit Service 4387a0
  return type;
Packit Service 4387a0
}
Packit Service 4387a0
Packit Service 4387a0
static gboolean
Packit Service 4387a0
gst_rtp_source_meta_init (GstMeta * meta, gpointer params, GstBuffer * buffer)
Packit Service 4387a0
{
Packit Service 4387a0
  GstRTPSourceMeta *dmeta = (GstRTPSourceMeta *) meta;
Packit Service 4387a0
Packit Service 4387a0
  dmeta->ssrc_valid = FALSE;
Packit Service 4387a0
  dmeta->csrc_count = 0;
Packit Service 4387a0
Packit Service 4387a0
  return TRUE;
Packit Service 4387a0
}
Packit Service 4387a0
Packit Service 4387a0
const GstMetaInfo *
Packit Service 4387a0
gst_rtp_source_meta_get_info (void)
Packit Service 4387a0
{
Packit Service 4387a0
  static const GstMetaInfo *rtp_source_meta_info = NULL;
Packit Service 4387a0
Packit Service 4387a0
  if (g_once_init_enter (&rtp_source_meta_info)) {
Packit Service 4387a0
    const GstMetaInfo *meta = gst_meta_register (GST_RTP_SOURCE_META_API_TYPE,
Packit Service 4387a0
        "GstRTPSourceMeta",
Packit Service 4387a0
        sizeof (GstRTPSourceMeta),
Packit Service 4387a0
        gst_rtp_source_meta_init,
Packit Service 4387a0
        (GstMetaFreeFunction) NULL,
Packit Service 4387a0
        gst_rtp_source_meta_transform);
Packit Service 4387a0
    g_once_init_leave (&rtp_source_meta_info, meta);
Packit Service 4387a0
  }
Packit Service 4387a0
  return rtp_source_meta_info;
Packit Service 4387a0
}