/[svn]/linuxsampler/trunk/src/engines/gig/Engine.h
ViewVC logotype

Diff of /linuxsampler/trunk/src/engines/gig/Engine.h

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 53 by schoenebeck, Mon Apr 26 17:15:51 2004 UTC revision 1800 by schoenebeck, Sun Dec 7 01:26:46 2008 UTC
# Line 2  Line 2 
2   *                                                                         *   *                                                                         *
3   *   LinuxSampler - modular, streaming capable sampler                     *   *   LinuxSampler - modular, streaming capable sampler                     *
4   *                                                                         *   *                                                                         *
5   *   Copyright (C) 2003 by Benno Senoner and Christian Schoenebeck         *   *   Copyright (C) 2003,2004 by Benno Senoner and Christian Schoenebeck    *
6     *   Copyright (C) 2005-2008 Christian Schoenebeck                         *
7   *                                                                         *   *                                                                         *
8   *   This program is free software; you can redistribute it and/or modify  *   *   This program is free software; you can redistribute it and/or modify  *
9   *   it under the terms of the GNU General Public License as published by  *   *   it under the terms of the GNU General Public License as published by  *
# Line 25  Line 26 
26    
27  #include "../../common/global.h"  #include "../../common/global.h"
28    
29  #if DEBUG_HEADERS  #include <map>
30  # warning Engine.h included  #include <gig.h>
 #endif // DEBUG_HEADERS  
31    
32    #include "EngineGlobals.h"
33  #include "../../common/RingBuffer.h"  #include "../../common/RingBuffer.h"
34  #include "../../common/RTELMemoryPool.h"  #include "../../common/Pool.h"
35    #include "../../common/ArrayList.h"
36    #include "../../common/Condition.h"
37  #include "../../common/ConditionServer.h"  #include "../../common/ConditionServer.h"
38  #include "../common/Engine.h"  #include "../Engine.h"
39  #include "../common/Event.h"  #include "../common/Event.h"
 #include "../../lib/fileloader/libgig/gig.h"  
 #include "InstrumentResourceManager.h"  
