engines/common/SignalUnitRack.h

/***************************************************************************
 *                                                                         *
 *   LinuxSampler - modular, streaming capable sampler                     *
 *                                                                         *
 *   Copyright (C) 2011 Grigor Iliev                                       *
 *                                                                         *
 *   This program 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 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 *   This program 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 program; if not, write to the Free Software           *
 *   Foundation, Inc., 59 Temple Place, Suite 330, Boston,                 *
 *   MA  02111-1307  USA                                                   *
 ***************************************************************************/

#ifndef __LS_SIGNALUNITRACK_H__
#define __LS_SIGNALUNITRACK_H__

#include "Event.h"
#include "SignalUnit.h"
#include "../../common/Pool.h"


namespace LinuxSampler {
    
    class EqSupport {
        private:
            int  BandCount;
            int* GainIdxs; ///< the indices of the gain controls
            int* FreqIdxs; ///< the indices of the frequency controls
            int* BandwidthIdxs; ///< the indices of the bandwidth controls
            Effect* pEffect;
            Effect* pEffect2; // If the effect is mono we'll need two effects
            
            inline float check(optional<float> minimum, optional<float> maximum, float value) {
                if (minimum) {
                    float min = *minimum;
                    if (value < min) value = min;
                }
                if (maximum) {
                    float max = *maximum;
                    if (value > max) value = max;
                }
                
                return value;
            }
            
        public:
            EqSupport();
            ~EqSupport();

            /**
             * Searches for know EQ effects and create one if the search succeed.
             * If the initialization is successful and EQ effect is selected,
             * HasSupport() returns true;
             */
            void Install();

            void Uninstall();

            /** Returns true if an EQ is created and is ready for use. */
            bool HasSupport() { return pEffect != NULL; }
 
            /** Reset the gains of all bands to 0dB. */
            void Reset() {
                if (!HasSupport()) return;
                for (int i = 0; i < BandCount; i++) {
                    pEffect->InputControl(GainIdxs[i])->SetValue(0); // 0dB
                    if (pEffect2 != NULL) pEffect2->InputControl(GainIdxs[i])->SetValue(0); // 0dB
                }
            }
            
            void InitEffect(AudioOutputDevice* pDevice) {
                if (pEffect != NULL) pEffect->InitEffect(pDevice);
                if (pEffect2 != NULL) pEffect2->InitEffect(pDevice);
            }
                
            int GetBandCount() { return BandCount; }

            void SetGain(int band, float gain);
            void SetFreq(int band, float freq);
            void SetBandwidth(int band, float octaves);
            
            AudioChannel* GetInChannelLeft() {
                return pEffect->InputChannel(0);
            }
            
            AudioChannel* GetInChannelRight() {
                return pEffect2 != NULL ? pEffect2->InputChannel(0) : pEffect->InputChannel(1);
            }
            
            AudioChannel* GetOutChannelLeft() {
                return pEffect->OutputChannel(0);
            }
            
            AudioChannel* GetOutChannelRight() {
                return pEffect2 != NULL ? pEffect2->OutputChannel(0) : pEffect->OutputChannel(1);
            }
            
            void RenderAudio(uint Samples) {
                pEffect->RenderAudio(Samples);
                if (pEffect2 != NULL) pEffect2->RenderAudio(Samples);
            }
    };
            
            
    class SignalUnitRack {
        protected:
            uint CurrentStep; // The current time step
            bool bHasEq;

        public:
            FixedArray<SignalUnit*> Units; // A list of all signal units in this rack

            /**
             * @param maxUnitCount We are using fixed size array because of the real-time safe requirements.
             */
            SignalUnitRack(int maxUnitCount): CurrentStep(0), bHasEq(false), Units(maxUnitCount) { }
            
            uint GetCurrentStep() { return CurrentStep; }

            virtual EndpointSignalUnit* GetEndpointUnit() = 0;
            
            virtual void EnterFadeOutStage() = 0;
            
            /**
             * Will be called to increment the time with one sample point.
             * Each unit should recalculate its current level on every call of this function.
             */
            virtual void Increment() {
                CurrentStep++;

                for (int i = 0; i < Units.size(); i++) {
                    Units[i]->Increment();
                }
            }
            
