gst/rtp/gstrtpchannels.h

   1 /* GStreamer
   2  * Copyright (C) <2008> 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., 59 Temple Place - Suite 330,
  17  * Boston, MA 02111-1307, USA.
  18  */
  19
  20 #include <string.h>
  21 #include <stdlib.h>
  22
  23 #include <gst/audio/audio.h>
  24 #include <gst/audio/multichannel.h>
  25
  26 typedef struct
  27 {
  28   const gchar                   *name;
  29   gint                           channels;
  30   const GstAudioChannelPosition *pos;
  31 } GstRTPChannelOrder;
  32
  33 static const GstAudioChannelPosition pos_4_1[] = {
  34   GST_AUDIO_CHANNEL_POSITION_FRONT_LEFT,
  35   GST_AUDIO_CHANNEL_POSITION_FRONT_RIGHT,
  36   GST_AUDIO_CHANNEL_POSITION_SIDE_LEFT,
  37   GST_AUDIO_CHANNEL_POSITION_SIDE_RIGHT
  38 };
  39
  40 static const GstAudioChannelPosition pos_4_2[] = {
  41   GST_AUDIO_CHANNEL_POSITION_FRONT_LEFT,
  42   GST_AUDIO_CHANNEL_POSITION_FRONT_RIGHT,
  43   GST_AUDIO_CHANNEL_POSITION_FRONT_CENTER,
  44   GST_AUDIO_CHANNEL_POSITION_LFE
  45 };
  46
  47 static const GstAudioChannelPosition pos_4_3[] = {
  48   GST_AUDIO_CHANNEL_POSITION_FRONT_LEFT,
  49   GST_AUDIO_CHANNEL_POSITION_FRONT_RIGHT,
  50   GST_AUDIO_CHANNEL_POSITION_FRONT_CENTER,
  51   GST_AUDIO_CHANNEL_POSITION_LFE
  52 };
  53
  54 static const GstAudioChannelPosition pos_5_1[] = {
  55   GST_AUDIO_CHANNEL_POSITION_FRONT_LEFT,
  56   GST_AUDIO_CHANNEL_POSITION_FRONT_RIGHT,
  57   GST_AUDIO_CHANNEL_POSITION_SIDE_LEFT,
  58   GST_AUDIO_CHANNEL_POSITION_SIDE_RIGHT,
  59   GST_AUDIO_CHANNEL_POSITION_FRONT_CENTER
  60 };
  61
  62 static const GstAudioChannelPosition pos_6_1[] = {
  63   GST_AUDIO_CHANNEL_POSITION_FRONT_LEFT,
  64   GST_AUDIO_CHANNEL_POSITION_FRONT_RIGHT,
  65   GST_AUDIO_CHANNEL_POSITION_SIDE_LEFT,
  66   GST_AUDIO_CHANNEL_POSITION_SIDE_RIGHT,
  67   GST_AUDIO_CHANNEL_POSITION_FRONT_CENTER,
  68   GST_AUDIO_CHANNEL_POSITION_LFE
  69 };
  70
  71 static const GstAudioChannelPosition pos_6_2[] = {
  72   GST_AUDIO_CHANNEL_POSITION_FRONT_LEFT,
  73   GST_AUDIO_CHANNEL_POSITION_FRONT_RIGHT,
  74   GST_AUDIO_CHANNEL_POSITION_FRONT_CENTER,
  75   GST_AUDIO_CHANNEL_POSITION_LFE,
  76   GST_AUDIO_CHANNEL_POSITION_SIDE_LEFT,
  77   GST_AUDIO_CHANNEL_POSITION_SIDE_RIGHT
  78 };
  79
  80 static const GstAudioChannelPosition pos_8_1[] = {
  81   GST_AUDIO_CHANNEL_POSITION_FRONT_LEFT,
  82   GST_AUDIO_CHANNEL_POSITION_FRONT_RIGHT,
  83   GST_AUDIO_CHANNEL_POSITION_FRONT_CENTER,
  84   GST_AUDIO_CHANNEL_POSITION_LFE,
  85   GST_AUDIO_CHANNEL_POSITION_SIDE_LEFT,
  86   GST_AUDIO_CHANNEL_POSITION_SIDE_RIGHT,
  87   GST_AUDIO_CHANNEL_POSITION_REAR_LEFT,
  88   GST_AUDIO_CHANNEL_POSITION_REAR_RIGHT
  89 };
  90
  91 static const GstAudioChannelPosition pos_8_2[] = {
  92   GST_AUDIO_CHANNEL_POSITION_FRONT_LEFT,
  93   GST_AUDIO_CHANNEL_POSITION_FRONT_RIGHT,
  94   GST_AUDIO_CHANNEL_POSITION_FRONT_CENTER,
  95   GST_AUDIO_CHANNEL_POSITION_LFE,
  96   GST_AUDIO_CHANNEL_POSITION_SIDE_LEFT,
  97   GST_AUDIO_CHANNEL_POSITION_SIDE_RIGHT,
  98   GST_AUDIO_CHANNEL_POSITION_REAR_LEFT,
  99   GST_AUDIO_CHANNEL_POSITION_REAR_RIGHT
 100 };
 101
 102 static const GstAudioChannelPosition pos_8_3[] = {
 103   GST_AUDIO_CHANNEL_POSITION_FRONT_LEFT,
 104   GST_AUDIO_CHANNEL_POSITION_FRONT_RIGHT,
 105   GST_AUDIO_CHANNEL_POSITION_FRONT_CENTER,
 106   GST_AUDIO_CHANNEL_POSITION_LFE,
 107   GST_AUDIO_CHANNEL_POSITION_SIDE_LEFT,
 108   GST_AUDIO_CHANNEL_POSITION_SIDE_RIGHT,
 109   GST_AUDIO_CHANNEL_POSITION_REAR_LEFT,
 110   GST_AUDIO_CHANNEL_POSITION_REAR_RIGHT
 111 };
 112
 113 static const GstAudioChannelPosition pos_def_1[] = {
 114   GST_AUDIO_CHANNEL_POSITION_FRONT_MONO
 115 };
 116
 117 static const GstAudioChannelPosition pos_def_2[] = {
 118   GST_AUDIO_CHANNEL_POSITION_FRONT_LEFT,
 119   GST_AUDIO_CHANNEL_POSITION_FRONT_RIGHT
 120 };
 121
 122 static const GstAudioChannelPosition pos_def_3[] = {
 123   GST_AUDIO_CHANNEL_POSITION_FRONT_LEFT,
 124   GST_AUDIO_CHANNEL_POSITION_FRONT_RIGHT,
 125   GST_AUDIO_CHANNEL_POSITION_FRONT_CENTER
 126 };
 127
 128 static const GstAudioChannelPosition pos_def_4[] = {
 129   GST_AUDIO_CHANNEL_POSITION_FRONT_LEFT,
 130   GST_AUDIO_CHANNEL_POSITION_FRONT_CENTER,
 131   GST_AUDIO_CHANNEL_POSITION_FRONT_RIGHT,
 132   GST_AUDIO_CHANNEL_POSITION_LFE
 133 };
 134
 135 static const GstAudioChannelPosition pos_def_5[] = {
 136   GST_AUDIO_CHANNEL_POSITION_FRONT_LEFT,
 137   GST_AUDIO_CHANNEL_POSITION_FRONT_RIGHT,
 138   GST_AUDIO_CHANNEL_POSITION_FRONT_CENTER,
 139   GST_AUDIO_CHANNEL_POSITION_SIDE_LEFT,
 140   GST_AUDIO_CHANNEL_POSITION_SIDE_RIGHT
 141 };
 142
 143 static const GstAudioChannelPosition pos_def_6[] = {
 144   GST_AUDIO_CHANNEL_POSITION_SIDE_LEFT,
 145   GST_AUDIO_CHANNEL_POSITION_FRONT_LEFT,
 146   GST_AUDIO_CHANNEL_POSITION_FRONT_CENTER,
 147   GST_AUDIO_CHANNEL_POSITION_SIDE_RIGHT,
 148   GST_AUDIO_CHANNEL_POSITION_FRONT_RIGHT,
 149   GST_AUDIO_CHANNEL_POSITION_LFE
 150 };
 151
 152 static const GstRTPChannelOrder channel_orders[] =
 153 {
 154   /* 4 channels */
 155   { "DV.LRLsRs",            4, pos_4_1 },
 156   { "DV.LRCS",              4, pos_4_2 },
 157   { "DV.LRCWo",             4, pos_4_3 },
 158   /* 5 channels */
 159   { "DV.LRLsRsC",           5, pos_5_1 },
 160   /* 6 channels */
 161   { "DV.LRLsRsCS",          6, pos_6_1 },
 162   { "DV.LmixRmixTWoQ1Q2",   6, pos_6_2 },
 163   /* 8 channels */
 164   { "DV.LRCWoLsRsLmixRmix", 8, pos_8_1 },
 165   { "DV.LRCWoLs1Rs1Ls2Rs2", 8, pos_8_2 },
 166   { "DV.LRCWoLsRsLcRc",     8, pos_8_3 },
 167
 168   /* default layouts */
 169   { NULL,                   1, pos_def_1 },
 170   { NULL,                   2, pos_def_2 },
 171   { NULL,                   3, pos_def_3 },
 172   { NULL,                   4, pos_def_4 },
 173   { NULL,                   5, pos_def_5 },
 174   { NULL,                   6, pos_def_6 },
 175
 176   /* terminator, invalid entry */
 177   { NULL,                   0, NULL },
 178 };
 179
 180 const GstRTPChannelOrder *   gst_rtp_channels_get_by_pos     (gint channels,
 181                                                               const GstAudioChannelPosition *pos);
 182 const GstRTPChannelOrder *   gst_rtp_channels_get_by_order   (gint channels,
 183                                                               const gchar *order);
 184 const GstRTPChannelOrder *   gst_rtp_channels_get_by_index   (gint channels, guint idx);
 185
 186 GstAudioChannelPosition *    gst_rtp_channels_create_default (gint channels);