40  #include "../../network/lscp.h"  #include "../../network/lscp.h"
41    #include "EngineChannel.h"
42    
43  #define PITCHBEND_SEMITONES             12  // identifier of this sampler engine
44  #define MAX_AUDIO_VOICES                64  #define LS_GIG_ENGINE_NAME "GIG"
45    
46  namespace LinuxSampler { namespace gig {  namespace LinuxSampler { namespace gig {
47    
# Line 47  namespace LinuxSampler { namespace gig { Line 49  namespace LinuxSampler { namespace gig {
49      class Voice;      class Voice;
50      class DiskThread;      class DiskThread;
51      class InstrumentResourceManager;      class InstrumentResourceManager;
52        class midi_key_info_t;
53        class EngineChannel;
54    
55      /**      /**
56       * Sampler engine for the Gigasampler format.       * Sampler engine for the Gigasampler format.
57       */       */
58      class gig::Engine : public LinuxSampler::Engine, public InstrumentConsumer {      class Engine : public LinuxSampler::Engine {
59          public:          public:
60              // methods              // methods
61              Engine();              Engine();
62             ~Engine();              virtual ~Engine();
63                void Connect(AudioOutputDevice* pAudioOut);
64                void SuspendAll();
65                void ResumeAll();
66                void Suspend(::gig::Region* pRegion);
67                void Resume(::gig::Region* pRegion);
68    
69              // abstract methods derived from class 'LinuxSampler::Engine'              // implementation of abstract methods derived from class 'LinuxSampler::Engine'
70              virtual void   LoadInstrument(const char* FileName, uint Instrument);              virtual int    RenderAudio(uint Samples);
71                virtual void   SendSysex(void* pData, uint Size, MidiInputPort* pSender);
72              virtual void   Reset();              virtual void   Reset();
73              virtual void   Enable();              virtual void   Enable();
74              virtual void   Disable();              virtual void   Disable();
             virtual void   SendNoteOn(uint8_t Key, uint8_t Velocity);  
             virtual void   SendNoteOff(uint8_t Key, uint8_t Velocity);  
             virtual void   SendPitchbend(int Pitch);  
             virtual void   SendControlChange(uint8_t Controller, uint8_t Value);  
             virtual float  Volume();  
             virtual void   Volume(float f);  
             virtual void   Connect(AudioOutputDevice* pAudioOut);  
             virtual void   DisconnectAudioOutputDevice();  
             virtual int    RenderAudio(uint Samples);  
75              virtual uint   VoiceCount();              virtual uint   VoiceCount();
76              virtual uint   VoiceCountMax();              virtual uint   VoiceCountMax();
77                virtual int    MaxVoices();
78                virtual void   SetMaxVoices(int iVoices) throw (Exception);
79              virtual bool   DiskStreamSupported();              virtual bool   DiskStreamSupported();
80              virtual uint   DiskStreamCount();              virtual uint   DiskStreamCount();
81              virtual uint   DiskStreamCountMax();              virtual uint   DiskStreamCountMax();
82                virtual int    MaxDiskStreams();
83                virtual void   SetMaxDiskStreams(int iStreams) throw (Exception);
84              virtual String DiskStreamBufferFillBytes();              virtual String DiskStreamBufferFillBytes();
85              virtual String DiskStreamBufferFillPercentage();              virtual String DiskStreamBufferFillPercentage();
86              virtual String Description();              virtual String Description();
87              virtual String Version();              virtual String Version();
88                virtual String EngineName();
89                virtual InstrumentManager* GetInstrumentManager();
90    
91              // abstract methods derived from interface class 'InstrumentConsumer'              void SetVoiceCount(uint Count);
92              virtual void ResourceToBeUpdated(::gig::Instrument* pResource, void*& pUpdateArg);  
93              virtual void ResourceUpdated(::gig::Instrument* pOldResource, ::gig::Instrument* pNewResource, void* pUpdateArg);              // Simple array wrapper just to make sure memory is freed
94          protected:              // when liblinuxsampler is unloaded
95              struct midi_key_info_t {              class FloatTable {
96                  RTEList<Voice>* pActiveVoices; ///< Contains the active voices associated with the MIDI key.              private:
97                  bool            KeyPressed;    ///< Is true if the respective MIDI key is currently pressed.                  const float* array;
98                  bool            Active;        ///< If the key contains active voices.              public:
99                  uint*           pSelf;         ///< hack to allow fast deallocation of the key from the list of active keys                  FloatTable(const float* array) : array(array) { }
100                  RTEList<Event>* pEvents;       ///< Key specific events (only Note-on, Note-off and sustain pedal currently)                  ~FloatTable() { delete[] array; }
101                    const float& operator[](int i) const { return array[i]; }
102              };              };
103    
104              static InstrumentResourceManager Instruments;              static const FloatTable VolumeCurve;    ///< Table that maps volume control change values 0..127 to amplitude. Unity gain is at 90.
105                static const FloatTable PanCurve;       ///< Table that maps pan control change values 0..128 to right channel amplitude. Unity gain is at 64 (center).
106                static const FloatTable CrossfadeCurve; ///< Table that maps crossfade control change values 0..127 to amplitude. Unity gain is at 127.
107    
108            //protected:
109                static InstrumentResourceManager instruments;
110    
111              AudioOutputDevice*      pAudioOutputDevice;              AudioOutputDevice*      pAudioOutputDevice;
112                uint                    SampleRate;            ///< Sample rate of the engines output audio signal (in Hz)
113                uint                    MaxSamplesPerCycle;    ///< Size of each audio output buffer
114              DiskThread*             pDiskThread;              DiskThread*             pDiskThread;
115              uint8_t                 ControllerTable[128];  ///< Reflects the current values (0-127) of all MIDI controllers for this engine / sampler channel.              RingBuffer<Event,false>* pEventQueue;          ///< Input event queue for engine global events (e.g. SysEx messages).
116              RingBuffer<Event>*      pEventQueue;           ///< Input event queue.              Pool<Voice>*            pVoicePool;            ///< Contains all voices that can be activated.
             midi_key_info_t         pMIDIKeyInfo[128];     ///< Contains all active voices sorted by MIDI key number and other informations to the respective MIDI key  
             RTELMemoryPool<Voice>*  pVoicePool;            ///< Contains all voices that can be activated.  
             RTELMemoryPool<uint>*   pActiveKeys;           ///< Holds all keys in it's allocation list with active voices.  
             RTELMemoryPool<Event>*  pEventPool;            ///< Contains all Event objects that can be used.  
117              EventGenerator*         pEventGenerator;              EventGenerator*         pEventGenerator;
118              RTEList<Event>*         pEvents;               ///< All events for the current audio fragment.              RTList<Event>*          pVoiceStealingQueue;   ///< All voice-launching events which had to be postponed due to free voice shortage.
119              RTEList<Event>*         pCCEvents;             ///< All control change events for the current audio fragment.              RTList<Event>*          pGlobalEvents;         ///< All engine global events for the current audio fragment (usually only SysEx messages).
120              RTEList<Event>*         pSynthesisEvents[Event::destination_count];     ///< Events directly affecting synthesis parameter (like pitch, volume and filter).              Pool<Event>*            pEventPool;            ///< Contains all Event objects that can be used.
121              float*                  pSynthesisParameters[Event::destination_count]; ///< Matrix with final synthesis parameters for the current audio fragment which will be used in the main synthesis loop.              RingBuffer<uint8_t,false>* pSysexBuffer;       ///< Input buffer for MIDI system exclusive messages.
122              RIFF::File*             pRIFF;              int                     ActiveVoiceCountTemp;  ///< number of currently active voices (for internal usage, will be used for incrementation)
             ::gig::File*            pGig;  
             ::gig::Instrument*      pInstrument;  
             bool                    SustainPedal;          ///< true if sustain pedal is down  
             double                  GlobalVolume;          ///< overall volume (a value < 1.0 means attenuation, a value > 1.0 means amplification)  
             int                     Pitch;                 ///< Current (absolute) MIDI pitch value.  
             int                     ActiveVoiceCount;      ///< number of currently active voices  
123              int                     ActiveVoiceCountMax;   ///< the maximum voice usage since application start              int                     ActiveVoiceCountMax;   ///< the maximum voice usage since application start
124                int                     VoiceSpawnsLeft;       ///< We only allow CONFIG_MAX_VOICES voices to be spawned per audio fragment, we use this variable to ensure this limit.
125                RTList<Voice>::Iterator itLastStolenVoice;     ///< Only for voice stealing: points to the last voice which was theft in current audio fragment, NULL otherwise.
126                RTList<uint>::Iterator  iuiLastStolenKey;      ///< Only for voice stealing: key number of last key on which the last voice was theft in current audio fragment, NULL otherwise.
127                EngineChannel*          pLastStolenChannel;    ///< Only for voice stealing: points to the engine channel on which the previous voice was stolen in this audio fragment.
128                RTList<Voice>::Iterator itLastStolenVoiceGlobally; ///< Same as itLastStolenVoice, but engine globally
129                RTList<uint>::Iterator  iuiLastStolenKeyGlobally;  ///< Same as iuiLastStolenKey, but engine globally
130              bool                    SuspensionRequested;              bool                    SuspensionRequested;
131              ConditionServer         EngineDisabled;              ConditionServer         EngineDisabled;
132                int8_t                  ScaleTuning[12];       ///< contains optional detune factors (-64..+63 cents) for all 12 semitones of an octave
133              void ProcessNoteOn(Event* pNoteOnEvent);              int                     MinFadeOutSamples;     ///< The number of samples needed to make an instant fade out (e.g. for voice stealing) without leading to clicks.
134              void ProcessNoteOff(Event* pNoteOffEvent);              uint32_t                RandomSeed;            ///< State of the random number generator used by the random dimension.
135              void ProcessPitchbend(Event* pPitchbendEvent);              Mutex                   ResetInternalMutex;    ///< Mutex to protect the ResetInternal function for concurrent usage (e.g. by the lscp and instrument loader threads).
136              void ProcessControlChange(Event* pControlChangeEvent);              Pool< ::gig::DimensionRegion*>* pDimRegionPool[2]; ///< Double buffered pool, used by the engine channels to keep track of dimension regions in use.
137              void KillVoice(Voice* pVoice);  
138              void ResetSynthesisParameters(Event::destination_t dst, float val);              void ProcessEvents(EngineChannel* pEngineChannel, uint Samples);
139                void RenderActiveVoices(EngineChannel* pEngineChannel, uint Samples);
140                void RenderStolenVoices(uint Samples);
141                void RouteAudio(EngineChannel* pEngineChannel, uint Samples);
142                void PostProcess(EngineChannel* pEngineChannel);
143                void ClearEventLists();
144                void ImportEvents(uint Samples);
145                void ProcessNoteOn(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOnEvent);
146                void ProcessNoteOff(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOffEvent);
147                void ProcessPitchbend(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itPitchbendEvent);
148                void ProcessControlChange(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itControlChangeEvent);
149                void ProcessSysex(Pool<Event>::Iterator& itSysexEvent);
150                void ProcessSuspensionsChanges();
151                void ProcessPendingStreamDeletions();
152                Pool<Voice>::Iterator LaunchVoice(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOnEvent, int iLayer, bool ReleaseTriggerVoice, bool VoiceStealing, bool HandleKeyGroupConflicts);
153                int  StealVoice(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOnEvent);
154                void FreeVoice(EngineChannel* pEngineChannel, Pool<Voice>::Iterator& itVoice);
155                void FreeKey(EngineChannel* pEngineChannel, midi_key_info_t* pKey);
156              void ResetInternal();              void ResetInternal();
157                void ResetScaleTuning();
158                void ResetSuspendedRegions();
159    
160                static Engine* AcquireEngine(LinuxSampler::gig::EngineChannel* pChannel, AudioOutputDevice* pDevice);
161                static void    FreeEngine(LinuxSampler::gig::EngineChannel* pChannel, AudioOutputDevice* pDevice);
162    
163                void DisableAndLock(); // FIXME: should at least be protected
164    
165              friend class Voice;              friend class Voice;
             friend class EGADSR;  
             friend class EGDecay;  
             friend class VCAManipulator;  
             friend class VCFCManipulator;  
             friend class VCOManipulator;  
             friend class InstrumentResourceManager;  
166          private:          private:
167              //static void AllocateSynthesisParametersMatrix();              Pool< ::gig::Region*> SuspendedRegions;
168                Mutex                 SuspendedRegionsMutex;
169                Condition             SuspensionChangeOngoing;
170                ::gig::Region*        pPendingRegionSuspension;
171                ::gig::Region*        pPendingRegionResumption;
172                int                   iPendingStreamDeletions;
173    
174                ArrayList<EngineChannel*> engineChannels; ///< All engine channels of a gig::Engine instance.
175    
176                static std::map<AudioOutputDevice*,Engine*> engines; ///< All instances of gig::Engine.
177    
178                int SostenutoKeys[128];
179                int SostenutoKeyCount;
180    
181                uint8_t GSCheckSum(const RingBuffer<uint8_t,false>::NonVolatileReader AddrReader, uint DataSize);
182                void    AdjustScale(int8_t ScaleTunes[12]);
183                void    ReleaseAllVoices(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itReleaseEvent);
184                void    KillAllVoices(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itKillEvent);
185                bool    ShouldReleaseVoice(EngineChannel* pEngineChannel, int Key);
186                bool    RegionSuspended(::gig::Region* pRegion);
187                static float* InitVolumeCurve();
188                static float* InitPanCurve();
189                static float* InitCrossfadeCurve();
190                static float* InitCurve(const float* segments, int size = 128);
191    
192                unsigned long FrameTime; ///< Time in frames of the start of the current audio fragment
193    
194              void DisableAndLock();              atomic_t ActiveVoiceCount; ///< number of currently active voices
195                int iMaxDiskStreams;
196      };      };
197    
198  }} // namespace LinuxSampler::gig  }} // namespace LinuxSampler::gig
Legend:
Removed from v.53  
changed lines
  Added in v.1800
  ViewVC Help
Powered by ViewVC