engines/sfz/Voice.h

/***************************************************************************
 *                                                                         *
 *   LinuxSampler - modular, streaming capable sampler                     *
 *                                                                         *
 *   Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck   *
 *   Copyright (C) 2005 - 2008 Christian Schoenebeck                       *
 *   Copyright (C) 2009 - 2012 Christian Schoenebeck and 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_SFZ_VOICE_H__
#define __LS_SFZ_VOICE_H__

#include "../../common/global_private.h"

#include "../../common/RTMath.h"
#include "../../common/Pool.h"
#include "../../drivers/audio/AudioOutputDevice.h"
#include "DiskThread.h"
#include "../gig/Filter.h"
#include "../common/VoiceBase.h"
#include "../gig/SynthesisParam.h"
#include "EG.h"
#include "EGADSR.h"
#include "SfzSignalUnitRack.h"

namespace LinuxSampler { namespace sfz {
    class Engine;
    class EngineChannel;

    /** SoundFont Voice
     *
     * Renders a voice for the SoundFont format.
     */
    class Voice : public LinuxSampler::VoiceBase<EngineChannel, ::sfz::Region, Sample, DiskThread> {
        public:
            Voice();
            virtual ~Voice();
            void SetOutput(AudioOutputDevice* pAudioOutputDevice);
            void SetEngine(LinuxSampler::Engine* pEngine);
            void CalculateFadeOutCoeff(float FadeOutTime, float SampleRate);
            virtual release_trigger_t GetReleaseTriggerFlags() OVERRIDE;

            virtual void VoiceFreed() OVERRIDE { SignalRack.Reset(); }

        protected:
            virtual SampleInfo       GetSampleInfo() OVERRIDE;
            virtual RegionInfo       GetRegionInfo() OVERRIDE;
            virtual InstrumentInfo   GetInstrumentInfo() OVERRIDE;
            virtual double           CalculateCrossfadeVolume(uint8_t MIDIKeyVelocity) OVERRIDE;
            virtual AbstractEngine*  GetEngine() OVERRIDE { return (AbstractEngine*)pEngine; }
            virtual float            GetReleaseTriggerAttenuation(float noteLength) OVERRIDE;
            virtual double           GetEG1ControllerValue(uint8_t MIDIKeyVelocity) OVERRIDE;
            virtual EGInfo           CalculateEG1ControllerInfluence(double eg1ControllerValue) OVERRIDE;
            virtual void             TriggerEG1(const EGInfo& egInfo, double velrelease, double velocityAttenuation, uint sampleRate, uint8_t velocity) OVERRIDE { }
            virtual double           GetEG2ControllerValue(uint8_t MIDIKeyVelocity) OVERRIDE;
            virtual EGInfo           CalculateEG2ControllerInfluence(double eg2ControllerValue) OVERRIDE;
            virtual void             TriggerEG2(const EGInfo& egInfo, double velrelease, double velocityAttenuation, uint sampleRate, uint8_t velocity) OVERRIDE { }
            virtual void             InitLFO1() OVERRIDE { }
            virtual void             InitLFO2() OVERRIDE { }
            virtual void             InitLFO3() OVERRIDE { }
            virtual float            CalculateCutoffBase(uint8_t MIDIKeyVelocity) OVERRIDE;
            virtual float            CalculateFinalCutoff(float cutoffBase) OVERRIDE;
            virtual uint8_t          GetVCFCutoffCtrl() OVERRIDE { return 0; }
            virtual uint8_t          GetVCFResonanceCtrl() OVERRIDE { return 0; }
            virtual void             ProcessCCEvent(RTList<Event>::Iterator& itEvent) OVERRIDE;
            virtual void             ProcessChannelPressureEvent(RTList<Event>::Iterator& itEvent) OVERRIDE;
            virtual void             ProcessPolyphonicKeyPressureEvent(RTList<Event>::Iterator& itEvent) OVERRIDE;
            virtual void             ProcessCutoffEvent(RTList<Event>::Iterator& itEvent) OVERRIDE { }
            virtual double           GetVelocityAttenuation(uint8_t MIDIKeyVelocity) OVERRIDE;
            virtual double           GetVelocityRelease(uint8_t MIDIKeyVelocity) OVERRIDE;
            virtual double           GetSampleAttenuation() OVERRIDE;
            virtual void             ProcessGroupEvent(RTList<Event>::Iterator& itEvent) OVERRIDE;
            virtual void             SetSampleStartOffset() OVERRIDE;
            virtual int              GetRAMCacheOffset() OVERRIDE { return pRegion->pSample->RAMCacheOffset; }
            virtual int              CalculatePan(uint8_t pan) OVERRIDE;

        private:
            SfzSignalUnitRack SignalRack;

        public: // FIXME: just made public for debugging (sanity check in Engine::RenderAudio()), should be changed to private before the final release
            // Attributes
            Engine*                     pEngine;            ///< Pointer to the sampler engine, to be able to access the event lists.
            //uint                        LoopCyclesLeft;     ///< In case there is a RAMLoop and it's not an endless loop; reflects number of loop cycles left to be passed

            // Static Methods
            static float CalculateFilterCutoffCoeff();

            // Methods
            void ProcessEvents(uint Samples);
            void processCrossFadeEvent(RTList<Event>::Iterator& itEvent);

            EngineChannel* GetSfzEngineChannel();
            
            friend class CCUnit;
            friend class XFInCCUnit;
            friend class XFOutCCUnit;
            friend class AmpEGUnit;
            friend class FilEGUnit;
            friend class PitchEGUnit;
            friend class PitchLFOUnit;
            friend class AmpLFOUnit;
            friend class FilLFOUnit;
            friend class EndpointUnit;
            friend class SfzSignalUnitRack;

        protected:
            virtual uint8_t CrossfadeAttenuation(uint8_t& CrossfadeControllerValue) OVERRIDE {
                /*uint8_t c = std::max(CrossfadeControllerValue, pRegion->AttenuationControllerThreshold);
                c = (!pRegion->Crossfade.out_end) ? c     // 0,0,0,0 means no crossfade defined
                          : (c < pRegion->Crossfade.in_end) ?
                                ((c <= pRegion->Crossfade.in_start) ? 0
                                : 127 * (c - pRegion->Crossfade.in_start) / (pRegion->Crossfade.in_end - pRegion->Crossfade.in_start))
                          : (c <= pRegion->Crossfade.out_start) ? 127
                          : (c < pRegion->Crossfade.out_end) ? 127 * (pRegion->Crossfade.out_end - c) / (pRegion->Crossfade.out_end - pRegion->Crossfade.out_start)
                          : 0;
                return pRegion->InvertAttenuationController ? 127 - c : c;*/ // TODO: ^^^
                return 0;
            }
    };

}} // namespace LinuxSampler::sfz

