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

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

Parent Directory | Revision Log | View Patch Patch

-revision 80 by schoenebeck,
Sun May 23 19:16:33 2004 UTC
+revision 690 by schoenebeck,
Fri Jul 15 16:43:56 2005 UTC
 Line 3
   *   LinuxSampler - modular, streaming capable sampler                     *
   *                                                                         *
   *   Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck   *
+  *   Copyright (C) 2005 Christian Schoenebeck                              *
   *                                                                         *
   *   This program is free software; you can redistribute it and/or modify  *
   *   it under the terms of the GNU General Public License as published by  *
-Line 23
+Line 24
  #include <sstream>
  #include "DiskThread.h"
  #include "Voice.h"
+ #include "EGADSR.h"
+ #include "../EngineFactory.h"
  #include "Engine.h"
+ #if defined(__APPLE__)
+ # include <stdlib.h>
+ #else
+ # include <malloc.h>
+ #endif
  namespace LinuxSampler { namespace gig {
-     InstrumentResourceManager Engine::Instruments;
+     InstrumentResourceManager Engine::instruments;
+     std::map<AudioOutputDevice*,Engine*> Engine::engines;
+     /**
+      * Get a gig::Engine object for the given gig::EngineChannel and the
+      * given AudioOutputDevice. All engine channels which are connected to
+      * the same audio output device will use the same engine instance. This
+      * method will be called by a gig::EngineChannel whenever it's
+      * connecting to a audio output device.
+      *
+      * @param pChannel - engine channel which acquires an engine object
+      * @param pDevice  - the audio output device \a pChannel is connected to
+      */
+     Engine* Engine::AcquireEngine(LinuxSampler::gig::EngineChannel* pChannel, AudioOutputDevice* pDevice) {
+         Engine* pEngine = NULL;
+         // check if there's already an engine for the given audio output device
+         if (engines.count(pDevice)) {
+             dmsg(4,("Using existing gig::Engine.\n"));
+             pEngine = engines[pDevice];
+         } else { // create a new engine (and disk thread) instance for the given audio output device
+             dmsg(4,("Creating new gig::Engine.\n"));
+             pEngine = (Engine*) EngineFactory::Create("gig");
+             pEngine->Connect(pDevice);
+             engines[pDevice] = pEngine;
+         }
+         // register engine channel to the engine instance
+         pEngine->engineChannels.add(pChannel);
+         // remember index in the ArrayList
+         pChannel->iEngineIndexSelf = pEngine->engineChannels.size() - 1;
+         dmsg(4,("This gig::Engine has now %d EngineChannels.\n",pEngine->engineChannels.size()));
+         return pEngine;
+     }
+     /**
+      * Once an engine channel is disconnected from an audio output device,
+      * it wil immediately call this method to unregister itself from the
+      * engine instance and if that engine instance is not used by any other
+      * engine channel anymore, then that engine instance will be destroyed.
+      *
+      * @param pChannel - engine channel which wants to disconnect from it's
+      *                   engine instance
+      * @param pDevice  - audio output device \a pChannel was connected to
+      */
+     void Engine::FreeEngine(LinuxSampler::gig::EngineChannel* pChannel, AudioOutputDevice* pDevice) {
+         dmsg(4,("Disconnecting EngineChannel from gig::Engine.\n"));
+         Engine* pEngine = engines[pDevice];
+         // unregister EngineChannel from the Engine instance
+         pEngine->engineChannels.remove(pChannel);
+         // if the used Engine instance is not used anymore, then destroy it
+         if (pEngine->engineChannels.empty()) {
+             pDevice->Disconnect(pEngine);
+             engines.erase(pDevice);
+             delete pEngine;
+             dmsg(4,("Destroying gig::Engine.\n"));
+         }
+         else dmsg(4,("This gig::Engine has now %d EngineChannels.\n",pEngine->engineChannels.size()));
+     }
+     /**
+      * Constructor
+      */
      Engine::Engine() {
-         pRIFF              = NULL;
-         pGig               = NULL;
-         pInstrument        = NULL;
          pAudioOutputDevice = NULL;
          pDiskThread        = NULL;
          pEventGenerator    = NULL;
-         pEventQueue        = new RingBuffer<Event>(MAX_EVENTS_PER_FRAGMENT);
+         pSysexBuffer       = new RingBuffer<uint8_t>(CONFIG_SYSEX_BUFFER_SIZE, 0);
-         pEventPool         = new RTELMemoryPool<Event>(MAX_EVENTS_PER_FRAGMENT);
+         pEventQueue        = new RingBuffer<Event>(CONFIG_MAX_EVENTS_PER_FRAGMENT, 0);
-         pVoicePool         = new RTELMemoryPool<Voice>(MAX_AUDIO_VOICES);
+         pEventPool         = new Pool<Event>(CONFIG_MAX_EVENTS_PER_FRAGMENT);
-         pActiveKeys        = new RTELMemoryPool<uint>(128);
+         pVoicePool         = new Pool<Voice>(CONFIG_MAX_VOICES);
-         pEvents            = new RTEList<Event>(pEventPool);
+         pVoiceStealingQueue = new RTList<Event>(pEventPool);
-         pCCEvents          = new RTEList<Event>(pEventPool);
+         pGlobalEvents      = new RTList<Event>(pEventPool);
-         for (uint i = 0; i < Event::destination_count; i++) {
+         for (RTList<Voice>::Iterator iterVoice = pVoicePool->allocAppend(); iterVoice == pVoicePool->last(); iterVoice = pVoicePool->allocAppend()) {
-             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);
          }
          pVoicePool->clear();
-Line 63 
 namespace LinuxSampler { namespace gig {
+Line 119 
 namespace LinuxSampler { namespace gig {
          pMainFilterParameters   = NULL;
          ResetInternal();
+         ResetScaleTuning();
      }
+     /**
+      * Destructor
+      */
      Engine::~Engine() {
          if (pDiskThread) {
+             dmsg(1,("Stopping disk thread..."));
              pDiskThread->StopThread();
              delete pDiskThread;
+             dmsg(1,("OK\n"));
          }
-         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;
          if (pEventQueue) delete pEventQueue;
          if (pEventPool)  delete pEventPool;
-         if (pVoicePool)  delete pVoicePool;
+         if (pVoicePool) {
-         if (pActiveKeys) delete pActiveKeys;
+             pVoicePool->clear();
+             delete pVoicePool;
+         }
          if (pEventGenerator) delete pEventGenerator;
          if (pMainFilterParameters) delete[] pMainFilterParameters;
          if (pBasicFilterParameters) delete[] pBasicFilterParameters;
-         if (pSynthesisParameters[0]) delete[] pSynthesisParameters[0];
+         if (pSynthesisParameters[0]) free(pSynthesisParameters[0]);
+         if (pVoiceStealingQueue) delete pVoiceStealingQueue;
+         if (pSysexBuffer) delete pSysexBuffer;
+         EngineFactory::Destroy(this);
      }
      void Engine::Enable() {
-Line 116 
 namespace LinuxSampler { namespace gig {
+Line 171 
 namespace LinuxSampler { namespace gig {
       */
      void Engine::Reset() {
          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();
          ResetInternal();
+         ResetScaleTuning();
-         // signal audio thread to continue with rendering
-         //SuspensionRequested = false;
          Enable();
      }
-Line 142 
 namespace LinuxSampler { namespace gig {
+Line 181 
 namespace LinuxSampler { namespace gig {
       *  control and status variables. This method is not thread safe!
       */
      void Engine::ResetInternal() {
-         Pitch               = 0;
-         SustainPedal        = false;
          ActiveVoiceCount    = 0;
          ActiveVoiceCountMax = 0;
-         // set all MIDI controller values to zero
+         // reset voice stealing parameters
-         memset(ControllerTable, 0x00, 128);
+         pVoiceStealingQueue->clear();
+         itLastStolenVoice          = RTList<Voice>::Iterator();
-         // reset key info
+         itLastStolenVoiceGlobally  = RTList<Voice>::Iterator();
-         for (uint i = 0; i < 128; i++) {
+         iuiLastStolenKey           = RTList<uint>::Iterator();
-             pMIDIKeyInfo[i].pActiveVoices->clear();
+         iuiLastStolenKeyGlobally   = RTList<uint>::Iterator();
-             pMIDIKeyInfo[i].pEvents->clear();
+         pLastStolenChannel         = NULL;
-             pMIDIKeyInfo[i].KeyPressed = false;
-             pMIDIKeyInfo[i].Active     = false;
-             pMIDIKeyInfo[i].pSelf      = NULL;
-         }
          // reset all voices
-         for (Voice* pVoice = pVoicePool->alloc(); pVoice; pVoice = pVoicePool->alloc()) {
+         for (RTList<Voice>::Iterator iterVoice = pVoicePool->allocAppend(); iterVoice == pVoicePool->last(); iterVoice = pVoicePool->allocAppend()) {
-             pVoice->Reset();
+             iterVoice->Reset();
          }
          pVoicePool->clear();
-         // free all active keys
-         pActiveKeys->clear();
          // reset disk thread
          if (pDiskThread) pDiskThread->Reset();
-Line 176 
 namespace LinuxSampler { namespace gig {
+Line 206 
 namespace LinuxSampler { namespace gig {
      }
      /**
-      *  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
-      */
-     void Engine::LoadInstrument(const char* FileName, uint Instrument) {
-         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();
-     }
-     /**
-      * Will be called by the InstrumentResourceManager when the instrument
-      * we are currently using in this engine is going to be updated, so we
-      * can stop playback before that happens.
       */
-     void Engine::ResourceToBeUpdated(::gig::Instrument* pResource, void*& pUpdateArg) {
+     void Engine::ResetScaleTuning() {
-         dmsg(3,("gig::Engine: Received instrument update message.\n"));
+         memset(&ScaleTuning[0], 0x00, 12);
-         DisableAndLock();
-         ResetInternal();
-         this->pInstrument = NULL;
      }
      /**
-      * Will be called by the InstrumentResourceManager when the instrument
+      * Connect this engine instance with the given audio output device.
-      * update process was completed, so we can continue with playback.
+      * This method will be called when an Engine instance is created.
+      * All of the engine's data structures which are dependant to the used
+      * audio output device / driver will be (re)allocated and / or
+      * adjusted appropriately.
+      *
+      * @param pAudioOut - audio output device to connect to
       */
-     void Engine::ResourceUpdated(::gig::Instrument* pOldResource, ::gig::Instrument* pNewResource, void* pUpdateArg) {
-         this->pInstrument = pNewResource;
-         Enable();
-     }
      void Engine::Connect(AudioOutputDevice* pAudioOut) {
          pAudioOutputDevice = pAudioOut;
-Line 265 
 namespace LinuxSampler { namespace gig {
+Line 235 
 namespace LinuxSampler { namespace gig {
              throw LinuxSamplerException(msg);
          }
+         this->MaxSamplesPerCycle = pAudioOutputDevice->MaxSamplesPerCycle();
+         this->SampleRate         = pAudioOutputDevice->SampleRate();
+         // FIXME: audio drivers with varying fragment sizes might be a problem here
+         MaxFadeOutPos = MaxSamplesPerCycle - int(double(SampleRate) * CONFIG_EG_MIN_RELEASE_TIME) - 1;
+         if (MaxFadeOutPos < 0) {
+             std::cerr << "gig::Engine: WARNING, CONFIG_EG_MIN_RELEASE_TIME "
+                       << "too big for current audio fragment size & sampling rate! "
+                       << "May lead to click sounds if voice stealing chimes in!\n" << std::flush;
+             // force volume ramp downs at the beginning of each fragment
+             MaxFadeOutPos = 0;
+             // lower minimum release time
+             const float minReleaseTime = (float) MaxSamplesPerCycle / (float) SampleRate;
+             for (RTList<Voice>::Iterator iterVoice = pVoicePool->allocAppend(); iterVoice == pVoicePool->last(); iterVoice = pVoicePool->allocAppend()) {
+                 iterVoice->pEG1->CalculateFadeOutCoeff(minReleaseTime, SampleRate);
+             }
+             pVoicePool->clear();
+         }
          // (re)create disk thread
          if (this->pDiskThread) {
+             dmsg(1,("Stopping disk thread..."));
              this->pDiskThread->StopThread();
              delete this->pDiskThread;
+             dmsg(1,("OK\n"));
          }
-         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
          if (!pDiskThread) {
              dmsg(0,("gig::Engine  new diskthread = NULL\n"));
              exit(EXIT_FAILURE);
          }
-         for (Voice* pVoice = pVoicePool->alloc(); pVoice; pVoice = pVoicePool->alloc()) {
+         for (RTList<Voice>::Iterator iterVoice = pVoicePool->allocAppend(); iterVoice == pVoicePool->last(); iterVoice = pVoicePool->allocAppend()) {
-             pVoice->pDiskThread = this->pDiskThread;
+             iterVoice->pDiskThread = this->pDiskThread;
-             pVoice->SetOutput(pAudioOut);
              dmsg(3,("d"));
          }
          pVoicePool->clear();
-Line 288 
 namespace LinuxSampler { namespace gig {
+Line 278 
 namespace LinuxSampler { namespace gig {
          pEventGenerator = new EventGenerator(pAudioOut->SampleRate());
          // (re)allocate synthesis parameter matrix
-         if (pSynthesisParameters[0]) delete[] pSynthesisParameters[0];
+         if (pSynthesisParameters[0]) free(pSynthesisParameters[0]);
-         pSynthesisParameters[0] = new float[Event::destination_count * pAudioOut->MaxSamplesPerCycle()];
+         #if defined(__APPLE__)
+         pSynthesisParameters[0] = (float *) malloc(Event::destination_count * sizeof(float) * pAudioOut->MaxSamplesPerCycle());
+         #else
+         pSynthesisParameters[0] = (float *) memalign(16,(Event::destination_count * sizeof(float) * pAudioOut->MaxSamplesPerCycle()));
+         #endif
          for (int dst = 1; dst < Event::destination_count; dst++)
              pSynthesisParameters[dst] = pSynthesisParameters[dst - 1] + pAudioOut->MaxSamplesPerCycle();
-Line 303 
 namespace LinuxSampler { namespace gig {
+Line 298 
 namespace LinuxSampler { namespace gig {
          pDiskThread->StartThread();
          dmsg(1,("OK\n"));
-         for (Voice* pVoice = pVoicePool->first(); pVoice; pVoice = pVoicePool->next()) {
+         for (RTList<Voice>::Iterator iterVoice = pVoicePool->allocAppend(); iterVoice == pVoicePool->last(); iterVoice = pVoicePool->allocAppend()) {
-             if (!pVoice->pDiskThread) {
+             if (!iterVoice->pDiskThread) {
                  dmsg(0,("Engine -> voice::trigger: !pDiskThread\n"));
                  exit(EXIT_FAILURE);
              }
          }
      }
-     void Engine::DisconnectAudioOutputDevice() {
+     /**
-         if (pAudioOutputDevice) { // if clause to prevent disconnect loops
+      * Clear all engine global event lists.
-             AudioOutputDevice* olddevice = pAudioOutputDevice;
+      */
-             pAudioOutputDevice = NULL;
+     void Engine::ClearEventLists() {
-             olddevice->Disconnect(this);
+         pGlobalEvents->clear();
+     }
+     /**
+      * Copy all events from the engine's global input queue buffer to the
+      * engine's internal event list. This will be done at the beginning of
+      * each audio cycle (that is each RenderAudio() call) to distinguish
+      * all global events which have to be processed in the current audio
+      * cycle. These events are usually just SysEx messages. Every
+      * EngineChannel has it's own input event queue buffer and event list
+      * to handle common events like NoteOn, NoteOff and ControlChange
+      * events.
+      *
+      * @param Samples - number of sample points to be processed in the
+      *                  current audio cycle
+      */
+     void Engine::ImportEvents(uint Samples) {
+         RingBuffer<Event>::NonVolatileReader eventQueueReader = pEventQueue->get_non_volatile_reader();
+         Event* pEvent;
+         while (true) {
+             // get next event from input event queue
+             if (!(pEvent = eventQueueReader.pop())) break;
+             // if younger event reached, ignore that and all subsequent ones for now
+             if (pEvent->FragmentPos() >= Samples) {
+                 eventQueueReader--;
+                 dmsg(2,("Younger Event, pos=%d ,Samples=%d!\n",pEvent->FragmentPos(),Samples));
+                 pEvent->ResetFragmentPos();
+                 break;
+             }
+             // copy event to internal event list
+             if (pGlobalEvents->poolIsEmpty()) {
+                 dmsg(1,("Event pool emtpy!\n"));
+                 break;
+             }
+             *pGlobalEvents->allocAppend() = *pEvent;
          }
+         eventQueueReader.free(); // free all copied events from input queue
      }
      /**
-Line 332 
 namespace LinuxSampler { namespace gig {
+Line 362 
 namespace LinuxSampler { namespace gig {
      int Engine::RenderAudio(uint Samples) {
          dmsg(5,("RenderAudio(Samples=%d)\n", Samples));
-         // return if no instrument loaded or engine disabled
+         // return if engine disabled
          if (EngineDisabled.Pop()) {
              dmsg(5,("gig::Engine: engine disabled (val=%d)\n",EngineDisabled.GetUnsafe()));
              return 0;
          }
-         if (!pInstrument) {
-             dmsg(5,("gig::Engine: no instrument loaded\n"));
-             return 0;
-         }
+         // update time of start and end of this audio fragment (as events' time stamps relate to this)
+         pEventGenerator->UpdateFragmentTime(Samples);
-         // empty the event lists for the new fragment
+         // We only allow a maximum of CONFIG_MAX_VOICES voices to be spawned
-         pEvents->clear();
+         // in each audio fragment. All subsequent request for spawning new
-         pCCEvents->clear();
+         // voices in the same audio fragment will be ignored.
-         for (uint i = 0; i < Event::destination_count; i++) {
+         VoiceSpawnsLeft = CONFIG_MAX_VOICES;
-             pSynthesisEvents[i]->clear();
+         // get all events from the engine's global input event queue which belong to the current fragment
+         // (these are usually just SysEx messages)
+         ImportEvents(Samples);
+         // process engine global events (these are currently only MIDI System Exclusive messages)
+         {
+             RTList<Event>::Iterator itEvent = pGlobalEvents->first();
+             RTList<Event>::Iterator end     = pGlobalEvents->end();
+             for (; itEvent != end; ++itEvent) {
+                 switch (itEvent->Type) {
+                     case Event::type_sysex:
+                         dmsg(5,("Engine: Sysex received\n"));
+                         ProcessSysex(itEvent);
+                         break;
+                 }
+             }
          }
-         // read and copy events from input queue
+         // reset internal voice counter (just for statistic of active voices)
-         Event event = pEventGenerator->CreateEvent();
+         ActiveVoiceCountTemp = 0;
-         while (true) {
-             if (!pEventQueue->pop(&event)) break;
-             pEvents->alloc_assign(event);
-         }
+         // handle events on all engine channels
+         for (int i = 0; i < engineChannels.size(); i++) {
+             if (!engineChannels[i]->pInstrument) continue; // ignore if no instrument loaded
+             ProcessEvents(engineChannels[i], Samples);
+         }
-         // 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
-         pEventGenerator->UpdateFragmentTime(Samples);
+         for (int i = 0; i < engineChannels.size(); i++) {
+             if (!engineChannels[i]->pInstrument) continue; // ignore if no instrument loaded
+             RenderActiveVoices(engineChannels[i], Samples);
+         }
+         // now that all ordinary voices on ALL engine channels are rendered, render new stolen voices
+         RenderStolenVoices(Samples);
-         // process events
+         // handle cleanup on all engine channels for the next audio fragment
-         Event* pNextEvent = pEvents->first();
+         for (int i = 0; i < engineChannels.size(); i++) {
-         while (pNextEvent) {
+             if (!engineChannels[i]->pInstrument) continue; // ignore if no instrument loaded
-             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;
-             }
          }
-         // render audio from all active voices
+         // empty the engine's event list for the next audio fragment
-         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
-         }
+         // reset voice stealing for the next audio fragment
+         pVoiceStealingQueue->clear();
-         // write that to the disk thread class so that it can print it
+         // just some statistics about this engine instance
-         // on the console for debugging purposes
+         ActiveVoiceCount = ActiveVoiceCountTemp;
-         ActiveVoiceCount = active_voices;
          if (ActiveVoiceCount > ActiveVoiceCountMax) ActiveVoiceCountMax = ActiveVoiceCount;
+         FrameTime += Samples;
          return 0;
      }
      /**
-      *  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
-      *  voice for the given key.
+      * engine channel.
       *
-      *  @param Key      - MIDI key number of the triggered key
+      * @param pEngineChannel - engine channel on which events should be
-      *  @param Velocity - MIDI velocity value of the triggered key
+      *                         processed
+      * @param Samples        - amount of sample points to be processed in
+      *                         this audio fragment cycle
       */
-     void Engine::SendNoteOn(uint8_t Key, uint8_t Velocity) {
+     void Engine::ProcessEvents(EngineChannel* pEngineChannel, uint Samples) {
-         Event event    = pEventGenerator->CreateEvent();
+         // get all events from the engine channels's input event queue which belong to the current fragment
-         event.Type     = Event::type_note_on;
+         // (these are the common events like NoteOn, NoteOff, ControlChange, etc.)
-         event.Key      = Key;
+         pEngineChannel->ImportEvents(Samples);
-         event.Velocity = Velocity;
-         if (this->pEventQueue->write_space() > 0) this->pEventQueue->push(&event);
+         // process events
-         else dmsg(1,("Engine: Input event queue full!"));
+         {
+             RTList<Event>::Iterator itEvent = pEngineChannel->pEvents->first();
+             RTList<Event>::Iterator end     = pEngineChannel->pEvents->end();
+             for (; itEvent != end; ++itEvent) {
+                 switch (itEvent->Type) {
+                     case Event::type_note_on:
+                         dmsg(5,("Engine: Note on received\n"));
+                         ProcessNoteOn((EngineChannel*)itEvent->pEngineChannel, itEvent);
+                         break;
+                     case Event::type_note_off:
+                         dmsg(5,("Engine: Note off received\n"));
+                         ProcessNoteOff((EngineChannel*)itEvent->pEngineChannel, itEvent);
+                         break;
+                     case Event::type_control_change:
+                         dmsg(5,("Engine: MIDI CC received\n"));
+                         ProcessControlChange((EngineChannel*)itEvent->pEngineChannel, itEvent);
+                         break;
+                     case Event::type_pitchbend:
+                         dmsg(5,("Engine: Pitchbend received\n"));
+                         ProcessPitchbend((EngineChannel*)itEvent->pEngineChannel, itEvent);
+                         break;
+                 }
+             }
+         }
+         // reset voice stealing for the next engine channel (or next audio fragment)
+         itLastStolenVoice         = RTList<Voice>::Iterator();
+         itLastStolenVoiceGlobally = RTList<Voice>::Iterator();
+         iuiLastStolenKey          = RTList<uint>::Iterator();
+         iuiLastStolenKeyGlobally  = RTList<uint>::Iterator();
+         pLastStolenChannel        = NULL;
      }
      /**
-      *  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
-      *  voice(s) on the given key.
+      * this fragment) on the given engine channel.
       *
-      *  @param Key      - MIDI key number of the released key
+      * @param pEngineChannel - engine channel on which audio should be
-      *  @param Velocity - MIDI release velocity value of the released key
+      *                         rendered
+      * @param Samples        - amount of sample points to be rendered in
+      *                         this audio fragment cycle
       */
-     void Engine::SendNoteOff(uint8_t Key, uint8_t Velocity) {
+     void Engine::RenderActiveVoices(EngineChannel* pEngineChannel, uint Samples) {
-         Event event    = pEventGenerator->CreateEvent();
+         RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first();
-         event.Type     = Event::type_note_off;
+         RTList<uint>::Iterator end    = pEngineChannel->pActiveKeys->end();
-         event.Key      = Key;
+         while (iuiKey != end) { // iterate through all active keys
-         event.Velocity = Velocity;
+             midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey];
-         if (this->pEventQueue->write_space() > 0) this->pEventQueue->push(&event);
+             ++iuiKey;
-         else dmsg(1,("Engine: Input event queue full!"));
+             RTList<Voice>::Iterator itVoice     = pKey->pActiveVoices->first();
+             RTList<Voice>::Iterator itVoicesEnd = pKey->pActiveVoices->end();
+             for (; itVoice != itVoicesEnd; ++itVoice) { // iterate through all voices on this key
+                 // now render current voice
+                 itVoice->Render(Samples);
+                 if (itVoice->IsActive()) ActiveVoiceCountTemp++; // still active
+                 else { // voice reached end, is now inactive
+                     FreeVoice(pEngineChannel, itVoice); // remove voice from the list of active voices
+                 }
+             }
+         }
      }
      /**
-      *  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
-      *  the pitch value for all voices.
+      * fragment) on the given engine channel. Stolen voices are rendered
+      * after all normal voices have been rendered; this is needed to render
+      * audio of those voices which were selected for voice stealing until
+      * the point were the stealing (that is the take over of the voice)
+      * actually happened.
       *
-      *  @param Pitch - MIDI pitch value (-8192 ... +8191)
+      * @param pEngineChannel - engine channel on which audio should be
+      *                         rendered
+      * @param Samples        - amount of sample points to be rendered in
+      *                         this audio fragment cycle
       */
-     void Engine::SendPitchbend(int Pitch) {
+     void Engine::RenderStolenVoices(uint Samples) {
-         Event event = pEventGenerator->CreateEvent();
+         RTList<Event>::Iterator itVoiceStealEvent = pVoiceStealingQueue->first();
-         event.Type  = Event::type_pitchbend;
+         RTList<Event>::Iterator end               = pVoiceStealingQueue->end();
-         event.Pitch = Pitch;
+         for (; itVoiceStealEvent != end; ++itVoiceStealEvent) {
-         if (this->pEventQueue->write_space() > 0) this->pEventQueue->push(&event);
+             EngineChannel* pEngineChannel = (EngineChannel*) itVoiceStealEvent->pEngineChannel;
-         else dmsg(1,("Engine: Input event queue full!"));
+             Pool<Voice>::Iterator itNewVoice =
+                 LaunchVoice(pEngineChannel, itVoiceStealEvent, itVoiceStealEvent->Param.Note.Layer, itVoiceStealEvent->Param.Note.ReleaseTrigger, false, false);
+             if (itNewVoice) {
+                 itNewVoice->Render(Samples);
+                 if (itNewVoice->IsActive()) ActiveVoiceCountTemp++; // still active
+                 else { // voice reached end, is now inactive
+                     FreeVoice(pEngineChannel, itNewVoice); // remove voice from the list of active voices
+                 }
+             }
+             else dmsg(1,("gig::Engine: ERROR, voice stealing didn't work out!\n"));
+             // we need to clear the key's event list explicitly here in case key was never active
+             midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[itVoiceStealEvent->Param.Note.Key];
+             pKey->VoiceTheftsQueued--;
+             if (!pKey->Active && !pKey->VoiceTheftsQueued) pKey->pEvents->clear();
+         }
      }
      /**
-      *  Will be called by the MIDIIn Thread to signal the audio thread that a
+      * Free all keys which have turned inactive in this audio fragment, from
-      *  continuous controller value has changed.
+      * the list of active keys and clear all event lists on that engine
+      * channel.
       *
-      *  @param Controller - MIDI controller number of the occured control change
+      * @param pEngineChannel - engine channel to cleanup
-      *  @param Value      - value of the control change
       */
-     void Engine::SendControlChange(uint8_t Controller, uint8_t Value) {
+     void Engine::PostProcess(EngineChannel* pEngineChannel) {
-         Event event      = pEventGenerator->CreateEvent();
+         // free all keys which have no active voices left
-         event.Type       = Event::type_control_change;
+         {
-         event.Controller = Controller;
+             RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first();
-         event.Value      = Value;
+             RTList<uint>::Iterator end    = pEngineChannel->pActiveKeys->end();
-         if (this->pEventQueue->write_space() > 0) this->pEventQueue->push(&event);
+             while (iuiKey != end) { // iterate through all active keys
+                 midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey];
+                 ++iuiKey;
+                 if (pKey->pActiveVoices->isEmpty()) FreeKey(pEngineChannel, pKey);
+                 #if CONFIG_DEVMODE
+                 else { // just a sanity check for debugging
+                     RTList<Voice>::Iterator itVoice     = pKey->pActiveVoices->first();
+                     RTList<Voice>::Iterator itVoicesEnd = pKey->pActiveVoices->end();
+                     for (; itVoice != itVoicesEnd; ++itVoice) { // iterate through all voices on this key
+                         if (itVoice->itKillEvent) {
+                             dmsg(1,("gig::Engine: ERROR, killed voice survived !!!\n"));
+                         }
+                     }
+                 }
+                 #endif // CONFIG_DEVMODE
+             }
+         }
+         // empty the engine channel's own event lists
+         pEngineChannel->ClearEventLists();
+     }
+     /**
+      *  Will be called by the MIDI input device whenever a MIDI system
+      *  exclusive message has arrived.
+      *
+      *  @param pData - pointer to sysex data
+      *  @param Size  - lenght of sysex data (in bytes)
+      */
+     void Engine::SendSysex(void* pData, uint Size) {
+         Event event             = pEventGenerator->CreateEvent();
+         event.Type              = Event::type_sysex;
+         event.Param.Sysex.Size  = Size;
+         event.pEngineChannel    = NULL; // as Engine global event
+         if (pEventQueue->write_space() > 0) {
+             if (pSysexBuffer->write_space() >= Size) {
+                 // copy sysex data to input buffer
+                 uint toWrite = Size;
+                 uint8_t* pPos = (uint8_t*) pData;
+                 while (toWrite) {
+                     const uint writeNow = RTMath::Min(toWrite, pSysexBuffer->write_space_to_end());
+                     pSysexBuffer->write(pPos, writeNow);
+                     toWrite -= writeNow;
+                     pPos    += writeNow;
+                 }
+                 // finally place sysex event into input event queue
+                 pEventQueue->push(&event);
+             }
+             else dmsg(1,("Engine: Sysex message too large (%d byte) for input buffer (%d byte)!",Size,CONFIG_SYSEX_BUFFER_SIZE));
+         }
          else dmsg(1,("Engine: Input event queue full!"));
      }
      /**
       *  Assigns and triggers a new voice for the respective MIDI key.
       *
-      *  @param pNoteOnEvent - key, velocity and time stamp of the event
+      *  @param pEngineChannel - engine channel on which this event occured on
+      *  @param itNoteOnEvent - key, velocity and time stamp of the event
       */
-     void Engine::ProcessNoteOn(Event* pNoteOnEvent) {
+     void Engine::ProcessNoteOn(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOnEvent) {
-         midi_key_info_t* pKey = &pMIDIKeyInfo[pNoteOnEvent->Key];
+         const int key = itNoteOnEvent->Param.Note.Key;
+         // Change key dimension value if key is in keyswitching area
+         {
+             const ::gig::Instrument* pInstrument = pEngineChannel->pInstrument;
+             if (key >= pInstrument->DimensionKeyRange.low && key <= pInstrument->DimensionKeyRange.high)
+                 pEngineChannel->CurrentKeyDimension = ((key - pInstrument->DimensionKeyRange.low) * 128) /
+                     (pInstrument->DimensionKeyRange.high - pInstrument->DimensionKeyRange.low + 1);
+         }
+         midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[key];
          pKey->KeyPressed = true; // the MIDI key was now pressed down
+         pKey->Velocity   = itNoteOnEvent->Param.Note.Velocity;
+         pKey->NoteOnTime = FrameTime + itNoteOnEvent->FragmentPos(); // will be used to calculate note length
          // cancel release process of voices on this key if needed
-         if (pKey->Active && !SustainPedal) {
+         if (pKey->Active && !pEngineChannel->SustainPedal) {
-             pNoteOnEvent->Type = Event::type_cancel_release; // transform event type
+             RTList<Event>::Iterator itCancelReleaseEvent = pKey->pEvents->allocAppend();
-             pEvents->move(pNoteOnEvent, pKey->pEvents); // move event to the key's own event list
+             if (itCancelReleaseEvent) {
+                 *itCancelReleaseEvent = *itNoteOnEvent;                  // copy event
+                 itCancelReleaseEvent->Type = Event::type_cancel_release; // transform event type
+             }
+             else dmsg(1,("Event pool emtpy!\n"));
          }
-         // allocate a new voice for the key
+         // move note on event to the key's own event list
-         Voice* pNewVoice = pKey->pActiveVoices->alloc();
+         RTList<Event>::Iterator itNoteOnEventOnKeyList = itNoteOnEvent.moveToEndOf(pKey->pEvents);
-         if (pNewVoice) {
-             // launch the new voice
+         // allocate and trigger new voice(s) for the key
-             if (pNewVoice->Trigger(pNoteOnEvent, this->Pitch, this->pInstrument) < 0) {
+         {
-                 dmsg(1,("Triggering new voice failed!\n"));
+             // first, get total amount of required voices (dependant on amount of layers)
-                 pKey->pActiveVoices->free(pNewVoice);
+             ::gig::Region* pRegion = pEngineChannel->pInstrument->GetRegion(itNoteOnEventOnKeyList->Param.Note.Key);
-             }
+             if (pRegion) {
-             else if (!pKey->Active) { // mark as active key
+                 int voicesRequired = pRegion->Layers;
-                 pKey->Active = true;
+                 // now launch the required amount of voices
-                 pKey->pSelf  = pActiveKeys->alloc();
+                 for (int i = 0; i < voicesRequired; i++)
-                 *pKey->pSelf = pNoteOnEvent->Key;
+                     LaunchVoice(pEngineChannel, itNoteOnEventOnKeyList, i, false, true, true);
              }
          }
-         else std::cerr << "No free voice!" << std::endl << std::flush;
+         // if neither a voice was spawned or postponed then remove note on event from key again
+         if (!pKey->Active && !pKey->VoiceTheftsQueued)
+             pKey->pEvents->free(itNoteOnEventOnKeyList);
+         pKey->RoundRobinIndex++;
      }
      /**
-Line 525 
 namespace LinuxSampler { namespace gig {
+Line 675 
 namespace LinuxSampler { namespace gig {
       *  sustain pedal will be released or voice turned inactive by itself (e.g.
       *  due to completion of sample playback).
       *
-      *  @param pNoteOffEvent - key, velocity and time stamp of the event
+      *  @param pEngineChannel - engine channel on which this event occured on
+      *  @param itNoteOffEvent - key, velocity and time stamp of the event
       */
-     void Engine::ProcessNoteOff(Event* pNoteOffEvent) {
+     void Engine::ProcessNoteOff(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOffEvent) {
-         midi_key_info_t* pKey = &pMIDIKeyInfo[pNoteOffEvent->Key];
+         midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[itNoteOffEvent->Param.Note.Key];
          pKey->KeyPressed = false; // the MIDI key was now released
          // release voices on this key if needed
-         if (pKey->Active && !SustainPedal) {
+         if (pKey->Active && !pEngineChannel->SustainPedal) {
-             pNoteOffEvent->Type = Event::type_release; // transform event type
+             itNoteOffEvent->Type = Event::type_release; // transform event type
-             pEvents->move(pNoteOffEvent, pKey->pEvents); // move event to the key's own event list
+             // move event to the key's own event list
+             RTList<Event>::Iterator itNoteOffEventOnKeyList = itNoteOffEvent.moveToEndOf(pKey->pEvents);
+             // spawn release triggered voice(s) if needed
+             if (pKey->ReleaseTrigger) {
+                 // first, get total amount of required voices (dependant on amount of layers)
+                 ::gig::Region* pRegion = pEngineChannel->pInstrument->GetRegion(itNoteOffEventOnKeyList->Param.Note.Key);
+                 if (pRegion) {
+                     int voicesRequired = pRegion->Layers;
+                     // MIDI note-on velocity is used instead of note-off velocity
+                     itNoteOffEventOnKeyList->Param.Note.Velocity = pKey->Velocity;
+                     // now launch the required amount of voices
+                     for (int i = 0; i < voicesRequired; i++)
+                         LaunchVoice(pEngineChannel, itNoteOffEventOnKeyList, i, true, false, false); //FIXME: for the moment we don't perform voice stealing for release triggered samples
+                 }
+                 pKey->ReleaseTrigger = false;
+             }
+             // if neither a voice was spawned or postponed then remove note off event from key again
+             if (!pKey->Active && !pKey->VoiceTheftsQueued)
+                 pKey->pEvents->free(itNoteOffEventOnKeyList);
          }
      }
-Line 543 
 namespace LinuxSampler { namespace gig {
+Line 717 
 namespace LinuxSampler { namespace gig {
       *  Moves pitchbend event from the general (input) event list to the pitch
       *  event list.
       *
-      *  @param pPitchbendEvent - absolute pitch value and time stamp of the event
+      *  @param pEngineChannel - engine channel on which this event occured on
+      *  @param itPitchbendEvent - absolute pitch value and time stamp of the event
       */
-     void Engine::ProcessPitchbend(Event* pPitchbendEvent) {
+     void Engine::ProcessPitchbend(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itPitchbendEvent) {
-         this->Pitch = pPitchbendEvent->Pitch; // store current pitch value
+         pEngineChannel->Pitch = itPitchbendEvent->Param.Pitch.Pitch; // store current pitch value
-         pEvents->move(pPitchbendEvent, pSynthesisEvents[Event::destination_vco]);
+         itPitchbendEvent.moveToEndOf(pEngineChannel->pSynthesisEvents[Event::destination_vco]);
      }
      /**
-      *  Immediately kills the voice given with pVoice (no matter if sustain is
+      *  Allocates and triggers a new voice. This method will usually be
-      *  pressed or not) and removes it from the MIDI key's list of active voice.
+      *  called by the ProcessNoteOn() method and by the voices itself
-      *  This method will e.g. be called if a voice went inactive by itself.
+      *  (e.g. to spawn further voices on the same key for layered sounds).
       *
-      *  @param pVoice - points to the voice to be killed
+      *  @param pEngineChannel      - engine channel on which this event occured on
+      *  @param itNoteOnEvent       - key, velocity and time stamp of the event
+      *  @param iLayer              - layer index for the new voice (optional - only
+      *                               in case of layered sounds of course)
+      *  @param ReleaseTriggerVoice - if new voice is a release triggered voice
+      *                               (optional, default = false)
+      *  @param VoiceStealing       - if voice stealing should be performed
+      *                               when there is no free voice
+      *                               (optional, default = true)
+      *  @param HandleKeyGroupConflicts - if voices should be killed due to a
+      *                                   key group conflict
+      *  @returns pointer to new voice or NULL if there was no free voice or
+      *           if the voice wasn't triggered (for example when no region is
+      *           defined for the given key).
       */
-     void Engine::KillVoice(Voice* pVoice) {
+     Pool<Voice>::Iterator Engine::LaunchVoice(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOnEvent, int iLayer, bool ReleaseTriggerVoice, bool VoiceStealing, bool HandleKeyGroupConflicts) {
-         if (pVoice) {
+         int MIDIKey            = itNoteOnEvent->Param.Note.Key;
-             if (pVoice->IsActive()) pVoice->Kill();
+         midi_key_info_t* pKey  = &pEngineChannel->pMIDIKeyInfo[MIDIKey];
+         ::gig::Region* pRegion = pEngineChannel->pInstrument->GetRegion(MIDIKey);
+         // if nothing defined for this key
+         if (!pRegion) return Pool<Voice>::Iterator(); // nothing to do
+         // only mark the first voice of a layered voice (group) to be in a
+         // key group, so the layered voices won't kill each other
+         int iKeyGroup = (iLayer == 0 && !ReleaseTriggerVoice) ? pRegion->KeyGroup : 0;
+         // handle key group (a.k.a. exclusive group) conflicts
+         if (HandleKeyGroupConflicts) {
+             if (iKeyGroup) { // if this voice / key belongs to a key group
+                 uint** ppKeyGroup = &pEngineChannel->ActiveKeyGroups[iKeyGroup];
+                 if (*ppKeyGroup) { // if there's already an active key in that key group
+                     midi_key_info_t* pOtherKey = &pEngineChannel->pMIDIKeyInfo[**ppKeyGroup];
+                     // kill all voices on the (other) key
+                     RTList<Voice>::Iterator itVoiceToBeKilled = pOtherKey->pActiveVoices->first();
+                     RTList<Voice>::Iterator end               = pOtherKey->pActiveVoices->end();
+                     for (; itVoiceToBeKilled != end; ++itVoiceToBeKilled) {
+                         if (itVoiceToBeKilled->Type != Voice::type_release_trigger) {
+                             itVoiceToBeKilled->Kill(itNoteOnEvent);
+                             --VoiceSpawnsLeft; //FIXME: just a hack, we should better check in StealVoice() if the voice was killed due to key conflict
+                         }
+                     }
+                 }
+             }
+         }
-             midi_key_info_t* pKey = &pMIDIKeyInfo[pVoice->MIDIKey];
+         Voice::type_t VoiceType = Voice::type_normal;
+         // get current dimension values to select the right dimension region
+         //TODO: for stolen voices this dimension region selection block is processed twice, this should be changed
+         //FIXME: controller values for selecting the dimension region here are currently not sample accurate
+         uint DimValues[8] = { 0 };
+         for (int i = pRegion->Dimensions - 1; i >= 0; i--) {
+             switch (pRegion->pDimensionDefinitions[i].dimension) {
+                 case ::gig::dimension_samplechannel:
+                     DimValues[i] = 0; //TODO: we currently ignore this dimension
+                     break;
+                 case ::gig::dimension_layer:
+                     DimValues[i] = iLayer;
+                     break;
+                 case ::gig::dimension_velocity:
+                     DimValues[i] = itNoteOnEvent->Param.Note.Velocity;
+                     break;
+                 case ::gig::dimension_channelaftertouch:
+                     DimValues[i] = 0; //TODO: we currently ignore this dimension
+                     break;
+                 case ::gig::dimension_releasetrigger:
+                     VoiceType = (ReleaseTriggerVoice) ? Voice::type_release_trigger : (!iLayer) ? Voice::type_release_trigger_required : Voice::type_normal;
+                     DimValues[i] = (uint) ReleaseTriggerVoice;
+                     break;
+                 case ::gig::dimension_keyboard:
+                     DimValues[i] = (uint) pEngineChannel->CurrentKeyDimension;
+                     break;
+                 case ::gig::dimension_roundrobin:
+                     DimValues[i] = (uint) pEngineChannel->pMIDIKeyInfo[MIDIKey].RoundRobinIndex; // incremented for each note on
+                     break;
+                 case ::gig::dimension_random:
+                     RandomSeed   = RandomSeed * 1103515245 + 12345; // classic pseudo random number generator
+                     DimValues[i] = (uint) RandomSeed >> (32 - pRegion->pDimensionDefinitions[i].bits); // highest bits are most random
+                     break;
+                 case ::gig::dimension_modwheel:
+                     DimValues[i] = pEngineChannel->ControllerTable[1];
+                     break;
+                 case ::gig::dimension_breath:
+                     DimValues[i] = pEngineChannel->ControllerTable[2];
+                     break;
+                 case ::gig::dimension_foot:
+                     DimValues[i] = pEngineChannel->ControllerTable[4];
+                     break;
+                 case ::gig::dimension_portamentotime:
+                     DimValues[i] = pEngineChannel->ControllerTable[5];
+                     break;
+                 case ::gig::dimension_effect1:
+                     DimValues[i] = pEngineChannel->ControllerTable[12];
+                     break;
+                 case ::gig::dimension_effect2:
+                     DimValues[i] = pEngineChannel->ControllerTable[13];
+                     break;
+                 case ::gig::dimension_genpurpose1:
+                     DimValues[i] = pEngineChannel->ControllerTable[16];
+                     break;
+                 case ::gig::dimension_genpurpose2:
+                     DimValues[i] = pEngineChannel->ControllerTable[17];
+                     break;
+                 case ::gig::dimension_genpurpose3:
+                     DimValues[i] = pEngineChannel->ControllerTable[18];
+                     break;
+                 case ::gig::dimension_genpurpose4:
+                     DimValues[i] = pEngineChannel->ControllerTable[19];
+                     break;
+                 case ::gig::dimension_sustainpedal:
+                     DimValues[i] = pEngineChannel->ControllerTable[64];
+                     break;
+                 case ::gig::dimension_portamento:
+                     DimValues[i] = pEngineChannel->ControllerTable[65];
+                     break;
+                 case ::gig::dimension_sostenutopedal:
+                     DimValues[i] = pEngineChannel->ControllerTable[66];
+                     break;
+                 case ::gig::dimension_softpedal:
+                     DimValues[i] = pEngineChannel->ControllerTable[67];
+                     break;
+                 case ::gig::dimension_genpurpose5:
+                     DimValues[i] = pEngineChannel->ControllerTable[80];
+                     break;
+                 case ::gig::dimension_genpurpose6:
+                     DimValues[i] = pEngineChannel->ControllerTable[81];
+                     break;
+                 case ::gig::dimension_genpurpose7:
+                     DimValues[i] = pEngineChannel->ControllerTable[82];
+                     break;
+                 case ::gig::dimension_genpurpose8:
+                     DimValues[i] = pEngineChannel->ControllerTable[83];
+                     break;
+                 case ::gig::dimension_effect1depth:
+                     DimValues[i] = pEngineChannel->ControllerTable[91];
+                     break;
+                 case ::gig::dimension_effect2depth:
+                     DimValues[i] = pEngineChannel->ControllerTable[92];
+                     break;
+                 case ::gig::dimension_effect3depth:
+                     DimValues[i] = pEngineChannel->ControllerTable[93];
+                     break;
+                 case ::gig::dimension_effect4depth:
+                     DimValues[i] = pEngineChannel->ControllerTable[94];
+                     break;
+                 case ::gig::dimension_effect5depth:
+                     DimValues[i] = pEngineChannel->ControllerTable[95];
+                     break;
+                 case ::gig::dimension_none:
+                     std::cerr << "gig::Engine::LaunchVoice() Error: dimension=none\n" << std::flush;
+                     break;
+                 default:
+                     std::cerr << "gig::Engine::LaunchVoice() Error: Unknown dimension\n" << std::flush;
+             }
+         }
+         ::gig::DimensionRegion* pDimRgn = pRegion->GetDimensionRegionByValue(DimValues);
+         // no need to continue if sample is silent
+         if (!pDimRgn->pSample || !pDimRgn->pSample->SamplesTotal) return Pool<Voice>::Iterator();
+         // allocate a new voice for the key
+         Pool<Voice>::Iterator itNewVoice = pKey->pActiveVoices->allocAppend();
+         if (itNewVoice) {
+             // launch the new voice
+             if (itNewVoice->Trigger(pEngineChannel, itNoteOnEvent, pEngineChannel->Pitch, pDimRgn, VoiceType, iKeyGroup) < 0) {
+                 dmsg(4,("Voice not triggered\n"));
+                 pKey->pActiveVoices->free(itNewVoice);
+             }
+             else { // on success
+                 --VoiceSpawnsLeft;
+                 if (!pKey->Active) { // mark as active key
+                     pKey->Active = true;
+                     pKey->itSelf = pEngineChannel->pActiveKeys->allocAppend();
+                     *pKey->itSelf = itNoteOnEvent->Param.Note.Key;
+                 }
+                 if (itNewVoice->KeyGroup) {
+                     uint** ppKeyGroup = &pEngineChannel->ActiveKeyGroups[itNewVoice->KeyGroup];
+                     *ppKeyGroup = &*pKey->itSelf; // put key as the (new) active key to its key group
+                 }
+                 if (itNewVoice->Type == Voice::type_release_trigger_required) pKey->ReleaseTrigger = true; // mark key for the need of release triggered voice(s)
+                 return itNewVoice; // success
+             }
+         }
+         else if (VoiceStealing) {
+             // try to steal one voice
+             int result = StealVoice(pEngineChannel, itNoteOnEvent);
+             if (!result) { // voice stolen successfully
+                 // put note-on event into voice-stealing queue, so it will be reprocessed after killed voice died
+                 RTList<Event>::Iterator itStealEvent = pVoiceStealingQueue->allocAppend();
+                 if (itStealEvent) {
+                     *itStealEvent = *itNoteOnEvent; // copy event
+                     itStealEvent->Param.Note.Layer = iLayer;
+                     itStealEvent->Param.Note.ReleaseTrigger = ReleaseTriggerVoice;
+                     pKey->VoiceTheftsQueued++;
+                 }
+                 else dmsg(1,("Voice stealing queue full!\n"));
+             }
+         }
+         return Pool<Voice>::Iterator(); // no free voice or error
+     }
+     /**
+      *  Will be called by LaunchVoice() method in case there are no free
+      *  voices left. This method will select and kill one old voice for
+      *  voice stealing and postpone the note-on event until the selected
+      *  voice actually died.
+      *
+      *  @param pEngineChannel - engine channel on which this event occured on
+      *  @param itNoteOnEvent - key, velocity and time stamp of the event
+      *  @returns 0 on success, a value < 0 if no active voice could be picked for voice stealing
+      */
+     int Engine::StealVoice(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOnEvent) {
+         if (VoiceSpawnsLeft <= 0) {
+             dmsg(1,("Max. voice thefts per audio fragment reached (you may raise CONFIG_MAX_VOICES).\n"));
+             return -1;
+         }
+         if (!pEventPool->poolIsEmpty()) {
+             RTList<Voice>::Iterator itSelectedVoice;
+             // Select one voice for voice stealing
+             switch (CONFIG_VOICE_STEAL_ALGO) {
+                 // try to pick the oldest voice on the key where the new
+                 // voice should be spawned, if there is no voice on that
+                 // key, or no voice left to kill, then procceed with
+                 // 'oldestkey' algorithm
+                 case voice_steal_algo_oldestvoiceonkey: {
+                     midi_key_info_t* pSelectedKey = &pEngineChannel->pMIDIKeyInfo[itNoteOnEvent->Param.Note.Key];
+                     itSelectedVoice = pSelectedKey->pActiveVoices->first();
+                     // proceed iterating if voice was created in this fragment cycle
+                     while (itSelectedVoice && !itSelectedVoice->IsStealable()) ++itSelectedVoice;
+                     // if we haven't found a voice then proceed with algorithm 'oldestkey'
+                     if (itSelectedVoice && itSelectedVoice->IsStealable()) break;
+                 } // no break - intentional !
+                 // try to pick the oldest voice on the oldest active key
+                 // from the same engine channel
+                 // (caution: must stay after 'oldestvoiceonkey' algorithm !)
+                 case voice_steal_algo_oldestkey: {
+                     // if we already stole in this fragment, try to proceed on same key
+                     if (this->itLastStolenVoice) {
+                         itSelectedVoice = this->itLastStolenVoice;
+                         do {
+                             ++itSelectedVoice;
+                         } while (itSelectedVoice && !itSelectedVoice->IsStealable()); // proceed iterating if voice was created in this fragment cycle
+                         // found a "stealable" voice ?
+                         if (itSelectedVoice && itSelectedVoice->IsStealable()) {
+                             // remember which voice we stole, so we can simply proceed on next voice stealing
+                             this->itLastStolenVoice = itSelectedVoice;
+                             break; // selection succeeded
+                         }
+                     }
+                     // get (next) oldest key
+                     RTList<uint>::Iterator iuiSelectedKey = (this->iuiLastStolenKey) ? ++this->iuiLastStolenKey : pEngineChannel->pActiveKeys->first();
+                     while (iuiSelectedKey) {
+                         midi_key_info_t* pSelectedKey = &pEngineChannel->pMIDIKeyInfo[*iuiSelectedKey];
+                         itSelectedVoice = pSelectedKey->pActiveVoices->first();
+                         // proceed iterating if voice was created in this fragment cycle
+                         while (itSelectedVoice && !itSelectedVoice->IsStealable()) ++itSelectedVoice;
+                         // found a "stealable" voice ?
+                         if (itSelectedVoice && itSelectedVoice->IsStealable()) {
+                             // remember which voice on which key we stole, so we can simply proceed on next voice stealing
+                             this->iuiLastStolenKey  = iuiSelectedKey;
+                             this->itLastStolenVoice = itSelectedVoice;
+                             break; // selection succeeded
+                         }
+                         ++iuiSelectedKey; // get next oldest key
+                     }
+                     break;
+                 }
+                 // don't steal anything
+                 case voice_steal_algo_none:
+                 default: {
+                     dmsg(1,("No free voice (voice stealing disabled)!\n"));
+                     return -1;
+                 }
+             }
+             // if we couldn't steal a voice from the same engine channel then
+             // steal oldest voice on the oldest key from any other engine channel
+             // (the smaller engine channel number, the higher priority)
+             if (!itSelectedVoice || !itSelectedVoice->IsStealable()) {
+                 EngineChannel* pSelectedChannel;
+                 int            iChannelIndex;
+                 // select engine channel
+                 if (pLastStolenChannel) {
+                     pSelectedChannel = pLastStolenChannel;
+                     iChannelIndex    = pSelectedChannel->iEngineIndexSelf;
+                 } else { // pick the engine channel followed by this engine channel
+                     iChannelIndex    = (pEngineChannel->iEngineIndexSelf + 1) % engineChannels.size();
+                     pSelectedChannel = engineChannels[iChannelIndex];
+                 }
+                 // if we already stole in this fragment, try to proceed on same key
+                 if (this->itLastStolenVoiceGlobally) {
+                     itSelectedVoice = this->itLastStolenVoiceGlobally;
+                     do {
+                         ++itSelectedVoice;
+                     } while (itSelectedVoice && !itSelectedVoice->IsStealable()); // proceed iterating if voice was created in this fragment cycle
+                 }
+                 #if CONFIG_DEVMODE
+                 EngineChannel* pBegin = pSelectedChannel; // to detect endless loop
+                 #endif // CONFIG_DEVMODE
+                 // did we find a 'stealable' voice?
+                 if (itSelectedVoice && itSelectedVoice->IsStealable()) {
+                     // remember which voice we stole, so we can simply proceed on next voice stealing
+                     this->itLastStolenVoiceGlobally = itSelectedVoice;
+                 } else while (true) { // iterate through engine channels
+                     // get (next) oldest key
+                     RTList<uint>::Iterator iuiSelectedKey = (this->iuiLastStolenKeyGlobally) ? ++this->iuiLastStolenKeyGlobally : pSelectedChannel->pActiveKeys->first();
+                     this->iuiLastStolenKeyGlobally = RTList<uint>::Iterator(); // to prevent endless loop (see line above)
+                     while (iuiSelectedKey) {
+                         midi_key_info_t* pSelectedKey = &pSelectedChannel->pMIDIKeyInfo[*iuiSelectedKey];
+                         itSelectedVoice = pSelectedKey->pActiveVoices->first();
+                         // proceed iterating if voice was created in this fragment cycle
+                         while (itSelectedVoice && !itSelectedVoice->IsStealable()) ++itSelectedVoice;
+                         // found a "stealable" voice ?
+                         if (itSelectedVoice && itSelectedVoice->IsStealable()) {
+                             // remember which voice on which key on which engine channel we stole, so we can simply proceed on next voice stealing
+                             this->iuiLastStolenKeyGlobally  = iuiSelectedKey;
+                             this->itLastStolenVoiceGlobally = itSelectedVoice;
+                             this->pLastStolenChannel        = pSelectedChannel;
+                             goto stealable_voice_found; // selection succeeded
+                         }
+                         ++iuiSelectedKey; // get next key on current engine channel
+                     }
+                     // get next engine channel
+                     iChannelIndex    = (iChannelIndex + 1) % engineChannels.size();
+                     pSelectedChannel = engineChannels[iChannelIndex];
+                     #if CONFIG_DEVMODE
+                     if (pSelectedChannel == pBegin) {
+                         dmsg(1,("FATAL ERROR: voice stealing endless loop!\n"));
+                         dmsg(1,("VoiceSpawnsLeft=%d.\n", VoiceSpawnsLeft));
+                         dmsg(1,("Exiting.\n"));
+                         exit(-1);
+                     }
+                     #endif // CONFIG_DEVMODE
+                 }
+             }
+             // jump point if a 'stealable' voice was found
+             stealable_voice_found:
+             #if CONFIG_DEVMODE
+             if (!itSelectedVoice->IsActive()) {
+                 dmsg(1,("gig::Engine: ERROR, tried to steal a voice which was not active !!!\n"));
+                 return -1;
+             }
+             #endif // CONFIG_DEVMODE
+             // now kill the selected voice
+             itSelectedVoice->Kill(itNoteOnEvent);
+             --VoiceSpawnsLeft;
+             return 0; // success
+         }
+         else {
+             dmsg(1,("Event pool emtpy!\n"));
+             return -1;
+         }
+     }
+     /**
+      *  Removes the given voice from the MIDI key's list of active voices.
+      *  This method will be called when a voice went inactive, e.g. because
+      *  it finished to playback its sample, finished its release stage or
+      *  just was killed.
+      *
+      *  @param pEngineChannel - engine channel on which this event occured on
+      *  @param itVoice - points to the voice to be freed
+      */
+     void Engine::FreeVoice(EngineChannel* pEngineChannel, Pool<Voice>::Iterator& itVoice) {
+         if (itVoice) {
+             midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[itVoice->MIDIKey];
+             uint keygroup = itVoice->KeyGroup;
              // free the voice object
-             pVoicePool->free(pVoice);
+             pVoicePool->free(itVoice);
-             // 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
-             if (pKey->pActiveVoices->is_empty()) {
+             if (pKey->pActiveVoices->isEmpty() && keygroup) {
-                 pKey->Active = false;
+                 uint** ppKeyGroup = &pEngineChannel->ActiveKeyGroups[keygroup];
-                 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"));
              }
          }
-         else std::cerr << "Couldn't release voice! (pVoice == NULL)\n" << std::flush;
+         else std::cerr << "Couldn't release voice! (!itVoice)\n" << std::flush;
+     }
+     /**
+      *  Called when there's no more voice left on a key, this call will
+      *  update the key info respectively.
+      *
+      *  @param pEngineChannel - engine channel on which this event occured on
+      *  @param pKey - key which is now inactive
+      */
+     void Engine::FreeKey(EngineChannel* pEngineChannel, midi_key_info_t* pKey) {
+         if (pKey->pActiveVoices->isEmpty()) {
+             pKey->Active = false;
+             pEngineChannel->pActiveKeys->free(pKey->itSelf); // remove key from list of active keys
+             pKey->itSelf = RTList<uint>::Iterator();
+             pKey->ReleaseTrigger = false;
+             pKey->pEvents->clear();
+             dmsg(3,("Key has no more voices now\n"));
+         }
+         else dmsg(1,("gig::Engine: Oops, tried to free a key which contains voices.\n"));
      }
      /**
       *  Reacts on supported control change commands (e.g. pitch bend wheel,
       *  modulation wheel, aftertouch).
       *
-      *  @param pControlChangeEvent - controller, value and time stamp of the event
+      *  @param pEngineChannel - engine channel on which this event occured on
+      *  @param itControlChangeEvent - controller, value and time stamp of the event
       */
-     void Engine::ProcessControlChange(Event* pControlChangeEvent) {
+     void Engine::ProcessControlChange(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itControlChangeEvent) {
-         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));
-         switch (pControlChangeEvent->Controller) {
+         // update controller value in the engine channel's controller table
-             case 64: {
+         pEngineChannel->ControllerTable[itControlChangeEvent->Param.CC.Controller] = itControlChangeEvent->Param.CC.Value;
-                 if (pControlChangeEvent->Value >= 64 && !SustainPedal) {
+         // move event from the unsorted event list to the control change event list
+         Pool<Event>::Iterator itControlChangeEventOnCCList = itControlChangeEvent.moveToEndOf(pEngineChannel->pCCEvents);
+         switch (itControlChangeEventOnCCList->Param.CC.Controller) {
+             case 7: { // volume
+                 //TODO: not sample accurate yet
+                 pEngineChannel->GlobalVolume = (float) itControlChangeEventOnCCList->Param.CC.Value / 127.0f;
+                 pEngineChannel->bStatusChanged = true; // engine channel status has changed, so set notify flag
+                 break;
+             }
+             case 10: { // panpot
+                 //TODO: not sample accurate yet
+                 const int pan = (int) itControlChangeEventOnCCList->Param.CC.Value - 64;
+                 pEngineChannel->GlobalPanLeft  = 1.0f - float(RTMath::Max(pan, 0)) /  63.0f;
+                 pEngineChannel->GlobalPanRight = 1.0f - float(RTMath::Min(pan, 0)) / -64.0f;
+                 break;
+             }
+             case 64: { // sustain
+                 if (itControlChangeEventOnCCList->Param.CC.Value >= 64 && !pEngineChannel->SustainPedal) {
                      dmsg(4,("PEDAL DOWN\n"));
-                     SustainPedal = true;
+                     pEngineChannel->SustainPedal = true;
                      // cancel release process of voices if necessary
-                     uint* piKey = pActiveKeys->first();
+                     RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first();
-                     if (piKey) {
+                     for (; iuiKey; ++iuiKey) {
-                         pControlChangeEvent->Type = Event::type_cancel_release; // transform event type
+                         midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey];
-                         while (piKey) {
+                         if (!pKey->KeyPressed) {
-                             midi_key_info_t* pKey = &pMIDIKeyInfo[*piKey];
+                             RTList<Event>::Iterator itNewEvent = pKey->pEvents->allocAppend();
-                             pActiveKeys->set_current(piKey);
+                             if (itNewEvent) {
-                             piKey = pActiveKeys->next();
+                                 *itNewEvent = *itControlChangeEventOnCCList; // copy event to the key's own event list
-                             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"));
                              }
+                             else dmsg(1,("Event pool emtpy!\n"));
                          }
                      }
                  }
-                 if (pControlChangeEvent->Value < 64 && SustainPedal) {
+                 if (itControlChangeEventOnCCList->Param.CC.Value < 64 && pEngineChannel->SustainPedal) {
                      dmsg(4,("PEDAL UP\n"));
-                     SustainPedal = false;
+                     pEngineChannel->SustainPedal = false;
                      // release voices if their respective key is not pressed
-                     uint* piKey = pActiveKeys->first();
+                     RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first();
-                     if (piKey) {
+                     for (; iuiKey; ++iuiKey) {
-                         pControlChangeEvent->Type = Event::type_release; // transform event type
+                         midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey];
-                         while (piKey) {
+                         if (!pKey->KeyPressed) {
-                             midi_key_info_t* pKey = &pMIDIKeyInfo[*piKey];
+                             RTList<Event>::Iterator itNewEvent = pKey->pEvents->allocAppend();
-                             pActiveKeys->set_current(piKey);
+                             if (itNewEvent) {
-                             piKey = pActiveKeys->next();
+                                 *itNewEvent = *itControlChangeEventOnCCList; // copy event to the key's own event list
-                             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"));
                              }
+                             else dmsg(1,("Event pool emtpy!\n"));
                          }
                      }
                  }
                  break;
              }
+             // Channel Mode Messages
+             case 120: { // all sound off
+                 KillAllVoices(pEngineChannel, itControlChangeEventOnCCList);
+                 break;
+             }
+             case 121: { // reset all controllers
+                 pEngineChannel->ResetControllers();
+                 break;
+             }
+             case 123: { // all notes off
+                 ReleaseAllVoices(pEngineChannel, itControlChangeEventOnCCList);
+                 break;
+             }
          }
+     }
-         // update controller value in the engine's controller table
+     /**
-         ControllerTable[pControlChangeEvent->Controller] = pControlChangeEvent->Value;
+      *  Reacts on MIDI system exclusive messages.
+      *
+      *  @param itSysexEvent - sysex data size and time stamp of the sysex event
+      */
+     void Engine::ProcessSysex(Pool<Event>::Iterator& itSysexEvent) {
+         RingBuffer<uint8_t>::NonVolatileReader reader = pSysexBuffer->get_non_volatile_reader();
-         // move event from the unsorted event list to the control change event list
+         uint8_t exclusive_status, id;
-         pEvents->move(pControlChangeEvent, pCCEvents);
+         if (!reader.pop(&exclusive_status)) goto free_sysex_data;
+         if (!reader.pop(&id))               goto free_sysex_data;
+         if (exclusive_status != 0xF0)       goto free_sysex_data;
+         switch (id) {
+             case 0x41: { // Roland
+                 dmsg(3,("Roland Sysex\n"));
+                 uint8_t device_id, model_id, cmd_id;
+                 if (!reader.pop(&device_id)) goto free_sysex_data;
+                 if (!reader.pop(&model_id))  goto free_sysex_data;
+                 if (!reader.pop(&cmd_id))    goto free_sysex_data;
+                 if (model_id != 0x42 /*GS*/) goto free_sysex_data;
+                 if (cmd_id != 0x12 /*DT1*/)  goto free_sysex_data;
+                 // command address
+                 uint8_t addr[3]; // 2 byte addr MSB, followed by 1 byte addr LSB)
+                 const RingBuffer<uint8_t>::NonVolatileReader checksum_reader = reader; // so we can calculate the check sum later
+                 if (reader.read(&addr[0], 3) != 3) goto free_sysex_data;
+                 if (addr[0] == 0x40 && addr[1] == 0x00) { // System Parameters
+                     dmsg(3,("\tSystem Parameter\n"));
+                 }
+                 else if (addr[0] == 0x40 && addr[1] == 0x01) { // Common Parameters
+                     dmsg(3,("\tCommon Parameter\n"));
+                 }
+                 else if (addr[0] == 0x40 && (addr[1] & 0xf0) == 0x10) { // Part Parameters (1)
+                     dmsg(3,("\tPart Parameter\n"));
+                     switch (addr[2]) {
+                         case 0x40: { // scale tuning
+                             dmsg(3,("\t\tScale Tuning\n"));
+                             uint8_t scale_tunes[12]; // detuning of all 12 semitones of an octave
+                             if (reader.read(&scale_tunes[0], 12) != 12) goto free_sysex_data;
+                             uint8_t checksum;
+                             if (!reader.pop(&checksum)) goto free_sysex_data;
+                             #if CONFIG_ASSERT_GS_SYSEX_CHECKSUM
+                             if (GSCheckSum(checksum_reader, 12)) goto free_sysex_data;
+                             #endif // CONFIG_ASSERT_GS_SYSEX_CHECKSUM
+                             for (int i = 0; i < 12; i++) scale_tunes[i] -= 64;
+                             AdjustScale((int8_t*) scale_tunes);
+                             dmsg(3,("\t\t\tNew scale applied.\n"));
+                             break;
+                         }
+                     }
+                 }
+                 else if (addr[0] == 0x40 && (addr[1] & 0xf0) == 0x20) { // Part Parameters (2)
+                 }
+                 else if (addr[0] == 0x41) { // Drum Setup Parameters
+                 }
+                 break;
+             }
+         }
+         free_sysex_data: // finally free sysex data
+         pSysexBuffer->increment_read_ptr(itSysexEvent->Param.Sysex.Size);
+     }
+     /**
+      * Calculates the Roland GS sysex check sum.
+      *
+      * @param AddrReader - reader which currently points to the first GS
+      *                     command address byte of the GS sysex message in
+      *                     question
+      * @param DataSize   - size of the GS message data (in bytes)
+      */
+     uint8_t Engine::GSCheckSum(const RingBuffer<uint8_t>::NonVolatileReader AddrReader, uint DataSize) {
+         RingBuffer<uint8_t>::NonVolatileReader reader = AddrReader;
+         uint bytes = 3 /*addr*/ + DataSize;
+         uint8_t addr_and_data[bytes];
+         reader.read(&addr_and_data[0], bytes);
+         uint8_t sum = 0;
+         for (uint i = 0; i < bytes; i++) sum += addr_and_data[i];
+         return 128 - sum % 128;
+     }
+     /**
+      * Allows to tune each of the twelve semitones of an octave.
+      *
+      * @param ScaleTunes - detuning of all twelve semitones (in cents)
+      */
+     void Engine::AdjustScale(int8_t ScaleTunes[12]) {
+         memcpy(&this->ScaleTuning[0], &ScaleTunes[0], 12); //TODO: currently not sample accurate
+     }
+     /**
+      * Releases all voices on an engine channel. All voices will go into
+      * the release stage and thus it might take some time (e.g. dependant to
+      * their envelope release time) until they actually die.
+      *
+      * @param pEngineChannel - engine channel on which all voices should be released
+      * @param itReleaseEvent - event which caused this releasing of all voices
+      */
+     void Engine::ReleaseAllVoices(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itReleaseEvent) {
+         RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first();
+         while (iuiKey) {
+             midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey];
+             ++iuiKey;
+             // append a 'release' event to the key's own event list
+             RTList<Event>::Iterator itNewEvent = pKey->pEvents->allocAppend();
+             if (itNewEvent) {
+                 *itNewEvent = *itReleaseEvent; // copy original event (to the key's event list)
+                 itNewEvent->Type = Event::type_release; // transform event type
+             }
+             else dmsg(1,("Event pool emtpy!\n"));
+         }
+     }
+     /**
+      * Kills all voices on an engine channel as soon as possible. Voices
+      * won't get into release state, their volume level will be ramped down
+      * as fast as possible.
+      *
+      * @param pEngineChannel - engine channel on which all voices should be killed
+      * @param itKillEvent    - event which caused this killing of all voices
+      */
+     void Engine::KillAllVoices(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itKillEvent) {
+         RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first();
+         RTList<uint>::Iterator end    = pEngineChannel->pActiveKeys->end();
+         while (iuiKey != end) { // iterate through all active keys
+             midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey];
+             ++iuiKey;
+             RTList<Voice>::Iterator itVoice     = pKey->pActiveVoices->first();
+             RTList<Voice>::Iterator itVoicesEnd = pKey->pActiveVoices->end();
+             for (; itVoice != itVoicesEnd; ++itVoice) { // iterate through all voices on this key
+                 itVoice->Kill(itKillEvent);
+                 --VoiceSpawnsLeft; //FIXME: just a temporary workaround, we should check the cause in StealVoice() instead
+             }
+         }
      }
      /**
-Line 654 
 namespace LinuxSampler { namespace gig {
+Line 1386 
 namespace LinuxSampler { namespace gig {
          }
      }
-     float Engine::Volume() {
-         return GlobalVolume;
-     }
-     void Engine::Volume(float f) {
-         GlobalVolume = f;
-     }
      uint Engine::VoiceCount() {
          return ActiveVoiceCount;
      }
-Line 690 
 namespace LinuxSampler { namespace gig {
+Line 1414 
 namespace LinuxSampler { namespace gig {
          return pDiskThread->GetBufferFillPercentage();
      }
+     String Engine::EngineName() {
+         return LS_GIG_ENGINE_NAME;
+     }
      String Engine::Description() {
          return "Gigasampler Engine";
      }
      String Engine::Version() {
-         return "0.0.1-0cvs20040423";
+         String s = "$Revision: 1.49 $";
+         return s.substr(11, s.size() - 13); // cut dollar signs, spaces and CVS macro keyword
      }
  }} // namespace LinuxSampler::gig

 Legend:



Removed from v.80
 


changed lines


 
Added in v.690
 Legend:



Removed from v.80
 


changed lines


 
Added in v.690
-Removed from v.80
+Added in v.690

	ViewVC Help
Powered by ViewVC