falkTX
/
Carla
mirror of https://github.com/falkTX/Carla
1
0
Fork 0
Code Releases 42 Activity
Audio plugin host https://kx.studio/carla
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
3441 Commits
16 Branches
200MB
Tree: f9387f9a34
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'f9387f9a34'
${ noResults }
Carla/source/modules/juce_audio_basics/buffers/juce_AudioChannelSet.cpp

337 lines
16KB
Raw Blame History 

  1. /*

  2.   ==============================================================================

  3. 

  4.    This file is part of the JUCE library.

  5.    Copyright (c) 2015 - ROLI Ltd.

  6. 

  7.    Permission is granted to use this software under the terms of either:

  8.    a) the GPL v2 (or any later version)

  9.    b) the Affero GPL v3

  10. 

  11.    Details of these licenses can be found at: www.gnu.org/licenses

  12. 

  13.    JUCE is distributed in the hope that it will be useful, but WITHOUT ANY

  14.    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR

  15.    A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

  16. 

  17.    ------------------------------------------------------------------------------

  18. 

  19.    To release a closed-source product which uses JUCE, commercial licenses are

  20.    available: visit www.juce.com for more information.

  21. 

  22.   ==============================================================================

  23. */

  24. 

  25. AudioChannelSet::AudioChannelSet (uint32 c) : channels (c) {}

  26. 

  27. bool AudioChannelSet::operator== (const AudioChannelSet& other) const noexcept  { return channels == other.channels; }

  28. bool AudioChannelSet::operator!= (const AudioChannelSet& other) const noexcept  { return channels != other.channels; }

  29. bool AudioChannelSet::operator<  (const AudioChannelSet& other) const noexcept  { return channels <  other.channels; }

  30. 

  31. String AudioChannelSet::getChannelTypeName (AudioChannelSet::ChannelType type)

  32. {

  33.     if (type >= discreteChannel0)

  34.         return String ("Discrete ") + String (type - discreteChannel0 + 1);

  35. 

  36.     switch (type)

  37.     {

  38.         case left:                return NEEDS_TRANS("Left");

  39.         case right:               return NEEDS_TRANS("Right");

  40.         case centre:              return NEEDS_TRANS("Centre");

  41.         case LFE:                 return NEEDS_TRANS("LFE");

  42.         case leftSurround:        return NEEDS_TRANS("Left Surround");

  43.         case rightSurround:       return NEEDS_TRANS("Right Surround");

  44.         case leftCentre:          return NEEDS_TRANS("Left Centre");

  45.         case rightCentre:         return NEEDS_TRANS("Right Centre");

  46.         case centreSurround:      return NEEDS_TRANS("Centre Surround");

  47.         case leftSurroundRear:    return NEEDS_TRANS("Left Surround Rear");

  48.         case rightSurroundRear:   return NEEDS_TRANS("Right Surround Rear");

  49.         case topMiddle:           return NEEDS_TRANS("Top Middle");

  50.         case topFrontLeft:        return NEEDS_TRANS("Top Front Left");

  51.         case topFrontCentre:      return NEEDS_TRANS("Top Front Centre");

  52.         case topFrontRight:       return NEEDS_TRANS("Top Front Right");

  53.         case topRearLeft:         return NEEDS_TRANS("Top Rear Left");

  54.         case topRearCentre:       return NEEDS_TRANS("Top Rear Centre");

  55.         case topRearRight:        return NEEDS_TRANS("Top Rear Right");

  56.         case wideLeft:            return NEEDS_TRANS("Wide Left");

  57.         case wideRight:           return NEEDS_TRANS("Wide Right");

  58.         case LFE2:                return NEEDS_TRANS("LFE 2");

  59.         case leftSurroundSide:    return NEEDS_TRANS ("Left Surround Side");

  60.         case rightSurroundSide:   return NEEDS_TRANS ("Right Surround Side");

  61.         case ambisonicW:          return NEEDS_TRANS("Ambisonic W");

  62.         case ambisonicX:          return NEEDS_TRANS("Ambisonic X");

  63.         case ambisonicY:          return NEEDS_TRANS("Ambisonic Y");

  64.         case ambisonicZ:          return NEEDS_TRANS("Ambisonic Z");

  65.         default:                  break;

  66.     }

  67. 

  68.     return "Unknown";

  69. }

  70. 

  71. String AudioChannelSet::getAbbreviatedChannelTypeName (AudioChannelSet::ChannelType type)

  72. {

  73.     if (type >= discreteChannel0)

  74.         return String (type - discreteChannel0 + 1);

  75. 

  76.     switch (type)

  77.     {

  78.         case left:                return "L";

  79.         case right:               return "R";

  80.         case centre:              return "C";

  81.         case LFE:                 return "Lfe";

  82.         case leftSurround:        return "Ls";

  83.         case rightSurround:       return "Rs";

  84.         case leftCentre:          return "Lc";

  85.         case rightCentre:         return "Rc";

  86.         case centreSurround:      return "Cs";

  87.         case leftSurroundRear:    return "Lrs";

  88.         case rightSurroundRear:   return "Rrs";

  89.         case topMiddle:           return "Tm";

  90.         case topFrontLeft:        return "Tfl";

  91.         case topFrontCentre:      return "Tfc";

  92.         case topFrontRight:       return "Tfr";

  93.         case topRearLeft:         return "Trl";

  94.         case topRearCentre:       return "Trc";

  95.         case topRearRight:        return "Trr";

  96.         case wideLeft:            return "Wl";

  97.         case wideRight:           return "Wr";

  98.         case LFE2:                return "Lfe2";

  99.         case leftSurroundSide:    return "Lss";

  100.         case rightSurroundSide:   return "Rss";

  101.         case ambisonicW:          return "W";

  102.         case ambisonicX:          return "X";

  103.         case ambisonicY:          return "Y";

  104.         case ambisonicZ:          return "Z";

  105.         default:                  break;

  106.     }

  107. 

  108.     return "";

  109. }

  110. 

  111. String AudioChannelSet::getSpeakerArrangementAsString() const

  112. {

  113.     StringArray speakerTypes;

  114.     Array<AudioChannelSet::ChannelType> speakers = getChannelTypes();

  115. 

  116.     for (int i = 0; i < speakers.size(); ++i)

  117.     {

  118.         String name = getAbbreviatedChannelTypeName (speakers.getReference (i));

  119. 

  120.         if (name.isNotEmpty())

  121.             speakerTypes.add (name);

  122.     }

  123. 

  124.     return speakerTypes.joinIntoString (" ");

  125. }

  126. 

  127. String AudioChannelSet::getDescription() const

  128. {

  129.     if (isDiscreteLayout())            return String ("Discrete #") + String (size());

  130.     if (*this == disabled())           return "Disabled";

  131.     if (*this == mono())               return "Mono";

  132.     if (*this == stereo())             return "Stereo";

  133. 

  134.     if (*this == createLCR())          return "LCR";

  135.     if (*this == createLRS())          return "LRS";

  136.     if (*this == createLCRS())         return "LCRS";

  137. 

  138.     if (*this == create5point0())      return "5.1 Surround";

  139.     if (*this == create5point1())      return "5.1 Surround (+Lfe)";

  140.     if (*this == create6point0())      return "6.1 Surround";

  141.     if (*this == create6point1())      return "6.1 Surround (+Lfe)";

  142.     if (*this == create6point0Music()) return "6.1 (Music) Surround";

  143.     if (*this == create6point1Music()) return "6.1 (Music) Surround (+Lfe)";

  144.     if (*this == create7point0())      return "7.1 Surround";

  145.     if (*this == create7point1())      return "7.1 Surround (Lfe)";

  146.     if (*this == create7point0SDDS())  return "7.1 Surround SDDS";

  147.     if (*this == create7point1SDDS())  return "7.1 Surround SDDS (+Lfe)";

  148. 

  149.     if (*this == quadraphonic())       return "Quadraphonic";

  150.     if (*this == pentagonal())         return "Pentagonal";

  151.     if (*this == hexagonal())          return "Hexagonal";

  152.     if (*this == octagonal())          return "Octagonal";

  153.     if (*this == ambisonic())          return "Ambisonic";

  154. 

  155. 

  156. 

  157.     return "Unknown";

  158. }

  159. 

  160. bool AudioChannelSet::isDiscreteLayout() const noexcept

  161. {

  162.     Array<AudioChannelSet::ChannelType> speakers = getChannelTypes();

  163.     for (int i = 0; i < speakers.size(); ++i)

  164.         if (speakers.getReference (i) > ambisonicZ)

  165.             return true;

  166. 

  167.     return false;

  168. }

  169. 

  170. int AudioChannelSet::size() const noexcept

  171. {

  172.     return channels.countNumberOfSetBits();

  173. }

  174. 

  175. AudioChannelSet::ChannelType AudioChannelSet::getTypeOfChannel (int index) const noexcept

  176. {

  177.     int bit = channels.findNextSetBit(0);

  178. 

  179.     for (int i = 0; i < index && bit >= 0; ++i)

  180.         bit = channels.findNextSetBit (bit + 1);

  181. 

  182.     return static_cast<ChannelType> (bit);

  183. }

  184. 

  185. int AudioChannelSet::getChannelIndexForType (AudioChannelSet::ChannelType type) const noexcept

  186. {

  187.     int idx = 0;

  188.     for (int bit = channels.findNextSetBit (0); bit >= 0; bit = channels.findNextSetBit (bit + 1))

  189.     {

  190.         if (static_cast<ChannelType> (bit) == type)

  191.             return idx;

  192. 

  193.         idx++;

  194.     }

  195. 

  196.     return -1;

  197. }

  198. 

  199. Array<AudioChannelSet::ChannelType> AudioChannelSet::getChannelTypes() const

  200. {

  201.     Array<ChannelType> result;

  202. 

  203.     for (int bit = channels.findNextSetBit(0); bit >= 0; bit = channels.findNextSetBit (bit + 1))

  204.         result.add (static_cast<ChannelType> (bit));

  205. 

  206.     return result;

  207. }

  208. 

  209. void AudioChannelSet::addChannel (ChannelType newChannel)

  210. {

  211.     const int bit = static_cast<int> (newChannel);

  212.     jassert (bit >= 0 && bit < 1024);

  213.     channels.setBit (bit);

  214. }

  215. 

  216. void AudioChannelSet::removeChannel (ChannelType newChannel)

  217. {

  218.     const int bit = static_cast<int> (newChannel);

  219.     jassert (bit >= 0 && bit < 1024);

  220.     channels.clearBit (bit);

  221. }

  222. 

  223. AudioChannelSet AudioChannelSet::disabled()           { return AudioChannelSet(); }

  224. AudioChannelSet AudioChannelSet::mono()               { return AudioChannelSet (1u << centre); }

  225. AudioChannelSet AudioChannelSet::stereo()             { return AudioChannelSet ((1u << left) | (1u << right)); }

  226. AudioChannelSet AudioChannelSet::createLCR()          { return AudioChannelSet ((1u << left) | (1u << right) | (1u << centre)); }

  227. AudioChannelSet AudioChannelSet::createLRS()          { return AudioChannelSet ((1u << left) | (1u << right) | (1u << surround)); }

  228. AudioChannelSet AudioChannelSet::createLCRS()         { return AudioChannelSet ((1u << left) | (1u << right) | (1u << centre) | (1u << surround)); }

  229. AudioChannelSet AudioChannelSet::create5point0()      { return AudioChannelSet ((1u << left) | (1u << right) | (1u << centre) | (1u << leftSurround) | (1u << rightSurround)); }

  230. AudioChannelSet AudioChannelSet::create5point1()      { return AudioChannelSet ((1u << left) | (1u << right) | (1u << centre) | (1u << leftSurround) | (1u << rightSurround) | (1u << LFE)); }

  231. AudioChannelSet AudioChannelSet::create6point0()      { return AudioChannelSet ((1u << left) | (1u << right) | (1u << centre) | (1u << leftSurround) | (1u << rightSurround) | (1u << centreSurround)); }

  232. AudioChannelSet AudioChannelSet::create6point1()      { return AudioChannelSet ((1u << left) | (1u << right) | (1u << centre) | (1u << leftSurround) | (1u << rightSurround) | (1u << centreSurround) | (1u << LFE)); }

  233. AudioChannelSet AudioChannelSet::create6point0Music() { return AudioChannelSet ((1u << left) | (1u << right) | (1u << leftSurround) | (1u << rightSurround) | (1u << leftSurroundSide) | (1u << rightSurroundSide)); }

  234. AudioChannelSet AudioChannelSet::create6point1Music() { return AudioChannelSet ((1u << left) | (1u << right) | (1u << leftSurround) | (1u << rightSurround) | (1u << leftSurroundSide) | (1u << rightSurroundSide) | (1u << LFE)); }

  235. AudioChannelSet AudioChannelSet::create7point0()      { return AudioChannelSet ((1u << left) | (1u << right) | (1u << centre) | (1u << leftSurroundSide) | (1u << rightSurroundSide) | (1u << leftSurroundRear) | (1u << rightSurroundRear)); }

  236. AudioChannelSet AudioChannelSet::create7point0SDDS()  { return AudioChannelSet ((1u << left) | (1u << right) | (1u << centre) | (1u << leftSurround) | (1u << rightSurround) | (1u << leftCentre) | (1u << rightCentre)); }

  237. AudioChannelSet AudioChannelSet::create7point1()      { return AudioChannelSet ((1u << left) | (1u << right) | (1u << centre) | (1u << leftSurroundSide) | (1u << rightSurroundSide) | (1u << leftSurroundRear) | (1u << rightSurroundRear) | (1u << LFE)); }

  238. AudioChannelSet AudioChannelSet::create7point1SDDS()  { return AudioChannelSet ((1u << left) | (1u << right) | (1u << centre) | (1u << leftSurround) | (1u << rightSurround) | (1u << leftCentre) | (1u << rightCentre) | (1u << LFE)); }

  239. AudioChannelSet AudioChannelSet::ambisonic()          { return AudioChannelSet ((1u << ambisonicW) | (1u << ambisonicX) | (1u << ambisonicY) | (1u << ambisonicZ)); }

  240. AudioChannelSet AudioChannelSet::quadraphonic()       { return AudioChannelSet ((1u << left) | (1u << right) | (1u << leftSurround) | (1u << rightSurround)); }

  241. AudioChannelSet AudioChannelSet::pentagonal()         { return AudioChannelSet ((1u << left) | (1u << right) | (1u << centre) | (1u << leftSurroundRear) | (1u << rightSurroundRear)); }

  242. AudioChannelSet AudioChannelSet::hexagonal()          { return AudioChannelSet ((1u << left) | (1u << right) | (1u << leftSurroundRear) | (1u << rightSurroundRear) |  (1u << centre) | (1u << centreSurround)); }

  243. AudioChannelSet AudioChannelSet::octagonal()          { return AudioChannelSet ((1u << left) | (1u << right) | (1u << leftSurround) | (1u << rightSurround) | (1u << centre) | (1u << centreSurround) | (1u << wideLeft) | (1u << wideRight)); }

  244. 

  245. 

  246. AudioChannelSet AudioChannelSet::discreteChannels (int numChannels)

  247. {

  248.     AudioChannelSet s;

  249.     s.channels.setRange (discreteChannel0, numChannels, true);

  250.     return s;

  251. }

  252. 

  253. AudioChannelSet AudioChannelSet::canonicalChannelSet (int numChannels)

  254. {

  255.     if (numChannels == 1) return AudioChannelSet::mono();

  256.     if (numChannels == 2) return AudioChannelSet::stereo();

  257.     if (numChannels == 3) return AudioChannelSet::createLCR();

  258.     if (numChannels == 4) return AudioChannelSet::quadraphonic();

  259.     if (numChannels == 5) return AudioChannelSet::create5point0();

  260.     if (numChannels == 6) return AudioChannelSet::create5point1();

  261.     if (numChannels == 7) return AudioChannelSet::create7point0();

  262.     if (numChannels == 8) return AudioChannelSet::create7point1();

  263. 

  264.     return discreteChannels (numChannels);

  265. }

  266. 

  267. AudioChannelSet AudioChannelSet::namedChannelSet (int numChannels)

  268. {

  269.     if (numChannels == 1) return AudioChannelSet::mono();

  270.     if (numChannels == 2) return AudioChannelSet::stereo();

  271.     if (numChannels == 3) return AudioChannelSet::createLCR();

  272.     if (numChannels == 4) return AudioChannelSet::quadraphonic();

  273.     if (numChannels == 5) return AudioChannelSet::create5point0();

  274.     if (numChannels == 6) return AudioChannelSet::create5point1();

  275.     if (numChannels == 7) return AudioChannelSet::create7point0();

  276.     if (numChannels == 8) return AudioChannelSet::create7point1();

  277. 

  278.     return AudioChannelSet();

  279. }

  280. 

  281. Array<AudioChannelSet> AudioChannelSet::channelSetsWithNumberOfChannels (int numChannels)

  282. {

  283.     Array<AudioChannelSet> retval;

  284. 

  285.     if (numChannels != 0)

  286.     {

  287.         retval.add (AudioChannelSet::discreteChannels (numChannels));

  288. 

  289.         if      (numChannels == 1)

  290.         {

  291.             retval.add (AudioChannelSet::mono());

  292.         }

  293.         else if (numChannels == 2)

  294.         {

  295.             retval.add (AudioChannelSet::stereo());

  296.         }

  297.         else if (numChannels == 3)

  298.         {

  299.             retval.add (AudioChannelSet::createLCR());

  300.             retval.add (AudioChannelSet::createLRS());

  301.         }

  302.         else if (numChannels == 4)

  303.         {

  304.             retval.add (AudioChannelSet::quadraphonic());

  305.             retval.add (AudioChannelSet::createLCRS());

  306.             retval.add (AudioChannelSet::ambisonic());

  307.         }

  308.         else if (numChannels == 5)

  309.         {

  310.             retval.add (AudioChannelSet::create5point0());

  311.             retval.add (AudioChannelSet::pentagonal());

  312.         }

  313.         else if (numChannels == 6)

  314.         {

  315.             retval.add (AudioChannelSet::create5point1());

  316.             retval.add (AudioChannelSet::create6point0());

  317.             retval.add (AudioChannelSet::create6point0Music());

  318.             retval.add (AudioChannelSet::hexagonal());

  319.         }

  320.         else if (numChannels == 7)

  321.         {

  322.             retval.add (AudioChannelSet::create7point0());

  323.             retval.add (AudioChannelSet::create7point0SDDS());

  324.             retval.add (AudioChannelSet::create6point1());

  325.             retval.add (AudioChannelSet::create6point1Music());

  326.         }

  327.         else if (numChannels == 8)

  328.         {

  329.             retval.add (AudioChannelSet::create7point1());

  330.             retval.add (AudioChannelSet::create7point1SDDS());

  331.             retval.add (AudioChannelSet::octagonal());

  332.         }

  333.     }

  334. 

  335.     return retval;

  336. }