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