source/includes/vst3sdk/pluginterfaces/vst/vstspeaker.h

   1 //------------------------------------------------------------------------
   2 // Project     : VST SDK
   3 //
   4 // Category    : Interfaces
   5 // Filename    : pluginterfaces/vst/vstspeaker.h
   6 // Created by  : Steinberg, 01/2018
   7 // Description : common defines
   8 //
   9 //-----------------------------------------------------------------------------
  10 // This file is part of a Steinberg SDK. It is subject to the license terms
  11 // in the LICENSE file found in the top-level directory of this distribution
  12 // and at www.steinberg.net/sdklicenses.
  13 // No part of the SDK, including this file, may be copied, modified, propagated,
  14 // or distributed except according to the terms contained in the LICENSE file.
  15 //-----------------------------------------------------------------------------
  16
  17 #pragma once
  18
  19 #include "pluginterfaces/vst/vsttypes.h"
  20
  21 //------------------------------------------------------------------------
  22 namespace Steinberg {
  23 namespace Vst {
  24 //------------------------------------------------------------------------
  25 /** \defgroup speakerArrangements Speaker Arrangements
  26 \image html "vst3_speaker_types.jpg"
  27 \n
  28 A SpeakerArrangement is a bitset combination of speakers. For example:
  29 \code
  30 const SpeakerArrangement kStereo = kSpeakerL | kSpeakerR; // => hex: 0x03 / binary: 0011.
  31 \endcode
  32 \see IAudioProcessor::getBusArrangement () and IAudioProcessor::setBusArrangements ()
  33 */
  34 //------------------------------------------------------------------------
  35
  36 //------------------------------------------------------------------------
  37 /** Speaker Definitions.
  38 \ingroup speakerArrangements */
  39 //------------------------------------------------------------------------
  40 /**@{*/
  41 const Speaker kSpeakerL    = 1 << 0;            ///< Left (L)
  42 const Speaker kSpeakerR    = 1 << 1;            ///< Right (R)
  43 const Speaker kSpeakerC    = 1 << 2;            ///< Center (C)
  44 const Speaker kSpeakerLfe  = 1 << 3;            ///< Subbass (Lfe)
  45 const Speaker kSpeakerLs   = 1 << 4;            ///< Left Surround (Ls)
  46 const Speaker kSpeakerRs   = 1 << 5;            ///< Right Surround (Rs)
  47 const Speaker kSpeakerLc   = 1 << 6;            ///< Left of Center (Lc) - Front Left Center
  48 const Speaker kSpeakerRc   = 1 << 7;            ///< Right of Center (Rc) - Front Right Center
  49 const Speaker kSpeakerS    = 1 << 8;            ///< Surround (S)
  50 const Speaker kSpeakerCs   = kSpeakerS;         ///< Center of Surround (Cs) - Back Center - Surround (S)
  51 const Speaker kSpeakerSl   = 1 << 9;            ///< Side Left (Sl)
  52 const Speaker kSpeakerSr   = 1 << 10;           ///< Side Right (Sr)
  53 const Speaker kSpeakerTc   = 1 << 11;           ///< Top Center Over-head, Top Middle (Tc)
  54 const Speaker kSpeakerTfl  = 1 << 12;           ///< Top Front Left (Tfl)
  55 const Speaker kSpeakerTfc  = 1 << 13;           ///< Top Front Center (Tfc)
  56 const Speaker kSpeakerTfr  = 1 << 14;           ///< Top Front Right (Tfr)
  57 const Speaker kSpeakerTrl  = 1 << 15;           ///< Top Rear/Back Left (Trl)
  58 const Speaker kSpeakerTrc  = 1 << 16;           ///< Top Rear/Back Center (Trc)
  59 const Speaker kSpeakerTrr  = 1 << 17;           ///< Top Rear/Back Right (Trr)
  60 const Speaker kSpeakerLfe2 = 1 << 18;           ///< Subbass 2 (Lfe2)
  61 const Speaker kSpeakerM    = 1 << 19;           ///< Mono (M)
  62
  63 const Speaker kSpeakerACN0  = (Speaker)1 << 20; ///< Ambisonic ACN 0
  64 const Speaker kSpeakerACN1  = (Speaker)1 << 21; ///< Ambisonic ACN 1
  65 const Speaker kSpeakerACN2  = (Speaker)1 << 22; ///< Ambisonic ACN 2
  66 const Speaker kSpeakerACN3  = (Speaker)1 << 23; ///< Ambisonic ACN 3
  67 const Speaker kSpeakerACN4  = (Speaker)1 << 38; ///< Ambisonic ACN 4
  68 const Speaker kSpeakerACN5  = (Speaker)1 << 39; ///< Ambisonic ACN 5
  69 const Speaker kSpeakerACN6  = (Speaker)1 << 40; ///< Ambisonic ACN 6
  70 const Speaker kSpeakerACN7  = (Speaker)1 << 41; ///< Ambisonic ACN 7
  71 const Speaker kSpeakerACN8  = (Speaker)1 << 42; ///< Ambisonic ACN 8
  72 const Speaker kSpeakerACN9  = (Speaker)1 << 43; ///< Ambisonic ACN 9
  73 const Speaker kSpeakerACN10 = (Speaker)1 << 44; ///< Ambisonic ACN 10
  74 const Speaker kSpeakerACN11 = (Speaker)1 << 45; ///< Ambisonic ACN 11
  75 const Speaker kSpeakerACN12 = (Speaker)1 << 46; ///< Ambisonic ACN 12
  76 const Speaker kSpeakerACN13 = (Speaker)1 << 47; ///< Ambisonic ACN 13
  77 const Speaker kSpeakerACN14 = (Speaker)1 << 48; ///< Ambisonic ACN 14
  78 const Speaker kSpeakerACN15 = (Speaker)1 << 49; ///< Ambisonic ACN 15
  79
  80 const Speaker kSpeakerTsl = (Speaker)1 << 24;   ///< Top Side Left (Tsl)
  81 const Speaker kSpeakerTsr = (Speaker)1 << 25;   ///< Top Side Right (Tsr)
  82 const Speaker kSpeakerLcs = (Speaker)1 << 26;   ///< Left of Center Surround (Lcs) - Back Left Center
  83 const Speaker kSpeakerRcs = (Speaker)1 << 27;   ///< Right of Center Surround (Rcs) - Back Right Center
  84
  85 const Speaker kSpeakerBfl = (Speaker)1 << 28;   ///< Bottom Front Left (Bfl)
  86 const Speaker kSpeakerBfc = (Speaker)1 << 29;   ///< Bottom Front Center (Bfc)
  87 const Speaker kSpeakerBfr = (Speaker)1 << 30;   ///< Bottom Front Right (Bfr)
  88
  89 const Speaker kSpeakerPl  = (Speaker)1 << 31;   ///< Proximity Left (Pl)
  90 const Speaker kSpeakerPr  = (Speaker)1 << 32;   ///< Proximity Right (Pr)
  91
  92 const Speaker kSpeakerBsl = (Speaker)1 << 33;   ///< Bottom Side Left (Bsl)
  93 const Speaker kSpeakerBsr = (Speaker)1 << 34;   ///< Bottom Side Right (Bsr)
  94 const Speaker kSpeakerBrl = (Speaker)1 << 35;   ///< Bottom Rear Left (Brl)
  95 const Speaker kSpeakerBrc = (Speaker)1 << 36;   ///< Bottom Rear Center (Brc)
  96 const Speaker kSpeakerBrr = (Speaker)1 << 37;   ///< Bottom Rear Right (Brr)
  97 //------------------------------------------------------------------------
  98 /** @}*/
  99
 100 //------------------------------------------------------------------------
 101 /** Speaker Arrangement Definitions (SpeakerArrangement) */
 102 namespace SpeakerArr
 103 {
 104 //------------------------------------------------------------------------
 105 /** Speaker Arrangement Definitions.
 106 \ingroup speakerArrangements */
 107 /*@{*/
 108 const SpeakerArrangement kEmpty                  = 0;          ///< empty arrangement
 109 const SpeakerArrangement kMono                   = kSpeakerM;  ///< M
 110 const SpeakerArrangement kStereo                 = kSpeakerL   | kSpeakerR;    ///< L R
 111 const SpeakerArrangement kStereoSurround = kSpeakerLs  | kSpeakerRs;   ///< Ls Rs
 112 const SpeakerArrangement kStereoCenter   = kSpeakerLc  | kSpeakerRc;   ///< Lc Rc
 113 const SpeakerArrangement kStereoSide     = kSpeakerSl  | kSpeakerSr;   ///< Sl Sr
 114 const SpeakerArrangement kStereoCLfe     = kSpeakerC   | kSpeakerLfe;  ///< C Lfe
 115 const SpeakerArrangement kStereoTF               = kSpeakerTfl | kSpeakerTfr;  ///< Tfl Tfr
 116 const SpeakerArrangement kStereoTS               = kSpeakerTsl | kSpeakerTsr;  ///< Tsl Tsr
 117 const SpeakerArrangement kStereoTR               = kSpeakerTrl | kSpeakerTrr;  ///< Trl Trr
 118 const SpeakerArrangement kStereoBF               = kSpeakerBfl | kSpeakerBfr;  ///< Bfl Bfr
 119 const SpeakerArrangement kCineFront              = kSpeakerL   | kSpeakerR | kSpeakerC | kSpeakerLc | kSpeakerRc; ///< L R C Lc Rc
 120
 121 /** L R C */
 122 const SpeakerArrangement k30Cine                 = kSpeakerL  | kSpeakerR | kSpeakerC;
 123 /** L R C Lfe */
 124 const SpeakerArrangement k31Cine                 = kSpeakerL  | kSpeakerR | kSpeakerC   | kSpeakerLfe;
 125 /** L R S */
 126 const SpeakerArrangement k30Music                = kSpeakerL  | kSpeakerR | kSpeakerCs;
 127 /** L R Lfe S */
 128 const SpeakerArrangement k31Music                = kSpeakerL  | kSpeakerR | kSpeakerLfe | kSpeakerCs;
 129 /** L R C   S (LCRS) */
 130 const SpeakerArrangement k40Cine                 = kSpeakerL  | kSpeakerR | kSpeakerC   | kSpeakerCs;
 131 /** L R C   Lfe S (LCRS+Lfe) */
 132 const SpeakerArrangement k41Cine                 = kSpeakerL  | kSpeakerR | kSpeakerC   | kSpeakerLfe | kSpeakerCs;
 133 /** L R Ls  Rs (Quadro) */
 134 const SpeakerArrangement k40Music                = kSpeakerL  | kSpeakerR | kSpeakerLs  | kSpeakerRs;
 135 /** L R Lfe Ls Rs (Quadro+Lfe) */
 136 const SpeakerArrangement k41Music                = kSpeakerL  | kSpeakerR | kSpeakerLfe | kSpeakerLs  | kSpeakerRs;
 137 /** L R C   Ls Rs */
 138 const SpeakerArrangement k50                     = kSpeakerL  | kSpeakerR | kSpeakerC   | kSpeakerLs  | kSpeakerRs;
 139 /** L R C  Lfe Ls Rs */
 140 const SpeakerArrangement k51                     = kSpeakerL  | kSpeakerR | kSpeakerC   | kSpeakerLfe | kSpeakerLs | kSpeakerRs;
 141 /** L R C  Ls  Rs Cs */
 142 const SpeakerArrangement k60Cine                 = kSpeakerL  | kSpeakerR | kSpeakerC   | kSpeakerLs  | kSpeakerRs | kSpeakerCs;
 143 /** L R C  Lfe Ls Rs Cs */
 144 const SpeakerArrangement k61Cine                 = kSpeakerL  | kSpeakerR | kSpeakerC   | kSpeakerLfe | kSpeakerLs | kSpeakerRs | kSpeakerCs;
 145 /** L R Ls Rs  Sl Sr */
 146 const SpeakerArrangement k60Music                = kSpeakerL  | kSpeakerR | kSpeakerLs  | kSpeakerRs  | kSpeakerSl | kSpeakerSr;
 147 /** L R Lfe Ls  Rs Sl Sr */
 148 const SpeakerArrangement k61Music                = kSpeakerL  | kSpeakerR | kSpeakerLfe | kSpeakerLs  | kSpeakerRs | kSpeakerSl | kSpeakerSr;
 149 /** L R C   Ls  Rs Lc Rc */
 150 const SpeakerArrangement k70Cine                 = kSpeakerL  | kSpeakerR | kSpeakerC   | kSpeakerLs  | kSpeakerRs | kSpeakerLc | kSpeakerRc;
 151 /** L R C Lfe Ls Rs Lc Rc */
 152 const SpeakerArrangement k71Cine                 = kSpeakerL  | kSpeakerR | kSpeakerC   | kSpeakerLfe | kSpeakerLs | kSpeakerRs | kSpeakerLc | kSpeakerRc;
 153 const SpeakerArrangement k71CineFullFront = k71Cine;
 154 /** L R C   Ls  Rs Sl Sr */
 155 const SpeakerArrangement k70Music                = kSpeakerL  | kSpeakerR | kSpeakerC   | kSpeakerLs  | kSpeakerRs | kSpeakerSl | kSpeakerSr;
 156 /** L R C Lfe Ls Rs Sl Sr */
 157 const SpeakerArrangement k71Music                = kSpeakerL  | kSpeakerR | kSpeakerC   | kSpeakerLfe | kSpeakerLs | kSpeakerRs | kSpeakerSl | kSpeakerSr;
 158
 159 /** L R C Lfe Ls Rs Lcs Rcs */
 160 const SpeakerArrangement k71CineFullRear = kSpeakerL  | kSpeakerR | kSpeakerC   | kSpeakerLfe | kSpeakerLs | kSpeakerRs | kSpeakerLcs | kSpeakerRcs;
 161 const SpeakerArrangement k71CineSideFill = k71Music;
 162 /** L R C Lfe Ls Rs Pl Pr */
 163 const SpeakerArrangement k71Proximity    = kSpeakerL  | kSpeakerR | kSpeakerC   | kSpeakerLfe | kSpeakerLs | kSpeakerRs | kSpeakerPl | kSpeakerPr;
 164
 165 /** L R C Ls  Rs Lc Rc Cs */
 166 const SpeakerArrangement k80Cine                 = kSpeakerL  | kSpeakerR | kSpeakerC   | kSpeakerLs  | kSpeakerRs | kSpeakerLc | kSpeakerRc | kSpeakerCs;
 167 /** L R C Lfe Ls Rs Lc Rc Cs */
 168 const SpeakerArrangement k81Cine                 = kSpeakerL  | kSpeakerR | kSpeakerC   | kSpeakerLfe | kSpeakerLs | kSpeakerRs | kSpeakerLc | kSpeakerRc | kSpeakerCs;
 169 /** L R C Ls  Rs Cs Sl Sr */
 170 const SpeakerArrangement k80Music                = kSpeakerL  | kSpeakerR | kSpeakerC   | kSpeakerLs  | kSpeakerRs | kSpeakerCs | kSpeakerSl | kSpeakerSr;
 171 /** L R C Lfe Ls Rs Cs Sl Sr */
 172 const SpeakerArrangement k81Music                = kSpeakerL  | kSpeakerR | kSpeakerC   | kSpeakerLfe | kSpeakerLs | kSpeakerRs | kSpeakerCs | kSpeakerSl | kSpeakerSr;
 173 /** L R C Ls Rs Lc Rc Sl Sr */
 174 const SpeakerArrangement k90Cine                 = kSpeakerL  | kSpeakerR | kSpeakerC   | kSpeakerLs  | kSpeakerRs | kSpeakerLc | kSpeakerRc |
 175                                            kSpeakerSl | kSpeakerSr;
 176 /** L R C Lfe Ls Rs Lc Rc Sl Sr */
 177 const SpeakerArrangement k91Cine                 = kSpeakerL  | kSpeakerR | kSpeakerC   | kSpeakerLfe | kSpeakerLs | kSpeakerRs | kSpeakerLc | kSpeakerRc |
 178                                            kSpeakerSl | kSpeakerSr;
 179 /** L R C Ls Rs Lc Rc Cs Sl Sr */
 180 const SpeakerArrangement k100Cine                = kSpeakerL  | kSpeakerR | kSpeakerC   | kSpeakerLs  | kSpeakerRs | kSpeakerLc | kSpeakerRc | kSpeakerCs |
 181                                            kSpeakerSl | kSpeakerSr;
 182 /** L R C Lfe Ls Rs Lc Rc Cs Sl Sr */
 183 const SpeakerArrangement k101Cine                = kSpeakerL  | kSpeakerR | kSpeakerC   | kSpeakerLfe | kSpeakerLs | kSpeakerRs | kSpeakerLc | kSpeakerRc | kSpeakerCs |
 184                                            kSpeakerSl | kSpeakerSr;
 185
 186 /** First-Order with Ambisonic Channel Number (ACN) ordering and SN3D normalization */
 187 const SpeakerArrangement kAmbi1stOrderACN = kSpeakerACN0 | kSpeakerACN1 | kSpeakerACN2 | kSpeakerACN3;
 188 /** Second-Order with Ambisonic Channel Number (ACN) ordering and SN3D normalization */
 189 const SpeakerArrangement kAmbi2cdOrderACN = kAmbi1stOrderACN | kSpeakerACN4 | kSpeakerACN5 | kSpeakerACN6 | kSpeakerACN7 | kSpeakerACN8;
 190 /** Third-Order with Ambisonic Channel Number (ACN) ordering and SN3D normalization */
 191 const SpeakerArrangement kAmbi3rdOrderACN = kAmbi2cdOrderACN | kSpeakerACN9 | kSpeakerACN10 | kSpeakerACN11 | kSpeakerACN12 | kSpeakerACN13 | kSpeakerACN14 | kSpeakerACN15;
 192
 193
 194 /*-----------*/
 195 /* 3D formats */
 196 /*-----------*/
 197 /** L R Ls Rs Tfl Tfr Trl Trr */                                                // 4.0.4
 198 const SpeakerArrangement k80Cube                   = kSpeakerL | kSpeakerR | kSpeakerLs | kSpeakerRs  | kSpeakerTfl| kSpeakerTfr| kSpeakerTrl | kSpeakerTrr;
 199 /** L R C Lfe Ls Rs Cs Tc */                                                    // 6.1.1
 200 const SpeakerArrangement k71CineTopCenter  = kSpeakerL | kSpeakerR | kSpeakerC  | kSpeakerLfe | kSpeakerLs | kSpeakerRs | kSpeakerCs  | kSpeakerTc;
 201 /** L R C Lfe Ls Rs Cs Tfc */                                                   // 6.1.1
 202 const SpeakerArrangement k71CineCenterHigh = kSpeakerL | kSpeakerR | kSpeakerC  | kSpeakerLfe | kSpeakerLs | kSpeakerRs | kSpeakerCs  | kSpeakerTfc;
 203 /** L R C Lfe Ls Rs Tfl Tfr */                                                  // 5.1.2
 204 const SpeakerArrangement k71CineFrontHigh  = kSpeakerL | kSpeakerR | kSpeakerC  | kSpeakerLfe | kSpeakerLs | kSpeakerRs | kSpeakerTfl | kSpeakerTfr;
 205 const SpeakerArrangement k71MPEG3D                 = k71CineFrontHigh;
 206 /** L R C Lfe Ls Rs Tsl Tsr */                                                  // 5.1.2
 207 const SpeakerArrangement k71CineSideHigh   = kSpeakerL | kSpeakerR | kSpeakerC  | kSpeakerLfe | kSpeakerLs | kSpeakerRs | kSpeakerTsl | kSpeakerTsr;
 208
 209 /** L R Lfe Ls Rs Tfl Tfc Tfr Bfc */                                    // 4.1.4
 210 const SpeakerArrangement k81MPEG3D               = kSpeakerL | kSpeakerR | kSpeakerLfe | kSpeakerLs | kSpeakerRs |
 211                                            kSpeakerTfl | kSpeakerTfc | kSpeakerTfr | kSpeakerBfc;
 212
 213 /** L R C Ls Rs Tfl Tfr Trl Trr */                                              // 5.0.4
 214 const SpeakerArrangement k90                     = kSpeakerL  | kSpeakerR | kSpeakerC | kSpeakerLs  | kSpeakerRs |
 215                                            kSpeakerTfl| kSpeakerTfr | kSpeakerTrl | kSpeakerTrr;
 216 const SpeakerArrangement k50_4                   = k90;
 217 /** L R C Lfe Ls Rs Tfl Tfr Trl Trr */                                  // 5.1.4
 218 const SpeakerArrangement k91                     = kSpeakerL  | kSpeakerR | kSpeakerC | kSpeakerLfe | kSpeakerLs | kSpeakerRs  |
 219                                            kSpeakerTfl| kSpeakerTfr | kSpeakerTrl | kSpeakerTrr;
 220 const SpeakerArrangement k51_4                   = k91;
 221
 222 /** L R C Ls Rs Sl Sr Tsl Tsr */                                                // 7.0.2
 223 const SpeakerArrangement k70_2                   = kSpeakerL  | kSpeakerR | kSpeakerC | kSpeakerLs | kSpeakerRs |
 224                                            kSpeakerSl | kSpeakerSr | kSpeakerTsl | kSpeakerTsr;
 225
 226 /** L R C Lfe Ls Rs Sl Sr Tsl Tsr */                                    // 7.1.2
 227 const SpeakerArrangement k71_2                   = kSpeakerL  | kSpeakerR | kSpeakerC | kSpeakerLfe | kSpeakerLs | kSpeakerRs |
 228                                            kSpeakerSl | kSpeakerSr | kSpeakerTsl | kSpeakerTsr;
 229 const SpeakerArrangement k91Atmos                = k71_2;               // 9.1 Dolby Atmos (3D)
 230
 231 /** L R C Ls Rs Sl Sr Tfl Tfr Trl Trr */                                // 7.0.4
 232 const SpeakerArrangement k70_4                   = kSpeakerL | kSpeakerR | kSpeakerC | kSpeakerLs | kSpeakerRs | kSpeakerSl | kSpeakerSr |
 233                                            kSpeakerTfl | kSpeakerTfr | kSpeakerTrl | kSpeakerTrr;
 234
 235 /** L R C Lfe Ls Rs Sl Sr Tfl Tfr Trl Trr */                    // 7.1.4
 236 const SpeakerArrangement k71_4                   = kSpeakerL | kSpeakerR | kSpeakerC | kSpeakerLfe | kSpeakerLs | kSpeakerRs | kSpeakerSl | kSpeakerSr |
 237                                            kSpeakerTfl | kSpeakerTfr | kSpeakerTrl | kSpeakerTrr;
 238 const SpeakerArrangement k111MPEG3D              = k71_4;
 239
 240 /** L R C Ls Rs Sl Sr Tfl Tfr Trl Trr Tsl Tsr */                // 7.0.6
 241 const SpeakerArrangement k70_6                   = kSpeakerL | kSpeakerR | kSpeakerC |
 242                                            kSpeakerLs | kSpeakerRs | kSpeakerSl | kSpeakerSr |
 243                                            kSpeakerTfl | kSpeakerTfr | kSpeakerTrl | kSpeakerTrr | kSpeakerTsl | kSpeakerTsr;
 244
 245 /** L R C Lfe Ls Rs Sl Sr Tfl Tfr Trl Trr Tsl Tsr */    // 7.1.6
 246 const SpeakerArrangement k71_6                   = kSpeakerL | kSpeakerR | kSpeakerC | kSpeakerLfe |
 247                                            kSpeakerLs | kSpeakerRs | kSpeakerSl | kSpeakerSr |
 248                                            kSpeakerTfl | kSpeakerTfr | kSpeakerTrl | kSpeakerTrr | kSpeakerTsl | kSpeakerTsr;
 249
 250 /** L R C Ls Rs Lc Rc Sl Sr Tfl Tfr Trl Trr */                  // 9.0.4
 251 const SpeakerArrangement k90_4                   = kSpeakerL | kSpeakerR | kSpeakerC |
 252                                            kSpeakerLs | kSpeakerRs | kSpeakerLc | kSpeakerRc | kSpeakerSl | kSpeakerSr |
 253                                            kSpeakerTfl | kSpeakerTfr | kSpeakerTrl | kSpeakerTrr;
 254
 255 /** L R C Lfe Ls Rs Lc Rc Sl Sr Tfl Tfr Trl Trr */              // 9.1.4
 256 const SpeakerArrangement k91_4                   = kSpeakerL | kSpeakerR | kSpeakerC | kSpeakerLfe |
 257                                            kSpeakerLs | kSpeakerRs | kSpeakerLc | kSpeakerRc | kSpeakerSl | kSpeakerSr |
 258                                            kSpeakerTfl | kSpeakerTfr | kSpeakerTrl | kSpeakerTrr;
 259
 260 /** L R C Lfe Ls Rs Lc Rc Sl Sr Tfl Tfr Trl Trr Tsl Tsr */ // 9.0.6
 261 const SpeakerArrangement k90_6                   = kSpeakerL | kSpeakerR | kSpeakerC |
 262                                            kSpeakerLs | kSpeakerRs | kSpeakerLc | kSpeakerRc | kSpeakerSl | kSpeakerSr |
 263                                            kSpeakerTfl | kSpeakerTfr | kSpeakerTrl | kSpeakerTrr | kSpeakerTsl | kSpeakerTsr;
 264
 265 /** L R C Lfe Ls Rs Lc Rc Sl Sr Tfl Tfr Trl Trr Tsl Tsr */ // 9.1.6
 266 const SpeakerArrangement k91_6                   = kSpeakerL | kSpeakerR | kSpeakerC | kSpeakerLfe |
 267                                            kSpeakerLs | kSpeakerRs | kSpeakerLc | kSpeakerRc | kSpeakerSl | kSpeakerSr |
 268                                            kSpeakerTfl | kSpeakerTfr | kSpeakerTrl | kSpeakerTrr | kSpeakerTsl | kSpeakerTsr;
 269
 270 /** L R C Ls Rs Tc Tfl Tfr Trl Trr */                                   // 5.0.5
 271 const SpeakerArrangement k100                    = kSpeakerL  | kSpeakerR | kSpeakerC | kSpeakerLs  | kSpeakerRs |
 272                                            kSpeakerTc | kSpeakerTfl | kSpeakerTfr | kSpeakerTrl | kSpeakerTrr;
 273 /** L R C Lfe Ls Rs Tc Tfl Tfr Trl Trr */                               // 5.1.5
 274 const SpeakerArrangement k101                    = kSpeakerL  | kSpeakerR | kSpeakerC | kSpeakerLfe | kSpeakerLs | kSpeakerRs  |
 275                                            kSpeakerTc | kSpeakerTfl | kSpeakerTfr | kSpeakerTrl | kSpeakerTrr;
 276 const SpeakerArrangement k101MPEG3D              = k101;
 277
 278 /** L R C Lfe Ls Rs Tfl Tfc Tfr Trl Trr Lfe2 */                 // 5.2.5
 279 const SpeakerArrangement k102                    = kSpeakerL  | kSpeakerR | kSpeakerC  | kSpeakerLfe | kSpeakerLs | kSpeakerRs  |
 280                                            kSpeakerTfl| kSpeakerTfc | kSpeakerTfr | kSpeakerTrl | kSpeakerTrr | kSpeakerLfe2;
 281
 282 /** L R C Ls Rs Tc Tfl Tfc Tfr Trl Trr */                               // 5.0.6
 283 const SpeakerArrangement k110                    = kSpeakerL  | kSpeakerR | kSpeakerC | kSpeakerLs  | kSpeakerRs |
 284                                            kSpeakerTc | kSpeakerTfl | kSpeakerTfc | kSpeakerTfr | kSpeakerTrl | kSpeakerTrr;
 285 /** L R C Lfe Ls Rs Tc Tfl Tfc Tfr Trl Trr */                   // 5.1.6
 286 const SpeakerArrangement k111                    = kSpeakerL  | kSpeakerR | kSpeakerC | kSpeakerLfe | kSpeakerLs | kSpeakerRs |
 287                                            kSpeakerTc | kSpeakerTfl | kSpeakerTfc | kSpeakerTfr | kSpeakerTrl | kSpeakerTrr;
 288
 289 /** L R C Lfe Ls Rs Lc Rc Tfl Tfc Tfr Trl Trr Lfe2 */   // 7.2.5
 290 const SpeakerArrangement k122                    = kSpeakerL  | kSpeakerR | kSpeakerC  | kSpeakerLfe | kSpeakerLs | kSpeakerRs  | kSpeakerLc  | kSpeakerRc |
 291                                            kSpeakerTfl| kSpeakerTfc | kSpeakerTfr | kSpeakerTrl | kSpeakerTrr | kSpeakerLfe2;
 292 /** L R C Ls Rs Sl Sr Tc Tfl Tfc Tfr Trl Trr */                 // 7.0.6
 293 const SpeakerArrangement k130                    = kSpeakerL  | kSpeakerR | kSpeakerC | kSpeakerLs  | kSpeakerRs | kSpeakerSl | kSpeakerSr |
 294                                            kSpeakerTc | kSpeakerTfl | kSpeakerTfc | kSpeakerTfr | kSpeakerTrl | kSpeakerTrr;
 295 /** L R C Lfe Ls Rs Sl Sr Tc Tfl Tfc Tfr Trl Trr */             // 7.1.6
 296 const SpeakerArrangement k131                    = kSpeakerL  | kSpeakerR | kSpeakerC | kSpeakerLfe | kSpeakerLs | kSpeakerRs | kSpeakerSl | kSpeakerSr |
 297                                            kSpeakerTc | kSpeakerTfl | kSpeakerTfc | kSpeakerTfr | kSpeakerTrl | kSpeakerTrr;
 298
 299 /** L R Ls Rs Sl Sr Tfl Tfr Trl Trr Bfl Bfr Brl Brr  */ // 6.0.4.4
 300 const SpeakerArrangement k140                    = kSpeakerL | kSpeakerR | kSpeakerLs | kSpeakerRs | kSpeakerSl | kSpeakerSr |
 301                                            kSpeakerTfl | kSpeakerTfr | kSpeakerTrl | kSpeakerTrr |
 302                                            kSpeakerBfl | kSpeakerBfr | kSpeakerBrl | kSpeakerBrr;
 303
 304 /** L R C Ls Rs Lc Rc Cs Sl Sr Tc Tfl Tfc Tfr Trl Trc Trr Tsl Tsr Bfl Bfc Bfr */                        // 10.0.9.3
 305 const SpeakerArrangement k220                    = kSpeakerL  | kSpeakerR | kSpeakerC  | kSpeakerLs | kSpeakerRs | kSpeakerLc | kSpeakerRc | kSpeakerCs | kSpeakerSl | kSpeakerSr |
 306                                            kSpeakerTc | kSpeakerTfl | kSpeakerTfc | kSpeakerTfr | kSpeakerTrl | kSpeakerTrc | kSpeakerTrr | kSpeakerTsl | kSpeakerTsr |
 307                                            kSpeakerBfl| kSpeakerBfc | kSpeakerBfr;
 308
 309 /** L R C Lfe Ls Rs Lc Rc Cs Sl Sr Tc Tfl Tfc Tfr Trl Trc Trr Lfe2 Tsl Tsr Bfl Bfc Bfr */       // 10.2.9.3
 310 const SpeakerArrangement k222                    = kSpeakerL  | kSpeakerR | kSpeakerC  | kSpeakerLfe | kSpeakerLs | kSpeakerRs | kSpeakerLc | kSpeakerRc | kSpeakerCs | kSpeakerSl | kSpeakerSr |
 311                                            kSpeakerTc | kSpeakerTfl | kSpeakerTfc | kSpeakerTfr | kSpeakerTrl | kSpeakerTrc | kSpeakerTrr | kSpeakerLfe2 | kSpeakerTsl | kSpeakerTsr |
 312                                            kSpeakerBfl| kSpeakerBfc | kSpeakerBfr;
 313
 314 //------------------------------------------------------------------------
 315 /** Speaker Arrangement String Representation.
 316 \ingroup speakerArrangements */
 317 /*@{*/
 318 const CString kStringEmpty              = "";
 319 const CString kStringMono               = "Mono";
 320 const CString kStringStereo             = "Stereo";
 321 const CString kStringStereoR    = "Stereo (Ls Rs)";
 322 const CString kStringStereoC    = "Stereo (Lc Rc)";
 323 const CString kStringStereoSide = "Stereo (Sl Sr)";
 324 const CString kStringStereoCLfe = "Stereo (C LFE)";
 325 const CString kStringStereoTF   = "Stereo (Tfl Tfr)";
 326 const CString kStringStereoTS   = "Stereo (Tsl Tsr)";
 327 const CString kStringStereoTR   = "Stereo (Trl Trr)";
 328 const CString kStringStereoBF   = "Stereo (Bfl Bfr)";
 329 const CString kStringCineFront  = "Cine Front";
 330
 331 const CString kString30Cine             = "LRC";
 332 const CString kString30Music    = "LRS";
 333 const CString kString31Cine             = "LRC+LFE";
 334 const CString kString31Music    = "LRS+LFE";
 335 const CString kString40Cine             = "LRCS";
 336 const CString kString40Music    = "Quadro";
 337 const CString kString41Cine             = "LRCS+LFE";
 338 const CString kString41Music    = "Quadro+LFE";
 339 const CString kString50                 = "5.0";
 340 const CString kString51                 = "5.1";
 341 const CString kString60Cine             = "6.0 Cine";
 342 const CString kString60Music    = "6.0 Music";
 343 const CString kString61Cine             = "6.1 Cine";
 344 const CString kString61Music    = "6.1 Music";
 345 const CString kString70Cine             = "7.0 SDDS";
 346 const CString kString70CineOld  = "7.0 Cine (SDDS)";
 347 const CString kString70Music    = "7.0";
 348 const CString kString70MusicOld = "7.0 Music (Dolby)";
 349 const CString kString71Cine             = "7.1 SDDS";
 350 const CString kString71CineOld  = "7.1 Cine (SDDS)";
 351 const CString kString71Music    = "7.1";
 352 const CString kString71MusicOld = "7.1 Music (Dolby)";
 353 const CString kString71CineTopCenter    = "7.1 Cine Top Center";
 354 const CString kString71CineCenterHigh   = "7.1 Cine Center High";
 355 const CString kString71CineFrontHigh    = "7.1 Cine Front High";
 356 const CString kString71CineSideHigh             = "7.1 Cine Side High";
 357 const CString kString71CineFullRear             = "7.1 Cine Full Rear";
 358 const CString kString71Proximity                = "7.1 Proximity";
 359 const CString kString80Cine             = "8.0 Cine";
 360 const CString kString80Music    = "8.0 Music";
 361 const CString kString80Cube             = "8.0 Cube";
 362 const CString kString81Cine             = "8.1 Cine";
 363 const CString kString81Music    = "8.1 Music";
 364 const CString kString90Cine             = "9.0 Cine";
 365 const CString kString91Cine             = "9.1 Cine";
 366 const CString kString100Cine    = "10.0 Cine";
 367 const CString kString101Cine    = "10.1 Cine";
 368 const CString kString102                = "10.2 Experimental";
 369 const CString kString122                = "12.2";
 370 const CString kString50_4               = "5.0.4";
 371 const CString kString51_4               = "5.1.4";
 372 const CString kString70_2               = "7.0.2";
 373 const CString kString71_2               = "7.1.2";
 374 const CString kString70_4               = "7.0.4";
 375 const CString kString71_4               = "7.1.4";
 376 const CString kString70_6               = "7.0.6";
 377 const CString kString71_6               = "7.1.6";
 378 const CString kString90_4               = "9.0.4";
 379 const CString kString91_4               = "9.1.4";
 380 const CString kString90_6               = "9.0.6";
 381 const CString kString91_6               = "9.1.6";
 382 const CString kString100                = "10.0 Auro-3D";
 383 const CString kString101                = "10.1 Auro-3D";
 384 const CString kString110                = "11.0 Auro-3D";
 385 const CString kString111                = "11.1 Auro-3D";
 386 const CString kString130                = "13.0 Auro-3D";
 387 const CString kString131                = "13.1 Auro-3D";
 388 const CString kString81MPEG             = "8.1 MPEG";
 389 const CString kString140                = "14.0";
 390 const CString kString222                = "22.2";
 391 const CString kString220                = "22.0";
 392 const CString kStringAmbi1stOrder = "1st Order Ambisonics";
 393 const CString kStringAmbi2cdOrder = "2nd Order Ambisonics";
 394 const CString kStringAmbi3rdOrder = "3rd Order Ambisonics";
 395
 396 /*@}*/
 397
 398 //------------------------------------------------------------------------
 399 /** Speaker Arrangement String Representation with Speakers Name.
 400 \ingroup speakerArrangements */
 401 /*@{*/
 402 const CString kStringMonoS              = "M";
 403 const CString kStringStereoS    = "L R";
 404 const CString kStringStereoRS   = "Ls Rs";
 405 const CString kStringStereoCS   = "Lc Rc";
 406 const CString kStringStereoSS   = "Sl Sr";
 407 const CString kStringStereoCLfeS= "C LFE";
 408 const CString kStringStereoTFS  = "Tfl Tfr";
 409 const CString kStringStereoTSS  = "Tsl Tsr";
 410 const CString kStringStereoTRS  = "Trl Trr";
 411 const CString kStringStereoBFS  = "Bfl Bfr";
 412 const CString kStringCineFrontS = "L R C Lc Rc";
 413 const CString kString30CineS    = "L R C";
 414 const CString kString30MusicS   = "L R S";
 415 const CString kString31CineS    = "L R C LFE";
 416 const CString kString31MusicS   = "L R LFE S";
 417 const CString kString40CineS    = "L R C S";
 418 const CString kString40MusicS   = "L R Ls Rs";
 419 const CString kString41CineS    = "L R C LFE S";
 420 const CString kString41MusicS   = "L R LFE Ls Rs";
 421 const CString kString50S                = "L R C Ls Rs";
 422 const CString kString51S                = "L R C LFE Ls Rs";
 423 const CString kString60CineS    = "L R C Ls Rs Cs";
 424 const CString kString60MusicS   = "L R Ls Rs Sl Sr";
 425 const CString kString61CineS    = "L R C LFE Ls Rs Cs";
 426 const CString kString61MusicS   = "L R LFE Ls Rs Sl Sr";
 427 const CString kString70CineS    = "L R C Ls Rs Lc Rc";
 428 const CString kString70MusicS   = "L R C Ls Rs Sl Sr";
 429 const CString kString71CineS    = "L R C LFE Ls Rs Lc Rc";
 430 const CString kString71MusicS   = "L R C LFE Ls Rs Sl Sr";
 431 const CString kString80CineS    = "L R C Ls Rs Lc Rc Cs";
 432 const CString kString80MusicS   = "L R C Ls Rs Cs Sl Sr";
 433 const CString kString81CineS    = "L R C LFE Ls Rs Lc Rc Cs";
 434 const CString kString81MusicS   = "L R C LFE Ls Rs Cs Sl Sr";
 435 const CString kString80CubeS    = "L R Ls Rs Tfl Tfr Trl Trr";
 436 const CString kString71CineTopCenterS   = "L R C LFE Ls Rs Cs Tc";
 437 const CString kString71CineCenterHighS  = "L R C LFE Ls Rs Cs Tfc";
 438 const CString kString71CineFrontHighS   = "L R C LFE Ls Rs Tfl Tfl";
 439 const CString kString71CineSideHighS    = "L R C LFE Ls Rs Tsl Tsl";
 440 const CString kString71CineFullRearS    = "L R C LFE Ls Rs Lcs Rcs";
 441 const CString kString71ProximityS               = "L R C LFE Ls Rs Pl Pr";
 442 const CString kString90CineS    = "L R C Ls Rs Lc Rc Sl Sr";
 443 const CString kString91CineS    = "L R C Lfe Ls Rs Lc Rc Sl Sr";
 444 const CString kString100CineS   = "L R C Ls Rs Lc Rc Cs Sl Sr";
 445 const CString kString101CineS   = "L R C Lfe Ls Rs Lc Rc Cs Sl Sr";
 446 const CString kString50_4S              = "L R C Ls Rs Tfl Tfr Trl Trr";
 447 const CString kString51_4S              = "L R C LFE Ls Rs Tfl Tfr Trl Trr";
 448 const CString kString70_2S              = "L R C Ls Rs Sl Sr Tsl Tsr";
 449 const CString kString71_2S              = "L R C LFE Ls Rs Sl Sr Tsl Tsr";
 450 const CString kString70_4S              = "L R C Ls Rs Sl Sr Tfl Tfr Trl Trr";
 451 const CString kString71_4S              = "L R C LFE Ls Rs Sl Sr Tfl Tfr Trl Trr";
 452 const CString kString70_6S              = "L R C Ls Rs Sl Sr Tfl Tfr Trl Trr Tsl Tsr";
 453 const CString kString71_6S              = "L R C LFE Ls Rs Sl Sr Tfl Tfr Trl Trr Tsl Tsr";
 454 const CString kString90_4S              = "L R C Ls Rs Lc Rc Sl Sr Tfl Tfr Trl Trr";
 455 const CString kString91_4S              = "L R C LFE Ls Rs Lc Rc Sl Sr Tfl Tfr Trl Trr";
 456 const CString kString90_6S              = "L R C Ls Rs Lc Rc Sl Sr Tfl Tfr Trl Trr Tsl Tsr";
 457 const CString kString91_6S              = "L R C LFE Ls Rs Lc Rc Sl Sr Tfl Tfr Trl Trr Tsl Tsr";
 458 const CString kString100S               = "L R C Ls Rs Tc Tfl Tfr Trl Trr";
 459 const CString kString101S               = "L R C LFE Ls Rs Tc Tfl Tfr Trl Trr";
 460 const CString kString110S               = "L R C Ls Rs Tc Tfl Tfc Tfr Trl Trr";
 461 const CString kString111S               = "L R C LFE Ls Rs Tc Tfl Tfc Tfr Trl Trr";
 462 const CString kString130S               = "L R C Ls Rs Sl Sr Tc Tfl Tfc Tfr Trl Trr";
 463 const CString kString131S               = "L R C LFE Ls Rs Sl Sr Tc Tfl Tfc Tfr Trl Trr";
 464 const CString kString102S               = "L R C LFE Ls Rs Tfl Tfc Tfr Trl Trr LFE2";
 465 const CString kString122S               = "L R C LFE Ls Rs Lc Rc Tfl Tfc Tfr Trl Trr LFE2";
 466 const CString kString81MPEGS    = "L R LFE Ls Rs Tfl Tfc Tfr Bfc";
 467 const CString kString140S               = "L R Ls Rs Sl Sr Tfl Tfr Trl Trr Bfl Bfr Brl Brr";
 468 const CString kString222S               = "L R C LFE Ls Rs Lc Rc Cs Sl Sr Tc Tfl Tfc Tfr Trl Trc Trr LFE2 Tsl Tsr Bfl Bfc Bfr";
 469 const CString kString220S               = "L R C Ls Rs Lc Rc Cs Sl Sr Tc Tfl Tfc Tfr Trl Trc Trr Tsl Tsr Bfl Bfc Bfr";
 470
 471 const CString kStringAmbi1stOrderS      = "0 1 2 3";
 472 const CString kStringAmbi2cdOrderS      = "0 1 2 3 4 5 6 7 8";
 473 const CString kStringAmbi3rdOrderS      = "0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15";
 474 /*@}*/
 475
 476 //------------------------------------------------------------------------
 477 /** Returns number of channels used in speaker arrangement.
 478 \ingroup speakerArrangements */
 479 /*@{*/
 480 inline int32 getChannelCount (SpeakerArrangement arr)
 481 {
 482         int32 count = 0;
 483         while (arr)
 484         {
 485                 if (arr & (SpeakerArrangement)1)
 486                         ++count;
 487                 arr >>= 1;
 488         }
 489         return count;
 490 }
 491
 492 //------------------------------------------------------------------------
 493 /** Returns the index of a given speaker in a speaker arrangement (-1 if speaker is not part of the
 494  * arrangement). */
 495 inline int32 getSpeakerIndex (Speaker speaker, SpeakerArrangement arrangement)
 496 {
 497         // check if speaker is present in arrangement
 498         if ((arrangement & speaker) == 0)
 499                 return -1;
 500
 501         int32 result = 0;
 502         Speaker i = 1;
 503         while (i < speaker)
 504         {
 505                 if (arrangement & i)
 506                         result++;
 507                 i <<= 1;
 508         }
 509
 510         return result;
 511 }
 512
 513 //------------------------------------------------------------------------
 514 /** Returns the speaker for a given index in a speaker arrangement (return 0 when out of range). */
 515 inline Speaker getSpeaker (const SpeakerArrangement& arr, int32 index)
 516 {
 517         SpeakerArrangement arrTmp = arr;
 518
 519         int32 index2 = -1;
 520         int32 pos = -1;
 521         while (arrTmp)
 522         {
 523                 if (arrTmp & 0x1)
 524                         index2++;
 525                 pos++;
 526                 if (index2 == index)
 527                         return (Speaker)1 << pos;
 528
 529                 arrTmp = arrTmp >> 1;
 530         }
 531         return 0;
 532 }
 533
 534 //------------------------------------------------------------------------
 535 /** Returns true if arrSubSet is a subset speaker of arr (means each speaker of arrSubSet is
 536  * included in arr). */
 537 inline bool isSubsetOf (const SpeakerArrangement& arrSubSet, const SpeakerArrangement& arr)
 538 {
 539         return (arrSubSet == (arrSubSet & arr));
 540 }
 541
 542 //------------------------------------------------------------------------
 543 /** Returns true if arrangement is a Auro configuration. */
 544 inline bool isAuro (const SpeakerArrangement& arr)
 545 {
 546         if (arr == k90 || arr == k91 || arr == k100 || arr == k101 || arr == k110 || arr == k111 ||
 547             arr == k130 || arr == k131)
 548         {
 549                 return true;
 550         }
 551         return false;
 552 }
 553
 554 //------------------------------------------------------------------------
 555 /** Returns true if arrangement contains top (upper layer) speakers */
 556 inline bool hasTopSpeakers (const SpeakerArrangement& arr)
 557 {
 558         if (arr & kSpeakerTc || arr & kSpeakerTfl || arr & kSpeakerTfc || arr & kSpeakerTfr ||
 559             arr & kSpeakerTrl || arr & kSpeakerTrc || arr & kSpeakerTrr || arr & kSpeakerTsl ||
 560             arr & kSpeakerTsr)
 561                 return true;
 562         return false;
 563 }
 564
 565 //------------------------------------------------------------------------
 566 /** Returns true if arrangement contains bottom (lower layer) speakers */
 567 inline bool hasBottomSpeakers (const SpeakerArrangement& arr)
 568 {
 569         if (arr & kSpeakerBfl || arr & kSpeakerBfc || arr & kSpeakerBfl || arr & kSpeakerBfc ||
 570             arr & kSpeakerBfr)
 571                 return true;
 572         return false;
 573 }
 574
 575 //------------------------------------------------------------------------
 576 /** Returns true if arrangement contains middle layer (at ears level) speakers */
 577 inline bool hasMiddleSpeakers (const SpeakerArrangement& arr)
 578 {
 579         if (arr & kSpeakerL || arr & kSpeakerR || arr & kSpeakerC || arr & kSpeakerLs ||
 580             arr & kSpeakerRs || arr & kSpeakerLc || arr & kSpeakerRc || arr & kSpeakerCs ||
 581             arr & kSpeakerSl || arr & kSpeakerSr || arr & kSpeakerM || arr & kSpeakerPl ||
 582             arr & kSpeakerPr || arr & kSpeakerLcs || arr & kSpeakerRcs)
 583                 return true;
 584         return false;
 585 }
 586
 587 //------------------------------------------------------------------------
 588 /** Returns true if arrangement contains LFE speakers */
 589 inline bool hasLfe (const SpeakerArrangement& arr)
 590 {
 591         if (arr & kSpeakerLfe || arr & kSpeakerLfe2)
 592                 return true;
 593         return false;
 594 }
 595
 596 //------------------------------------------------------------------------
 597 /** Returns true if arrangement is a 3D configuration ((top or bottom) and middle) */
 598 inline bool is3D (const SpeakerArrangement& arr)
 599 {
 600         bool top = hasTopSpeakers (arr);
 601         bool bottom = hasBottomSpeakers (arr);
 602         bool middle = hasMiddleSpeakers (arr);
 603
 604         if (((top || bottom) && middle) || (top && bottom))
 605                 return true;
 606         return false;
 607 }
 608
 609 //------------------------------------------------------------------------
 610 /** Returns true if arrangement is a Auro configuration. */
 611 inline bool isAmbisonics (const SpeakerArrangement& arr)
 612 {
 613         if (arr == kAmbi1stOrderACN || arr == kAmbi2cdOrderACN || arr == kAmbi3rdOrderACN)
 614         {
 615                 return true;
 616         }
 617         return false;
 618 }
 619
 620 //------------------------------------------------------------------------
 621 /** Returns the speaker arrangement associated to a string representation.
 622     Returns kEmpty if no associated arrangement is known. */
 623 inline SpeakerArrangement getSpeakerArrangementFromString (CString arrStr)
 624 {
 625         if (!strcmp8 (arrStr, kStringMono))
 626                 return kMono;
 627         if (!strcmp8 (arrStr, kStringStereo))
 628                 return kStereo;
 629         if (!strcmp8 (arrStr, kStringStereoR))
 630                 return kStereoSurround;
 631         if (!strcmp8 (arrStr, kStringStereoC))
 632                 return kStereoCenter;
 633         if (!strcmp8 (arrStr, kStringStereoSide))
 634                 return kStereoSide;
 635         if (!strcmp8 (arrStr, kStringStereoCLfe))
 636                 return kStereoCLfe;
 637         if (!strcmp8 (arrStr, kStringStereoTF))
 638                 return kStereoTF;
 639         if (!strcmp8 (arrStr, kStringStereoTS))
 640                 return kStereoTS;
 641         if (!strcmp8 (arrStr, kStringStereoTR))
 642                 return kStereoTR;
 643         if (!strcmp8 (arrStr, kStringStereoBF))
 644                 return kStereoBF;
 645         if (!strcmp8 (arrStr, kStringCineFront))
 646                 return kCineFront;
 647         if (!strcmp8 (arrStr, kString30Cine))
 648                 return k30Cine;
 649         if (!strcmp8 (arrStr, kString30Music))
 650                 return k30Music;
 651         if (!strcmp8 (arrStr, kString31Cine))
 652                 return k31Cine;
 653         if (!strcmp8 (arrStr, kString31Music))
 654                 return k31Music;
 655         if (!strcmp8 (arrStr, kString40Cine))
 656                 return k40Cine;
 657         if (!strcmp8 (arrStr, kString40Music))
 658                 return k40Music;
 659         if (!strcmp8 (arrStr, kString41Cine))
 660                 return k41Cine;
 661         if (!strcmp8 (arrStr, kString41Music))
 662                 return k41Music;
 663         if (!strcmp8 (arrStr, kString50))
 664                 return k50;
 665         if (!strcmp8 (arrStr, kString51))
 666                 return k51;
 667         if (!strcmp8 (arrStr, kString60Cine))
 668                 return k60Cine;
 669         if (!strcmp8 (arrStr, kString60Music))
 670                 return k60Music;
 671         if (!strcmp8 (arrStr, kString61Cine))
 672                 return k61Cine;
 673         if (!strcmp8 (arrStr, kString61Music))
 674                 return k61Music;
 675         if (!strcmp8 (arrStr, kString70Cine) || !strcmp8 (arrStr, kString70CineOld))
 676                 return k70Cine;
 677         if (!strcmp8 (arrStr, kString70Music) || !strcmp8 (arrStr, kString70MusicOld))
 678                 return k70Music;
 679         if (!strcmp8 (arrStr, kString71Cine) || !strcmp8 (arrStr, kString71CineOld))
 680                 return k71Cine;
 681         if (!strcmp8 (arrStr, kString71Music) || !strcmp8 (arrStr, kString71MusicOld))
 682                 return k71Music;
 683         if (!strcmp8 (arrStr, kString71Proximity))
 684                 return k71Proximity;
 685         if (!strcmp8 (arrStr, kString80Cine))
 686                 return k80Cine;
 687         if (!strcmp8 (arrStr, kString80Music))
 688                 return k80Music;
 689         if (!strcmp8 (arrStr, kString81Cine))
 690                 return k81Cine;
 691         if (!strcmp8 (arrStr, kString81Music))
 692                 return k81Music;
 693         if (!strcmp8 (arrStr, kString102))
 694                 return k102;
 695         if (!strcmp8 (arrStr, kString122))
 696                 return k122;
 697         if (!strcmp8 (arrStr, kString80Cube))
 698                 return k80Cube;
 699         if (!strcmp8 (arrStr, kString71CineTopCenter))
 700                 return k71CineTopCenter;
 701         if (!strcmp8 (arrStr, kString71CineCenterHigh))
 702                 return k71CineCenterHigh;
 703         if (!strcmp8 (arrStr, kString71CineFrontHigh))
 704                 return k71CineFrontHigh;
 705         if (!strcmp8 (arrStr, kString71CineSideHigh))
 706                 return k71CineSideHigh;
 707         if (!strcmp8 (arrStr, kString71CineFullRear))
 708                 return k71CineFullRear;
 709         if (!strcmp8 (arrStr, kString90Cine))
 710                 return k90Cine;
 711         if (!strcmp8 (arrStr, kString91Cine))
 712                 return k91Cine;
 713         if (!strcmp8 (arrStr, kString100Cine))
 714                 return k100Cine;
 715         if (!strcmp8 (arrStr, kString101Cine))
 716                 return k101Cine;
 717         if (!strcmp8 (arrStr, kString50_4))
 718                 return k50_4;
 719         if (!strcmp8 (arrStr, kString51_4))
 720                 return k51_4;
 721         if (!strcmp8 (arrStr, kString81MPEG))
 722                 return k81MPEG3D;
 723         if (!strcmp8 (arrStr, kString70_2))
 724                 return k70_2;
 725         if (!strcmp8 (arrStr, kString71_2))
 726                 return k71_2;
 727         if (!strcmp8 (arrStr, kString70_4))
 728                 return k70_4;
 729         if (!strcmp8 (arrStr, kString71_4))
 730                 return k71_4;
 731         if (!strcmp8 (arrStr, kString70_6))
 732                 return k70_6;
 733         if (!strcmp8 (arrStr, kString71_6))
 734                 return k71_6;
 735         if (!strcmp8 (arrStr, kString90_4))
 736                 return k90_4;
 737         if (!strcmp8 (arrStr, kString91_4))
 738                 return k91_4;
 739         if (!strcmp8 (arrStr, kString90_6))
 740                 return k90_6;
 741         if (!strcmp8 (arrStr, kString91_6))
 742                 return k91_6;
 743         if (!strcmp8 (arrStr, kString100))
 744                 return k100;
 745         if (!strcmp8 (arrStr, kString101))
 746                 return k101;
 747         if (!strcmp8 (arrStr, kString110))
 748                 return k110;
 749         if (!strcmp8 (arrStr, kString111))
 750                 return k111;
 751         if (!strcmp8 (arrStr, kString130))
 752                 return k130;
 753         if (!strcmp8 (arrStr, kString131))
 754                 return k131;
 755         if (!strcmp8 (arrStr, kString140))
 756                 return k140;
 757         if (!strcmp8 (arrStr, kString222))
 758                 return k222;
 759         if (!strcmp8 (arrStr, kString220))
 760                 return k220;
 761         if (!strcmp8 (arrStr, kStringAmbi1stOrder))
 762                 return kAmbi1stOrderACN;
 763         if (!strcmp8 (arrStr, kStringAmbi2cdOrder))
 764                 return kAmbi2cdOrderACN;
 765         if (!strcmp8 (arrStr, kStringAmbi3rdOrder))
 766                 return kAmbi3rdOrderACN;
 767         return kEmpty;
 768 }
 769
 770 //------------------------------------------------------------------------
 771 /** Returns the string representation of a given speaker arrangement.
 772     Returns kStringEmpty if arr is unknown. */
 773 inline CString getSpeakerArrangementString (SpeakerArrangement arr, bool withSpeakersName)
 774 {
 775         switch (arr)
 776         {
 777                 case kMono:                             return withSpeakersName ? kStringMonoS          : kStringMono;
 778                 case kStereo:                   return withSpeakersName ? kStringStereoS        : kStringStereo;
 779                 case kStereoSurround:   return withSpeakersName ? kStringStereoRS       : kStringStereoR;
 780                 case kStereoCenter:             return withSpeakersName ? kStringStereoCS       : kStringStereoC;
 781                 case kStereoSide:               return withSpeakersName ? kStringStereoSS       : kStringStereoSide;
 782                 case kStereoCLfe:               return withSpeakersName ? kStringStereoCLfeS: kStringStereoCLfe;
 783                 case kStereoTF:                 return withSpeakersName ? kStringStereoTFS      : kStringStereoTF;
 784                 case kStereoTS:                 return withSpeakersName ? kStringStereoTSS      : kStringStereoTS;
 785                 case kStereoTR:                 return withSpeakersName ? kStringStereoTRS      : kStringStereoTR;
 786                 case kStereoBF:                 return withSpeakersName ? kStringStereoBFS      : kStringStereoBF;
 787                 case kCineFront:                return withSpeakersName ? kStringCineFrontS : kStringCineFront;
 788                 case k30Cine:                   return withSpeakersName ? kString30CineS        : kString30Cine;
 789                 case k30Music:                  return withSpeakersName ? kString30MusicS       : kString30Music;
 790                 case k31Cine:                   return withSpeakersName ? kString31CineS        : kString31Cine;
 791                 case k31Music:                  return withSpeakersName ? kString31MusicS       : kString31Music;
 792                 case k40Cine:                   return withSpeakersName ? kString40CineS        : kString40Cine;
 793                 case k40Music:                  return withSpeakersName ? kString40MusicS       : kString40Music;
 794                 case k41Cine:                   return withSpeakersName ? kString41CineS        : kString41Cine;
 795                 case k41Music:                  return withSpeakersName ? kString41MusicS       : kString41Music;
 796                 case k50:                               return withSpeakersName ? kString50S            : kString50;
 797                 case k51:                               return withSpeakersName ? kString51S            : kString51;
 798                 case k60Cine:                   return withSpeakersName ? kString60CineS        : kString60Cine;
 799                 case k60Music:                  return withSpeakersName ? kString60MusicS       : kString60Music;
 800                 case k61Cine:                   return withSpeakersName ? kString61CineS        : kString61Cine;
 801                 case k61Music:                  return withSpeakersName ? kString61MusicS       : kString61Music;
 802                 case k70Cine:                   return withSpeakersName ? kString70CineS        : kString70Cine;
 803                 case k70Music:                  return withSpeakersName ? kString70MusicS       : kString70Music;
 804                 case k71Cine:                   return withSpeakersName ? kString71CineS        : kString71Cine;
 805                 case k71Music:                  return withSpeakersName ? kString71MusicS       : kString71Music;
 806                 case k71Proximity:              return withSpeakersName ? kString71ProximityS : kString71Proximity;
 807                 case k80Cine:                   return withSpeakersName ? kString80CineS        : kString80Cine;
 808                 case k80Music:                  return withSpeakersName ? kString80MusicS       : kString80Music;
 809                 case k81Cine:                   return withSpeakersName ? kString81CineS        : kString81Cine;
 810                 case k81Music:                  return withSpeakersName ? kString81MusicS       : kString81Music;
 811                 case k81MPEG3D:                 return withSpeakersName ? kString81MPEGS        : kString81MPEG;
 812                 case k102:                              return withSpeakersName ? kString102S           : kString102;
 813                 case k122:                              return withSpeakersName ? kString122S           : kString122;
 814                 case k80Cube:                   return withSpeakersName ? kString80CubeS        : kString80Cube;
 815                 case k71CineTopCenter:  return withSpeakersName ? kString71CineTopCenterS       : kString71CineTopCenter;
 816                 case k71CineCenterHigh: return withSpeakersName ? kString71CineCenterHighS      : kString71CineCenterHigh;
 817                 case k71CineFrontHigh:  return withSpeakersName ? kString71CineFrontHighS       : kString71CineFrontHigh;
 818                 case k71CineSideHigh:   return withSpeakersName ? kString71CineSideHighS        : kString71CineSideHigh;
 819                 case k71CineFullRear:   return withSpeakersName ? kString71CineFullRearS        : kString71CineFullRear;
 820                 case k90Cine:                   return withSpeakersName ? kString90CineS        : kString90Cine;
 821                 case k91Cine:                   return withSpeakersName ? kString91CineS        : kString91Cine;
 822                 case k100Cine:                  return withSpeakersName ? kString100CineS       : kString100Cine;
 823                 case k101Cine:                  return withSpeakersName ? kString101CineS       : kString101Cine;
 824                 case k100:                              return withSpeakersName ? kString100S           : kString100;
 825                 case k101:                              return withSpeakersName ? kString101S           : kString101;
 826                 case k110:                              return withSpeakersName ? kString110S           : kString110;
 827                 case k111:                              return withSpeakersName ? kString111S           : kString111;
 828
 829                 case k50_4:                             return withSpeakersName ? kString50_4S          : kString50_4;
 830                 case k51_4:                             return withSpeakersName ? kString51_4S          : kString51_4;
 831                 case k70_2:                             return withSpeakersName ? kString70_2S          : kString70_2;
 832                 case k71_2:                             return withSpeakersName ? kString71_2S          : kString71_2;
 833                 case k70_4:                             return withSpeakersName ? kString70_4S          : kString70_4;
 834                 case k71_4:                             return withSpeakersName ? kString71_4S          : kString71_4;
 835                 case k70_6:                             return withSpeakersName ? kString70_6S          : kString70_6;
 836                 case k71_6:                             return withSpeakersName ? kString71_6S          : kString71_6;
 837                 case k90_4:                             return withSpeakersName ? kString90_4S          : kString90_4;
 838                 case k91_4:                             return withSpeakersName ? kString91_4S          : kString91_4;
 839                 case k90_6:                             return withSpeakersName ? kString90_6S          : kString90_6;
 840                 case k91_6:                             return withSpeakersName ? kString91_6S          : kString91_6;
 841                 case k130:                              return withSpeakersName ? kString130S           : kString130;
 842                 case k131:                              return withSpeakersName ? kString131S           : kString131;
 843                 case k140:                              return withSpeakersName ? kString140S           : kString140;
 844                 case k222:                              return withSpeakersName ? kString222S           : kString222;
 845                 case k220:                              return withSpeakersName ? kString220S           : kString220;
 846                         break;
 847         }
 848
 849         if (arr == kAmbi1stOrderACN)
 850                 return withSpeakersName ? kStringAmbi1stOrderS : kStringAmbi1stOrder;
 851         if (arr == kAmbi2cdOrderACN)
 852                 return withSpeakersName ? kStringAmbi2cdOrderS : kStringAmbi2cdOrder;
 853         if (arr == kAmbi3rdOrderACN)
 854                 return withSpeakersName ? kStringAmbi3rdOrderS : kStringAmbi3rdOrder;
 855
 856         return kStringEmpty;
 857 }
 858
 859 //------------------------------------------------------------------------
 860 /** Returns a CString representation of a given speaker in a given arrangement */
 861 inline CString getSpeakerShortName (const SpeakerArrangement& arr, int32 index)
 862 {
 863         SpeakerArrangement arrTmp = arr;
 864
 865         bool found = false;
 866         int32 index2 = -1;
 867         int32 pos = -1;
 868         while (arrTmp)
 869         {
 870                 if (arrTmp & 0x1)
 871                         index2++;
 872                 pos++;
 873                 if (index2 == index)
 874                 {
 875                         found = true;
 876                         break;
 877                 }
 878                 arrTmp = arrTmp >> 1;
 879         }
 880
 881         if (!found)
 882                 return "";
 883
 884         Speaker speaker = (Speaker)1 << pos;
 885         if (speaker == kSpeakerL)
 886                 return "L";
 887         if (speaker == kSpeakerR)
 888                 return "R";
 889         if (speaker == kSpeakerC)
 890                 return "C";
 891         if (speaker == kSpeakerLfe)
 892                 return "LFE";
 893         if (speaker == kSpeakerLs)
 894                 return "Ls";
 895         if (speaker == kSpeakerRs)
 896                 return "Rs";
 897         if (speaker == kSpeakerLc)
 898                 return "Lc";
 899         if (speaker == kSpeakerRc)
 900                 return "Rc";
 901         if (speaker == kSpeakerCs)
 902                 return "S";
 903         if (speaker == kSpeakerSl)
 904                 return "Sl";
 905         if (speaker == kSpeakerSr)
 906                 return "Sr";
 907         if (speaker == kSpeakerTc)
 908                 return "Tc";
 909         if (speaker == kSpeakerTfl)
 910                 return "Tfl";
 911         if (speaker == kSpeakerTfc)
 912                 return "Tfc";
 913         if (speaker == kSpeakerTfr)
 914                 return "Tfr";
 915         if (speaker == kSpeakerTrl)
 916                 return "Trl";
 917         if (speaker == kSpeakerTrc)
 918                 return "Trc";
 919         if (speaker == kSpeakerTrr)
 920                 return "Trr";
 921         if (speaker == kSpeakerLfe2)
 922                 return "LFE2";
 923         if (speaker == kSpeakerM)
 924                 return "M";
 925
 926         if (speaker == kSpeakerACN0)
 927                 return "0";
 928         if (speaker == kSpeakerACN1)
 929                 return "1";
 930         if (speaker == kSpeakerACN2)
 931                 return "2";
 932         if (speaker == kSpeakerACN3)
 933                 return "3";
 934         if (speaker == kSpeakerACN4)
 935                 return "4";
 936         if (speaker == kSpeakerACN5)
 937                 return "5";
 938         if (speaker == kSpeakerACN6)
 939                 return "6";
 940         if (speaker == kSpeakerACN7)
 941                 return "7";
 942         if (speaker == kSpeakerACN8)
 943                 return "8";
 944         if (speaker == kSpeakerACN9)
 945                 return "9";
 946         if (speaker == kSpeakerACN10)
 947                 return "10";
 948         if (speaker == kSpeakerACN11)
 949                 return "11";
 950         if (speaker == kSpeakerACN12)
 951                 return "12";
 952         if (speaker == kSpeakerACN13)
 953                 return "13";
 954         if (speaker == kSpeakerACN14)
 955                 return "14";
 956         if (speaker == kSpeakerACN15)
 957                 return "15";
 958
 959         if (speaker == kSpeakerTsl)
 960                 return "Tsl";
 961         if (speaker == kSpeakerTsr)
 962                 return "Tsr";
 963         if (speaker == kSpeakerLcs)
 964                 return "Lcs";
 965         if (speaker == kSpeakerRcs)
 966                 return "Rcs";
 967
 968         if (speaker == kSpeakerBfl)
 969                 return "Bfl";
 970         if (speaker == kSpeakerBfc)
 971                 return "Bfc";
 972         if (speaker == kSpeakerBfr)
 973                 return "Bfr";
 974         if (speaker == kSpeakerPl)
 975                 return "Pl";
 976         if (speaker == kSpeakerPr)
 977                 return "Pr";
 978         if (speaker == kSpeakerBsl)
 979                 return "Bsl";
 980         if (speaker == kSpeakerBsr)
 981                 return "Bsr";
 982         if (speaker == kSpeakerBrl)
 983                 return "Brl";
 984         if (speaker == kSpeakerBrc)
 985                 return "Brc";
 986         if (speaker == kSpeakerBrr)
 987                 return "Brr";
 988
 989         return "";
 990 }
 991
 992 /*@}*/
 993
 994 //------------------------------------------------------------------------
 995 } // namespace SpeakerArr
 996 } // namespace Vst
 997 } // namespace Steinberg