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

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

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

revision 80 by schoenebeck, Sun May 23 19:16:33 2004 UTC revision 924 by schoenebeck, Sat Oct 21 14:13:09 2006 UTC
# Line 3  Line 3 
3   *   LinuxSampler - modular, streaming capable sampler                     *   *   LinuxSampler - modular, streaming capable sampler                     *
4   *                                                                         *   *                                                                         *
5   *   Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck   *   *   Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck   *
6     *   Copyright (C) 2005, 2006 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 23  Line 24 
24  #include <sstream>  #include <sstream>
25  #include "DiskThread.h"  #include "DiskThread.h"
26  #include "Voice.h"  #include "Voice.h"
27    #include "EGADSR.h"
28    #include "../EngineFactory.h"
29    
30  #include "Engine.h"  #include "Engine.h"
31    
32  namespace LinuxSampler { namespace gig {  namespace LinuxSampler { namespace gig {
33    
34      InstrumentResourceManager Engine::Instruments;      InstrumentResourceManager Engine::instruments;
35    
36        std::map<AudioOutputDevice*,Engine*> Engine::engines;
37    
38        /**
39         * Get a gig::Engine object for the given gig::EngineChannel and the
40         * given AudioOutputDevice. All engine channels which are connected to
41         * the same audio output device will use the same engine instance. This
42         * method will be called by a gig::EngineChannel whenever it's
43         * connecting to a audio output device.
44         *
45         * @param pChannel - engine channel which acquires an engine object
46         * @param pDevice  - the audio output device \a pChannel is connected to
47         */
48        Engine* Engine::AcquireEngine(LinuxSampler::gig::EngineChannel* pChannel, AudioOutputDevice* pDevice) {
49            Engine* pEngine = NULL;
50            // check if there's already an engine for the given audio output device
51            if (engines.count(pDevice)) {
52                dmsg(4,("Using existing gig::Engine.\n"));
53                pEngine = engines[pDevice];
54            } else { // create a new engine (and disk thread) instance for the given audio output device
55                dmsg(4,("Creating new gig::Engine.\n"));
56                pEngine = (Engine*) EngineFactory::Create("gig");
57                pEngine->Connect(pDevice);
58                engines[pDevice] = pEngine;
59            }
60            // register engine channel to the engine instance
61            pEngine->engineChannels.add(pChannel);
62            // remember index in the ArrayList
63            pChannel->iEngineIndexSelf = pEngine->engineChannels.size() - 1;
64            dmsg(4,("This gig::Engine has now %d EngineChannels.\n",pEngine->engineChannels.size()));
65            return pEngine;
66        }
67    
68        /**
69         * Once an engine channel is disconnected from an audio output device,
70         * it wil immediately call this method to unregister itself from the
71         * engine instance and if that engine instance is not used by any other
72         * engine channel anymore, then that engine instance will be destroyed.
73         *
74         * @param pChannel - engine channel which wants to disconnect from it's
75         *                   engine instance
76         * @param pDevice  - audio output device \a pChannel was connected to
77         */
78        void Engine::FreeEngine(LinuxSampler::gig::EngineChannel* pChannel, AudioOutputDevice* pDevice) {
79            dmsg(4,("Disconnecting EngineChannel from gig::Engine.\n"));
80            Engine* pEngine = engines[pDevice];
81            // unregister EngineChannel from the Engine instance
82            pEngine->engineChannels.remove(pChannel);
83            // if the used Engine instance is not used anymore, then destroy it
84            if (pEngine->engineChannels.empty()) {
85                pDevice->Disconnect(pEngine);
86                engines.erase(pDevice);
87                delete pEngine;
88                dmsg(4,("Destroying gig::Engine.\n"));
89            }
90            else dmsg(4,("This gig::Engine has now %d EngineChannels.\n",pEngine->engineChannels.size()));
91        }
92    
93        /**
94         * Constructor
95         */
96      Engine::Engine() {      Engine::Engine() {
         pRIFF              = NULL;  
         pGig               = NULL;  
         pInstrument        = NULL;  
97          pAudioOutputDevice = NULL;          pAudioOutputDevice = NULL;
98          pDiskThread        = NULL;          pDiskThread        = NULL;
99          pEventGenerator    = NULL;          pEventGenerator    = NULL;
100          pEventQueue        = new RingBuffer<Event>(MAX_EVENTS_PER_FRAGMENT);          pSysexBuffer       = new RingBuffer<uint8_t>(CONFIG_SYSEX_BUFFER_SIZE, 0);
101          pEventPool         = new RTELMemoryPool<Event>(MAX_EVENTS_PER_FRAGMENT);          pEventQueue        = new RingBuffer<Event>(CONFIG_MAX_EVENTS_PER_FRAGMENT, 0);
102          pVoicePool         = new RTELMemoryPool<Voice>(MAX_AUDIO_VOICES);          pEventPool         = new Pool<Event>(CONFIG_MAX_EVENTS_PER_FRAGMENT);
103          pActiveKeys        = new RTELMemoryPool<uint>(128);          pVoicePool         = new Pool<Voice>(CONFIG_MAX_VOICES);
104          pEvents            = new RTEList<Event>(pEventPool);          pVoiceStealingQueue = new RTList<Event>(pEventPool);
105          pCCEvents          = new RTEList<Event>(pEventPool);          pGlobalEvents      = new RTList<Event>(pEventPool);
106          for (uint i = 0; i < Event::destination_count; i++) {          for (RTList<Voice>::Iterator iterVoice = pVoicePool->allocAppend(); iterVoice == pVoicePool->last(); iterVoice = pVoicePool->allocAppend()) {
107              pSynthesisEvents[i] = new RTEList<Event>(pEventPool);              iterVoice->SetEngine(this);
         }  
         for (uint i = 0; i < 128; i++) {  
             pMIDIKeyInfo[i].pActiveVoices = new RTEList<Voice>(pVoicePool);  
             pMIDIKeyInfo[i].KeyPressed    = false;  
             pMIDIKeyInfo[i].Active        = false;  
             pMIDIKeyInfo[i].pSelf         = NULL;  
             pMIDIKeyInfo[i].pEvents       = new RTEList<Event>(pEventPool);  
         }  
         for (Voice* pVoice = pVoicePool->alloc(); pVoice; pVoice = pVoicePool->alloc()) {  
             pVoice->SetEngine(this);  
108          }          }
109          pVoicePool->clear();          pVoicePool->clear();
110    
         pSynthesisParameters[0] = NULL; // we allocate when an audio device is connected  
         pBasicFilterParameters  = NULL;  
         pMainFilterParameters   = NULL;  
   
111          ResetInternal();          ResetInternal();
112            ResetScaleTuning();
113      }      }
114    
115        /**
116         * Destructor
117         */
118      Engine::~Engine() {      Engine::~Engine() {
119            MidiInputPort::RemoveSysexListener(this);
120          if (pDiskThread) {          if (pDiskThread) {
121                dmsg(1,("Stopping disk thread..."));
122              pDiskThread->StopThread();              pDiskThread->StopThread();
123              delete pDiskThread;              delete pDiskThread;
124                dmsg(1,("OK\n"));
125          }          }
         if (pGig)  delete pGig;  
         if (pRIFF) delete pRIFF;  
         for (uint i = 0; i < 128; i++) {  
             if (pMIDIKeyInfo[i].pActiveVoices) delete pMIDIKeyInfo[i].pActiveVoices;  
             if (pMIDIKeyInfo[i].pEvents)       delete pMIDIKeyInfo[i].pEvents;  
         }  
         for (uint i = 0; i < Event::destination_count; i++) {  
             if (pSynthesisEvents[i]) delete pSynthesisEvents[i];  
         }  
         delete[] pSynthesisEvents;  
         if (pEvents)     delete pEvents;  
         if (pCCEvents)   delete pCCEvents;  
126          if (pEventQueue) delete pEventQueue;          if (pEventQueue) delete pEventQueue;
127          if (pEventPool)  delete pEventPool;          if (pEventPool)  delete pEventPool;
128          if (pVoicePool)  delete pVoicePool;          if (pVoicePool) {
129          if (pActiveKeys) delete pActiveKeys;              pVoicePool->clear();
130                delete pVoicePool;
131            }
132          if (pEventGenerator) delete pEventGenerator;          if (pEventGenerator) delete pEventGenerator;
133          if (pMainFilterParameters) delete[] pMainFilterParameters;          if (pVoiceStealingQueue) delete pVoiceStealingQueue;
134          if (pBasicFilterParameters) delete[] pBasicFilterParameters;          if (pSysexBuffer) delete pSysexBuffer;
135          if (pSynthesisParameters[0]) delete[] pSynthesisParameters[0];          EngineFactory::Destroy(this);
136      }      }
137    
138      void Engine::Enable() {      void Engine::Enable() {
# Line 116  namespace LinuxSampler { namespace gig { Line 159  namespace LinuxSampler { namespace gig {
159       */       */
160      void Engine::Reset() {      void Engine::Reset() {
161          DisableAndLock();          DisableAndLock();
   
         //if (pAudioOutputDevice->IsPlaying()) { // if already running  
             /*  
             // signal audio thread not to enter render part anymore  
             SuspensionRequested = true;  
             // sleep until wakened by audio thread  
             pthread_mutex_lock(&__render_state_mutex);  
             pthread_cond_wait(&__render_exit_condition, &__render_state_mutex);  
             pthread_mutex_unlock(&__render_state_mutex);  
             */  
         //}  
   
         //if (wasplaying) pAudioOutputDevice->Stop();  
   
162          ResetInternal();          ResetInternal();
163            ResetScaleTuning();
         // signal audio thread to continue with rendering  
         //SuspensionRequested = false;  
164          Enable();          Enable();
165      }      }
166    
167      /**      /**
168       *  Reset all voices and disk thread and clear input event queue and all       *  Reset all voices and disk thread and clear input event queue and all
169       *  control and status variables. This method is not thread safe!       *  control and status variables. This method is protected by a mutex.
170       */       */
171      void Engine::ResetInternal() {      void Engine::ResetInternal() {
172          Pitch               = 0;          ResetInternalMutex.Lock();
173          SustainPedal        = false;  
174            // make sure that the engine does not get any sysex messages
175            // while it's reseting
176            bool sysexDisabled = MidiInputPort::RemoveSysexListener(this);
177          ActiveVoiceCount    = 0;          ActiveVoiceCount    = 0;
178          ActiveVoiceCountMax = 0;          ActiveVoiceCountMax = 0;
179    
180          // set all MIDI controller values to zero          // reset voice stealing parameters
181          memset(ControllerTable, 0x00, 128);          pVoiceStealingQueue->clear();
182            itLastStolenVoice          = RTList<Voice>::Iterator();
183          // reset key info          itLastStolenVoiceGlobally  = RTList<Voice>::Iterator();
184          for (uint i = 0; i < 128; i++) {          iuiLastStolenKey           = RTList<uint>::Iterator();
185              pMIDIKeyInfo[i].pActiveVoices->clear();          iuiLastStolenKeyGlobally   = RTList<uint>::Iterator();
186              pMIDIKeyInfo[i].pEvents->clear();          pLastStolenChannel         = NULL;
             pMIDIKeyInfo[i].KeyPressed = false;  
             pMIDIKeyInfo[i].Active     = false;  
             pMIDIKeyInfo[i].pSelf      = NULL;  
         }  
187    
188          // reset all voices          // reset all voices
189          for (Voice* pVoice = pVoicePool->alloc(); pVoice; pVoice = pVoicePool->alloc()) {          for (RTList<Voice>::Iterator iterVoice = pVoicePool->allocAppend(); iterVoice == pVoicePool->last(); iterVoice = pVoicePool->allocAppend()) {
190              pVoice->Reset();              iterVoice->Reset();
191          }          }
192          pVoicePool->clear();          pVoicePool->clear();
193    
         // free all active keys  
         pActiveKeys->clear();  
   
194          // reset disk thread          // reset disk thread
195          if (pDiskThread) pDiskThread->Reset();          if (pDiskThread) pDiskThread->Reset();
196    
197          // delete all input events          // delete all input events
198          pEventQueue->init();          pEventQueue->init();
199            pSysexBuffer->init();
200            if (sysexDisabled) MidiInputPort::AddSysexListener(this);
201            ResetInternalMutex.Unlock();
202      }      }
203    
204      /**      /**
205       *  Load an instrument from a .gig file.       * Reset to normal, chromatic scale (means equal tempered).
      *  
      *  @param FileName   - file name of the Gigasampler instrument file  
      *  @param Instrument - index of the instrument in the .gig file  
      *  @throws LinuxSamplerException  on error  
      *  @returns          detailed description of the method call result  
206       */       */
207      void Engine::LoadInstrument(const char* FileName, uint Instrument) {      void Engine::ResetScaleTuning() {
208            memset(&ScaleTuning[0], 0x00, 12);
         DisableAndLock();  
   
         ResetInternal(); // reset engine  
   
         // free old instrument  
         if (pInstrument) {  
             // give old instrument back to instrument manager  
             Instruments.HandBack(pInstrument, this);  
         }  
   
         // request gig instrument from instrument manager  
         try {  
             instrument_id_t instrid;  
             instrid.FileName    = FileName;  
             instrid.iInstrument = Instrument;  
             pInstrument = Instruments.Borrow(instrid, this);  
             if (!pInstrument) {  
                 dmsg(1,("no instrument loaded!!!\n"));  
                 exit(EXIT_FAILURE);  
             }  
         }  
         catch (RIFF::Exception e) {  
             String msg = "gig::Engine error: Failed to load instrument, cause: " + e.Message;  
             throw LinuxSamplerException(msg);  
         }  
         catch (InstrumentResourceManagerException e) {  
             String msg = "gig::Engine error: Failed to load instrument, cause: " + e.Message();  
             throw LinuxSamplerException(msg);  
         }  
         catch (...) {  
             throw LinuxSamplerException("gig::Engine error: Failed to load instrument, cause: Unknown exception while trying to parse gig file.");  
         }  
   
         // inform audio driver for the need of two channels  
         try {  
             if (pAudioOutputDevice) pAudioOutputDevice->AcquireChannels(2); // gig Engine only stereo  
         }  
         catch (AudioOutputException e) {  
             String msg = "Audio output device unable to provide 2 audio channels, cause: " + e.Message();  
             throw LinuxSamplerException(msg);  
         }  
   
         Enable();  
209      }      }
210    
211      /**      /**
212       * Will be called by the InstrumentResourceManager when the instrument       * Connect this engine instance with the given audio output device.
213       * we are currently using in this engine is going to be updated, so we       * This method will be called when an Engine instance is created.
214       * can stop playback before that happens.       * All of the engine's data structures which are dependant to the used
215       */       * audio output device / driver will be (re)allocated and / or
216      void Engine::ResourceToBeUpdated(::gig::Instrument* pResource, void*& pUpdateArg) {       * adjusted appropriately.
217          dmsg(3,("gig::Engine: Received instrument update message.\n"));       *
218          DisableAndLock();       * @param pAudioOut - audio output device to connect to
         ResetInternal();  
         this->pInstrument = NULL;  
     }  
   
     /**  
      * Will be called by the InstrumentResourceManager when the instrument  
      * update process was completed, so we can continue with playback.  
219       */       */
     void Engine::ResourceUpdated(::gig::Instrument* pOldResource, ::gig::Instrument* pNewResource, void* pUpdateArg) {  
         this->pInstrument = pNewResource;  
         Enable();  
     }  
   
220      void Engine::Connect(AudioOutputDevice* pAudioOut) {      void Engine::Connect(AudioOutputDevice* pAudioOut) {
221          pAudioOutputDevice = pAudioOut;          pAudioOutputDevice = pAudioOut;
222    
# Line 262  namespace LinuxSampler { namespace gig { Line 228  namespace LinuxSampler { namespace gig {
228          }          }
229          catch (AudioOutputException e) {          catch (AudioOutputException e) {
230              String msg = "Audio output device unable to provide 2 audio channels, cause: " + e.Message();              String msg = "Audio output device unable to provide 2 audio channels, cause: " + e.Message();
231              throw LinuxSamplerException(msg);              throw Exception(msg);
232            }
233    
234            this->MaxSamplesPerCycle = pAudioOutputDevice->MaxSamplesPerCycle();
235            this->SampleRate         = pAudioOutputDevice->SampleRate();
236    
237            // FIXME: audio drivers with varying fragment sizes might be a problem here
238            MaxFadeOutPos = MaxSamplesPerCycle - int(double(SampleRate) * CONFIG_EG_MIN_RELEASE_TIME) - 1;
239            if (MaxFadeOutPos < 0) {
240                std::cerr << "gig::Engine: WARNING, CONFIG_EG_MIN_RELEASE_TIME "
241                          << "too big for current audio fragment size & sampling rate! "
242                          << "May lead to click sounds if voice stealing chimes in!\n" << std::flush;
243                // force volume ramp downs at the beginning of each fragment
244                MaxFadeOutPos = 0;
245                // lower minimum release time
246                const float minReleaseTime = (float) MaxSamplesPerCycle / (float) SampleRate;
247                for (RTList<Voice>::Iterator iterVoice = pVoicePool->allocAppend(); iterVoice == pVoicePool->last(); iterVoice = pVoicePool->allocAppend()) {
248                    iterVoice->EG1.CalculateFadeOutCoeff(minReleaseTime, SampleRate);
249                }
250                pVoicePool->clear();
251          }          }
252    
253          // (re)create disk thread          // (re)create disk thread
254          if (this->pDiskThread) {          if (this->pDiskThread) {
255                dmsg(1,("Stopping disk thread..."));
256              this->pDiskThread->StopThread();              this->pDiskThread->StopThread();
257              delete this->pDiskThread;              delete this->pDiskThread;
258                dmsg(1,("OK\n"));
259          }          }
260          this->pDiskThread = new DiskThread(((pAudioOut->MaxSamplesPerCycle() << MAX_PITCH) << 1) + 6); //FIXME: assuming stereo          this->pDiskThread = new DiskThread(((pAudioOut->MaxSamplesPerCycle() << CONFIG_MAX_PITCH) << 1) + 6); //FIXME: assuming stereo
261          if (!pDiskThread) {          if (!pDiskThread) {
262              dmsg(0,("gig::Engine  new diskthread = NULL\n"));              dmsg(0,("gig::Engine  new diskthread = NULL\n"));
263              exit(EXIT_FAILURE);              exit(EXIT_FAILURE);
264          }          }
265    
266          for (Voice* pVoice = pVoicePool->alloc(); pVoice; pVoice = pVoicePool->alloc()) {          for (RTList<Voice>::Iterator iterVoice = pVoicePool->allocAppend(); iterVoice == pVoicePool->last(); iterVoice = pVoicePool->allocAppend()) {
267              pVoice->pDiskThread = this->pDiskThread;              iterVoice->pDiskThread = this->pDiskThread;
             pVoice->SetOutput(pAudioOut);  
268              dmsg(3,("d"));              dmsg(3,("d"));
269          }          }
270          pVoicePool->clear();          pVoicePool->clear();
# Line 287  namespace LinuxSampler { namespace gig { Line 273  namespace LinuxSampler { namespace gig {
273          if (pEventGenerator) delete pEventGenerator;          if (pEventGenerator) delete pEventGenerator;
274          pEventGenerator = new EventGenerator(pAudioOut->SampleRate());          pEventGenerator = new EventGenerator(pAudioOut->SampleRate());
275    
         // (re)allocate synthesis parameter matrix  
         if (pSynthesisParameters[0]) delete[] pSynthesisParameters[0];  
         pSynthesisParameters[0] = new float[Event::destination_count * pAudioOut->MaxSamplesPerCycle()];  
         for (int dst = 1; dst < Event::destination_count; dst++)  
             pSynthesisParameters[dst] = pSynthesisParameters[dst - 1] + pAudioOut->MaxSamplesPerCycle();  
   
         // (re)allocate biquad filter parameter sequence  
         if (pBasicFilterParameters) delete[] pBasicFilterParameters;  
         if (pMainFilterParameters)  delete[] pMainFilterParameters;  
         pBasicFilterParameters = new biquad_param_t[pAudioOut->MaxSamplesPerCycle()];  
         pMainFilterParameters  = new biquad_param_t[pAudioOut->MaxSamplesPerCycle()];  
   
276          dmsg(1,("Starting disk thread..."));          dmsg(1,("Starting disk thread..."));
277          pDiskThread->StartThread();          pDiskThread->StartThread();
278          dmsg(1,("OK\n"));          dmsg(1,("OK\n"));
279    
280          for (Voice* pVoice = pVoicePool->first(); pVoice; pVoice = pVoicePool->next()) {          for (RTList<Voice>::Iterator iterVoice = pVoicePool->allocAppend(); iterVoice == pVoicePool->last(); iterVoice = pVoicePool->allocAppend()) {
281              if (!pVoice->pDiskThread) {              if (!iterVoice->pDiskThread) {
282                  dmsg(0,("Engine -> voice::trigger: !pDiskThread\n"));                  dmsg(0,("Engine -> voice::trigger: !pDiskThread\n"));
283                  exit(EXIT_FAILURE);                  exit(EXIT_FAILURE);
284              }              }
285          }          }
286      }      }
287    
288      void Engine::DisconnectAudioOutputDevice() {      /**
289          if (pAudioOutputDevice) { // if clause to prevent disconnect loops       * Clear all engine global event lists.
290              AudioOutputDevice* olddevice = pAudioOutputDevice;       */
291              pAudioOutputDevice = NULL;      void Engine::ClearEventLists() {
292              olddevice->Disconnect(this);          pGlobalEvents->clear();
293        }
294    
295        /**
296         * Copy all events from the engine's global input queue buffer to the
297         * engine's internal event list. This will be done at the beginning of
298         * each audio cycle (that is each RenderAudio() call) to distinguish
299         * all global events which have to be processed in the current audio
300         * cycle. These events are usually just SysEx messages. Every
301         * EngineChannel has it's own input event queue buffer and event list
302         * to handle common events like NoteOn, NoteOff and ControlChange
303         * events.
304         *
305         * @param Samples - number of sample points to be processed in the
306         *                  current audio cycle
307         */
308        void Engine::ImportEvents(uint Samples) {
309            RingBuffer<Event>::NonVolatileReader eventQueueReader = pEventQueue->get_non_volatile_reader();
310            Event* pEvent;
311            while (true) {
312                // get next event from input event queue
313                if (!(pEvent = eventQueueReader.pop())) break;
314                // if younger event reached, ignore that and all subsequent ones for now
315                if (pEvent->FragmentPos() >= Samples) {
316                    eventQueueReader--;
317                    dmsg(2,("Younger Event, pos=%d ,Samples=%d!\n",pEvent->FragmentPos(),Samples));
318                    pEvent->ResetFragmentPos();
319                    break;
320                }
321                // copy event to internal event list
322                if (pGlobalEvents->poolIsEmpty()) {
323                    dmsg(1,("Event pool emtpy!\n"));
324                    break;
325                }
326                *pGlobalEvents->allocAppend() = *pEvent;
327          }          }
328            eventQueueReader.free(); // free all copied events from input queue
329      }      }
330    
331      /**      /**
332       *  Let this engine proceed to render the given amount of sample points. The       * Let this engine proceed to render the given amount of sample points.
333       *  calculated audio data of all voices of this engine will be placed into       * The engine will iterate through all engine channels and render audio
334       *  the engine's audio sum buffer which has to be copied and eventually be       * for each engine channel independently. The calculated audio data of
335       *  converted to the appropriate value range by the audio output class (e.g.       * all voices of each engine channel will be placed into the audio sum
336       *  AlsaIO or JackIO) right after.       * buffers of the respective audio output device, connected to the
337         * respective engine channel.
338       *       *
339       *  @param Samples - number of sample points to be rendered       *  @param Samples - number of sample points to be rendered
340       *  @returns       0 on success       *  @returns       0 on success
# Line 332  namespace LinuxSampler { namespace gig { Line 342  namespace LinuxSampler { namespace gig {
342      int Engine::RenderAudio(uint Samples) {      int Engine::RenderAudio(uint Samples) {
343          dmsg(5,("RenderAudio(Samples=%d)\n", Samples));          dmsg(5,("RenderAudio(Samples=%d)\n", Samples));
344    
345          // return if no instrument loaded or engine disabled          // return if engine disabled
346          if (EngineDisabled.Pop()) {          if (EngineDisabled.Pop()) {
347              dmsg(5,("gig::Engine: engine disabled (val=%d)\n",EngineDisabled.GetUnsafe()));              dmsg(5,("gig::Engine: engine disabled (val=%d)\n",EngineDisabled.GetUnsafe()));
348              return 0;              return 0;
349          }          }
         if (!pInstrument) {  
             dmsg(5,("gig::Engine: no instrument loaded\n"));  
             return 0;  
         }  
350    
351            // update time of start and end of this audio fragment (as events' time stamps relate to this)
352            pEventGenerator->UpdateFragmentTime(Samples);
353    
354          // empty the event lists for the new fragment          // We only allow a maximum of CONFIG_MAX_VOICES voices to be spawned
355          pEvents->clear();          // in each audio fragment. All subsequent request for spawning new
356          pCCEvents->clear();          // voices in the same audio fragment will be ignored.
357          for (uint i = 0; i < Event::destination_count; i++) {          VoiceSpawnsLeft = CONFIG_MAX_VOICES;
358              pSynthesisEvents[i]->clear();  
359            // get all events from the engine's global input event queue which belong to the current fragment
360            // (these are usually just SysEx messages)
361            ImportEvents(Samples);
362    
363            // process engine global events (these are currently only MIDI System Exclusive messages)
364            {
365                RTList<Event>::Iterator itEvent = pGlobalEvents->first();
366                RTList<Event>::Iterator end     = pGlobalEvents->end();
367                for (; itEvent != end; ++itEvent) {
368                    switch (itEvent->Type) {
369                        case Event::type_sysex:
370                            dmsg(5,("Engine: Sysex received\n"));
371                            ProcessSysex(itEvent);
372                            break;
373                    }
374                }
375          }          }
376    
377          // read and copy events from input queue          // reset internal voice counter (just for statistic of active voices)
378          Event event = pEventGenerator->CreateEvent();          ActiveVoiceCountTemp = 0;
         while (true) {  
             if (!pEventQueue->pop(&event)) break;  
             pEvents->alloc_assign(event);  
         }  
379    
380            // handle events on all engine channels
381            for (int i = 0; i < engineChannels.size(); i++) {
382                if (!engineChannels[i]->pInstrument) continue; // ignore if no instrument loaded
383                ProcessEvents(engineChannels[i], Samples);
384            }
385    
386          // update time of start and end of this audio fragment (as events' time stamps relate to this)          // render all 'normal', active voices on all engine channels
387          pEventGenerator->UpdateFragmentTime(Samples);          for (int i = 0; i < engineChannels.size(); i++) {
388                if (!engineChannels[i]->pInstrument) continue; // ignore if no instrument loaded
389                RenderActiveVoices(engineChannels[i], Samples);
390            }
391    
392            // now that all ordinary voices on ALL engine channels are rendered, render new stolen voices
393            RenderStolenVoices(Samples);
394    
395          // process events          // handle cleanup on all engine channels for the next audio fragment
396          Event* pNextEvent = pEvents->first();          for (int i = 0; i < engineChannels.size(); i++) {
397          while (pNextEvent) {              if (!engineChannels[i]->pInstrument) continue; // ignore if no instrument loaded
398              Event* pEvent = pNextEvent;              PostProcess(engineChannels[i]);
             pEvents->set_current(pEvent);  
             pNextEvent = pEvents->next();  
             switch (pEvent->Type) {  
                 case Event::type_note_on:  
                     dmsg(5,("Audio Thread: Note on received\n"));  
                     ProcessNoteOn(pEvent);  
                     break;  
                 case Event::type_note_off:  
                     dmsg(5,("Audio Thread: Note off received\n"));  
                     ProcessNoteOff(pEvent);  
                     break;  
                 case Event::type_control_change:  
                     dmsg(5,("Audio Thread: MIDI CC received\n"));  
                     ProcessControlChange(pEvent);  
                     break;  
                 case Event::type_pitchbend:  
                     dmsg(5,("Audio Thread: Pitchbend received\n"));  
                     ProcessPitchbend(pEvent);  
                     break;  
             }  
399          }          }
400    
401    
402          // render audio from all active voices          // empty the engine's event list for the next audio fragment
403          int active_voices = 0;          ClearEventLists();
         uint* piKey = pActiveKeys->first();  
         while (piKey) { // iterate through all active keys  
             midi_key_info_t* pKey = &pMIDIKeyInfo[*piKey];  
             pActiveKeys->set_current(piKey);  
             piKey = pActiveKeys->next();  
   
             Voice* pVoiceNext = pKey->pActiveVoices->first();  
             while (pVoiceNext) { // iterate through all voices on this key  
                 // already get next voice on key  
                 Voice* pVoice = pVoiceNext;  
                 pKey->pActiveVoices->set_current(pVoice);  
                 pVoiceNext = pKey->pActiveVoices->next();  
   
                 // now render current voice  
                 pVoice->Render(Samples);  
                 if (pVoice->IsActive()) active_voices++; // still active  
                 else { // voice reached end, is now inactive  
                     KillVoice(pVoice); // remove voice from the list of active voices  
                 }  
             }  
             pKey->pEvents->clear(); // free all events on the key  
         }  
404    
405            // reset voice stealing for the next audio fragment
406            pVoiceStealingQueue->clear();
407    
408          // write that to the disk thread class so that it can print it          // just some statistics about this engine instance
409          // on the console for debugging purposes          ActiveVoiceCount = ActiveVoiceCountTemp;
         ActiveVoiceCount = active_voices;  
410          if (ActiveVoiceCount > ActiveVoiceCountMax) ActiveVoiceCountMax = ActiveVoiceCount;          if (ActiveVoiceCount > ActiveVoiceCountMax) ActiveVoiceCountMax = ActiveVoiceCount;
411    
412            FrameTime += Samples;
413    
414          return 0;          return 0;
415      }      }
416    
417      /**      /**
418       *  Will be called by the MIDIIn Thread to let the audio thread trigger a new       * Dispatch and handle all events in this audio fragment for the given
419       *  voice for the given key.       * engine channel.
420       *       *
421       *  @param Key      - MIDI key number of the triggered key       * @param pEngineChannel - engine channel on which events should be
422       *  @param Velocity - MIDI velocity value of the triggered key       *                         processed
423         * @param Samples        - amount of sample points to be processed in
424         *                         this audio fragment cycle
425       */       */
426      void Engine::SendNoteOn(uint8_t Key, uint8_t Velocity) {      void Engine::ProcessEvents(EngineChannel* pEngineChannel, uint Samples) {
427          Event event    = pEventGenerator->CreateEvent();          // get all events from the engine channels's input event queue which belong to the current fragment
428          event.Type     = Event::type_note_on;          // (these are the common events like NoteOn, NoteOff, ControlChange, etc.)
429          event.Key      = Key;          pEngineChannel->ImportEvents(Samples);
430          event.Velocity = Velocity;  
431          if (this->pEventQueue->write_space() > 0) this->pEventQueue->push(&event);          // process events
432          else dmsg(1,("Engine: Input event queue full!"));          {
433                RTList<Event>::Iterator itEvent = pEngineChannel->pEvents->first();
434                RTList<Event>::Iterator end     = pEngineChannel->pEvents->end();
435                for (; itEvent != end; ++itEvent) {
436                    switch (itEvent->Type) {
437                        case Event::type_note_on:
438                            dmsg(5,("Engine: Note on received\n"));
439                            ProcessNoteOn((EngineChannel*)itEvent->pEngineChannel, itEvent);
440                            break;
441                        case Event::type_note_off:
442                            dmsg(5,("Engine: Note off received\n"));
443                            ProcessNoteOff((EngineChannel*)itEvent->pEngineChannel, itEvent);
444                            break;
445                        case Event::type_control_change:
446                            dmsg(5,("Engine: MIDI CC received\n"));
447                            ProcessControlChange((EngineChannel*)itEvent->pEngineChannel, itEvent);
448                            break;
449                        case Event::type_pitchbend:
450                            dmsg(5,("Engine: Pitchbend received\n"));
451                            ProcessPitchbend((EngineChannel*)itEvent->pEngineChannel, itEvent);
452                            break;
453                    }
454                }
455            }
456    
457            // reset voice stealing for the next engine channel (or next audio fragment)
458            itLastStolenVoice         = RTList<Voice>::Iterator();
459            itLastStolenVoiceGlobally = RTList<Voice>::Iterator();
460            iuiLastStolenKey          = RTList<uint>::Iterator();
461            iuiLastStolenKeyGlobally  = RTList<uint>::Iterator();
462            pLastStolenChannel        = NULL;
463      }      }
464    
465      /**      /**
466       *  Will be called by the MIDIIn Thread to signal the audio thread to release       * Render all 'normal' voices (that is voices which were not stolen in
467       *  voice(s) on the given key.       * this fragment) on the given engine channel.
468       *       *
469       *  @param Key      - MIDI key number of the released key       * @param pEngineChannel - engine channel on which audio should be
470       *  @param Velocity - MIDI release velocity value of the released key       *                         rendered
471         * @param Samples        - amount of sample points to be rendered in
472         *                         this audio fragment cycle
473       */       */
474      void Engine::SendNoteOff(uint8_t Key, uint8_t Velocity) {      void Engine::RenderActiveVoices(EngineChannel* pEngineChannel, uint Samples) {
475          Event event    = pEventGenerator->CreateEvent();          #if !CONFIG_PROCESS_MUTED_CHANNELS
476          event.Type     = Event::type_note_off;          if (pEngineChannel->GetMute()) return; // skip if sampler channel is muted
477          event.Key      = Key;          #endif
478          event.Velocity = Velocity;  
479          if (this->pEventQueue->write_space() > 0) this->pEventQueue->push(&event);          RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first();
480          else dmsg(1,("Engine: Input event queue full!"));          RTList<uint>::Iterator end    = pEngineChannel->pActiveKeys->end();
481            while (iuiKey != end) { // iterate through all active keys
482                midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey];
483                ++iuiKey;
484    
485                RTList<Voice>::Iterator itVoice     = pKey->pActiveVoices->first();
486                RTList<Voice>::Iterator itVoicesEnd = pKey->pActiveVoices->end();
487                for (; itVoice != itVoicesEnd; ++itVoice) { // iterate through all voices on this key
488                    // now render current voice
489                    itVoice->Render(Samples);
490                    if (itVoice->IsActive()) ActiveVoiceCountTemp++; // still active
491                    else { // voice reached end, is now inactive
492                        FreeVoice(pEngineChannel, itVoice); // remove voice from the list of active voices
493                    }
494                }
495            }
496      }      }
497    
498      /**      /**
499       *  Will be called by the MIDIIn Thread to signal the audio thread to change       * Render all stolen voices (only voices which were stolen in this
500       *  the pitch value for all voices.       * fragment) on the given engine channel. Stolen voices are rendered
501         * after all normal voices have been rendered; this is needed to render
502         * audio of those voices which were selected for voice stealing until
503         * the point were the stealing (that is the take over of the voice)
504         * actually happened.
505       *       *
506       *  @param Pitch - MIDI pitch value (-8192 ... +8191)       * @param pEngineChannel - engine channel on which audio should be
507         *                         rendered
508         * @param Samples        - amount of sample points to be rendered in
509         *                         this audio fragment cycle
510       */       */
511      void Engine::SendPitchbend(int Pitch) {      void Engine::RenderStolenVoices(uint Samples) {
512          Event event = pEventGenerator->CreateEvent();          RTList<Event>::Iterator itVoiceStealEvent = pVoiceStealingQueue->first();
513          event.Type  = Event::type_pitchbend;          RTList<Event>::Iterator end               = pVoiceStealingQueue->end();
514          event.Pitch = Pitch;          for (; itVoiceStealEvent != end; ++itVoiceStealEvent) {
515          if (this->pEventQueue->write_space() > 0) this->pEventQueue->push(&event);              EngineChannel* pEngineChannel = (EngineChannel*) itVoiceStealEvent->pEngineChannel;
516          else dmsg(1,("Engine: Input event queue full!"));              Pool<Voice>::Iterator itNewVoice =
517                    LaunchVoice(pEngineChannel, itVoiceStealEvent, itVoiceStealEvent->Param.Note.Layer, itVoiceStealEvent->Param.Note.ReleaseTrigger, false, false);
518                if (itNewVoice) {
519                    itNewVoice->Render(Samples);
520                    if (itNewVoice->IsActive()) ActiveVoiceCountTemp++; // still active
521                    else { // voice reached end, is now inactive
522                        FreeVoice(pEngineChannel, itNewVoice); // remove voice from the list of active voices
523                    }
524                }
525                else dmsg(1,("gig::Engine: ERROR, voice stealing didn't work out!\n"));
526    
527                // we need to clear the key's event list explicitly here in case key was never active
528                midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[itVoiceStealEvent->Param.Note.Key];
529                pKey->VoiceTheftsQueued--;
530                if (!pKey->Active && !pKey->VoiceTheftsQueued) pKey->pEvents->clear();
531            }
532        }
533    
534        /**
535         * Free all keys which have turned inactive in this audio fragment, from
536         * the list of active keys and clear all event lists on that engine
537         * channel.
538         *
539         * @param pEngineChannel - engine channel to cleanup
540         */
541        void Engine::PostProcess(EngineChannel* pEngineChannel) {
542            // free all keys which have no active voices left
543            {
544                RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first();
545                RTList<uint>::Iterator end    = pEngineChannel->pActiveKeys->end();
546                while (iuiKey != end) { // iterate through all active keys
547                    midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey];
548                    ++iuiKey;
549                    if (pKey->pActiveVoices->isEmpty()) FreeKey(pEngineChannel, pKey);
550                    #if CONFIG_DEVMODE
551                    else { // just a sanity check for debugging
552                        RTList<Voice>::Iterator itVoice     = pKey->pActiveVoices->first();
553                        RTList<Voice>::Iterator itVoicesEnd = pKey->pActiveVoices->end();
554                        for (; itVoice != itVoicesEnd; ++itVoice) { // iterate through all voices on this key
555                            if (itVoice->itKillEvent) {
556                                dmsg(1,("gig::Engine: ERROR, killed voice survived !!!\n"));
557                            }
558                        }
559                    }
560                    #endif // CONFIG_DEVMODE
561                }
562            }
563    
564            // empty the engine channel's own event lists
565            pEngineChannel->ClearEventLists();
566      }      }
567    
568      /**      /**
569       *  Will be called by the MIDIIn Thread to signal the audio thread that a       *  Will be called by the MIDI input device whenever a MIDI system
570       *  continuous controller value has changed.       *  exclusive message has arrived.
571       *       *
572       *  @param Controller - MIDI controller number of the occured control change       *  @param pData - pointer to sysex data
573       *  @param Value      - value of the control change       *  @param Size  - lenght of sysex data (in bytes)
574       */       */
575      void Engine::SendControlChange(uint8_t Controller, uint8_t Value) {      void Engine::SendSysex(void* pData, uint Size) {
576          Event event      = pEventGenerator->CreateEvent();          Event event             = pEventGenerator->CreateEvent();
577          event.Type       = Event::type_control_change;          event.Type              = Event::type_sysex;
578          event.Controller = Controller;          event.Param.Sysex.Size  = Size;
579          event.Value      = Value;          event.pEngineChannel    = NULL; // as Engine global event
580          if (this->pEventQueue->write_space() > 0) this->pEventQueue->push(&event);          if (pEventQueue->write_space() > 0) {
581                if (pSysexBuffer->write_space() >= Size) {
582                    // copy sysex data to input buffer
583                    uint toWrite = Size;
584                    uint8_t* pPos = (uint8_t*) pData;
585                    while (toWrite) {
586                        const uint writeNow = RTMath::Min(toWrite, pSysexBuffer->write_space_to_end());
587                        pSysexBuffer->write(pPos, writeNow);
588                        toWrite -= writeNow;
589                        pPos    += writeNow;
590    
591                    }
592                    // finally place sysex event into input event queue
593                    pEventQueue->push(&event);
594                }
595                else dmsg(1,("Engine: Sysex message too large (%d byte) for input buffer (%d byte)!",Size,CONFIG_SYSEX_BUFFER_SIZE));
596            }
597          else dmsg(1,("Engine: Input event queue full!"));          else dmsg(1,("Engine: Input event queue full!"));
598      }      }
599    
600      /**      /**
601       *  Assigns and triggers a new voice for the respective MIDI key.       *  Assigns and triggers a new voice for the respective MIDI key.
602       *       *
603       *  @param pNoteOnEvent - key, velocity and time stamp of the event       *  @param pEngineChannel - engine channel on which this event occured on
604         *  @param itNoteOnEvent - key, velocity and time stamp of the event
605       */       */
606      void Engine::ProcessNoteOn(Event* pNoteOnEvent) {      void Engine::ProcessNoteOn(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOnEvent) {
607          midi_key_info_t* pKey = &pMIDIKeyInfo[pNoteOnEvent->Key];          #if !CONFIG_PROCESS_MUTED_CHANNELS
608            if (pEngineChannel->GetMute()) return; // skip if sampler channel is muted
609            #endif
610    
611            const int key = itNoteOnEvent->Param.Note.Key;
612            midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[key];
613    
614            // move note on event to the key's own event list
615            RTList<Event>::Iterator itNoteOnEventOnKeyList = itNoteOnEvent.moveToEndOf(pKey->pEvents);
616    
617            // if Solo Mode then kill all already active voices
618            if (pEngineChannel->SoloMode) {
619                Pool<uint>::Iterator itYoungestKey = pEngineChannel->pActiveKeys->last();
620                if (itYoungestKey) {
621                    const int iYoungestKey = *itYoungestKey;
622                    const midi_key_info_t* pOtherKey = &pEngineChannel->pMIDIKeyInfo[iYoungestKey];
623                    if (pOtherKey->Active) {
624                        // get final portamento position of currently active voice
625                        if (pEngineChannel->PortamentoMode) {
626                            RTList<Voice>::Iterator itVoice = pOtherKey->pActiveVoices->last();
627                            if (itVoice) itVoice->UpdatePortamentoPos(itNoteOnEventOnKeyList);
628                        }
629                        // kill all voices on the (other) key
630                        RTList<Voice>::Iterator itVoiceToBeKilled = pOtherKey->pActiveVoices->first();
631                        RTList<Voice>::Iterator end               = pOtherKey->pActiveVoices->end();
632                        for (; itVoiceToBeKilled != end; ++itVoiceToBeKilled) {
633                            if (itVoiceToBeKilled->Type != Voice::type_release_trigger)
634                                itVoiceToBeKilled->Kill(itNoteOnEventOnKeyList);
635                        }
636                    }
637                }
638                // set this key as 'currently active solo key'
639                pEngineChannel->SoloKey = key;
640            }
641    
642            // Change key dimension value if key is in keyswitching area
643            {
644                const ::gig::Instrument* pInstrument = pEngineChannel->pInstrument;
645                if (key >= pInstrument->DimensionKeyRange.low && key <= pInstrument->DimensionKeyRange.high)
646                    pEngineChannel->CurrentKeyDimension = float(key - pInstrument->DimensionKeyRange.low) /
647                        (pInstrument->DimensionKeyRange.high - pInstrument->DimensionKeyRange.low + 1);
648            }
649    
650          pKey->KeyPressed = true; // the MIDI key was now pressed down          pKey->KeyPressed = true; // the MIDI key was now pressed down
651            pKey->Velocity   = itNoteOnEventOnKeyList->Param.Note.Velocity;
652            pKey->NoteOnTime = FrameTime + itNoteOnEventOnKeyList->FragmentPos(); // will be used to calculate note length
653    
654          // cancel release process of voices on this key if needed          // cancel release process of voices on this key if needed
655          if (pKey->Active && !SustainPedal) {          if (pKey->Active && !pEngineChannel->SustainPedal) {
656              pNoteOnEvent->Type = Event::type_cancel_release; // transform event type              RTList<Event>::Iterator itCancelReleaseEvent = pKey->pEvents->allocAppend();
657              pEvents->move(pNoteOnEvent, pKey->pEvents); // move event to the key's own event list              if (itCancelReleaseEvent) {
658                    *itCancelReleaseEvent = *itNoteOnEventOnKeyList;         // copy event
659                    itCancelReleaseEvent->Type = Event::type_cancel_release; // transform event type
660                }
661                else dmsg(1,("Event pool emtpy!\n"));
662          }          }
663    
664          // allocate a new voice for the key          // allocate and trigger new voice(s) for the key
665          Voice* pNewVoice = pKey->pActiveVoices->alloc();          {
666          if (pNewVoice) {              // first, get total amount of required voices (dependant on amount of layers)
667              // launch the new voice              ::gig::Region* pRegion = pEngineChannel->pInstrument->GetRegion(itNoteOnEventOnKeyList->Param.Note.Key);
668              if (pNewVoice->Trigger(pNoteOnEvent, this->Pitch, this->pInstrument) < 0) {              if (pRegion) {
669                  dmsg(1,("Triggering new voice failed!\n"));                  int voicesRequired = pRegion->Layers;
670                  pKey->pActiveVoices->free(pNewVoice);                  // now launch the required amount of voices
671              }                  for (int i = 0; i < voicesRequired; i++)
672              else if (!pKey->Active) { // mark as active key                      LaunchVoice(pEngineChannel, itNoteOnEventOnKeyList, i, false, true, true);
                 pKey->Active = true;  
                 pKey->pSelf  = pActiveKeys->alloc();  
                 *pKey->pSelf = pNoteOnEvent->Key;  
673              }              }
674          }          }
675          else std::cerr << "No free voice!" << std::endl << std::flush;  
676            // if neither a voice was spawned or postponed then remove note on event from key again
677            if (!pKey->Active && !pKey->VoiceTheftsQueued)
678                pKey->pEvents->free(itNoteOnEventOnKeyList);
679    
680            if (!pEngineChannel->SoloMode || pEngineChannel->PortamentoPos < 0.0f) pEngineChannel->PortamentoPos = (float) key;
681            pKey->RoundRobinIndex++;
682      }      }
683    
684      /**      /**
# Line 525  namespace LinuxSampler { namespace gig { Line 687  namespace LinuxSampler { namespace gig {
687       *  sustain pedal will be released or voice turned inactive by itself (e.g.       *  sustain pedal will be released or voice turned inactive by itself (e.g.
688       *  due to completion of sample playback).       *  due to completion of sample playback).
689       *       *
690       *  @param pNoteOffEvent - key, velocity and time stamp of the event       *  @param pEngineChannel - engine channel on which this event occured on
691         *  @param itNoteOffEvent - key, velocity and time stamp of the event
692       */       */
693      void Engine::ProcessNoteOff(Event* pNoteOffEvent) {      void Engine::ProcessNoteOff(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOffEvent) {
694          midi_key_info_t* pKey = &pMIDIKeyInfo[pNoteOffEvent->Key];          #if !CONFIG_PROCESS_MUTED_CHANNELS
695            if (pEngineChannel->GetMute()) return; // skip if sampler channel is muted
696            #endif
697    
698            const int iKey = itNoteOffEvent->Param.Note.Key;
699            midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[iKey];
700          pKey->KeyPressed = false; // the MIDI key was now released          pKey->KeyPressed = false; // the MIDI key was now released
701    
702          // release voices on this key if needed          // move event to the key's own event list
703          if (pKey->Active && !SustainPedal) {          RTList<Event>::Iterator itNoteOffEventOnKeyList = itNoteOffEvent.moveToEndOf(pKey->pEvents);
704              pNoteOffEvent->Type = Event::type_release; // transform event type  
705              pEvents->move(pNoteOffEvent, pKey->pEvents); // move event to the key's own event list          bool bShouldRelease = pKey->Active && ShouldReleaseVoice(pEngineChannel, itNoteOffEventOnKeyList->Param.Note.Key);
706    
707            // in case Solo Mode is enabled, kill all voices on this key and respawn a voice on the highest pressed key (if any)
708            if (pEngineChannel->SoloMode) { //TODO: this feels like too much code just for handling solo mode :P
709                bool bOtherKeysPressed = false;
710                if (iKey == pEngineChannel->SoloKey) {
711                    pEngineChannel->SoloKey = -1;
712                    // if there's still a key pressed down, respawn a voice (group) on the highest key
713                    for (int i = 127; i > 0; i--) {
714                        midi_key_info_t* pOtherKey = &pEngineChannel->pMIDIKeyInfo[i];
715                        if (pOtherKey->KeyPressed) {
716                            bOtherKeysPressed = true;
717                            // make the other key the new 'currently active solo key'
718                            pEngineChannel->SoloKey = i;
719                            // get final portamento position of currently active voice
720                            if (pEngineChannel->PortamentoMode) {
721                                RTList<Voice>::Iterator itVoice = pKey->pActiveVoices->first();
722                                if (itVoice) itVoice->UpdatePortamentoPos(itNoteOffEventOnKeyList);
723                            }
724                            // create a pseudo note on event
725                            RTList<Event>::Iterator itPseudoNoteOnEvent = pOtherKey->pEvents->allocAppend();
726                            if (itPseudoNoteOnEvent) {
727                                // copy event
728                                *itPseudoNoteOnEvent = *itNoteOffEventOnKeyList;
729                                // transform event to a note on event
730                                itPseudoNoteOnEvent->Type                = Event::type_note_on;
731                                itPseudoNoteOnEvent->Param.Note.Key      = i;
732                                itPseudoNoteOnEvent->Param.Note.Velocity = pOtherKey->Velocity;
733                                // allocate and trigger new voice(s) for the other key
734                                {
735                                    // first, get total amount of required voices (dependant on amount of layers)
736                                    ::gig::Region* pRegion = pEngineChannel->pInstrument->GetRegion(i);
737                                    if (pRegion) {
738                                        int voicesRequired = pRegion->Layers;
739                                        // now launch the required amount of voices
740                                        for (int iLayer = 0; iLayer < voicesRequired; iLayer++)
741                                            LaunchVoice(pEngineChannel, itPseudoNoteOnEvent, iLayer, false, true, false);
742                                    }
743                                }
744                                // if neither a voice was spawned or postponed then remove note on event from key again
745                                if (!pOtherKey->Active && !pOtherKey->VoiceTheftsQueued)
746                                    pOtherKey->pEvents->free(itPseudoNoteOnEvent);
747    
748                            } else dmsg(1,("Could not respawn voice, no free event left\n"));
749                            break; // done
750                        }
751                    }
752                }
753                if (bOtherKeysPressed) {
754                    if (pKey->Active) { // kill all voices on this key
755                        bShouldRelease = false; // no need to release, as we kill it here
756                        RTList<Voice>::Iterator itVoiceToBeKilled = pKey->pActiveVoices->first();
757                        RTList<Voice>::Iterator end               = pKey->pActiveVoices->end();
758                        for (; itVoiceToBeKilled != end; ++itVoiceToBeKilled) {
759                            if (itVoiceToBeKilled->Type != Voice::type_release_trigger)
760                                itVoiceToBeKilled->Kill(itNoteOffEventOnKeyList);
761                        }
762                    }
763                } else pEngineChannel->PortamentoPos = -1.0f;
764            }
765    
766            // if no solo mode (the usual case) or if solo mode and no other key pressed, then release voices on this key if needed
767            if (bShouldRelease) {
768                itNoteOffEventOnKeyList->Type = Event::type_release; // transform event type
769    
770                // spawn release triggered voice(s) if needed
771                if (pKey->ReleaseTrigger) {
772                    // first, get total amount of required voices (dependant on amount of layers)
773                    ::gig::Region* pRegion = pEngineChannel->pInstrument->GetRegion(itNoteOffEventOnKeyList->Param.Note.Key);
774                    if (pRegion) {
775                        int voicesRequired = pRegion->Layers;
776    
777                        // MIDI note-on velocity is used instead of note-off velocity
778                        itNoteOffEventOnKeyList->Param.Note.Velocity = pKey->Velocity;
779    
780                        // now launch the required amount of voices
781                        for (int i = 0; i < voicesRequired; i++)
782                            LaunchVoice(pEngineChannel, itNoteOffEventOnKeyList, i, true, false, false); //FIXME: for the moment we don't perform voice stealing for release triggered samples
783                    }
784                    pKey->ReleaseTrigger = false;
785                }
786            }
787    
788            // if neither a voice was spawned or postponed on this key then remove note off event from key again
789            if (!pKey->Active && !pKey->VoiceTheftsQueued)
790                pKey->pEvents->free(itNoteOffEventOnKeyList);
791        }
792    
793        /**
794         *  Moves pitchbend event from the general (input) event list to the engine
795         *  channel's event list. It will actually processed later by the
796         *  respective voice.
797         *
798         *  @param pEngineChannel - engine channel on which this event occured on
799         *  @param itPitchbendEvent - absolute pitch value and time stamp of the event
800         */
801        void Engine::ProcessPitchbend(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itPitchbendEvent) {
802            pEngineChannel->Pitch = itPitchbendEvent->Param.Pitch.Pitch; // store current pitch value
803        }
804    
805        /**
806         *  Allocates and triggers a new voice. This method will usually be
807         *  called by the ProcessNoteOn() method and by the voices itself
808         *  (e.g. to spawn further voices on the same key for layered sounds).
809         *
810         *  @param pEngineChannel      - engine channel on which this event occured on
811         *  @param itNoteOnEvent       - key, velocity and time stamp of the event
812         *  @param iLayer              - layer index for the new voice (optional - only
813         *                               in case of layered sounds of course)
814         *  @param ReleaseTriggerVoice - if new voice is a release triggered voice
815         *                               (optional, default = false)
816         *  @param VoiceStealing       - if voice stealing should be performed
817         *                               when there is no free voice
818         *                               (optional, default = true)
819         *  @param HandleKeyGroupConflicts - if voices should be killed due to a
820         *                                   key group conflict
821         *  @returns pointer to new voice or NULL if there was no free voice or
822         *           if the voice wasn't triggered (for example when no region is
823         *           defined for the given key).
824         */
825        Pool<Voice>::Iterator Engine::LaunchVoice(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOnEvent, int iLayer, bool ReleaseTriggerVoice, bool VoiceStealing, bool HandleKeyGroupConflicts) {
826            int MIDIKey            = itNoteOnEvent->Param.Note.Key;
827            midi_key_info_t* pKey  = &pEngineChannel->pMIDIKeyInfo[MIDIKey];
828            ::gig::Region* pRegion = pEngineChannel->pInstrument->GetRegion(MIDIKey);
829    
830            // if nothing defined for this key
831            if (!pRegion) return Pool<Voice>::Iterator(); // nothing to do
832    
833            // only mark the first voice of a layered voice (group) to be in a
834            // key group, so the layered voices won't kill each other
835            int iKeyGroup = (iLayer == 0 && !ReleaseTriggerVoice) ? pRegion->KeyGroup : 0;
836    
837            // handle key group (a.k.a. exclusive group) conflicts
838            if (HandleKeyGroupConflicts) {
839                if (iKeyGroup) { // if this voice / key belongs to a key group
840                    uint** ppKeyGroup = &pEngineChannel->ActiveKeyGroups[iKeyGroup];
841                    if (*ppKeyGroup) { // if there's already an active key in that key group
842                        midi_key_info_t* pOtherKey = &pEngineChannel->pMIDIKeyInfo[**ppKeyGroup];
843                        // kill all voices on the (other) key
844                        RTList<Voice>::Iterator itVoiceToBeKilled = pOtherKey->pActiveVoices->first();
845                        RTList<Voice>::Iterator end               = pOtherKey->pActiveVoices->end();
846                        for (; itVoiceToBeKilled != end; ++itVoiceToBeKilled) {
847                            if (itVoiceToBeKilled->Type != Voice::type_release_trigger) {
848                                itVoiceToBeKilled->Kill(itNoteOnEvent);
849                                --VoiceSpawnsLeft; //FIXME: just a hack, we should better check in StealVoice() if the voice was killed due to key conflict
850                            }
851                        }
852                    }
853                }
854          }          }
855    
856            Voice::type_t VoiceType = Voice::type_normal;
857    
858            // get current dimension values to select the right dimension region
859            //TODO: for stolen voices this dimension region selection block is processed twice, this should be changed
860            //FIXME: controller values for selecting the dimension region here are currently not sample accurate
861            uint DimValues[8] = { 0 };
862            for (int i = pRegion->Dimensions - 1; i >= 0; i--) {
863                switch (pRegion->pDimensionDefinitions[i].dimension) {
864                    case ::gig::dimension_samplechannel:
865                        DimValues[i] = 0; //TODO: we currently ignore this dimension
866                        break;
867                    case ::gig::dimension_layer:
868                        DimValues[i] = iLayer;
869                        break;
870                    case ::gig::dimension_velocity:
871                        DimValues[i] = itNoteOnEvent->Param.Note.Velocity;
872                        break;
873                    case ::gig::dimension_channelaftertouch:
874                        DimValues[i] = pEngineChannel->ControllerTable[128];
875                        break;
876                    case ::gig::dimension_releasetrigger:
877                        VoiceType = (ReleaseTriggerVoice) ? Voice::type_release_trigger : (!iLayer) ? Voice::type_release_trigger_required : Voice::type_normal;
878                        DimValues[i] = (uint) ReleaseTriggerVoice;
879                        break;
880                    case ::gig::dimension_keyboard:
881                        DimValues[i] = (uint) (pEngineChannel->CurrentKeyDimension * pRegion->pDimensionDefinitions[i].zones);
882                        break;
883                    case ::gig::dimension_roundrobin:
884                        DimValues[i] = (uint) pEngineChannel->pMIDIKeyInfo[MIDIKey].RoundRobinIndex; // incremented for each note on
885                        break;
886                    case ::gig::dimension_random:
887                        RandomSeed   = RandomSeed * 1103515245 + 12345; // classic pseudo random number generator
888                        DimValues[i] = (uint) RandomSeed >> (32 - pRegion->pDimensionDefinitions[i].bits); // highest bits are most random
889                        break;
890                    case ::gig::dimension_modwheel:
891                        DimValues[i] = pEngineChannel->ControllerTable[1];
892                        break;
893                    case ::gig::dimension_breath:
894                        DimValues[i] = pEngineChannel->ControllerTable[2];
895                        break;
896                    case ::gig::dimension_foot:
897                        DimValues[i] = pEngineChannel->ControllerTable[4];
898                        break;
899                    case ::gig::dimension_portamentotime:
900                        DimValues[i] = pEngineChannel->ControllerTable[5];
901                        break;
902                    case ::gig::dimension_effect1:
903                        DimValues[i] = pEngineChannel->ControllerTable[12];
904                        break;
905                    case ::gig::dimension_effect2:
906                        DimValues[i] = pEngineChannel->ControllerTable[13];
907                        break;
908                    case ::gig::dimension_genpurpose1:
909                        DimValues[i] = pEngineChannel->ControllerTable[16];
910                        break;
911                    case ::gig::dimension_genpurpose2:
912                        DimValues[i] = pEngineChannel->ControllerTable[17];
913                        break;
914                    case ::gig::dimension_genpurpose3:
915                        DimValues[i] = pEngineChannel->ControllerTable[18];
916                        break;
917                    case ::gig::dimension_genpurpose4:
918                        DimValues[i] = pEngineChannel->ControllerTable[19];
919                        break;
920                    case ::gig::dimension_sustainpedal:
921                        DimValues[i] = pEngineChannel->ControllerTable[64];
922                        break;
923                    case ::gig::dimension_portamento:
924                        DimValues[i] = pEngineChannel->ControllerTable[65];
925                        break;
926                    case ::gig::dimension_sostenutopedal:
927                        DimValues[i] = pEngineChannel->ControllerTable[66];
928                        break;
929                    case ::gig::dimension_softpedal:
930                        DimValues[i] = pEngineChannel->ControllerTable[67];
931                        break;
932                    case ::gig::dimension_genpurpose5:
933                        DimValues[i] = pEngineChannel->ControllerTable[80];
934                        break;
935                    case ::gig::dimension_genpurpose6:
936                        DimValues[i] = pEngineChannel->ControllerTable[81];
937                        break;
938                    case ::gig::dimension_genpurpose7:
939                        DimValues[i] = pEngineChannel->ControllerTable[82];
940                        break;
941                    case ::gig::dimension_genpurpose8:
942                        DimValues[i] = pEngineChannel->ControllerTable[83];
943                        break;
944                    case ::gig::dimension_effect1depth:
945                        DimValues[i] = pEngineChannel->ControllerTable[91];
946                        break;
947                    case ::gig::dimension_effect2depth:
948                        DimValues[i] = pEngineChannel->ControllerTable[92];
949                        break;
950                    case ::gig::dimension_effect3depth:
951                        DimValues[i] = pEngineChannel->ControllerTable[93];
952                        break;
953                    case ::gig::dimension_effect4depth:
954                        DimValues[i] = pEngineChannel->ControllerTable[94];
955                        break;
956                    case ::gig::dimension_effect5depth:
957                        DimValues[i] = pEngineChannel->ControllerTable[95];
958                        break;
959                    case ::gig::dimension_none:
960                        std::cerr << "gig::Engine::LaunchVoice() Error: dimension=none\n" << std::flush;
961                        break;
962                    default:
963                        std::cerr << "gig::Engine::LaunchVoice() Error: Unknown dimension\n" << std::flush;
964                }
965            }
966            ::gig::DimensionRegion* pDimRgn = pRegion->GetDimensionRegionByValue(DimValues);
967    
968            // no need to continue if sample is silent
969            if (!pDimRgn->pSample || !pDimRgn->pSample->SamplesTotal) return Pool<Voice>::Iterator();
970    
971            // allocate a new voice for the key
972            Pool<Voice>::Iterator itNewVoice = pKey->pActiveVoices->allocAppend();
973            if (itNewVoice) {
974                // launch the new voice
975                if (itNewVoice->Trigger(pEngineChannel, itNoteOnEvent, pEngineChannel->Pitch, pDimRgn, VoiceType, iKeyGroup) < 0) {
976                    dmsg(4,("Voice not triggered\n"));
977                    pKey->pActiveVoices->free(itNewVoice);
978                }
979                else { // on success
980                    --VoiceSpawnsLeft;
981                    if (!pKey->Active) { // mark as active key
982                        pKey->Active = true;
983                        pKey->itSelf = pEngineChannel->pActiveKeys->allocAppend();
984                        *pKey->itSelf = itNoteOnEvent->Param.Note.Key;
985                    }
986                    if (itNewVoice->KeyGroup) {
987                        uint** ppKeyGroup = &pEngineChannel->ActiveKeyGroups[itNewVoice->KeyGroup];
988                        *ppKeyGroup = &*pKey->itSelf; // put key as the (new) active key to its key group
989                    }
990                    if (itNewVoice->Type == Voice::type_release_trigger_required) pKey->ReleaseTrigger = true; // mark key for the need of release triggered voice(s)
991                    return itNewVoice; // success
992                }
993            }
994            else if (VoiceStealing) {
995                // try to steal one voice
996                int result = StealVoice(pEngineChannel, itNoteOnEvent);
997                if (!result) { // voice stolen successfully
998                    // put note-on event into voice-stealing queue, so it will be reprocessed after killed voice died
999                    RTList<Event>::Iterator itStealEvent = pVoiceStealingQueue->allocAppend();
1000                    if (itStealEvent) {
1001                        *itStealEvent = *itNoteOnEvent; // copy event
1002                        itStealEvent->Param.Note.Layer = iLayer;
1003                        itStealEvent->Param.Note.ReleaseTrigger = ReleaseTriggerVoice;
1004                        pKey->VoiceTheftsQueued++;
1005                    }
1006                    else dmsg(1,("Voice stealing queue full!\n"));
1007                }
1008            }
1009    
1010            return Pool<Voice>::Iterator(); // no free voice or error
1011      }      }
1012    
1013      /**      /**
1014       *  Moves pitchbend event from the general (input) event list to the pitch       *  Will be called by LaunchVoice() method in case there are no free
1015       *  event list.       *  voices left. This method will select and kill one old voice for
1016         *  voice stealing and postpone the note-on event until the selected
1017         *  voice actually died.
1018       *       *
1019       *  @param pPitchbendEvent - absolute pitch value and time stamp of the event       *  @param pEngineChannel - engine channel on which this event occured on
1020         *  @param itNoteOnEvent - key, velocity and time stamp of the event
1021         *  @returns 0 on success, a value < 0 if no active voice could be picked for voice stealing
1022       */       */
1023      void Engine::ProcessPitchbend(Event* pPitchbendEvent) {      int Engine::StealVoice(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOnEvent) {
1024          this->Pitch = pPitchbendEvent->Pitch; // store current pitch value          if (VoiceSpawnsLeft <= 0) {
1025          pEvents->move(pPitchbendEvent, pSynthesisEvents[Event::destination_vco]);              dmsg(1,("Max. voice thefts per audio fragment reached (you may raise CONFIG_MAX_VOICES).\n"));
1026                return -1;
1027            }
1028            if (!pEventPool->poolIsEmpty()) {
1029    
1030                RTList<Voice>::Iterator itSelectedVoice;
1031    
1032                // Select one voice for voice stealing
1033                switch (CONFIG_VOICE_STEAL_ALGO) {
1034    
1035                    // try to pick the oldest voice on the key where the new
1036                    // voice should be spawned, if there is no voice on that
1037                    // key, or no voice left to kill, then procceed with
1038                    // 'oldestkey' algorithm
1039                    case voice_steal_algo_oldestvoiceonkey: {
1040                        midi_key_info_t* pSelectedKey = &pEngineChannel->pMIDIKeyInfo[itNoteOnEvent->Param.Note.Key];
1041                        itSelectedVoice = pSelectedKey->pActiveVoices->first();
1042                        // proceed iterating if voice was created in this fragment cycle
1043                        while (itSelectedVoice && !itSelectedVoice->IsStealable()) ++itSelectedVoice;
1044                        // if we haven't found a voice then proceed with algorithm 'oldestkey'
1045                        if (itSelectedVoice && itSelectedVoice->IsStealable()) break;
1046                    } // no break - intentional !
1047    
1048                    // try to pick the oldest voice on the oldest active key
1049                    // from the same engine channel
1050                    // (caution: must stay after 'oldestvoiceonkey' algorithm !)
1051                    case voice_steal_algo_oldestkey: {
1052                        // if we already stole in this fragment, try to proceed on same key
1053                        if (this->itLastStolenVoice) {
1054                            itSelectedVoice = this->itLastStolenVoice;
1055                            do {
1056                                ++itSelectedVoice;
1057                            } while (itSelectedVoice && !itSelectedVoice->IsStealable()); // proceed iterating if voice was created in this fragment cycle
1058                            // found a "stealable" voice ?
1059                            if (itSelectedVoice && itSelectedVoice->IsStealable()) {
1060                                // remember which voice we stole, so we can simply proceed on next voice stealing
1061                                this->itLastStolenVoice = itSelectedVoice;
1062                                break; // selection succeeded
1063                            }
1064                        }
1065                        // get (next) oldest key
1066                        RTList<uint>::Iterator iuiSelectedKey = (this->iuiLastStolenKey) ? ++this->iuiLastStolenKey : pEngineChannel->pActiveKeys->first();
1067                        while (iuiSelectedKey) {
1068                            midi_key_info_t* pSelectedKey = &pEngineChannel->pMIDIKeyInfo[*iuiSelectedKey];
1069                            itSelectedVoice = pSelectedKey->pActiveVoices->first();
1070                            // proceed iterating if voice was created in this fragment cycle
1071                            while (itSelectedVoice && !itSelectedVoice->IsStealable()) ++itSelectedVoice;
1072                            // found a "stealable" voice ?
1073                            if (itSelectedVoice && itSelectedVoice->IsStealable()) {
1074                                // remember which voice on which key we stole, so we can simply proceed on next voice stealing
1075                                this->iuiLastStolenKey  = iuiSelectedKey;
1076                                this->itLastStolenVoice = itSelectedVoice;
1077                                break; // selection succeeded
1078                            }
1079                            ++iuiSelectedKey; // get next oldest key
1080                        }
1081                        break;
1082                    }
1083    
1084                    // don't steal anything
1085                    case voice_steal_algo_none:
1086                    default: {
1087                        dmsg(1,("No free voice (voice stealing disabled)!\n"));
1088                        return -1;
1089                    }
1090                }
1091    
1092                // if we couldn't steal a voice from the same engine channel then
1093                // steal oldest voice on the oldest key from any other engine channel
1094                // (the smaller engine channel number, the higher priority)
1095                if (!itSelectedVoice || !itSelectedVoice->IsStealable()) {
1096                    EngineChannel* pSelectedChannel;
1097                    int            iChannelIndex;
1098                    // select engine channel
1099                    if (pLastStolenChannel) {
1100                        pSelectedChannel = pLastStolenChannel;
1101                        iChannelIndex    = pSelectedChannel->iEngineIndexSelf;
1102                    } else { // pick the engine channel followed by this engine channel
1103                        iChannelIndex    = (pEngineChannel->iEngineIndexSelf + 1) % engineChannels.size();
1104                        pSelectedChannel = engineChannels[iChannelIndex];
1105                    }
1106    
1107                    // if we already stole in this fragment, try to proceed on same key
1108                    if (this->itLastStolenVoiceGlobally) {
1109                        itSelectedVoice = this->itLastStolenVoiceGlobally;
1110                        do {
1111                            ++itSelectedVoice;
1112                        } while (itSelectedVoice && !itSelectedVoice->IsStealable()); // proceed iterating if voice was created in this fragment cycle
1113                    }
1114    
1115                    #if CONFIG_DEVMODE
1116                    EngineChannel* pBegin = pSelectedChannel; // to detect endless loop
1117                    #endif // CONFIG_DEVMODE
1118    
1119                    // did we find a 'stealable' voice?
1120                    if (itSelectedVoice && itSelectedVoice->IsStealable()) {
1121                        // remember which voice we stole, so we can simply proceed on next voice stealing
1122                        this->itLastStolenVoiceGlobally = itSelectedVoice;
1123                    } else while (true) { // iterate through engine channels
1124                        // get (next) oldest key
1125                        RTList<uint>::Iterator iuiSelectedKey = (this->iuiLastStolenKeyGlobally) ? ++this->iuiLastStolenKeyGlobally : pSelectedChannel->pActiveKeys->first();
1126                        this->iuiLastStolenKeyGlobally = RTList<uint>::Iterator(); // to prevent endless loop (see line above)
1127                        while (iuiSelectedKey) {
1128                            midi_key_info_t* pSelectedKey = &pSelectedChannel->pMIDIKeyInfo[*iuiSelectedKey];
1129                            itSelectedVoice = pSelectedKey->pActiveVoices->first();
1130                            // proceed iterating if voice was created in this fragment cycle
1131                            while (itSelectedVoice && !itSelectedVoice->IsStealable()) ++itSelectedVoice;
1132                            // found a "stealable" voice ?
1133                            if (itSelectedVoice && itSelectedVoice->IsStealable()) {
1134                                // remember which voice on which key on which engine channel we stole, so we can simply proceed on next voice stealing
1135                                this->iuiLastStolenKeyGlobally  = iuiSelectedKey;
1136                                this->itLastStolenVoiceGlobally = itSelectedVoice;
1137                                this->pLastStolenChannel        = pSelectedChannel;
1138                                goto stealable_voice_found; // selection succeeded
1139                            }
1140                            ++iuiSelectedKey; // get next key on current engine channel
1141                        }
1142                        // get next engine channel
1143                        iChannelIndex    = (iChannelIndex + 1) % engineChannels.size();
1144                        pSelectedChannel = engineChannels[iChannelIndex];
1145    
1146                        #if CONFIG_DEVMODE
1147                        if (pSelectedChannel == pBegin) {
1148                            dmsg(1,("FATAL ERROR: voice stealing endless loop!\n"));
1149                            dmsg(1,("VoiceSpawnsLeft=%d.\n", VoiceSpawnsLeft));
1150                            dmsg(1,("Exiting.\n"));
1151                            exit(-1);
1152                        }
1153                        #endif // CONFIG_DEVMODE
1154                    }
1155                }
1156    
1157                // jump point if a 'stealable' voice was found
1158                stealable_voice_found:
1159    
1160                #if CONFIG_DEVMODE
1161                if (!itSelectedVoice->IsActive()) {
1162                    dmsg(1,("gig::Engine: ERROR, tried to steal a voice which was not active !!!\n"));
1163                    return -1;
1164                }
1165                #endif // CONFIG_DEVMODE
1166    
1167                // now kill the selected voice
1168                itSelectedVoice->Kill(itNoteOnEvent);
1169    
1170                --VoiceSpawnsLeft;
1171    
1172                return 0; // success
1173            }
1174            else {
1175                dmsg(1,("Event pool emtpy!\n"));
1176                return -1;
1177            }
1178      }      }
1179    
1180      /**      /**
1181       *  Immediately kills the voice given with pVoice (no matter if sustain is       *  Removes the given voice from the MIDI key's list of active voices.
1182       *  pressed or not) and removes it from the MIDI key's list of active voice.       *  This method will be called when a voice went inactive, e.g. because
1183       *  This method will e.g. be called if a voice went inactive by itself.       *  it finished to playback its sample, finished its release stage or
1184         *  just was killed.
1185       *       *
1186       *  @param pVoice - points to the voice to be killed       *  @param pEngineChannel - engine channel on which this event occured on
1187         *  @param itVoice - points to the voice to be freed
1188       */       */
1189      void Engine::KillVoice(Voice* pVoice) {      void Engine::FreeVoice(EngineChannel* pEngineChannel, Pool<Voice>::Iterator& itVoice) {
1190          if (pVoice) {          if (itVoice) {
1191              if (pVoice->IsActive()) pVoice->Kill();              midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[itVoice->MIDIKey];
1192    
1193              midi_key_info_t* pKey = &pMIDIKeyInfo[pVoice->MIDIKey];              uint keygroup = itVoice->KeyGroup;
1194    
1195              // free the voice object              // free the voice object
1196              pVoicePool->free(pVoice);              pVoicePool->free(itVoice);
1197    
1198              // check if there are no voices left on the MIDI key and update the key info if so              // if no other voices left and member of a key group, remove from key group
1199              if (pKey->pActiveVoices->is_empty()) {              if (pKey->pActiveVoices->isEmpty() && keygroup) {
1200                  pKey->Active = false;                  uint** ppKeyGroup = &pEngineChannel->ActiveKeyGroups[keygroup];
1201                  pActiveKeys->free(pKey->pSelf); // remove key from list of active keys                  if (*ppKeyGroup == &*pKey->itSelf) *ppKeyGroup = NULL; // remove key from key group
                 pKey->pSelf = NULL;  
                 dmsg(3,("Key has no more voices now\n"));  
1202              }              }
1203          }          }
1204          else std::cerr << "Couldn't release voice! (pVoice == NULL)\n" << std::flush;          else std::cerr << "Couldn't release voice! (!itVoice)\n" << std::flush;
1205        }
1206    
1207        /**
1208         *  Called when there's no more voice left on a key, this call will
1209         *  update the key info respectively.
1210         *
1211         *  @param pEngineChannel - engine channel on which this event occured on
1212         *  @param pKey - key which is now inactive
1213         */
1214        void Engine::FreeKey(EngineChannel* pEngineChannel, midi_key_info_t* pKey) {
1215            if (pKey->pActiveVoices->isEmpty()) {
1216                pKey->Active = false;
1217                pEngineChannel->pActiveKeys->free(pKey->itSelf); // remove key from list of active keys
1218                pKey->itSelf = RTList<uint>::Iterator();
1219                pKey->ReleaseTrigger = false;
1220                pKey->pEvents->clear();
1221                dmsg(3,("Key has no more voices now\n"));
1222            }
1223            else dmsg(1,("gig::Engine: Oops, tried to free a key which contains voices.\n"));
1224      }      }
1225    
1226      /**      /**
1227       *  Reacts on supported control change commands (e.g. pitch bend wheel,       *  Reacts on supported control change commands (e.g. pitch bend wheel,
1228       *  modulation wheel, aftertouch).       *  modulation wheel, aftertouch).
1229       *       *
1230       *  @param pControlChangeEvent - controller, value and time stamp of the event       *  @param pEngineChannel - engine channel on which this event occured on
1231         *  @param itControlChangeEvent - controller, value and time stamp of the event
1232       */       */
1233      void Engine::ProcessControlChange(Event* pControlChangeEvent) {      void Engine::ProcessControlChange(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itControlChangeEvent) {
1234          dmsg(4,("Engine::ContinuousController cc=%d v=%d\n", pControlChangeEvent->Controller, pControlChangeEvent->Value));          dmsg(4,("Engine::ContinuousController cc=%d v=%d\n", itControlChangeEvent->Param.CC.Controller, itControlChangeEvent->Param.CC.Value));
1235    
1236          switch (pControlChangeEvent->Controller) {          // update controller value in the engine channel's controller table
1237              case 64: {          pEngineChannel->ControllerTable[itControlChangeEvent->Param.CC.Controller] = itControlChangeEvent->Param.CC.Value;
1238                  if (pControlChangeEvent->Value >= 64 && !SustainPedal) {  
1239                      dmsg(4,("PEDAL DOWN\n"));          switch (itControlChangeEvent->Param.CC.Controller) {
1240                      SustainPedal = true;              case 5: { // portamento time
1241                    pEngineChannel->PortamentoTime = (float) itControlChangeEvent->Param.CC.Value / 127.0f * (float) CONFIG_PORTAMENTO_TIME_MAX + (float) CONFIG_PORTAMENTO_TIME_MIN;
1242                    break;
1243                }
1244                case 7: { // volume
1245                    //TODO: not sample accurate yet
1246                    pEngineChannel->GlobalVolume = VolumeCurve[itControlChangeEvent->Param.CC.Value] *  CONFIG_GLOBAL_ATTENUATION;
1247                    pEngineChannel->bStatusChanged = true; // engine channel status has changed, so set notify flag
1248                    break;
1249                }
1250                case 10: { // panpot
1251                    //TODO: not sample accurate yet
1252                    pEngineChannel->GlobalPanLeft  = PanCurve[128 - itControlChangeEvent->Param.CC.Value];
1253                    pEngineChannel->GlobalPanRight = PanCurve[itControlChangeEvent->Param.CC.Value];
1254                    break;
1255                }
1256                case 64: { // sustain
1257                    if (itControlChangeEvent->Param.CC.Value >= 64 && !pEngineChannel->SustainPedal) {
1258                        dmsg(4,("DAMPER (RIGHT) PEDAL DOWN\n"));
1259                        pEngineChannel->SustainPedal = true;
1260    
1261                        #if !CONFIG_PROCESS_MUTED_CHANNELS
1262                        if (pEngineChannel->GetMute()) return; // skip if sampler channel is muted
1263                        #endif
1264    
1265                      // cancel release process of voices if necessary                      // cancel release process of voices if necessary
1266                      uint* piKey = pActiveKeys->first();                      RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first();
1267                      if (piKey) {                      for (; iuiKey; ++iuiKey) {
1268                          pControlChangeEvent->Type = Event::type_cancel_release; // transform event type                          midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey];
1269                          while (piKey) {                          if (!pKey->KeyPressed) {
1270                              midi_key_info_t* pKey = &pMIDIKeyInfo[*piKey];                              RTList<Event>::Iterator itNewEvent = pKey->pEvents->allocAppend();
1271                              pActiveKeys->set_current(piKey);                              if (itNewEvent) {
1272                              piKey = pActiveKeys->next();                                  *itNewEvent = *itControlChangeEvent; // copy event to the key's own event list
1273                              if (!pKey->KeyPressed) {                                  itNewEvent->Type = Event::type_cancel_release; // transform event type
                                 Event* pNewEvent = pKey->pEvents->alloc();  
                                 if (pNewEvent) *pNewEvent = *pControlChangeEvent; // copy event to the key's own event list  
                                 else dmsg(1,("Event pool emtpy!\n"));  
1274                              }                              }
1275                                else dmsg(1,("Event pool emtpy!\n"));
1276                          }                          }
1277                      }                      }
1278                  }                  }
1279                  if (pControlChangeEvent->Value < 64 && SustainPedal) {                  if (itControlChangeEvent->Param.CC.Value < 64 && pEngineChannel->SustainPedal) {
1280                      dmsg(4,("PEDAL UP\n"));                      dmsg(4,("DAMPER (RIGHT) PEDAL UP\n"));
1281                      SustainPedal = false;                      pEngineChannel->SustainPedal = false;
1282    
1283                        #if !CONFIG_PROCESS_MUTED_CHANNELS
1284                        if (pEngineChannel->GetMute()) return; // skip if sampler channel is muted
1285                        #endif
1286    
1287                      // release voices if their respective key is not pressed                      // release voices if their respective key is not pressed
1288                      uint* piKey = pActiveKeys->first();                      RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first();
1289                      if (piKey) {                      for (; iuiKey; ++iuiKey) {
1290                          pControlChangeEvent->Type = Event::type_release; // transform event type                          midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey];
1291                          while (piKey) {                          if (!pKey->KeyPressed && ShouldReleaseVoice(pEngineChannel, *iuiKey)) {
1292                              midi_key_info_t* pKey = &pMIDIKeyInfo[*piKey];                              RTList<Event>::Iterator itNewEvent = pKey->pEvents->allocAppend();
1293                              pActiveKeys->set_current(piKey);                              if (itNewEvent) {
1294                              piKey = pActiveKeys->next();                                  *itNewEvent = *itControlChangeEvent; // copy event to the key's own event list
1295                              if (!pKey->KeyPressed) {                                  itNewEvent->Type = Event::type_release; // transform event type
                                 Event* pNewEvent = pKey->pEvents->alloc();  
                                 if (pNewEvent) *pNewEvent = *pControlChangeEvent; // copy event to the key's own event list  
                                 else dmsg(1,("Event pool emtpy!\n"));  
1296                              }                              }
1297                                else dmsg(1,("Event pool emtpy!\n"));
1298                            }
1299                        }
1300                    }
1301                    break;
1302                }
1303                case 65: { // portamento on / off
1304                    KillAllVoices(pEngineChannel, itControlChangeEvent);
1305                    pEngineChannel->PortamentoMode = itControlChangeEvent->Param.CC.Value >= 64;
1306                    break;
1307                }
1308                case 66: { // sostenuto
1309                    if (itControlChangeEvent->Param.CC.Value >= 64 && !pEngineChannel->SostenutoPedal) {
1310                        dmsg(4,("SOSTENUTO (CENTER) PEDAL DOWN\n"));
1311                        pEngineChannel->SostenutoPedal = true;
1312    
1313                        #if !CONFIG_PROCESS_MUTED_CHANNELS
1314                        if (pEngineChannel->GetMute()) return; // skip if sampler channel is muted
1315                        #endif
1316    
1317                        SostenutoKeyCount = 0;
1318                        // Remeber the pressed keys
1319                        RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first();
1320                        for (; iuiKey; ++iuiKey) {
1321                            midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey];
1322                            if (pKey->KeyPressed && SostenutoKeyCount < 128) SostenutoKeys[SostenutoKeyCount++] = *iuiKey;
1323                        }
1324                    }
1325                    if (itControlChangeEvent->Param.CC.Value < 64 && pEngineChannel->SostenutoPedal) {
1326                        dmsg(4,("SOSTENUTO (CENTER) PEDAL UP\n"));
1327                        pEngineChannel->SostenutoPedal = false;
1328    
1329                        #if !CONFIG_PROCESS_MUTED_CHANNELS
1330                        if (pEngineChannel->GetMute()) return; // skip if sampler channel is muted
1331                        #endif
1332    
1333                        // release voices if the damper pedal is up and their respective key is not pressed
1334                        for (int i = 0; i < SostenutoKeyCount; i++) {
1335                            midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[SostenutoKeys[i]];
1336                            if (!pKey->KeyPressed && !pEngineChannel->SustainPedal) {
1337                                RTList<Event>::Iterator itNewEvent = pKey->pEvents->allocAppend();
1338                                if (itNewEvent) {
1339                                    *itNewEvent = *itControlChangeEvent; // copy event to the key's own event list
1340                                    itNewEvent->Type = Event::type_release; // transform event type
1341                                }
1342                                else dmsg(1,("Event pool emtpy!\n"));
1343                            }
1344                        }
1345                    }
1346                    break;
1347                }
1348    
1349    
1350                // Channel Mode Messages
1351    
1352                case 120: { // all sound off
1353                    KillAllVoices(pEngineChannel, itControlChangeEvent);
1354                    break;
1355                }
1356                case 121: { // reset all controllers
1357                    pEngineChannel->ResetControllers();
1358                    break;
1359                }
1360                case 123: { // all notes off
1361                    #if CONFIG_PROCESS_ALL_NOTES_OFF
1362                    ReleaseAllVoices(pEngineChannel, itControlChangeEvent);
1363                    #endif // CONFIG_PROCESS_ALL_NOTES_OFF
1364                    break;
1365                }
1366                case 126: { // mono mode on
1367                    KillAllVoices(pEngineChannel, itControlChangeEvent);
1368                    pEngineChannel->SoloMode = true;
1369                    break;
1370                }
1371                case 127: { // poly mode on
1372                    KillAllVoices(pEngineChannel, itControlChangeEvent);
1373                    pEngineChannel->SoloMode = false;
1374                    break;
1375                }
1376            }
1377        }
1378    
1379        /**
1380         *  Reacts on MIDI system exclusive messages.
1381         *
1382         *  @param itSysexEvent - sysex data size and time stamp of the sysex event
1383         */
1384        void Engine::ProcessSysex(Pool<Event>::Iterator& itSysexEvent) {
1385            RingBuffer<uint8_t>::NonVolatileReader reader = pSysexBuffer->get_non_volatile_reader();
1386    
1387            uint8_t exclusive_status, id;
1388            if (!reader.pop(&exclusive_status)) goto free_sysex_data;
1389            if (!reader.pop(&id))               goto free_sysex_data;
1390            if (exclusive_status != 0xF0)       goto free_sysex_data;
1391    
1392            switch (id) {
1393                case 0x41: { // Roland
1394                    dmsg(3,("Roland Sysex\n"));
1395                    uint8_t device_id, model_id, cmd_id;
1396                    if (!reader.pop(&device_id)) goto free_sysex_data;
1397                    if (!reader.pop(&model_id))  goto free_sysex_data;
1398                    if (!reader.pop(&cmd_id))    goto free_sysex_data;
1399                    if (model_id != 0x42 /*GS*/) goto free_sysex_data;
1400                    if (cmd_id != 0x12 /*DT1*/)  goto free_sysex_data;
1401    
1402                    // command address
1403                    uint8_t addr[3]; // 2 byte addr MSB, followed by 1 byte addr LSB)
1404                    const RingBuffer<uint8_t>::NonVolatileReader checksum_reader = reader; // so we can calculate the check sum later
1405                    if (reader.read(&addr[0], 3) != 3) goto free_sysex_data;
1406                    if (addr[0] == 0x40 && addr[1] == 0x00) { // System Parameters
1407                        dmsg(3,("\tSystem Parameter\n"));
1408                    }
1409                    else if (addr[0] == 0x40 && addr[1] == 0x01) { // Common Parameters
1410                        dmsg(3,("\tCommon Parameter\n"));
1411                    }
1412                    else if (addr[0] == 0x40 && (addr[1] & 0xf0) == 0x10) { // Part Parameters (1)
1413                        dmsg(3,("\tPart Parameter\n"));
1414                        switch (addr[2]) {
1415                            case 0x40: { // scale tuning
1416                                dmsg(3,("\t\tScale Tuning\n"));
1417                                uint8_t scale_tunes[12]; // detuning of all 12 semitones of an octave
1418                                if (reader.read(&scale_tunes[0], 12) != 12) goto free_sysex_data;
1419                                uint8_t checksum;
1420                                if (!reader.pop(&checksum)) goto free_sysex_data;
1421                                #if CONFIG_ASSERT_GS_SYSEX_CHECKSUM
1422                                if (GSCheckSum(checksum_reader, 12)) goto free_sysex_data;
1423                                #endif // CONFIG_ASSERT_GS_SYSEX_CHECKSUM
1424                                for (int i = 0; i < 12; i++) scale_tunes[i] -= 64;
1425                                AdjustScale((int8_t*) scale_tunes);
1426                                dmsg(3,("\t\t\tNew scale applied.\n"));
1427                                break;
1428                          }                          }
1429                      }                      }
1430                  }                  }
1431                    else if (addr[0] == 0x40 && (addr[1] & 0xf0) == 0x20) { // Part Parameters (2)
1432                    }
1433                    else if (addr[0] == 0x41) { // Drum Setup Parameters
1434                    }
1435                  break;                  break;
1436              }              }
1437          }          }
1438    
1439          // update controller value in the engine's controller table          free_sysex_data: // finally free sysex data
1440          ControllerTable[pControlChangeEvent->Controller] = pControlChangeEvent->Value;          pSysexBuffer->increment_read_ptr(itSysexEvent->Param.Sysex.Size);
1441        }
1442    
1443          // move event from the unsorted event list to the control change event list      /**
1444          pEvents->move(pControlChangeEvent, pCCEvents);       * Calculates the Roland GS sysex check sum.
1445         *
1446         * @param AddrReader - reader which currently points to the first GS
1447         *                     command address byte of the GS sysex message in
1448         *                     question
1449         * @param DataSize   - size of the GS message data (in bytes)
1450         */
1451        uint8_t Engine::GSCheckSum(const RingBuffer<uint8_t>::NonVolatileReader AddrReader, uint DataSize) {
1452            RingBuffer<uint8_t>::NonVolatileReader reader = AddrReader;
1453            uint bytes = 3 /*addr*/ + DataSize;
1454            uint8_t addr_and_data[bytes];
1455            reader.read(&addr_and_data[0], bytes);
1456            uint8_t sum = 0;
1457            for (uint i = 0; i < bytes; i++) sum += addr_and_data[i];
1458            return 128 - sum % 128;
1459      }      }
1460    
1461      /**      /**
1462       * Initialize the parameter sequence for the modulation destination given by       * Allows to tune each of the twelve semitones of an octave.
1463       * by 'dst' with the constant value given by val.       *
1464         * @param ScaleTunes - detuning of all twelve semitones (in cents)
1465       */       */
1466      void Engine::ResetSynthesisParameters(Event::destination_t dst, float val) {      void Engine::AdjustScale(int8_t ScaleTunes[12]) {
1467          int maxsamples = pAudioOutputDevice->MaxSamplesPerCycle();          memcpy(&this->ScaleTuning[0], &ScaleTunes[0], 12); //TODO: currently not sample accurate
1468          float* m = &pSynthesisParameters[dst][0];      }
1469          for (int i = 0; i < maxsamples; i += 4) {  
1470             m[i]   = val;      /**
1471             m[i+1] = val;       * Releases all voices on an engine channel. All voices will go into
1472             m[i+2] = val;       * the release stage and thus it might take some time (e.g. dependant to
1473             m[i+3] = val;       * their envelope release time) until they actually die.
1474         *
1475         * @param pEngineChannel - engine channel on which all voices should be released
1476         * @param itReleaseEvent - event which caused this releasing of all voices
1477         */
1478        void Engine::ReleaseAllVoices(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itReleaseEvent) {
1479            RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first();
1480            while (iuiKey) {
1481                midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey];
1482                ++iuiKey;
1483                // append a 'release' event to the key's own event list
1484                RTList<Event>::Iterator itNewEvent = pKey->pEvents->allocAppend();
1485                if (itNewEvent) {
1486                    *itNewEvent = *itReleaseEvent; // copy original event (to the key's event list)
1487                    itNewEvent->Type = Event::type_release; // transform event type
1488                }
1489                else dmsg(1,("Event pool emtpy!\n"));
1490          }          }
1491      }      }
1492    
1493      float Engine::Volume() {      /**
1494          return GlobalVolume;       * Kills all voices on an engine channel as soon as possible. Voices
1495         * won't get into release state, their volume level will be ramped down
1496         * as fast as possible.
1497         *
1498         * @param pEngineChannel - engine channel on which all voices should be killed
1499         * @param itKillEvent    - event which caused this killing of all voices
1500         */
1501        void Engine::KillAllVoices(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itKillEvent) {
1502            RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first();
1503            RTList<uint>::Iterator end    = pEngineChannel->pActiveKeys->end();
1504            while (iuiKey != end) { // iterate through all active keys
1505                midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey];
1506                ++iuiKey;
1507                RTList<Voice>::Iterator itVoice     = pKey->pActiveVoices->first();
1508                RTList<Voice>::Iterator itVoicesEnd = pKey->pActiveVoices->end();
1509                for (; itVoice != itVoicesEnd; ++itVoice) { // iterate through all voices on this key
1510                    itVoice->Kill(itKillEvent);
1511                    --VoiceSpawnsLeft; //FIXME: just a temporary workaround, we should check the cause in StealVoice() instead
1512                }
1513            }
1514      }      }
1515    
1516      void Engine::Volume(float f) {      /**
1517          GlobalVolume = f;       * Determines whether the specified voice should be released.
1518         *
1519         * @param pEngineChannel - The engine channel on which the voice should be checked
1520         * @param Key - The key number
1521         * @returns true if the specified should be released, false otherwise.
1522         */
1523        bool Engine::ShouldReleaseVoice(EngineChannel* pEngineChannel, int Key) {
1524            if (pEngineChannel->SustainPedal) return false;
1525    
1526            if (pEngineChannel->SostenutoPedal) {
1527                for (int i = 0; i < SostenutoKeyCount; i++)
1528                    if (Key == SostenutoKeys[i]) return false;
1529            }
1530    
1531            return true;
1532      }      }
1533    
1534      uint Engine::VoiceCount() {      uint Engine::VoiceCount() {
# Line 690  namespace LinuxSampler { namespace gig { Line 1559  namespace LinuxSampler { namespace gig {
1559          return pDiskThread->GetBufferFillPercentage();          return pDiskThread->GetBufferFillPercentage();
1560      }      }
1561    
1562        String Engine::EngineName() {
1563            return LS_GIG_ENGINE_NAME;
1564        }
1565    
1566      String Engine::Description() {      String Engine::Description() {
1567          return "Gigasampler Engine";          return "Gigasampler Engine";
1568      }      }
1569    
1570      String Engine::Version() {      String Engine::Version() {
1571          return "0.0.1-0cvs20040423";          String s = "$Revision: 1.65 $";
1572            return s.substr(11, s.size() - 13); // cut dollar signs, spaces and CVS macro keyword
1573        }
1574    
1575        // static constant initializers
1576        const float* Engine::VolumeCurve(InitVolumeCurve());
1577        const float* Engine::PanCurve(InitPanCurve());
1578        const float* Engine::CrossfadeCurve(InitCrossfadeCurve());
1579    
1580        float* Engine::InitVolumeCurve() {
1581            // line-segment approximation
1582            const float segments[] = {
1583                0, 0, 2, 0.0046, 16, 0.016, 31, 0.051, 45, 0.115, 54.5, 0.2,
1584                64.5, 0.39, 74, 0.74, 92, 1.03, 114, 1.94, 119.2, 2.2, 127, 2.2
1585            };
1586            return InitCurve(segments);
1587        }
1588    
1589        float* Engine::InitPanCurve() {
1590            // line-segment approximation
1591            const float segments[] = {
1592                0, 0, 1, 0,
1593                2, 0.05, 31.5, 0.7, 51, 0.851, 74.5, 1.12,
1594                127, 1.41, 128, 1.41
1595            };
1596            return InitCurve(segments, 129);
1597        }
1598    
1599        float* Engine::InitCrossfadeCurve() {
1600            // line-segment approximation
1601            const float segments[] = {
1602                0, 0, 1, 0.03, 10, 0.1, 51, 0.58, 127, 1
1603            };
1604            return InitCurve(segments);
1605        }
1606    
1607        float* Engine::InitCurve(const float* segments, int size) {
1608            float* y = new float[size];
1609            for (int x = 0 ; x < size ; x++) {
1610                if (x > segments[2]) segments += 2;
1611                y[x] = segments[1] + (x - segments[0]) *
1612                    (segments[3] - segments[1]) / (segments[2] - segments[0]);
1613            }
1614            return y;
1615      }      }
1616    
1617  }} // namespace LinuxSampler::gig  }} // namespace LinuxSampler::gig
Legend:
Removed from v.80  
changed lines
  Added in v.924
  ViewVC Help
Powered by ViewVC