File: ReferenceCountedDecoder.h

package info (click to toggle)
iem-plugin-suite 1.15.0-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 6,080 kB
  • sloc: cpp: 58,973; python: 269; sh: 79; makefile: 41
file content (125 lines) | stat: -rw-r--r-- 4,067 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
/*
 ==============================================================================
 This file is part of the IEM plug-in suite.
 Author: Daniel Rudrich
 Copyright (c) 2017 - Institute of Electronic Music and Acoustics (IEM)
 https://iem.at

 The IEM plug-in suite is free software: you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 the Free Software Foundation, either version 3 of the License, or
 (at your option) any later version.

 The IEM plug-in suite is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 GNU General Public License for more details.

 You should have received a copy of the GNU General Public License
 along with this software.  If not, see <https://www.gnu.org/licenses/>.
 ==============================================================================
 */

#pragma once
#include "MaxRE.h"
#include "ReferenceCountedMatrix.h"
#include "ambisonicTools.h"
#include "inPhase.h"

class ReferenceCountedDecoder : public ReferenceCountedMatrix
{
public:
    typedef juce::ReferenceCountedObjectPtr<ReferenceCountedDecoder> Ptr;

    enum class Normalization
    {
        n3d,
        sn3d
    };

    enum class Weights
    {
        none,
        maxrE,
        inPhase
    };

    struct Settings
    {
        Normalization expectedNormalization = Normalization::sn3d;
        Weights weights = Weights::none;
        bool weightsAlreadyApplied = false;
        int subwooferChannel = -1;
    };

    ReferenceCountedDecoder (const juce::String& nameToUse,
                             const juce::String& descriptionToUse,
                             int rows,
                             int columns) :
        ReferenceCountedMatrix (nameToUse, descriptionToUse, rows, columns),
        order (isqrt (columns) - 1)
    {
    }

    ~ReferenceCountedDecoder() override = default;

    virtual juce::String getConstructorMessage() const override
    {
        return "Decoder named '" + name + "' constructed. Size: "
               + juce::String (matrix.getNumRows()) + "x" + juce::String (matrix.getNumColumns());
    }

    virtual juce::String getDeconstructorMessage() const override
    {
        return "Decoder named '" + name + "' destroyed.";
    }

    const juce::String getName() { return name; }

    const juce::String getDescription() { return description; }

    void setSettings (const Settings newSettings) { settings = newSettings; }

    const Settings getSettings() { return settings; }

    const juce::String getWeightsString() const
    {
        switch (settings.weights)
        {
            case Weights::maxrE:
                return "maxrE";
            case Weights::inPhase:
                return "inPhase";
            default:
                return "none";
        }
    }

    /**
     Applies the inverse weights to the decoder matrix, so it can be used with different orders. This method has to be called before the decoder processes audio input.
    */
    void removeAppliedWeights()
    {
        if (settings.weightsAlreadyApplied && settings.weights != Weights::none)
        {
            const auto nCols = static_cast<int> (matrix.getNumColumns());
            const auto nRows = static_cast<int> (matrix.getNumRows());
            if (settings.weights == Weights::maxrE)
                for (int i = 0; i < nCols; ++i)
                    for (int j = 0; j < nRows; ++j)
                        matrix (j, i) /= getMaxRELUT (order)[i];
            else if (settings.weights == Weights::inPhase)
                for (int i = 0; i < nCols; ++i)
                    for (int j = 0; j < nRows; ++j)
                        matrix (j, i) /= getInPhaseLUT (order)[i];
            settings.weightsAlreadyApplied = false;
        }
    }

    const int getOrder() { return order; }

private:
    Settings settings;
    const int order;
    JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (ReferenceCountedDecoder)
};