media/base/channel_layout.cc

   1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #include "media/base/channel_layout.h"
   6
   7 #include "base/basictypes.h"
   8 #include "base/logging.h"
   9
  10 namespace media {
  11
  12 static const int kLayoutToChannels[] = {
  13     0,   // CHANNEL_LAYOUT_NONE
  14     0,   // CHANNEL_LAYOUT_UNSUPPORTED
  15     1,   // CHANNEL_LAYOUT_MONO
  16     2,   // CHANNEL_LAYOUT_STEREO
  17     3,   // CHANNEL_LAYOUT_2_1
  18     3,   // CHANNEL_LAYOUT_SURROUND
  19     4,   // CHANNEL_LAYOUT_4_0
  20     4,   // CHANNEL_LAYOUT_2_2
  21     4,   // CHANNEL_LAYOUT_QUAD
  22     5,   // CHANNEL_LAYOUT_5_0
  23     6,   // CHANNEL_LAYOUT_5_1
  24     5,   // CHANNEL_LAYOUT_5_0_BACK
  25     6,   // CHANNEL_LAYOUT_5_1_BACK
  26     7,   // CHANNEL_LAYOUT_7_0
  27     8,   // CHANNEL_LAYOUT_7_1
  28     8,   // CHANNEL_LAYOUT_7_1_WIDE
  29     2,   // CHANNEL_LAYOUT_STEREO_DOWNMIX
  30     3,   // CHANNEL_LAYOUT_2POINT1
  31     4,   // CHANNEL_LAYOUT_3_1
  32     5,   // CHANNEL_LAYOUT_4_1
  33     6,   // CHANNEL_LAYOUT_6_0
  34     6,   // CHANNEL_LAYOUT_6_0_FRONT
  35     6,   // CHANNEL_LAYOUT_HEXAGONAL
  36     7,   // CHANNEL_LAYOUT_6_1
  37     7,   // CHANNEL_LAYOUT_6_1_BACK
  38     7,   // CHANNEL_LAYOUT_6_1_FRONT
  39     7,   // CHANNEL_LAYOUT_7_0_FRONT
  40     8,   // CHANNEL_LAYOUT_7_1_WIDE_BACK
  41     8,   // CHANNEL_LAYOUT_OCTAGONAL
  42     0,   // CHANNEL_LAYOUT_DISCRETE
  43     3,   // CHANNEL_LAYOUT_STEREO_AND_KEYBOARD_MIC
  44     5,   // CHANNEL_LAYOUT_4_1_QUAD_SIDE
  45 };
  46
  47 // The channel orderings for each layout as specified by FFmpeg. Each value
  48 // represents the index of each channel in each layout.  Values of -1 mean the
  49 // channel at that index is not used for that layout. For example, the left side
  50 // surround sound channel in FFmpeg's 5.1 layout is in the 5th position (because
  51 // the order is L, R, C, LFE, LS, RS), so
  52 // kChannelOrderings[CHANNEL_LAYOUT_5_1][SIDE_LEFT] = 4;
  53 static const int kChannelOrderings[CHANNEL_LAYOUT_MAX + 1][CHANNELS_MAX + 1] = {
  54     // FL | FR | FC | LFE | BL | BR | FLofC | FRofC | BC | SL | SR
  55
  56     // CHANNEL_LAYOUT_NONE
  57     {  -1 , -1 , -1 , -1  , -1 , -1 , -1    , -1    , -1 , -1 , -1 },
  58
  59     // CHANNEL_LAYOUT_UNSUPPORTED
  60     {  -1 , -1 , -1 , -1  , -1 , -1 , -1    , -1    , -1 , -1 , -1 },
  61
  62     // CHANNEL_LAYOUT_MONO
  63     {  -1 , -1 , 0  , -1  , -1 , -1 , -1    , -1    , -1 , -1 , -1 },
  64
  65     // CHANNEL_LAYOUT_STEREO
  66     {  0  , 1  , -1 , -1  , -1 , -1 , -1    , -1    , -1 , -1 , -1 },
  67
  68     // CHANNEL_LAYOUT_2_1
  69     {  0  , 1  , -1 , -1  , -1 , -1 , -1    , -1    , 2  , -1 , -1 },
  70
  71     // CHANNEL_LAYOUT_SURROUND
  72     {  0  , 1  , 2  , -1  , -1 , -1 , -1    , -1    , -1 , -1 , -1 },
  73
  74     // CHANNEL_LAYOUT_4_0
  75     {  0  , 1  , 2  , -1  , -1 , -1 , -1    , -1    , 3  , -1 , -1 },
  76
  77     // CHANNEL_LAYOUT_2_2
  78     {  0  , 1  , -1 , -1  , -1 , -1 , -1    , -1    , -1 , 2  ,  3 },
  79
  80     // CHANNEL_LAYOUT_QUAD
  81     {  0  , 1  , -1 , -1  , 2  , 3  , -1    , -1    , -1 , -1 , -1 },
  82
  83     // CHANNEL_LAYOUT_5_0
  84     {  0  , 1  , 2  , -1  , -1 , -1 , -1    , -1    , -1 , 3  ,  4 },
  85
  86     // CHANNEL_LAYOUT_5_1
  87     {  0  , 1  , 2  , 3   , -1 , -1 , -1    , -1    , -1 , 4  ,  5 },
  88
  89     // FL | FR | FC | LFE | BL | BR | FLofC | FRofC | BC | SL | SR
  90
  91     // CHANNEL_LAYOUT_5_0_BACK
  92     {  0  , 1  , 2  , -1  , 3  , 4  , -1    , -1    , -1 , -1 , -1 },
  93
  94     // CHANNEL_LAYOUT_5_1_BACK
  95     {  0  , 1  , 2  , 3   , 4  , 5  , -1    , -1    , -1 , -1 , -1 },
  96
  97     // CHANNEL_LAYOUT_7_0
  98     {  0  , 1  , 2  , -1  , 5  , 6  , -1    , -1    , -1 , 3  ,  4 },
  99
 100     // CHANNEL_LAYOUT_7_1
 101     {  0  , 1  , 2  , 3   , 6  , 7  , -1    , -1    , -1 , 4  ,  5 },
 102
 103     // CHANNEL_LAYOUT_7_1_WIDE
 104     {  0  , 1  , 2  , 3   , -1 , -1 , 6     , 7     , -1 , 4  ,  5 },
 105
 106     // CHANNEL_LAYOUT_STEREO_DOWNMIX
 107     {  0  , 1  , -1 , -1  , -1 , -1 , -1    , -1    , -1 , -1 , -1 },
 108
 109     // CHANNEL_LAYOUT_2POINT1
 110     {  0  , 1  , -1 ,  2  , -1 , -1 , -1    , -1    , -1 , -1 , -1 },
 111
 112     // CHANNEL_LAYOUT_3_1
 113     {  0  , 1  ,  2 ,  3  , -1 , -1 , -1    , -1    , -1 , -1 , -1 },
 114
 115     // CHANNEL_LAYOUT_4_1
 116     {  0  , 1  ,  2 ,  4  , -1 , -1 , -1    , -1    ,  3 , -1 , -1 },
 117
 118     // CHANNEL_LAYOUT_6_0
 119     {  0  , 1  , 2  , -1  , -1 , -1 , -1    , -1    ,  5 , 3  ,  4 },
 120
 121     // CHANNEL_LAYOUT_6_0_FRONT
 122     {  0  , 1  , -1 , -1  , -1 , -1 ,  4    ,  5    , -1 , 2  ,  3 },
 123
 124     // FL | FR | FC | LFE | BL | BR | FLofC | FRofC | BC | SL | SR
 125
 126     // CHANNEL_LAYOUT_HEXAGONAL
 127     {  0  , 1  , 2  , -1  , 3  , 4  , -1    , -1    ,  5 , -1 , -1 },
 128
 129     // CHANNEL_LAYOUT_6_1
 130     {  0  , 1  , 2  , 3   , -1 , -1 , -1    , -1    ,  6 , 4  ,  5 },
 131
 132     // CHANNEL_LAYOUT_6_1_BACK
 133     {  0  , 1  , 2  , 3   , 4  , 5  , -1    , -1    ,  6 , -1 , -1 },
 134
 135     // CHANNEL_LAYOUT_6_1_FRONT
 136     {  0  , 1  , -1 , 6   , -1 , -1 , 4     , 5     , -1 , 2  ,  3 },
 137
 138     // CHANNEL_LAYOUT_7_0_FRONT
 139     {  0  , 1  , 2  , -1  , -1 , -1 , 5     , 6     , -1 , 3  ,  4 },
 140
 141     // CHANNEL_LAYOUT_7_1_WIDE_BACK
 142     {  0  , 1  , 2  , 3   , 4  , 5  , 6     , 7     , -1 , -1 , -1 },
 143
 144     // CHANNEL_LAYOUT_OCTAGONAL
 145     {  0  , 1  , 2  , -1  , 5  , 6  , -1    , -1    ,  7 , 3  ,  4 },
 146
 147     // CHANNEL_LAYOUT_DISCRETE
 148     {  -1 , -1 , -1 , -1  , -1 , -1 , -1    , -1    , -1 , -1 , -1 },
 149
 150     // CHANNEL_LAYOUT_STEREO_AND_KEYBOARD_MIC
 151     {  0  , 1  , 2  , -1  , -1 , -1 , -1    , -1    , -1 , -1 , -1 },
 152
 153     // CHANNEL_LAYOUT_4_1_QUAD_SIDE
 154     {  0  , 1  , -1 ,  4  , -1 , -1 , -1    , -1    , -1 , 2  ,  3 },
 155
 156     // FL | FR | FC | LFE | BL | BR | FLofC | FRofC | BC | SL | SR
 157 };
 158
 159 int ChannelLayoutToChannelCount(ChannelLayout layout) {
 160   DCHECK_LT(static_cast<size_t>(layout), arraysize(kLayoutToChannels));
 161   return kLayoutToChannels[layout];
 162 }
 163
 164 // Converts a channel count into a channel layout.
 165 ChannelLayout GuessChannelLayout(int channels) {
 166   switch (channels) {
 167     case 1:
 168       return CHANNEL_LAYOUT_MONO;
 169     case 2:
 170       return CHANNEL_LAYOUT_STEREO;
 171     case 3:
 172       return CHANNEL_LAYOUT_SURROUND;
 173     case 4:
 174       return CHANNEL_LAYOUT_QUAD;
 175     case 5:
 176       return CHANNEL_LAYOUT_5_0;
 177     case 6:
 178       return CHANNEL_LAYOUT_5_1;
 179     case 7:
 180       return CHANNEL_LAYOUT_6_1;
 181     case 8:
 182       return CHANNEL_LAYOUT_7_1;
 183     default:
 184       DVLOG(1) << "Unsupported channel count: " << channels;
 185   }
 186   return CHANNEL_LAYOUT_UNSUPPORTED;
 187 }
 188
 189 int ChannelOrder(ChannelLayout layout, Channels channel) {
 190   DCHECK_LT(static_cast<size_t>(layout), arraysize(kChannelOrderings));
 191   DCHECK_LT(static_cast<size_t>(channel), arraysize(kChannelOrderings[0]));
 192   return kChannelOrderings[layout][channel];
 193 }
 194
 195 const char* ChannelLayoutToString(ChannelLayout layout) {
 196   switch (layout) {
 197     case CHANNEL_LAYOUT_NONE:
 198       return "NONE";
 199     case CHANNEL_LAYOUT_UNSUPPORTED:
 200       return "UNSUPPORTED";
 201     case CHANNEL_LAYOUT_MONO:
 202       return "MONO";
 203     case CHANNEL_LAYOUT_STEREO:
 204       return "STEREO";
 205     case CHANNEL_LAYOUT_2_1:
 206       return "2.1";
 207     case CHANNEL_LAYOUT_SURROUND:
 208       return "SURROUND";
 209     case CHANNEL_LAYOUT_4_0:
 210       return "4.0";
 211     case CHANNEL_LAYOUT_2_2:
 212       return "QUAD_SIDE";
 213     case CHANNEL_LAYOUT_QUAD:
 214       return "QUAD";
 215     case CHANNEL_LAYOUT_5_0:
 216       return "5.0";
 217     case CHANNEL_LAYOUT_5_1:
 218       return "5.1";
 219     case CHANNEL_LAYOUT_5_0_BACK:
 220       return "5.0_BACK";
 221     case CHANNEL_LAYOUT_5_1_BACK:
 222       return "5.1_BACK";
 223     case CHANNEL_LAYOUT_7_0:
 224       return "7.0";
 225     case CHANNEL_LAYOUT_7_1:
 226       return "7.1";
 227     case CHANNEL_LAYOUT_7_1_WIDE:
 228       return "7.1_WIDE";
 229     case CHANNEL_LAYOUT_STEREO_DOWNMIX:
 230       return "STEREO_DOWNMIX";
 231     case CHANNEL_LAYOUT_2POINT1:
 232       return "2POINT1";
 233     case CHANNEL_LAYOUT_3_1:
 234       return "3.1";
 235     case CHANNEL_LAYOUT_4_1:
 236       return "4.1";
 237     case CHANNEL_LAYOUT_6_0:
 238       return "6.0";
 239     case CHANNEL_LAYOUT_6_0_FRONT:
 240       return "6.0_FRONT";
 241     case CHANNEL_LAYOUT_HEXAGONAL:
 242       return "HEXAGONAL";
 243     case CHANNEL_LAYOUT_6_1:
 244       return "6.1";
 245     case CHANNEL_LAYOUT_6_1_BACK:
 246       return "6.1_BACK";
 247     case CHANNEL_LAYOUT_6_1_FRONT:
 248       return "6.1_FRONT";
 249     case CHANNEL_LAYOUT_7_0_FRONT:
 250       return "7.0_FRONT";
 251     case CHANNEL_LAYOUT_7_1_WIDE_BACK:
 252       return "7.1_WIDE_BACK";
 253     case CHANNEL_LAYOUT_OCTAGONAL:
 254       return "OCTAGONAL";
 255     case CHANNEL_LAYOUT_DISCRETE:
 256       return "DISCRETE";
 257     case CHANNEL_LAYOUT_STEREO_AND_KEYBOARD_MIC:
 258       return "STEREO_AND_KEYBOARD_MIC";
 259     case CHANNEL_LAYOUT_4_1_QUAD_SIDE:
 260       return "4.1_QUAD_SIDE";
 261   }
 262   NOTREACHED() << "Invalid channel layout provided: " << layout;
 263   return "";
 264 }
 265
 266 }  // namespace media