DISTRHO
/
JUCE
mirror of https://github.com/DISTRHO/JUCE
1
0
Fork 0
Code Releases 1 Activity
The JUCE cross-platform C++ framework, with DISTRHO/KXStudio specific changes
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.
12135 Commits
11 Branches
1.4GB
Tree: 79f1ffec2e
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '79f1ffec2e'
${ noResults }
JUCE/modules/juce_audio_basics/buffers/juce_AudioChannelSet.cpp

726 lines
33KB
Raw Blame History 

  1. /*

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

  3. 

  4.    This file is part of the JUCE library.

  5.    Copyright (c) 2020 - Raw Material Software Limited

  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. 

  27. 

  28. AudioChannelSet::AudioChannelSet (uint32 c) : channels (static_cast<int64> (c))

  29. {

  30. }

  31. 

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

  33. {

  34.     for (auto channel : c)

  35.         addChannel (channel);

  36. }

  37. 

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

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

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

  41. 

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

  43. {

  44.     if (type >= discreteChannel0)

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

  46. 

  47.     switch (type)

  48.     {

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  78.         case ambisonicACN4:       return NEEDS_TRANS("Ambisonic 4");

  79.         case ambisonicACN5:       return NEEDS_TRANS("Ambisonic 5");

  80.         case ambisonicACN6:       return NEEDS_TRANS("Ambisonic 6");

  81.         case ambisonicACN7:       return NEEDS_TRANS("Ambisonic 7");

  82.         case ambisonicACN8:       return NEEDS_TRANS("Ambisonic 8");

  83.         case ambisonicACN9:       return NEEDS_TRANS("Ambisonic 9");

  84.         case ambisonicACN10:      return NEEDS_TRANS("Ambisonic 10");

  85.         case ambisonicACN11:      return NEEDS_TRANS("Ambisonic 11");

  86.         case ambisonicACN12:      return NEEDS_TRANS("Ambisonic 12");

  87.         case ambisonicACN13:      return NEEDS_TRANS("Ambisonic 13");

  88.         case ambisonicACN14:      return NEEDS_TRANS("Ambisonic 14");

  89.         case ambisonicACN15:      return NEEDS_TRANS("Ambisonic 15");

  90.         case ambisonicACN16:      return NEEDS_TRANS("Ambisonic 16");

  91.         case ambisonicACN17:      return NEEDS_TRANS("Ambisonic 17");

  92.         case ambisonicACN18:      return NEEDS_TRANS("Ambisonic 18");

  93.         case ambisonicACN19:      return NEEDS_TRANS("Ambisonic 19");

  94.         case ambisonicACN20:      return NEEDS_TRANS("Ambisonic 20");

  95.         case ambisonicACN21:      return NEEDS_TRANS("Ambisonic 21");

  96.         case ambisonicACN22:      return NEEDS_TRANS("Ambisonic 22");

  97.         case ambisonicACN23:      return NEEDS_TRANS("Ambisonic 23");

  98.         case ambisonicACN24:      return NEEDS_TRANS("Ambisonic 24");

  99.         case ambisonicACN25:      return NEEDS_TRANS("Ambisonic 25");

  100.         case ambisonicACN26:      return NEEDS_TRANS("Ambisonic 26");

  101.         case ambisonicACN27:      return NEEDS_TRANS("Ambisonic 27");

  102.         case ambisonicACN28:      return NEEDS_TRANS("Ambisonic 28");

  103.         case ambisonicACN29:      return NEEDS_TRANS("Ambisonic 29");

  104.         case ambisonicACN30:      return NEEDS_TRANS("Ambisonic 30");

  105.         case ambisonicACN31:      return NEEDS_TRANS("Ambisonic 31");

  106.         case ambisonicACN32:      return NEEDS_TRANS("Ambisonic 32");

  107.         case ambisonicACN33:      return NEEDS_TRANS("Ambisonic 33");

  108.         case ambisonicACN34:      return NEEDS_TRANS("Ambisonic 34");

  109.         case ambisonicACN35:      return NEEDS_TRANS("Ambisonic 35");

  110.         case bottomFrontLeft:     return NEEDS_TRANS("Bottom Front Left");

  111.         case bottomFrontCentre:   return NEEDS_TRANS("Bottom Front Centre");

  112.         case bottomFrontRight:    return NEEDS_TRANS("Bottom Front Right");

  113.         case proximityLeft:       return NEEDS_TRANS("Proximity Left");

  114.         case proximityRight:      return NEEDS_TRANS("Proximity Right");

  115.         case bottomSideLeft:      return NEEDS_TRANS("Bottom Side Left");

  116.         case bottomSideRight:     return NEEDS_TRANS("Bottom Side Right");

  117.         case bottomRearLeft:      return NEEDS_TRANS("Bottom Rear Left");

  118.         case bottomRearCentre:    return NEEDS_TRANS("Bottom Rear Centre");

  119.         case bottomRearRight:     return NEEDS_TRANS("Bottom Rear Right");

  120.         case discreteChannel0:

  121.         case unknown:

  122.         default:                  break;

  123.     }

  124. 

  125.     return "Unknown";

  126. }

  127. 

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

  129. {

  130.     if (type >= discreteChannel0)

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

  132. 

  133.     switch (type)

  134.     {

  135.         case left:                return "L";

  136.         case right:               return "R";

  137.         case centre:              return "C";

  138.         case LFE:                 return "Lfe";

  139.         case leftSurround:        return "Ls";

  140.         case rightSurround:       return "Rs";

  141.         case leftCentre:          return "Lc";

  142.         case rightCentre:         return "Rc";

  143.         case centreSurround:      return "Cs";

  144.         case leftSurroundRear:    return "Lrs";

  145.         case rightSurroundRear:   return "Rrs";

  146.         case topMiddle:           return "Tm";

  147.         case topFrontLeft:        return "Tfl";

  148.         case topFrontCentre:      return "Tfc";

  149.         case topFrontRight:       return "Tfr";

  150.         case topRearLeft:         return "Trl";

  151.         case topRearCentre:       return "Trc";

  152.         case topRearRight:        return "Trr";

  153.         case wideLeft:            return "Wl";

  154.         case wideRight:           return "Wr";

  155.         case LFE2:                return "Lfe2";

  156.         case leftSurroundSide:    return "Lss";

  157.         case rightSurroundSide:   return "Rss";

  158.         case ambisonicACN0:       return "ACN0";

  159.         case ambisonicACN1:       return "ACN1";

  160.         case ambisonicACN2:       return "ACN2";

  161.         case ambisonicACN3:       return "ACN3";

  162.         case ambisonicACN4:       return "ACN4";

  163.         case ambisonicACN5:       return "ACN5";

  164.         case ambisonicACN6:       return "ACN6";

  165.         case ambisonicACN7:       return "ACN7";

  166.         case ambisonicACN8:       return "ACN8";

  167.         case ambisonicACN9:       return "ACN9";

  168.         case ambisonicACN10:      return "ACN10";

  169.         case ambisonicACN11:      return "ACN11";

  170.         case ambisonicACN12:      return "ACN12";

  171.         case ambisonicACN13:      return "ACN13";

  172.         case ambisonicACN14:      return "ACN14";

  173.         case ambisonicACN15:      return "ACN15";

  174.         case ambisonicACN16:      return "ACN16";

  175.         case ambisonicACN17:      return "ACN17";

  176.         case ambisonicACN18:      return "ACN18";

  177.         case ambisonicACN19:      return "ACN19";

  178.         case ambisonicACN20:      return "ACN20";

  179.         case ambisonicACN21:      return "ACN21";

  180.         case ambisonicACN22:      return "ACN22";

  181.         case ambisonicACN23:      return "ACN23";

  182.         case ambisonicACN24:      return "ACN24";

  183.         case ambisonicACN25:      return "ACN25";

  184.         case ambisonicACN26:      return "ACN26";

  185.         case ambisonicACN27:      return "ACN27";

  186.         case ambisonicACN28:      return "ACN28";

  187.         case ambisonicACN29:      return "ACN29";

  188.         case ambisonicACN30:      return "ACN30";

  189.         case ambisonicACN31:      return "ACN31";

  190.         case ambisonicACN32:      return "ACN32";

  191.         case ambisonicACN33:      return "ACN33";

  192.         case ambisonicACN34:      return "ACN34";

  193.         case ambisonicACN35:      return "ACN35";

  194.         case topSideLeft:         return "Tsl";

  195.         case topSideRight:        return "Tsr";

  196.         case bottomFrontLeft:     return "Bfl";

  197.         case bottomFrontCentre:   return "Bfc";

  198.         case bottomFrontRight:    return "Bfr";

  199.         case proximityLeft:       return "Pl";

  200.         case proximityRight:      return "Pr";

  201.         case bottomSideLeft:      return "Bsl";

  202.         case bottomSideRight:     return "Bsr";

  203.         case bottomRearLeft:      return "Brl";

  204.         case bottomRearCentre:    return "Brc";

  205.         case bottomRearRight:     return "Brr";

  206.         case discreteChannel0:

  207.         case unknown:

  208.         default:                  break;

  209.     }

  210. 

  211.     if (type >= ambisonicACN4 && type <= ambisonicACN35)

  212.         return "ACN" + String (type - ambisonicACN4 + 4);

  213. 

  214.     return {};

  215. }

  216. 

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

  218. {

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

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

  221.                                                                + abbr.getIntValue() - 1);

  222. 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  250.     if (abbr == "ACN0")  return ambisonicACN0;

  251.     if (abbr == "ACN1")  return ambisonicACN1;

  252.     if (abbr == "ACN2")  return ambisonicACN2;

  253.     if (abbr == "ACN3")  return ambisonicACN3;

  254.     if (abbr == "ACN4")  return ambisonicACN4;

  255.     if (abbr == "ACN5")  return ambisonicACN5;

  256.     if (abbr == "ACN6")  return ambisonicACN6;

  257.     if (abbr == "ACN7")  return ambisonicACN7;

  258.     if (abbr == "ACN8")  return ambisonicACN8;

  259.     if (abbr == "ACN9")  return ambisonicACN9;

  260.     if (abbr == "ACN10") return ambisonicACN10;

  261.     if (abbr == "ACN11") return ambisonicACN11;

  262.     if (abbr == "ACN12") return ambisonicACN12;

  263.     if (abbr == "ACN13") return ambisonicACN13;

  264.     if (abbr == "ACN14") return ambisonicACN14;

  265.     if (abbr == "ACN15") return ambisonicACN15;

  266.     if (abbr == "ACN16") return ambisonicACN16;

  267.     if (abbr == "ACN17") return ambisonicACN17;

  268.     if (abbr == "ACN18") return ambisonicACN18;

  269.     if (abbr == "ACN19") return ambisonicACN19;

  270.     if (abbr == "ACN20") return ambisonicACN20;

  271.     if (abbr == "ACN21") return ambisonicACN21;

  272.     if (abbr == "ACN22") return ambisonicACN22;

  273.     if (abbr == "ACN23") return ambisonicACN23;

  274.     if (abbr == "ACN24") return ambisonicACN24;

  275.     if (abbr == "ACN25") return ambisonicACN25;

  276.     if (abbr == "ACN26") return ambisonicACN26;

  277.     if (abbr == "ACN27") return ambisonicACN27;

  278.     if (abbr == "ACN28") return ambisonicACN28;

  279.     if (abbr == "ACN29") return ambisonicACN29;

  280.     if (abbr == "ACN30") return ambisonicACN30;

  281.     if (abbr == "ACN31") return ambisonicACN31;

  282.     if (abbr == "ACN32") return ambisonicACN32;

  283.     if (abbr == "ACN33") return ambisonicACN33;

  284.     if (abbr == "ACN34") return ambisonicACN34;

  285.     if (abbr == "ACN35") return ambisonicACN35;

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

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

  288.     if (abbr == "Bfl")   return bottomFrontLeft;

  289.     if (abbr == "Bfc")   return bottomFrontCentre;

  290.     if (abbr == "Bfr")   return bottomFrontRight;

  291.     if (abbr == "Bsl")   return bottomSideLeft;

  292.     if (abbr == "Bsr")   return bottomSideRight;

  293.     if (abbr == "Brl")   return bottomRearLeft;

  294.     if (abbr == "Brc")   return bottomRearCentre;

  295.     if (abbr == "Brr")   return bottomRearRight;

  296.     return unknown;

  297. }

  298. 

  299. String AudioChannelSet::getSpeakerArrangementAsString() const

  300. {

  301.     StringArray speakerTypes;

  302. 

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

  304.     {

  305.         auto name = getAbbreviatedChannelTypeName (speaker);

  306. 

  307.         if (name.isNotEmpty())

  308.             speakerTypes.add (name);

  309.     }

  310. 

  311.     return speakerTypes.joinIntoString (" ");

  312. }

  313. 

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

  315. {

  316.     AudioChannelSet set;

  317. 

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

  319.     {

  320.         auto type = getChannelTypeFromAbbreviation (abbr);

  321. 

  322.         if (type != unknown)

  323.             set.addChannel (type);

  324.     }

  325. 

  326.     return set;

  327. }

  328. 

  329. String AudioChannelSet::getDescription() const

  330. {

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

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

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

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

  335. 

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

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

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

  339. 

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

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

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

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

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

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

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

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

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

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

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

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

  352. 

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

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

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

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

  357. 

  358.     // ambisonics

  359.     {

  360.         auto order = getAmbisonicOrder();

  361. 

  362.         if (order >= 0)

  363.         {

  364.             String suffix;

  365. 

  366.             switch (order)

  367.             {

  368.                 case 1:  suffix = "st"; break;

  369.                 case 2:  suffix = "nd"; break;

  370.                 case 3:  suffix = "rd"; break;

  371.                 default: suffix = "th"; break;

  372.             }

  373. 

  374.             return String (order) + suffix + " Order Ambisonics";

  375.         }

  376.     }

  377. 

  378.     return "Unknown";

  379. }

  380. 

  381. bool AudioChannelSet::isDiscreteLayout() const noexcept

  382. {

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

  384.         if (speaker <= ambisonicACN35)

  385.             return false;

  386. 

  387.     return true;

  388. }

  389. 

  390. int AudioChannelSet::size() const noexcept

  391. {

  392.     return channels.countNumberOfSetBits();

  393. }

  394. 

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

  396. {

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

  398. 

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

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

  401. 

  402.     return static_cast<ChannelType> (bit);

  403. }

  404. 

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

  406. {

  407.     int idx = 0;

  408. 

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

  410.     {

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

  412.             return idx;

  413. 

  414.         idx++;

  415.     }

  416. 

  417.     return -1;

  418. }

  419. 

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

  421. {

  422.     Array<ChannelType> result;

  423. 

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

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

  426. 

  427.     return result;

  428. }

  429. 

  430. void AudioChannelSet::addChannel (ChannelType newChannel)

  431. {

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

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

  434.     channels.setBit (bit);

  435. }

  436. 

  437. void AudioChannelSet::removeChannel (ChannelType newChannel)

  438. {

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

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

  441.     channels.clearBit (bit);

  442. }

  443. 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  465. 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)); }

  466. AudioChannelSet AudioChannelSet::create7point0point4() { return AudioChannelSet ((1u << left) | (1u << right) | (1u << centre) | (1u << leftSurroundSide) | (1u << rightSurroundSide) | (1u << leftSurroundRear) | (1u << rightSurroundRear) | (1u << topFrontLeft) | (1u << topFrontRight) | (1u << topRearLeft) | (1u << topRearRight)); }

  467. AudioChannelSet AudioChannelSet::create7point1point4() { return AudioChannelSet ((1u << left) | (1u << right) | (1u << centre) | (1u << LFE) | (1u << leftSurroundSide) | (1u << rightSurroundSide) | (1u << leftSurroundRear) | (1u << rightSurroundRear) | (1u << topFrontLeft) | (1u << topFrontRight) | (1u << topRearLeft) | (1u << topRearRight)); }

  468. 

  469. AudioChannelSet AudioChannelSet::ambisonic (int order)

  470. {

  471.     jassert (isPositiveAndBelow (order, 6));

  472. 

  473.     if (order == 0)

  474.         return AudioChannelSet ((uint32) (1 << ambisonicACN0));

  475. 

  476.     AudioChannelSet set ((1u << ambisonicACN0) | (1u << ambisonicACN1) | (1u << ambisonicACN2) | (1u << ambisonicACN3));

  477. 

  478.     auto numAmbisonicChannels = (order + 1) * (order + 1);

  479.     set.channels.setRange (ambisonicACN4, numAmbisonicChannels - 4, true);

  480. 

  481.     return set;

  482. }

  483. 

  484. int AudioChannelSet::getAmbisonicOrder() const

  485. {

  486.     auto ambisonicOrder = getAmbisonicOrderForNumChannels (size());

  487. 

  488.     if (ambisonicOrder >= 0)

  489.         return (*this == ambisonic (ambisonicOrder) ? ambisonicOrder : -1);

  490. 

  491.     return -1;

  492. }

  493. 

  494. AudioChannelSet AudioChannelSet::discreteChannels (int numChannels)

  495. {

  496.     AudioChannelSet s;

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

  498.     return s;

  499. }

  500. 

  501. AudioChannelSet AudioChannelSet::canonicalChannelSet (int numChannels)

  502. {

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

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

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

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

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

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

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

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

  511. 

  512.     return discreteChannels (numChannels);

  513. }

  514. 

  515. AudioChannelSet AudioChannelSet::namedChannelSet (int numChannels)

  516. {

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

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

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

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

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

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

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

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

  525. 

  526.     return {};

  527. }

  528. 

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

  530. {

  531.     Array<AudioChannelSet> retval;

  532. 

  533.     if (numChannels != 0)

  534.     {

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

  536. 

  537.         if      (numChannels == 1)

  538.         {

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

  540.         }

  541.         else if (numChannels == 2)

  542.         {

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

  544.         }

  545.         else if (numChannels == 3)

  546.         {

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

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

  549.         }

  550.         else if (numChannels == 4)

  551.         {

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

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

  554.         }

  555.         else if (numChannels == 5)

  556.         {

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

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

  559.         }

  560.         else if (numChannels == 6)

  561.         {

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

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

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

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

  566.         }

  567.         else if (numChannels == 7)

  568.         {

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

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

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

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

  573.         }

  574.         else if (numChannels == 8)

  575.         {

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

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

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

  579.         }

  580. 

  581.         auto order = getAmbisonicOrderForNumChannels (numChannels);

  582.         if (order >= 0)

  583.             retval.add (AudioChannelSet::ambisonic (order));

  584.     }

  585. 

  586.     return retval;

  587. }

  588. 

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

  590. {

  591.     AudioChannelSet set;

  592. 

  593.     for (auto ch : channelArray)

  594.     {

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

  596. 

  597.         set.addChannel (ch);

  598.     }

  599. 

  600.     return set;

  601. }

  602. 

  603. //==============================================================================

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

  605. {

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

  607. }

  608. 

  609. int32 AudioChannelSet::getWaveChannelMask() const noexcept

  610. {

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

  612.         return -1;

  613. 

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

  615. }

  616. 

  617. //==============================================================================

  618. int JUCE_CALLTYPE AudioChannelSet::getAmbisonicOrderForNumChannels (int numChannels)

  619. {

  620.     auto sqrtMinusOne   = std::sqrt (static_cast<float> (numChannels)) - 1.0f;

  621.     auto ambisonicOrder = jmax (0, static_cast<int> (std::floor (sqrtMinusOne)));

  622. 

  623.     if (ambisonicOrder > 5)

  624.         return -1;

  625. 

  626.     return (static_cast<float> (ambisonicOrder) == sqrtMinusOne ? ambisonicOrder : -1);

  627. }

  628. 

  629. 

  630. //==============================================================================

  631. //==============================================================================

  632. #if JUCE_UNIT_TESTS

  633. 

  634. class AudioChannelSetUnitTest  : public UnitTest

  635. {

  636. public:

  637.     AudioChannelSetUnitTest()

  638.         : UnitTest ("AudioChannelSetUnitTest", UnitTestCategories::audio)

  639.     {}

  640. 

  641.     void runTest() override

  642.     {

  643.         auto max = AudioChannelSet::maxChannelsOfNamedLayout;

  644. 

  645.         beginTest ("maxChannelsOfNamedLayout is non-discrete");

  646.         expect (AudioChannelSet::channelSetsWithNumberOfChannels (max).size() >= 2);

  647. 

  648.         beginTest ("channelSetsWithNumberOfChannels returns correct speaker count");

  649.         {

  650.             for (auto ch = 1; ch <= max; ++ch)

  651.             {

  652.                 auto channelSets = AudioChannelSet::channelSetsWithNumberOfChannels (ch);

  653. 

  654.                 for (auto set : channelSets)

  655.                     expect (set.size() == ch);

  656.             }

  657.         }

  658. 

  659.         beginTest ("Ambisonics");

  660.         {

  661.             uint64 mask = 0;

  662. 

  663.             mask |= (1ull << AudioChannelSet::ambisonicACN0);

  664.             checkAmbisonic (mask, 0, "0th Order Ambisonics");

  665. 

  666.             mask |= (1ull << AudioChannelSet::ambisonicACN1) | (1ull << AudioChannelSet::ambisonicACN2) | (1ull << AudioChannelSet::ambisonicACN3);

  667.             checkAmbisonic (mask, 1, "1st Order Ambisonics");

  668. 

  669.             mask |= (1ull << AudioChannelSet::ambisonicACN4) | (1ull << AudioChannelSet::ambisonicACN5) | (1ull << AudioChannelSet::ambisonicACN6)

  670.                   | (1ull << AudioChannelSet::ambisonicACN7) | (1ull << AudioChannelSet::ambisonicACN8);

  671.             checkAmbisonic (mask, 2, "2nd Order Ambisonics");

  672. 

  673.             mask |= (1ull << AudioChannelSet::ambisonicACN9)  | (1ull << AudioChannelSet::ambisonicACN10) | (1ull << AudioChannelSet::ambisonicACN11)

  674.                   | (1ull << AudioChannelSet::ambisonicACN12) | (1ull << AudioChannelSet::ambisonicACN13) | (1ull << AudioChannelSet::ambisonicACN14)

  675.                   | (1ull << AudioChannelSet::ambisonicACN15);

  676.             checkAmbisonic (mask, 3, "3rd Order Ambisonics");

  677. 

  678.             mask |= (1ull << AudioChannelSet::ambisonicACN16) | (1ull << AudioChannelSet::ambisonicACN17) | (1ull << AudioChannelSet::ambisonicACN18)

  679.                   | (1ull << AudioChannelSet::ambisonicACN19) | (1ull << AudioChannelSet::ambisonicACN20) | (1ull << AudioChannelSet::ambisonicACN21)

  680.                   | (1ull << AudioChannelSet::ambisonicACN22) | (1ull << AudioChannelSet::ambisonicACN23) | (1ull << AudioChannelSet::ambisonicACN24);

  681.             checkAmbisonic (mask, 4, "4th Order Ambisonics");

  682. 

  683.             mask |= (1ull << AudioChannelSet::ambisonicACN25) | (1ull << AudioChannelSet::ambisonicACN26) | (1ull << AudioChannelSet::ambisonicACN27)

  684.                   | (1ull << AudioChannelSet::ambisonicACN28) | (1ull << AudioChannelSet::ambisonicACN29) | (1ull << AudioChannelSet::ambisonicACN30)

  685.                   | (1ull << AudioChannelSet::ambisonicACN31) | (1ull << AudioChannelSet::ambisonicACN32) | (1ull << AudioChannelSet::ambisonicACN33)

  686.                   | (1ull << AudioChannelSet::ambisonicACN34) | (1ull << AudioChannelSet::ambisonicACN35);

  687.             checkAmbisonic (mask, 5, "5th Order Ambisonics");

  688.         }

  689.     }

  690. 

  691. private:

  692.     void checkAmbisonic (uint64 mask, int order, const char* layoutName)

  693.     {

  694.         auto expected = AudioChannelSet::ambisonic (order);

  695.         auto numChannels = expected.size();

  696. 

  697.         expect (numChannels == BigInteger ((int64) mask).countNumberOfSetBits());

  698.         expect (channelSetFromMask (mask) == expected);

  699. 

  700.         expect (order == expected.getAmbisonicOrder());

  701.         expect (expected.getDescription() == layoutName);

  702. 

  703.         auto layouts = AudioChannelSet::channelSetsWithNumberOfChannels (numChannels);

  704.         expect (layouts.contains (expected));

  705. 

  706.         for (auto layout : layouts)

  707.             expect (layout.getAmbisonicOrder() == (layout == expected ? order : -1));

  708.     }

  709. 

  710.     static AudioChannelSet channelSetFromMask (uint64 mask)

  711.     {

  712.         Array<AudioChannelSet::ChannelType> channels;

  713.         for (int bit = 0; bit <= 62; ++bit)

  714.             if ((mask & (1ull << bit)) != 0)

  715.                 channels.add (static_cast<AudioChannelSet::ChannelType> (bit));

  716. 

  717.         return AudioChannelSet::channelSetWithChannels (channels);

  718.     }

  719. };

  720. 

  721. static AudioChannelSetUnitTest audioChannelSetUnitTest;

  722. 

  723. #endif

  724. 

  725. } // namespace juce