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.
5209 Commits
16 Branches
14GB
Tree: fea4a0b12d
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'fea4a0b12d'
${ noResults }
Carla/source/modules/juce_audio_basics/buffers/juce_AudioChannelSet.cpp

432 lines
19KB
Raw Blame History 

  1. /*

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

  3. 

  4.    This file is part of the JUCE library.

  5.    Copyright (c) 2017 - ROLI Ltd.

  6. 

  7.    JUCE is an open source library subject to commercial or open-source

  8.    licensing.

  9. 

  10.    The code included in this file is provided under the terms of the ISC license

  11.    http://www.isc.org/downloads/software-support-policy/isc-license. Permission

  12.    To use, copy, modify, and/or distribute this software for any purpose with or

  13.    without fee is hereby granted provided that the above copyright notice and

  14.    this permission notice appear in all copies.

  15. 

  16.    JUCE IS PROVIDED "AS IS" WITHOUT ANY WARRANTY, AND ALL WARRANTIES, WHETHER

  17.    EXPRESSED OR IMPLIED, INCLUDING MERCHANTABILITY AND FITNESS FOR PURPOSE, ARE

  18.    DISCLAIMED.

  19. 

  20.   ==============================================================================

  21. */

  22. 

  23. namespace juce

  24. {

  25. 

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

  27. AudioChannelSet::AudioChannelSet (const Array<ChannelType>& c)

  28. {

  29.     for (auto channel : c)

  30.         addChannel (channel);

  31. }

  32. 

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

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

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

  36. 

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

  38. {

  39.     if (type >= discreteChannel0)

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

  41. 

  42.     switch (type)

  43.     {

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  71.         case topSideLeft:         return NEEDS_TRANS("Top Side Left");

  72.         case topSideRight:        return NEEDS_TRANS("Top Side Right");

  73.         default:                  break;

  74.     }

  75. 

  76.     return "Unknown";

  77. }

  78. 

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

  80. {

  81.     if (type >= discreteChannel0)

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

  83. 

  84.     switch (type)

  85.     {

  86.         case left:                return "L";

  87.         case right:               return "R";

  88.         case centre:              return "C";

  89.         case LFE:                 return "Lfe";

  90.         case leftSurround:        return "Ls";

  91.         case rightSurround:       return "Rs";

  92.         case leftCentre:          return "Lc";

  93.         case rightCentre:         return "Rc";

  94.         case centreSurround:      return "Cs";

  95.         case leftSurroundRear:    return "Lrs";

  96.         case rightSurroundRear:   return "Rrs";

  97.         case topMiddle:           return "Tm";

  98.         case topFrontLeft:        return "Tfl";

  99.         case topFrontCentre:      return "Tfc";

  100.         case topFrontRight:       return "Tfr";

  101.         case topRearLeft:         return "Trl";

  102.         case topRearCentre:       return "Trc";

  103.         case topRearRight:        return "Trr";

  104.         case wideLeft:            return "Wl";

  105.         case wideRight:           return "Wr";

  106.         case LFE2:                return "Lfe2";

  107.         case leftSurroundSide:    return "Lss";

  108.         case rightSurroundSide:   return "Rss";

  109.         case ambisonicW:          return "W";

  110.         case ambisonicX:          return "X";

  111.         case ambisonicY:          return "Y";

  112.         case ambisonicZ:          return "Z";

  113.         case topSideLeft:         return "Tsl";

  114.         case topSideRight:        return "Tsr";

  115.         default:                  break;

  116.     }

  117. 

  118.     return {};

  119. }

  120. 

  121. AudioChannelSet::ChannelType AudioChannelSet::getChannelTypeFromAbbreviation (const String& abbr)

  122. {

  123.     if (abbr.length() > 0 && (abbr[0] >= '0' && abbr[0] <= '9'))

  124.         return static_cast<AudioChannelSet::ChannelType> (static_cast<int> (discreteChannel0)

  125.                                                                + abbr.getIntValue() + 1);

  126. 

  127.     if (abbr == "L")    return left;

  128.     if (abbr == "R")    return right;

  129.     if (abbr == "C")    return centre;

  130.     if (abbr == "Lfe")  return LFE;

  131.     if (abbr == "Ls")   return leftSurround;

  132.     if (abbr == "Rs")   return rightSurround;

  133.     if (abbr == "Lc")   return leftCentre;

  134.     if (abbr == "Rc")   return rightCentre;

  135.     if (abbr == "Cs")   return centreSurround;

  136.     if (abbr == "Lrs")  return leftSurroundRear;

  137.     if (abbr == "Rrs")  return rightSurroundRear;

  138.     if (abbr == "Tm")   return topMiddle;

  139.     if (abbr == "Tfl")  return topFrontLeft;

  140.     if (abbr == "Tfc")  return topFrontCentre;

  141.     if (abbr == "Tfr")  return topFrontRight;

  142.     if (abbr == "Trl")  return topRearLeft;

  143.     if (abbr == "Trc")  return topRearCentre;

  144.     if (abbr == "Trr")  return topRearRight;

  145.     if (abbr == "Wl")   return wideLeft;

  146.     if (abbr == "Wr")   return wideRight;

  147.     if (abbr == "Lfe2") return LFE2;

  148.     if (abbr == "Lss")  return leftSurroundSide;

  149.     if (abbr == "Rss")  return rightSurroundSide;

  150.     if (abbr == "W")    return ambisonicW;

  151.     if (abbr == "X")    return ambisonicX;

  152.     if (abbr == "Y")    return ambisonicY;

  153.     if (abbr == "Z")    return ambisonicZ;

  154.     if (abbr == "Tsl")  return topSideLeft;

  155.     if (abbr == "Tsr")  return topSideRight;

  156. 

  157.     return unknown;

  158. }

  159. 

  160. String AudioChannelSet::getSpeakerArrangementAsString() const

  161. {

  162.     StringArray speakerTypes;

  163. 

  164.     for (auto& speaker : getChannelTypes())

  165.     {

  166.         auto name = getAbbreviatedChannelTypeName (speaker);

  167. 

  168.         if (name.isNotEmpty())

  169.             speakerTypes.add (name);

  170.     }

  171. 

  172.     return speakerTypes.joinIntoString (" ");

  173. }

  174. 

  175. AudioChannelSet AudioChannelSet::fromAbbreviatedString (const String& str)

  176. {

  177.     AudioChannelSet set;

  178. 

  179.     for (auto& abbr : StringArray::fromTokens (str, true))

  180.     {

  181.         auto type = getChannelTypeFromAbbreviation (abbr);

  182. 

  183.         if (type != unknown)

  184.             set.addChannel (type);

  185.     }

  186. 

  187.     return set;

  188. }

  189. 

  190. String AudioChannelSet::getDescription() const

  191. {

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

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

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

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

  196. 

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

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

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

  200. 

  201.     if (*this == create5point0())       return "5.0 Surround";

  202.     if (*this == create5point1())       return "5.1 Surround";

  203.     if (*this == create6point0())       return "6.0 Surround";

  204.     if (*this == create6point1())       return "6.1 Surround";

  205.     if (*this == create6point0Music())  return "6.0 (Music) Surround";

  206.     if (*this == create6point1Music())  return "6.1 (Music) Surround";

  207.     if (*this == create7point0())       return "7.0 Surround";

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

  209.     if (*this == create7point0SDDS())   return "7.0 Surround SDDS";

  210.     if (*this == create7point1SDDS())   return "7.1 Surround SDDS";

  211.     if (*this == create7point0point2()) return "7.0.2 Surround";

  212.     if (*this == create7point1point2()) return "7.1.2 Surround";

  213. 

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

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

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

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

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

  219. 

  220.     return "Unknown";

  221. }

  222. 

  223. bool AudioChannelSet::isDiscreteLayout() const noexcept

  224. {

  225.     for (auto& speaker : getChannelTypes())

  226.         if (speaker <= topSideRight)

  227.             return false;

  228. 

  229.     return true;

  230. }

  231. 

  232. int AudioChannelSet::size() const noexcept

  233. {

  234.     return channels.countNumberOfSetBits();

  235. }

  236. 

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

  238. {

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

  240. 

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

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

  243. 

  244.     return static_cast<ChannelType> (bit);

  245. }

  246. 

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

  248. {

  249.     int idx = 0;

  250. 

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

  252.     {

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

  254.             return idx;

  255. 

  256.         idx++;

  257.     }

  258. 

  259.     return -1;

  260. }

  261. 

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

  263. {

  264.     Array<ChannelType> result;

  265. 

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

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

  268. 

  269.     return result;

  270. }

  271. 

  272. void AudioChannelSet::addChannel (ChannelType newChannel)

  273. {

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

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

  276.     channels.setBit (bit);

  277. }

  278. 

  279. void AudioChannelSet::removeChannel (ChannelType newChannel)

  280. {

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

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

  283.     channels.clearBit (bit);

  284. }

  285. 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  307. AudioChannelSet AudioChannelSet::create7point0point2() { return AudioChannelSet ((1u << left) | (1u << right) | (1u << centre) | (1u << leftSurroundSide) | (1u << rightSurroundSide) | (1u << leftSurroundRear) | (1u << rightSurroundRear) | (1u << topSideLeft) | (1u << topSideRight)); }

  308. AudioChannelSet AudioChannelSet::create7point1point2() { return AudioChannelSet ((1u << left) | (1u << right) | (1u << centre) | (1u << LFE) | (1u << leftSurroundSide) | (1u << rightSurroundSide) | (1u << leftSurroundRear) | (1u << rightSurroundRear) | (1u << topSideLeft) | (1u << topSideRight)); }

  309. 

  310. 

  311. AudioChannelSet AudioChannelSet::discreteChannels (int numChannels)

  312. {

  313.     AudioChannelSet s;

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

  315.     return s;

  316. }

  317. 

  318. AudioChannelSet AudioChannelSet::canonicalChannelSet (int numChannels)

  319. {

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

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

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

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

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

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

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

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

  328. 

  329.     return discreteChannels (numChannels);

  330. }

  331. 

  332. AudioChannelSet AudioChannelSet::namedChannelSet (int numChannels)

  333. {

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

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

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

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

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

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

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

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

  342. 

  343.     return {};

  344. }

  345. 

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

  347. {

  348.     Array<AudioChannelSet> retval;

  349. 

  350.     if (numChannels != 0)

  351.     {

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

  353. 

  354.         if      (numChannels == 1)

  355.         {

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

  357.         }

  358.         else if (numChannels == 2)

  359.         {

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

  361.         }

  362.         else if (numChannels == 3)

  363.         {

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

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

  366.         }

  367.         else if (numChannels == 4)

  368.         {

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

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

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

  372.         }

  373.         else if (numChannels == 5)

  374.         {

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

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

  377.         }

  378.         else if (numChannels == 6)

  379.         {

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

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

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

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

  384.         }

  385.         else if (numChannels == 7)

  386.         {

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

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

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

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

  391.         }

  392.         else if (numChannels == 8)

  393.         {

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

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

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

  397.         }

  398.     }

  399. 

  400.     return retval;

  401. }

  402. 

  403. AudioChannelSet JUCE_CALLTYPE AudioChannelSet::channelSetWithChannels (const Array<ChannelType>& channelArray)

  404. {

  405.     AudioChannelSet set;

  406. 

  407.     for (auto ch : channelArray)

  408.     {

  409.         jassert (! set.channels[static_cast<int> (ch)]);

  410. 

  411.         set.addChannel (ch);

  412.     }

  413. 

  414.     return set;

  415. }

  416. 

  417. //==============================================================================

  418. AudioChannelSet JUCE_CALLTYPE AudioChannelSet::fromWaveChannelMask (int32 dwChannelMask)

  419. {

  420.     return AudioChannelSet (static_cast<uint32> ((dwChannelMask & ((1 << 18) - 1)) << 1));

  421. }

  422. 

  423. int32 AudioChannelSet::getWaveChannelMask() const noexcept

  424. {

  425.     if (channels.getHighestBit() > topRearRight)

  426.         return -1;

  427. 

  428.     return (channels.toInteger() >> 1);

  429. }

  430. 

  431. } // namespace juce