            virtual void ProcessCCEvent(RTList<Event>::Iterator& itEvent) {
                if ( !(itEvent->Type == Event::type_control_change && itEvent->Param.CC.Controller) ) return;
                for (int i = 0; i < Units.size(); i++) {
                    Units[i]->ProcessCCEvent(itEvent->Param.CC.Controller, itEvent->Param.CC.Value);
                }
            }
            
            /** Initializes and triggers the rack. */
            virtual void Trigger() {
                CurrentStep = 0;
                for (int i = 0; i < Units.size(); i++) {
                    Units[i]->Trigger();
                }
            }
            
            /**
             * When the rack belongs to a voice, this method is
             * called when the voice enter the release stage.
             */
            virtual void EnterReleaseStage() {
                for (int i = 0; i < Units.size(); i++) {
                    Units[i]->EnterReleaseStage();
                }
            }
            
            /**
             * When the rack belongs to a voice, this method is
             * called when the voice is of type which ignore note off.
             */
            virtual void CancelRelease() {
                for (int i = 0; i < Units.size(); i++) {
                    Units[i]->CancelRelease();
                }
            }
            
            /**
             * Determines whether an equalization is applied to the voice.
             * Used for optimization.
             */
            bool HasEq() { return bHasEq; }
            
            virtual void UpdateEqSettings(EqSupport* pEqSupport) = 0;
    };
} // namespace LinuxSampler