#endif // __LS_SFZ_VOICE_H__
1	iliev	2012	/***************************************************************************
2			* *
3			* LinuxSampler - modular, streaming capable sampler *
4			* *
5			* Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck *
6	persson	2055	* Copyright (C) 2005 - 2008 Christian Schoenebeck *
7	persson	2311	* Copyright (C) 2009 - 2012 Christian Schoenebeck and Grigor Iliev *
8	iliev	2012	* *
9			* This program is free software; you can redistribute it and/or modify *
10			* it under the terms of the GNU General Public License as published by *
11			* the Free Software Foundation; either version 2 of the License, or *
12			* (at your option) any later version. *
13			* *
14			* This program is distributed in the hope that it will be useful, *
15			* but WITHOUT ANY WARRANTY; without even the implied warranty of *
16			* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
17			* GNU General Public License for more details. *
18			* *
19			* You should have received a copy of the GNU General Public License *
20			* along with this program; if not, write to the Free Software *
21			* Foundation, Inc., 59 Temple Place, Suite 330, Boston, *
22			* MA 02111-1307 USA *
23			***************************************************************************/
24
25			#ifndef __LS_SFZ_VOICE_H__
26			#define __LS_SFZ_VOICE_H__
27
28			#include "../../common/global_private.h"
29
30			#include "../../common/RTMath.h"
31			#include "../../common/Pool.h"
32			#include "../../drivers/audio/AudioOutputDevice.h"
33			#include "DiskThread.h"
34			#include "../gig/Filter.h"
35			#include "../common/VoiceBase.h"
36			#include "../gig/SynthesisParam.h"
37	persson	2055	#include "EG.h"
38			#include "EGADSR.h"
39	iliev	2218	#include "SfzSignalUnitRack.h"
40	iliev	2012
41			namespace LinuxSampler { namespace sfz {
42			class Engine;
43			class EngineChannel;
44
45	iliev	2015	/** SoundFont Voice
46	iliev	2012	*
47	iliev	2015	* Renders a voice for the SoundFont format.
48	iliev	2012	*/
49	iliev	2021	class Voice : public LinuxSampler::VoiceBase<EngineChannel, ::sfz::Region, Sample, DiskThread> {
50	iliev	2012	public:
51			Voice();
52			virtual ~Voice();
53			void SetOutput(AudioOutputDevice* pAudioOutputDevice);
54			void SetEngine(LinuxSampler::Engine* pEngine);
55	persson	2327	void CalculateFadeOutCoeff(float FadeOutTime, float SampleRate);
56	schoenebeck	3444	virtual release_trigger_t GetReleaseTriggerFlags() OVERRIDE;
57
58	schoenebeck	3054	virtual void VoiceFreed() OVERRIDE { SignalRack.Reset(); }
59	iliev	2012
60	iliev	2015	protected:
61	schoenebeck	3054	virtual SampleInfo GetSampleInfo() OVERRIDE;
62			virtual RegionInfo GetRegionInfo() OVERRIDE;
63			virtual InstrumentInfo GetInstrumentInfo() OVERRIDE;
64			virtual double CalculateCrossfadeVolume(uint8_t MIDIKeyVelocity) OVERRIDE;
65			virtual AbstractEngine* GetEngine() OVERRIDE { return (AbstractEngine*)pEngine; }
66			virtual float GetReleaseTriggerAttenuation(float noteLength) OVERRIDE;
67			virtual double GetEG1ControllerValue(uint8_t MIDIKeyVelocity) OVERRIDE;
68			virtual EGInfo CalculateEG1ControllerInfluence(double eg1ControllerValue) OVERRIDE;
69			virtual void TriggerEG1(const EGInfo& egInfo, double velrelease, double velocityAttenuation, uint sampleRate, uint8_t velocity) OVERRIDE { }
70			virtual double GetEG2ControllerValue(uint8_t MIDIKeyVelocity) OVERRIDE;
71			virtual EGInfo CalculateEG2ControllerInfluence(double eg2ControllerValue) OVERRIDE;
72			virtual void TriggerEG2(const EGInfo& egInfo, double velrelease, double velocityAttenuation, uint sampleRate, uint8_t velocity) OVERRIDE { }
73			virtual void InitLFO1() OVERRIDE { }
74			virtual void InitLFO2() OVERRIDE { }
75			virtual void InitLFO3() OVERRIDE { }
76			virtual float CalculateCutoffBase(uint8_t MIDIKeyVelocity) OVERRIDE;
77			virtual float CalculateFinalCutoff(float cutoffBase) OVERRIDE;
78			virtual uint8_t GetVCFCutoffCtrl() OVERRIDE { return 0; }
79			virtual uint8_t GetVCFResonanceCtrl() OVERRIDE { return 0; }
80	schoenebeck	2559	virtual void ProcessCCEvent(RTList<Event>::Iterator& itEvent) OVERRIDE;
81			virtual void ProcessChannelPressureEvent(RTList<Event>::Iterator& itEvent) OVERRIDE;
82			virtual void ProcessPolyphonicKeyPressureEvent(RTList<Event>::Iterator& itEvent) OVERRIDE;
83	schoenebeck	3054	virtual void ProcessCutoffEvent(RTList<Event>::Iterator& itEvent) OVERRIDE { }
84			virtual double GetVelocityAttenuation(uint8_t MIDIKeyVelocity) OVERRIDE;
85			virtual double GetVelocityRelease(uint8_t MIDIKeyVelocity) OVERRIDE;
86			virtual double GetSampleAttenuation() OVERRIDE;
87			virtual void ProcessGroupEvent(RTList<Event>::Iterator& itEvent) OVERRIDE;
88			virtual void SetSampleStartOffset() OVERRIDE;
89			virtual int GetRAMCacheOffset() OVERRIDE { return pRegion->pSample->RAMCacheOffset; }
90			virtual int CalculatePan(uint8_t pan) OVERRIDE;
91	iliev	2015
92			private:
93	iliev	2218	SfzSignalUnitRack SignalRack;
94	persson	2055
95	iliev	2015	public: // FIXME: just made public for debugging (sanity check in Engine::RenderAudio()), should be changed to private before the final release
96	iliev	2012	// Attributes
97			Engine* pEngine; ///< Pointer to the sampler engine, to be able to access the event lists.
98			//uint LoopCyclesLeft; ///< In case there is a RAMLoop and it's not an endless loop; reflects number of loop cycles left to be passed
99
100			// Static Methods
101			static float CalculateFilterCutoffCoeff();
102
103			// Methods
104			void ProcessEvents(uint Samples);
105			void processCrossFadeEvent(RTList<Event>::Iterator& itEvent);
106
107	iliev	2015	EngineChannel* GetSfzEngineChannel();
108	iliev	2218
109	iliev	2230	friend class CCUnit;
110	iliev	2236	friend class XFInCCUnit;
111			friend class XFOutCCUnit;
112	iliev	2229	friend class AmpEGUnit;
113	iliev	2222	friend class FilEGUnit;
114	iliev	2220	friend class PitchEGUnit;
115	iliev	2221	friend class PitchLFOUnit;
116			friend class AmpLFOUnit;
117			friend class FilLFOUnit;
118	iliev	2236	friend class EndpointUnit;
119	iliev	2218	friend class SfzSignalUnitRack;
120	iliev	2015
121			protected:
122	schoenebeck	3054	virtual uint8_t CrossfadeAttenuation(uint8_t& CrossfadeControllerValue) OVERRIDE {
123	iliev	2015	/*uint8_t c = std::max(CrossfadeControllerValue, pRegion->AttenuationControllerThreshold);
124			c = (!pRegion->Crossfade.out_end) ? c // 0,0,0,0 means no crossfade defined
125			: (c < pRegion->Crossfade.in_end) ?
126			((c <= pRegion->Crossfade.in_start) ? 0
127			: 127 * (c - pRegion->Crossfade.in_start) / (pRegion->Crossfade.in_end - pRegion->Crossfade.in_start))
128			: (c <= pRegion->Crossfade.out_start) ? 127
129			: (c < pRegion->Crossfade.out_end) ? 127 * (pRegion->Crossfade.out_end - c) / (pRegion->Crossfade.out_end - pRegion->Crossfade.out_start)
130			: 0;
131			return pRegion->InvertAttenuationController ? 127 - c : c;*/ // TODO: ^^^
132			return 0;
133	iliev	2012	}
134			};
135
136			}} // namespace LinuxSampler::sfz
137
138			#endif // __LS_SFZ_VOICE_H__