#endif  /* __LS_SIGNALUNITRACK_H__ */
1	iliev	2205	/***************************************************************************
2			* *
3			* LinuxSampler - modular, streaming capable sampler *
4			* *
5			* Copyright (C) 2011 Grigor Iliev *
6			* *
7			* This program is free software; you can redistribute it and/or modify *
8			* it under the terms of the GNU General Public License as published by *
9			* the Free Software Foundation; either version 2 of the License, or *
10			* (at your option) any later version. *
11			* *
12			* This program is distributed in the hope that it will be useful, *
13			* but WITHOUT ANY WARRANTY; without even the implied warranty of *
14			* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
15			* GNU General Public License for more details. *
16			* *
17			* You should have received a copy of the GNU General Public License *
18			* along with this program; if not, write to the Free Software *
19			* Foundation, Inc., 59 Temple Place, Suite 330, Boston, *
20			* MA 02111-1307 USA *
21			***************************************************************************/
22
23			#ifndef __LS_SIGNALUNITRACK_H__
24			#define __LS_SIGNALUNITRACK_H__
25
26			#include "Event.h"
27			#include "SignalUnit.h"
28			#include "../../common/Pool.h"
29
30
31			namespace LinuxSampler {
32	iliev	2218
33	iliev	2296	class EqSupport {
34			private:
35			int BandCount;
36			int* GainIdxs; ///< the indices of the gain controls
37			int* FreqIdxs; ///< the indices of the frequency controls
38			int* BandwidthIdxs; ///< the indices of the bandwidth controls
39			Effect* pEffect;
40			Effect* pEffect2; // If the effect is mono we'll need two effects
41
42			inline float check(optional<float> minimum, optional<float> maximum, float value) {
43			if (minimum) {
44			float min = *minimum;
45			if (value < min) value = min;
46			}
47			if (maximum) {
48			float max = *maximum;
49			if (value > max) value = max;
50			}
51
52			return value;
53			}
54
55			public:
56			EqSupport();
57			~EqSupport();
58
59			/**
60			* Searches for know EQ effects and create one if the search succeed.
61			* If the initialization is successful and EQ effect is selected,
62			* HasSupport() returns true;
63			*/
64			void Install();
65
66			void Uninstall();
67
68			/** Returns true if an EQ is created and is ready for use. */
69			bool HasSupport() { return pEffect != NULL; }
70
71			/** Reset the gains of all bands to 0dB. */
72			void Reset() {
73			if (!HasSupport()) return;
74			for (int i = 0; i < BandCount; i++) {
75			pEffect->InputControl(GainIdxs[i])->SetValue(0); // 0dB
76			if (pEffect2 != NULL) pEffect2->InputControl(GainIdxs[i])->SetValue(0); // 0dB
77			}
78			}
79
80			void InitEffect(AudioOutputDevice* pDevice) {
81			if (pEffect != NULL) pEffect->InitEffect(pDevice);
82			if (pEffect2 != NULL) pEffect2->InitEffect(pDevice);
83			}
84
85			int GetBandCount() { return BandCount; }
86
87			void SetGain(int band, float gain);
88			void SetFreq(int band, float freq);
89			void SetBandwidth(int band, float octaves);
90
91			AudioChannel* GetInChannelLeft() {
92			return pEffect->InputChannel(0);
93			}
94
95			AudioChannel* GetInChannelRight() {
96			return pEffect2 != NULL ? pEffect2->InputChannel(0) : pEffect->InputChannel(1);
97			}
98
99			AudioChannel* GetOutChannelLeft() {
100			return pEffect->OutputChannel(0);
101			}
102
103			AudioChannel* GetOutChannelRight() {
104			return pEffect2 != NULL ? pEffect2->OutputChannel(0) : pEffect->OutputChannel(1);
105			}
106
107			void RenderAudio(uint Samples) {
108			pEffect->RenderAudio(Samples);
109			if (pEffect2 != NULL) pEffect2->RenderAudio(Samples);
110			}
111			};
112
113
114
115	iliev	2205	class SignalUnitRack {
116			protected:
117			uint CurrentStep; // The current time step
118	iliev	2296	bool bHasEq;
119	iliev	2205
120			public:
121	iliev	2218	FixedArray<SignalUnit*> Units; // A list of all signal units in this rack
122	iliev	2217
123	iliev	2218	/**
124			* @param maxUnitCount We are using fixed size array because of the real-time safe requirements.
125			*/
126	iliev	2296	SignalUnitRack(int maxUnitCount): CurrentStep(0), bHasEq(false), Units(maxUnitCount) { }
127	iliev	2218
128	iliev	2205	uint GetCurrentStep() { return CurrentStep; }
129
130			virtual EndpointSignalUnit* GetEndpointUnit() = 0;
131
132	iliev	2218	virtual void EnterFadeOutStage() = 0;
133
134	iliev	2205	/**
135			* Will be called to increment the time with one sample point.
136			* Each unit should recalculate its current level on every call of this function.
137			*/
138			virtual void Increment() {
139			CurrentStep++;
140
141			for (int i = 0; i < Units.size(); i++) {
142			Units[i]->Increment();
143			}
144			}
145
146			virtual void ProcessCCEvent(RTList<Event>::Iterator& itEvent) {
147			if ( !(itEvent->Type == Event::type_control_change && itEvent->Param.CC.Controller) ) return;
148			for (int i = 0; i < Units.size(); i++) {
149			Units[i]->ProcessCCEvent(itEvent->Param.CC.Controller, itEvent->Param.CC.Value);
150			}
151			}
152
153			/** Initializes and triggers the rack. */
154			virtual void Trigger() {
155			CurrentStep = 0;
156			for (int i = 0; i < Units.size(); i++) {
157			Units[i]->Trigger();
158			}
159			}
160
161	iliev	2217	/**
162			* When the rack belongs to a voice, this method is
163			* called when the voice enter the release stage.
164			*/
165	iliev	2205	virtual void EnterReleaseStage() {
166			for (int i = 0; i < Units.size(); i++) {
167			Units[i]->EnterReleaseStage();
168			}
169			}
170
171	iliev	2217	/**
172			* When the rack belongs to a voice, this method is
173			* called when the voice is of type which ignore note off.
174			*/
175	iliev	2205	virtual void CancelRelease() {
176			for (int i = 0; i < Units.size(); i++) {
177			Units[i]->CancelRelease();
178			}
179			}
180	iliev	2296
181			/**
182			* Determines whether an equalization is applied to the voice.
183			* Used for optimization.
184			*/
185			bool HasEq() { return bHasEq; }
186
187			virtual void UpdateEqSettings(EqSupport* pEqSupport) = 0;
188	iliev	2205	};
189			} // namespace LinuxSampler
190
191			#endif /* __LS_SIGNALUNITRACK_H__ */