/[svn]/linuxsampler/trunk/src/engines/EngineBase.h

Diff of /linuxsampler/trunk/src/engines/EngineBase.h

Parent Directory | Revision Log | View Patch Patch

-revision 2410 by schoenebeck,
Sat Feb  2 18:52:15 2013 UTC
+revision 3283 by schoenebeck,
Wed Jun 21 20:59:06 2017 UTC
 Line 5
   *   Copyright (C) 2003,2004 by Benno Senoner and Christian Schoenebeck    *
   *   Copyright (C) 2005-2008 Christian Schoenebeck                         *
   *   Copyright (C) 2009-2012 Christian Schoenebeck and Grigor Iliev        *
+  *   Copyright (C) 2012-2017 Christian Schoenebeck and Andreas Persson     *
   *                                                                         *
   *   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 32
+Line 33
  #include "InstrumentManager.h"
  #include "../common/global_private.h"
+ // a bit headroom over CONFIG_MAX_VOICES to avoid minor complications i.e. under voice stealing conditions
+ #define MAX_NOTES_HEADROOM  3
+ #define GLOBAL_MAX_NOTES    (GLOBAL_MAX_VOICES * MAX_NOTES_HEADROOM)
  namespace LinuxSampler {
-Line 45 
 namespace LinuxSampler {
+Line 49 
 namespace LinuxSampler {
          class IM  /* Instrument Manager */,
          class I   /* Instrument */
      >
-     class EngineBase: public AbstractEngine, public RegionPools<R>, public VoicePool<V> {
+     class EngineBase: public AbstractEngine, public RegionPools<R>, public NotePool<V> {
          public:
+             typedef typename RTList< Note<V> >::Iterator NoteIterator;
              typedef typename RTList<V>::Iterator VoiceIterator;
              typedef typename Pool<V>::Iterator PoolVoiceIterator;
              typedef typename RTList<RR*>::Iterator RootRegionIterator;
              typedef typename MidiKeyboardManager<V>::MidiKey MidiKey;
-             EngineBase() : SuspendedRegions(128) {
+             EngineBase() : noteIDPool(GLOBAL_MAX_NOTES), SuspendedRegions(128) {
                  pDiskThread          = NULL;
+                 pNotePool            = new Pool< Note<V> >(GLOBAL_MAX_NOTES);
+                 pNotePool->setPoolElementIDsReservedBits(INSTR_SCRIPT_EVENT_ID_RESERVED_BITS);
                  pVoicePool           = new Pool<V>(GLOBAL_MAX_VOICES);
                  pRegionPool[0]       = new Pool<R*>(GLOBAL_MAX_VOICES);
                  pRegionPool[1]       = new Pool<R*>(GLOBAL_MAX_VOICES);
                  pVoiceStealingQueue  = new RTList<Event>(pEventPool);
                  iMaxDiskStreams      = GLOBAL_MAX_STREAMS;
-                 for (VoiceIterator iterVoice = pVoicePool->allocAppend(); iterVoice == pVoicePool->last(); iterVoice = pVoicePool->allocAppend()) {
+                 // init all Voice objects in voice pool
+                 for (VoiceIterator iterVoice = pVoicePool->allocAppend();
+                      iterVoice; iterVoice = pVoicePool->allocAppend())
+                 {
                      iterVoice->SetEngine(this);
                  }
                  pVoicePool->clear();
+                 // init all Note objects in note pool
+                 for (NoteIterator itNote = pNotePool->allocAppend(); itNote;
+                      itNote = pNotePool->allocAppend())
+                 {
+                     itNote->init(pVoicePool, &noteIDPool);
+                 }
+                 pNotePool->clear();
                  ResetInternal();
                  ResetScaleTuning();
                  ResetSuspendedRegions();
-Line 79 
 namespace LinuxSampler {
+Line 97 
 namespace LinuxSampler {
                      dmsg(1,("OK\n"));
                  }
+                 if (pNotePool) {
+                     pNotePool->clear();
+                     delete pNotePool;
+                 }
                  if (pVoicePool) {
                      pVoicePool->clear();
                      delete pVoicePool;
-Line 104 
 namespace LinuxSampler {
+Line 127 
 namespace LinuxSampler {
               *  @param Samples - number of sample points to be rendered
               *  @returns       0 on success
               */
-             virtual int RenderAudio(uint Samples) {
+             virtual int RenderAudio(uint Samples) OVERRIDE {
                  dmsg(8,("RenderAudio(Samples=%d)\n", Samples));
                  // return if engine disabled
-Line 140 
 namespace LinuxSampler {
+Line 163 
 namespace LinuxSampler {
                                  dmsg(5,("Engine: Sysex received\n"));
                                  ProcessSysex(itEvent);
                                  break;
+                             default: ; // noop
                          }
                      }
                  }
+                 // In case scale tuning has been changed, recalculate pitch for
+                 // all active voices.
+                 ProcessScaleTuningChange();
                  // reset internal voice counter (just for statistic of active voices)
                  ActiveVoiceCountTemp = 0;
-Line 205 
 namespace LinuxSampler {
+Line 233 
 namespace LinuxSampler {
                  return 0;
              }
-             virtual int MaxVoices() { return pVoicePool->poolSize(); }
+             virtual int MaxVoices() OVERRIDE { return pVoicePool->poolSize(); }
-             virtual void SetMaxVoices(int iVoices) throw (Exception) {
+             virtual void SetMaxVoices(int iVoices) throw (Exception) OVERRIDE {
                  if (iVoices < 1)
                      throw Exception("Maximum voices for an engine cannot be set lower than 1");
-Line 231 
 namespace LinuxSampler {
+Line 259 
 namespace LinuxSampler {
                      pChannel->ResetRegionsInUse(pRegionPool);
                  }
+                 // FIXME: Shouldn't all those pool elements be freed before resizing the pools?
                  try {
                      pVoicePool->resizePool(iVoices);
+                     pNotePool->resizePool(iVoices * MAX_NOTES_HEADROOM);
+                     noteIDPool.resizePool(iVoices * MAX_NOTES_HEADROOM);
                  } catch (...) {
                      throw Exception("FATAL: Could not resize voice pool!");
                  }
-                 for (VoiceIterator iterVoice = pVoicePool->allocAppend(); iterVoice == pVoicePool->last(); iterVoice = pVoicePool->allocAppend()) {
+                 for (VoiceIterator iterVoice = pVoicePool->allocAppend();
+                      iterVoice; iterVoice = pVoicePool->allocAppend())
+                 {
                      iterVoice->SetEngine(this);
                      iterVoice->pDiskThread = this->pDiskThread;
                  }
                  pVoicePool->clear();
+                 for (NoteIterator itNote = pNotePool->allocAppend(); itNote;
+                      itNote = pNotePool->allocAppend())
+                 {
+                     itNote->init(pVoicePool, &noteIDPool);
+                 }
+                 pNotePool->clear();
                  PostSetMaxVoices(iVoices);
                  ResumeAll();
              }
-Line 250 
 namespace LinuxSampler {
+Line 290 
 namespace LinuxSampler {
              /** Called after the new max number of voices is set and before resuming the engine. */
              virtual void PostSetMaxVoices(int iVoices) { }
-             virtual uint DiskStreamCount() { return (pDiskThread) ? pDiskThread->GetActiveStreamCount() : 0; }
+             virtual uint DiskStreamCount() OVERRIDE { return (pDiskThread) ? pDiskThread->GetActiveStreamCount() : 0; }
-             virtual uint DiskStreamCountMax() { return (pDiskThread) ? pDiskThread->ActiveStreamCountMax : 0; }
+             virtual uint DiskStreamCountMax() OVERRIDE { return (pDiskThread) ? pDiskThread->ActiveStreamCountMax : 0; }
-             virtual int  MaxDiskStreams() { return iMaxDiskStreams; }
+             virtual int  MaxDiskStreams() OVERRIDE { return iMaxDiskStreams; }
-             virtual void SetMaxDiskStreams(int iStreams) throw (Exception) {
+             virtual void SetMaxDiskStreams(int iStreams) throw (Exception) OVERRIDE {
                  if (iStreams < 0)
                      throw Exception("Maximum disk streams for an engine cannot be set lower than 0");
-Line 269 
 namespace LinuxSampler {
+Line 309 
 namespace LinuxSampler {
                  ResumeAll();
              }
-             virtual String DiskStreamBufferFillBytes() { return (pDiskThread) ? pDiskThread->GetBufferFillBytes() : ""; }
+             virtual String DiskStreamBufferFillBytes() OVERRIDE { return (pDiskThread) ? pDiskThread->GetBufferFillBytes() : ""; }
-             virtual String DiskStreamBufferFillPercentage() { return (pDiskThread) ? pDiskThread->GetBufferFillPercentage() : ""; }
+             virtual String DiskStreamBufferFillPercentage() OVERRIDE { return (pDiskThread) ? pDiskThread->GetBufferFillPercentage() : ""; }
-             virtual InstrumentManager* GetInstrumentManager() { return &instruments; }
+             virtual InstrumentManager* GetInstrumentManager() OVERRIDE { return &instruments; }
              /**
               * Connect this engine instance with the given audio output device.
-Line 282 
 namespace LinuxSampler {
+Line 322 
 namespace LinuxSampler {
               *
               * @param pAudioOut - audio output device to connect to
               */
-             virtual void Connect(AudioOutputDevice* pAudioOut) {
+             virtual void Connect(AudioOutputDevice* pAudioOut) OVERRIDE {
                  // caution: don't ignore if connecting to the same device here,
                  // because otherwise SetMaxDiskStreams() implementation won't work anymore!
-Line 311 
 namespace LinuxSampler {
+Line 351 
 namespace LinuxSampler {
                      MinFadeOutSamples = MaxSamplesPerCycle;
                      // lower minimum release time
                      const float minReleaseTime = (float) MaxSamplesPerCycle / (float) SampleRate;
+                     pVoicePool->clear();
                      for (VoiceIterator iterVoice = pVoicePool->allocAppend(); iterVoice == pVoicePool->last(); iterVoice = pVoicePool->allocAppend()) {
                          iterVoice->CalculateFadeOutCoeff(minReleaseTime, SampleRate);
                      }
-Line 331 
 namespace LinuxSampler {
+Line 372 
 namespace LinuxSampler {
                      exit(EXIT_FAILURE);
                  }
+                 pVoicePool->clear();
                  for (VoiceIterator iterVoice = pVoicePool->allocAppend(); iterVoice == pVoicePool->last(); iterVoice = pVoicePool->allocAppend()) {
                      iterVoice->pDiskThread = this->pDiskThread;
                      dmsg(3,("d"));
                  }
                  pVoicePool->clear();
-                 // (re)create event generator
+                 // update event generator
-                 if (pEventGenerator) delete pEventGenerator;
+                 pEventGenerator->SetSampleRate(pAudioOut->SampleRate());
-                 pEventGenerator = new EventGenerator(pAudioOut->SampleRate());
                  dmsg(1,("Starting disk thread..."));
                  pDiskThread->StartThread();
-Line 370 
 namespace LinuxSampler {
+Line 411 
 namespace LinuxSampler {
              }
              // Implementattion for abstract method derived from Engine.
-             virtual void ReconnectAudioOutputDevice() {
+             virtual void ReconnectAudioOutputDevice() OVERRIDE {
                  SuspendAll();
                  if (pAudioOutputDevice) Connect(pAudioOutputDevice);
                  ResumeAll();
-Line 428 
 namespace LinuxSampler {
+Line 469 
 namespace LinuxSampler {
               * @param pRegion - region the engine shall stop using
               */
              virtual void Suspend(RR* pRegion) {
-                 dmsg(2,("EngineBase: Suspending Region %x ...\n",pRegion));
+                 dmsg(2,("EngineBase: Suspending Region %p ...\n",(void*)pRegion));
-                 SuspendedRegionsMutex.Lock();
+                 {
-                 SuspensionChangeOngoing.Set(true);
+                     LockGuard lock(SuspendedRegionsMutex);
-                 pPendingRegionSuspension = pRegion;
+                     SuspensionChangeOngoing.Set(true);
-                 SuspensionChangeOngoing.WaitAndUnlockIf(true);
+                     pPendingRegionSuspension = pRegion;
-                 SuspendedRegionsMutex.Unlock();
+                     SuspensionChangeOngoing.WaitAndUnlockIf(true);
-                 dmsg(2,("EngineBase: Region %x suspended.",pRegion));
+                 }
+                 dmsg(2,("EngineBase: Region %p suspended.",(void*)pRegion));
              }
              /**
-Line 444 
 namespace LinuxSampler {
+Line 486 
 namespace LinuxSampler {
               * @param pRegion - region the engine shall be allowed to use again
               */
              virtual void Resume(RR* pRegion) {
-                 dmsg(2,("EngineBase: Resuming Region %x ...\n",pRegion));
+                 dmsg(2,("EngineBase: Resuming Region %p ...\n",(void*)pRegion));
-                 SuspendedRegionsMutex.Lock();
+                 {
-                 SuspensionChangeOngoing.Set(true);
+                     LockGuard lock(SuspendedRegionsMutex);
-                 pPendingRegionResumption = pRegion;
+                     SuspensionChangeOngoing.Set(true);
-                 SuspensionChangeOngoing.WaitAndUnlockIf(true);
+                     pPendingRegionResumption = pRegion;
-                 SuspendedRegionsMutex.Unlock();
+                     SuspensionChangeOngoing.WaitAndUnlockIf(true);
-                 dmsg(2,("EngineBase: Region %x resumed.\n",pRegion));
+                 }
+                 dmsg(2,("EngineBase: Region %p resumed.\n",(void*)pRegion));
              }
              virtual void ResetSuspendedRegions() {
-Line 553 
 namespace LinuxSampler {
+Line 596 
 namespace LinuxSampler {
              }
              // implementation of abstract method derived from class 'LinuxSampler::RegionPools'
-             virtual Pool<R*>* GetRegionPool(int index) {
+             virtual Pool<R*>* GetRegionPool(int index) OVERRIDE {
                  if (index < 0 || index > 1) throw Exception("Index out of bounds");
                  return pRegionPool[index];
              }
-             // implementation of abstract method derived from class 'LinuxSampler::VoicePool'
+             // implementation of abstract methods derived from class 'LinuxSampler::NotePool'
-             virtual Pool<V>* GetVoicePool() { return pVoicePool; }
+             virtual Pool<V>* GetVoicePool() OVERRIDE { return pVoicePool; }
+             virtual Pool< Note<V> >* GetNotePool() OVERRIDE { return pNotePool; }
+             virtual Pool<note_id_t>* GetNoteIDPool() OVERRIDE { return &noteIDPool; }
              D* GetDiskThread() { return pDiskThread; }
-Line 572 
 namespace LinuxSampler {
+Line 617 
 namespace LinuxSampler {
              public:
                  int PendingStreamDeletions;
                  RR* pPendingRegionSuspension;
                  SuspensionVoiceHandler(RR* pPendingRegionSuspension) {
                      PendingStreamDeletions = 0;
                      this->pPendingRegionSuspension = pPendingRegionSuspension;
                  }
-                 virtual bool Process(MidiKey* pMidiKey) {
+                 virtual bool Process(MidiKey* pMidiKey) OVERRIDE {
-                     VoiceIterator itVoice = pMidiKey->pActiveVoices->first();
+                     NoteIterator  itNote  = pMidiKey->pActiveNotes->first();
+                     VoiceIterator itVoice = itNote->pActiveVoices->first();
                      // if current key is not associated with this region, skip this key
                      if (itVoice->GetRegion()->GetParent() != pPendingRegionSuspension) return false;
                      return true;
                  }
-                 virtual void Process(VoiceIterator& itVoice) {
+                 virtual void Process(VoiceIterator& itVoice) OVERRIDE {
                      // request a notification from disk thread side for stream deletion
                      const Stream::Handle hStream = itVoice->KillImmediately(true);
                      if (hStream != Stream::INVALID_HANDLE) { // voice actually used a stream
-Line 601 
 namespace LinuxSampler {
+Line 648 
 namespace LinuxSampler {
              int                          ActiveVoiceCountTemp;  ///< number of currently active voices (for internal usage, will be used for incrementation)
              VoiceIterator                itLastStolenVoice;     ///< Only for voice stealing: points to the last voice which was theft in current audio fragment, NULL otherwise.
+             NoteIterator                 itLastStolenNote;      ///< Only for voice stealing: points to the last note from which was theft in current audio fragment, NULL otherwise.
              RTList<uint>::Iterator       iuiLastStolenKey;      ///< Only for voice stealing: key number of last key on which the last voice was theft in current audio fragment, NULL otherwise.
              EngineChannelBase<V, R, I>*  pLastStolenChannel;    ///< Only for voice stealing: points to the engine channel on which the previous voice was stolen in this audio fragment.
              VoiceIterator                itLastStolenVoiceGlobally; ///< Same as itLastStolenVoice, but engine globally
+             NoteIterator                 itLastStolenNoteGlobally; ///< Same as itLastStolenNote, but engine globally
              RTList<uint>::Iterator       iuiLastStolenKeyGlobally;  ///< Same as iuiLastStolenKey, but engine globally
              RTList<Event>*               pVoiceStealingQueue;   ///< All voice-launching events which had to be postponed due to free voice shortage.
              Mutex                        ResetInternalMutex;    ///< Mutex to protect the ResetInternal function for concurrent usage (e.g. by the lscp and instrument loader threads).
              int iMaxDiskStreams;
+             NoteBase* NoteByID(note_id_t id) OVERRIDE {
+                 NoteIterator itNote = GetNotePool()->fromID(id);
+                 if (!itNote) return NULL;
+                 return &*itNote;
+             }
+             /**
+              * Gets a new @c Note object from the note pool, initializes it
+              * appropriately, links it with requested parent note (if
+              * requested), moves it to the appropriate key's list of active
+              * notes it, and sticks the new note's unique ID to the
+              * passed @a pNoteOnEvent.
+              *
+              * @param pEngineChannel - engine channel on which this event happened
+              * @param pNoteOnEvent - event which caused this
+              * @returns new note's unique ID (or zero on error)
+              */
+             note_id_t LaunchNewNote(LinuxSampler::EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOnEvent) OVERRIDE {
+                 EngineChannelBase<V, R, I>* pChannel = static_cast<EngineChannelBase<V, R, I>*>(pEngineChannel);
+                 Pool< Note<V> >* pNotePool = GetNotePool();
+                 if (pNotePool->poolIsEmpty()) {
+                     dmsg(1,("Engine: Could not launch new note; Note pool empty!\n"));
+                     return 0; // error
+                 }
+                 // create a new note (for new voices to be assigned to)
+                 //NoteIterator itNewNote = pKey->pActiveNotes->allocAppend();
+                 NoteIterator itNewNote = pNotePool->allocAppend();
+                 const note_id_t newNoteID = pNotePool->getID(itNewNote);
+                 // remember the engine's time when this note was triggered exactly
+                 itNewNote->triggerSchedTime = itNoteOnEvent->SchedTime();
+                 // usually the new note (and its subsequent voices) will be
+                 // allocated on the key provided by the event's note number,
+                 // however if this new note is requested not to be a regular
+                 // note, but rather a child note, then this new note will be
+                 // allocated on the parent note's key instead in order to
+                 // release the child note simultaniously with its parent note
+                 itNewNote->hostKey = itNoteOnEvent->Param.Note.Key;
+                 // in case this new note was requested to be a child note,
+                 // then retrieve its parent note and link them with each other
+                 const note_id_t parentNoteID = itNoteOnEvent->Param.Note.ParentNoteID;
+                 if (parentNoteID) {
+                     NoteIterator itParentNote = pNotePool->fromID(parentNoteID);
+                     if (itParentNote) {
+                         RTList<note_id_t>::Iterator itChildNoteID = itParentNote->pChildNotes->allocAppend();
+                         if (itChildNoteID) {
+                             // link parent and child note with each other
+                             *itChildNoteID = newNoteID;
+                             itNewNote->parentNoteID = parentNoteID;
+                             itNewNote->hostKey = itParentNote->hostKey;
+                         } else {
+                             dmsg(1,("Engine: Could not assign new note as child note; Note ID pool empty!\n"));
+                             pNotePool->free(itNewNote);
+                             return 0; // error
+                         }
+                     } else {
+                         // the parent note was apparently released already, so
+                         // free the new note again and inform caller that it
+                         // should drop the event
+                         dmsg(3,("Engine: Could not assign new note as child note; Parent note is gone!\n"));
+                         pNotePool->free(itNewNote);
+                         return 0; // error
+                     }
+                 }
+                 dmsg(2,("Launched new note on host key %d\n", itNewNote->hostKey));
+                 // copy event which caused this note
+                 itNewNote->cause = *itNoteOnEvent;
+                 itNewNote->eventID = pEventPool->getID(itNoteOnEvent);
+                 if (!itNewNote->eventID) {
+                     dmsg(0,("Engine: No valid event ID resolved for note. This is a bug!!!\n"));
+                 }
+                 // move new note to its host key
+                 MidiKey* pKey = &pChannel->pMIDIKeyInfo[itNewNote->hostKey];
+                 itNewNote.moveToEndOf(pKey->pActiveNotes);
+                 // assign unique note ID of this new note to the original note on event
+                 itNoteOnEvent->Param.Note.ID = newNoteID;
+                 return newNoteID; // success
+             }
              /**
               * Dispatch and handle all events in this audio fragment for the given
               * engine channel.
-Line 624 
 namespace LinuxSampler {
+Line 761 
 namespace LinuxSampler {
                  AbstractEngineChannel* pChannel = static_cast<AbstractEngineChannel*>(pEngineChannel);
                  pChannel->ImportEvents(Samples);
-                 // process events
+                 // if a valid real-time instrument script is loaded, pre-process
+                 // the event list by running the script now, since the script
+                 // might filter events or add new ones for this cycle
+                 if (pChannel->pScript) {
+                     const sched_time_t fragmentEndTime = pEventGenerator->schedTimeAtCurrentFragmentEnd();
+                     // resume suspended script executions been scheduled for
+                     // this audio fragment cycle (which were suspended in a
+                     // previous audio fragment cycle)
+                     ProcessSuspendedScriptEvents(pChannel, fragmentEndTime);
+                     // spawn new script executions for the new MIDI events of
+                     // this audio fragment cycle
+                     //
+                     // FIXME: it would probably be better to just schedule newly spawned script executions here and then execute them altogether with already suspended ones all at once in order of all their scheduled timing
+                     for (RTList<Event>::Iterator itEvent = pChannel->pEvents->first(),
+                         end = pChannel->pEvents->end(); itEvent != end; )
+                     {
+                         //HACK: avoids iterator invalidation which might happen below since an instrument script might drop an event by direct raw pointer access (it would be considerable to extend the Iterator class to detect and circumvent this case by checking the "reincarnation" member variable).
+                         RTList<Event>::Iterator itNext = itEvent;
+                         ++itNext;
+                         switch (itEvent->Type) {
+                             case Event::type_note_on:
+                                 if (pChannel->pScript->handlerNote)
+                                     ProcessEventByScript(pChannel, itEvent, pChannel->pScript->handlerNote);
+                                 break;
+                             case Event::type_note_off:
+                                 if (pChannel->pScript->handlerRelease)
+                                     ProcessEventByScript(pChannel, itEvent, pChannel->pScript->handlerRelease);
+                                 break;
+                             case Event::type_control_change:
+                             case Event::type_channel_pressure:
+                             case Event::type_pitchbend:
+                                 if (pChannel->pScript->handlerController)
+                                     ProcessEventByScript(pChannel, itEvent, pChannel->pScript->handlerController);
+                                 break;
+                             case Event::type_note_pressure:
+                                 //TODO: ...
+                                 break;
+                             case Event::type_sysex:
+                                 //TODO: ...
+                                 break;
+                             case Event::type_cancel_release_key:
+                             case Event::type_release_key:
+                             case Event::type_release_note:
+                             case Event::type_play_note:
+                             case Event::type_stop_note:
+                             case Event::type_kill_note:
+                             case Event::type_note_synth_param:
+                                 break; // noop
+                         }
+                         // see HACK comment above
+                         itEvent = itNext;
+                     }
+                     // this has to be run again, since the newly spawned scripts
+                     // above may have cause suspended scripts that must be
+                     // resumed within this same audio fragment cycle
+                     //
+                     // FIXME: see FIXME comment above
+                     ProcessSuspendedScriptEvents(pChannel, fragmentEndTime);
+                 }
+                 // if there are any delayed events scheduled for the current
+                 // audio fragment cycle, then move and sort them into the main
+                 // event list
+                 if (!pChannel->delayedEvents.queue.isEmpty()) {
+                     dmsg(5,("Engine: There are delayed MIDI events (total queue size: %d) ...\n", pChannel->delayedEvents.queue.size()));
+                     const sched_time_t fragmentEndTime = pEventGenerator->schedTimeAtCurrentFragmentEnd();
+                     RTList<Event>::Iterator itEvent = pChannel->pEvents->first();
+                     while (true) {
+                         RTList<ScheduledEvent>::Iterator itDelayedEventNode =
+                             pEventGenerator->popNextScheduledEvent(
+                                 pChannel->delayedEvents.queue,
+                                 pChannel->delayedEvents.schedulerNodes,
+                                 fragmentEndTime
+                             );
+                         if (!itDelayedEventNode) break;
+                         // get the actual delayed event object and free the used scheduler node
+                         RTList<Event>::Iterator itDelayedEvent = itDelayedEventNode->itEvent;
+                         pChannel->delayedEvents.schedulerNodes.free(itDelayedEventNode);
+                         if (!itDelayedEvent) { // should never happen, but just to be sure ...
+                             dmsg(1,("Engine: Oops, invalid delayed event!\n"));
+                             continue;
+                         }
+                         // skip all events on main event list which have a time
+                         // before (or equal to) the delayed event to be inserted
+                         for (; itEvent && itEvent->FragmentPos() <= itDelayedEvent->FragmentPos();
+                              ++itEvent);
+                         // now move delayed event from delayedEvents.pList to
+                         // the current position on the main event list
+                         itEvent = itDelayedEvent.moveBefore(itEvent);
+                         dmsg(5,("Engine: Inserted event of type %d into main event list (queue size: %d).\n", itEvent->Type, pChannel->delayedEvents.queue.size()));
+                     }
+                     dmsg(5,("Engine: End of delayed events (total queue size: %d).\n", pChannel->delayedEvents.queue.size()));
+                 }
+                 // now process all events regularly
                  {
                      RTList<Event>::Iterator itEvent = pChannel->pEvents->first();
                      RTList<Event>::Iterator end     = pChannel->pEvents->end();
-Line 634 
 namespace LinuxSampler {
+Line 872 
 namespace LinuxSampler {
                                  dmsg(5,("Engine: Note on received\n"));
                                  ProcessNoteOn((EngineChannel*)itEvent->pEngineChannel, itEvent);
                                  break;
+                             case Event::type_play_note:
+                                 dmsg(5,("Engine: Play Note 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_stop_note:
+                                 dmsg(5,("Engine: Stop Note received\n"));
+                                 ProcessNoteOff((EngineChannel*)itEvent->pEngineChannel, itEvent);
+                                 break;
+                             case Event::type_kill_note:
+                                 dmsg(5,("Engine: Kill Note received\n"));
+                                 ProcessKillNote((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_channel_pressure:
+                                 dmsg(5,("Engine: MIDI Chan. Pressure received\n"));
+                                 ProcessChannelPressure((EngineChannel*)itEvent->pEngineChannel, itEvent);
+                                 break;
+                             case Event::type_note_pressure:
+                                 dmsg(5,("Engine: MIDI Note Pressure received\n"));
+                                 ProcessPolyphonicKeyPressure((EngineChannel*)itEvent->pEngineChannel, itEvent);
+                                 break;
                              case Event::type_pitchbend:
                                  dmsg(5,("Engine: Pitchbend received\n"));
                                  ProcessPitchbend(static_cast<AbstractEngineChannel*>(itEvent->pEngineChannel), itEvent);
                                  break;
+                             case Event::type_note_synth_param:
+                                 dmsg(5,("Engine: Note Synth Param received\n"));
+                                 ProcessNoteSynthParam(itEvent->pEngineChannel, itEvent);
+                                 break;
+                             case Event::type_sysex:
+                                 break; // TODO ...
+                             case Event::type_cancel_release_key:
+                             case Event::type_release_key:
+                             case Event::type_release_note:
+                                 break; // noop
                          }
                      }
                  }
-Line 653 
 namespace LinuxSampler {
+Line 922 
 namespace LinuxSampler {
                  // reset voice stealing for the next engine channel (or next audio fragment)
                  itLastStolenVoice         = VoiceIterator();
                  itLastStolenVoiceGlobally = VoiceIterator();
+                 itLastStolenNote          = NoteIterator();
+                 itLastStolenNoteGlobally  = NoteIterator();
                  iuiLastStolenKey          = RTList<uint>::Iterator();
                  iuiLastStolenKeyGlobally  = RTList<uint>::Iterator();
                  pLastStolenChannel        = NULL;
              }
              /**
+              * Run all suspended script execution instances which are scheduled
+              * to be resumed for the current audio fragment cycle.
+              *
+              * @param pChannel - engine channel on which suspended events occurred
+              */
+             void ProcessSuspendedScriptEvents(AbstractEngineChannel* pChannel, const sched_time_t fragmentEndTime) {
+                 while (true) {
+                     RTList<ScriptEvent>::Iterator itEvent =
+                         pEventGenerator->popNextScheduledScriptEvent(
+                             pChannel->pScript->suspendedEvents,
+                             *pChannel->pScript->pEvents, fragmentEndTime
+                         );
+                     if (!itEvent) break;
+                     ResumeScriptEvent(pChannel, itEvent);
+                 }
+             }
+             /** @brief Call instrument script's event handler for this event.
+              *
+              * Causes a new execution instance of the currently loaded real-time
+              * instrument script's event handler (callback) to be spawned for
+              * the given MIDI event.
+              *
+              * @param pChannel - engine channel on which the MIDI event occurred
+              * @param itEvent - MIDI event that causes this new script execution
+              * @param pEventHandler - script's event handler to be executed
+              */
+             void ProcessEventByScript(AbstractEngineChannel* pChannel, RTList<Event>::Iterator& itEvent, VMEventHandler* pEventHandler) {
+                 const int key = itEvent->Param.Note.Key; // even if this is not a note on/off event, accessing it does not mean any harm
+                 // check if polyphonic data is passed from "note" to "release"
+                 // script event handlers
+                 if (pEventHandler == pChannel->pScript->handlerRelease &&
+                     pChannel->pScript->handlerNote &&
+                     pChannel->pScript->handlerNote->isPolyphonic() &&
+                     pChannel->pScript->handlerRelease->isPolyphonic() &&
+                     !pChannel->pScript->pKeyEvents[key]->isEmpty())
+                 {
+                     // polyphonic variable data is used/passed from "note" to
+                     // "release" script callback, so we have to recycle the
+                     // original "note on" script event(s)
+                     RTList<ScriptEvent>::Iterator it  = pChannel->pScript->pKeyEvents[key]->first();
+                     RTList<ScriptEvent>::Iterator end = pChannel->pScript->pKeyEvents[key]->end();
+                     for (; it != end; ++it) {
+                         ProcessScriptEvent(
+                             pChannel, itEvent, pEventHandler, it
+                         );
+                     }
+                 } else {
+                     // no polyphonic data is used/passed from "note" to
+                     // "release" script callback, so just use a new fresh
+                     // script event object
+                     RTList<ScriptEvent>::Iterator itScriptEvent =
+                         pChannel->pScript->pEvents->allocAppend();
+                     // if event handler uses polyphonic variables, reset them
+                     // to zero values before starting to execute the handler
+                     if (pEventHandler->isPolyphonic())
+                         itScriptEvent->execCtx->resetPolyphonicData();
+                     ProcessScriptEvent(
+                         pChannel, itEvent, pEventHandler, itScriptEvent
+                     );
+                 }
+             }
+             /** @brief Spawn new execution instance of an instrument script handler.
+              *
+              * Will be called to initiate a new execution of a real-time
+              * instrument script event right from the start of the script's
+              * respective handler. If script execution did not complete after
+              * calling this method, the respective script exeuction is then
+              * suspended and a call to ResumeScriptEvent() will be used next
+              * time to continue its execution.
+              *
+              * @param pChannel - engine channel this script is running for
+              * @param itEvent - event which caused execution of this script
+              *                  event handler
+              * @param pEventHandler - VM representation of event handler to be
+              *                        executed
+              * @param itScriptEvent - script event that shall be processed
+              */
+             void ProcessScriptEvent(AbstractEngineChannel* pChannel, RTList<Event>::Iterator& itEvent, VMEventHandler* pEventHandler, RTList<ScriptEvent>::Iterator& itScriptEvent) {
+                 if (!itScriptEvent) return; // not a valid script event (i.e. because no free script event was left in the script event pool)
+                 // fill the list of script handlers to be executed by this event
+                 int i = 0;
+                 itScriptEvent->handlers[i++] = pEventHandler; // actual event handler (i.e. note, controller)
+                 itScriptEvent->handlers[i] = NULL; // NULL termination of list
+                 // initialize/reset other members
+                 itScriptEvent->cause = *itEvent;
+                 itScriptEvent->scheduleTime = itEvent->SchedTime();
+                 itScriptEvent->currentHandler = 0;
+                 itScriptEvent->executionSlices = 0;
+                 itScriptEvent->ignoreAllWaitCalls = false;
+                 itScriptEvent->handlerType = pEventHandler->eventHandlerType();
+                 // this is the native representation of the $EVENT_ID script variable
+                 itScriptEvent->id =
+                     (itEvent->Type == Event::type_note_on)
+                         ? ScriptID::fromNoteID( itEvent->Param.Note.ID )
+                         : ScriptID::fromEventID( pEventPool->getID(itEvent) );
+                 // run script handler(s)
+                 VMExecStatus_t res = pScriptVM->exec(
+                     pChannel->pScript->parserContext, &*itScriptEvent
+                 );
+                 // was the script suspended?
+                 if (res & VM_EXEC_SUSPENDED) { // script was suspended ...
+                     // in case the script was suspended, keep it on the allocated
+                     // ScriptEvent list to be resume at the scheduled time in future,
+                     // additionally insert it into a sorted time queue
+                     pEventGenerator->scheduleAheadMicroSec(
+                         pChannel->pScript->suspendedEvents, // scheduler queue
+                         *itScriptEvent, // script event
+                         itScriptEvent->cause.FragmentPos(), // current time of script event (basis for its next execution)
+                         itScriptEvent->execCtx->suspensionTimeMicroseconds() // how long shall it be suspended
+                     );
+                 } else { // script execution has finished without 'suspended' status ...
+                     // if "polyphonic" variable data is passed from script's
+                     // "note" event handler to its "release" event handler, then
+                     // the script event must be kept and recycled for the later
+                     // occuring "release" script event ...
+                     if (pEventHandler == pChannel->pScript->handlerNote &&
+                         pChannel->pScript->handlerRelease &&
+                         pChannel->pScript->handlerNote->isPolyphonic() &&
+                         pChannel->pScript->handlerRelease->isPolyphonic())
+                     {
+                         const int key = itEvent->Param.Note.Key;
+                         itScriptEvent.moveToEndOf(pChannel->pScript->pKeyEvents[key & 127]);
+                     } else {
+                         // ... otherwise if no polyphonic data is passed and
+                         // script's execution has finished without suspension
+                         // status, then free the script event for a new future
+                         // script event to be triggered from start
+                         pChannel->pScript->pEvents->free(itScriptEvent);
+                     }
+                 }
+             }
+             /** @brief Resume execution of instrument script.
+              *
+              * Will be called to resume execution of a real-time instrument
+              * script event which has been suspended previously.
+              *
+              * Script execution might be suspended for various reasons. Usually
+              * a script will be suspended if the script called the built-in
+              * "wait()" function, but it might also be suspended automatically
+              * if the script took too much execution time in an audio fragment
+              * cycle. So in the latter case automatic suspension is performed in
+              * order to avoid harm for the sampler's overall real-time
+              * requirements.
+              *
+              * @param pChannel - engine channel this script is running for
+              * @param itScriptEvent - script execution that shall be resumed
+              */
+             void ResumeScriptEvent(AbstractEngineChannel* pChannel, RTList<ScriptEvent>::Iterator& itScriptEvent) {
+                 VMEventHandler* handler = itScriptEvent->handlers[itScriptEvent->currentHandler];
+                 // run script
+                 VMExecStatus_t res = pScriptVM->exec(
+                     pChannel->pScript->parserContext, &*itScriptEvent
+                 );
+                 // was the script suspended?
+                 if (res & VM_EXEC_SUSPENDED) {
+                     // in case the script was suspended, keep it on the allocated
+                     // ScriptEvent list to be resume at the scheduled time in future,
+                     // additionally insert it into a sorted time queue
+                     pEventGenerator->scheduleAheadMicroSec(
+                         pChannel->pScript->suspendedEvents, // scheduler queue
+                         *itScriptEvent, // script event
+                         itScriptEvent->cause.FragmentPos(), // current time of script event (basis for its next execution)
+                         itScriptEvent->execCtx->suspensionTimeMicroseconds() // how long shall it be suspended
+                     );
+                 } else { // script execution has finished without 'suspended' status ...
+                     // if "polyphonic" variable data is passed from script's
+                     // "note" event handler to its "release" event handler, then
+                     // the script event must be kept and recycled for the later
+                     // occuring "release" script event ...
+                     if (handler && handler == pChannel->pScript->handlerNote &&
+                         pChannel->pScript->handlerRelease &&
+                         pChannel->pScript->handlerNote->isPolyphonic() &&
+                         pChannel->pScript->handlerRelease->isPolyphonic())
+                     {
+                         const int key = itScriptEvent->cause.Param.Note.Key;
+                         itScriptEvent.moveToEndOf(pChannel->pScript->pKeyEvents[key & 127]);
+                     } else {
+                         // ... otherwise if no polyphonic data is passed and
+                         // script's execution has finished without suspension
+                         // status, then free the script event for a new future
+                         // script event to be triggered from start
+                         pChannel->pScript->pEvents->free(itScriptEvent);
+                     }
+                 }
+             }
+             /**
               *  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 pEngineChannel - engine channel on which this event occurred 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  StealVoice(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOnEvent) {
+             int 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;
-Line 676 
 namespace LinuxSampler {
+Line 1143 
 namespace LinuxSampler {
                  EngineChannelBase<V, R, I>* pEngineChn = static_cast<EngineChannelBase<V, R, I>*>(pEngineChannel);
-                 if (!pEventPool->poolIsEmpty()) {
+                 if (pEventPool->poolIsEmpty()) {
+                     dmsg(1,("Event pool emtpy!\n"));
+                     return -1;
+                 }
-                     if(!pEngineChn->StealVoice(itNoteOnEvent, &itLastStolenVoice, &iuiLastStolenKey)) {
+                 if (!pEngineChn->StealVoice(itNoteOnEvent, &itLastStolenVoice, &itLastStolenNote, &iuiLastStolenKey)) {
-                         --VoiceSpawnsLeft;
+                     --VoiceSpawnsLeft;
-                         return 0;
+                     return 0;
-                     }
+                 }
-                     // if we couldn't steal a voice from the same engine channel then
+                 // 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
+                 // steal oldest voice on the oldest key from any other engine channel
-                     // (the smaller engine channel number, the higher priority)
+                 // (the smaller engine channel number, the higher priority)
-                     EngineChannelBase<V, R, I>*  pSelectedChannel;
+                 EngineChannelBase<V, R, I>*  pSelectedChannel;
-                     int                       iChannelIndex;
+                 int                          iChannelIndex;
-                     VoiceIterator             itSelectedVoice;
+                 VoiceIterator                itSelectedVoice;
-                     // select engine channel
+                 // select engine channel
-                     if (pLastStolenChannel) {
+                 if (pLastStolenChannel) {
-                         pSelectedChannel = pLastStolenChannel;
+                     pSelectedChannel = pLastStolenChannel;
-                         iChannelIndex    = pSelectedChannel->iEngineIndexSelf;
+                     iChannelIndex    = pSelectedChannel->iEngineIndexSelf;
-                     } else { // pick the engine channel followed by this engine channel
+                 } else { // pick the engine channel followed by this engine channel
-                         iChannelIndex    = (pEngineChn->iEngineIndexSelf + 1) % engineChannels.size();
+                     iChannelIndex    = (pEngineChn->iEngineIndexSelf + 1) % engineChannels.size();
-                         pSelectedChannel = static_cast<EngineChannelBase<V, R, I>*>(engineChannels[iChannelIndex]);
+                     pSelectedChannel = static_cast<EngineChannelBase<V, R, I>*>(engineChannels[iChannelIndex]);
-                     }
+                 }
-                     // if we already stole in this fragment, try to proceed on same key
+                 // if we already stole in this fragment, try to proceed on same note
-                     if (this->itLastStolenVoiceGlobally) {
+                 if (this->itLastStolenVoiceGlobally) {
-                         itSelectedVoice = this->itLastStolenVoiceGlobally;
+                     itSelectedVoice = this->itLastStolenVoiceGlobally;
-                         do {
+                     do {
-                             ++itSelectedVoice;
+                         ++itSelectedVoice;
-                         } while (itSelectedVoice && !itSelectedVoice->IsStealable()); // proceed iterating if voice was created in this fragment cycle
+                     } while (itSelectedVoice && !itSelectedVoice->IsStealable()); // proceed iterating if voice was created in this fragment cycle
+                 }
+                 // 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;
+                     // done
+                     goto stealable_voice_found;
+                 }
+                 // get (next) oldest note
+                 if (this->itLastStolenNoteGlobally) {
+                     for (NoteIterator itNote = ++this->itLastStolenNoteGlobally;
+                          itNote; ++itNote)
+                     {
+                         for (itSelectedVoice = itNote->pActiveVoices->first(); itSelectedVoice; ++itSelectedVoice) {
+                             // proceed iterating if voice was created in this audio fragment cycle
+                             if (itSelectedVoice->IsStealable()) {
+                                 // remember which voice of which note we stole, so we can simply proceed on next voice stealing
+                                 this->itLastStolenNoteGlobally  = itNote;
+                                 this->itLastStolenVoiceGlobally = itSelectedVoice;
+                                 goto stealable_voice_found; // selection succeeded
+                             }
+                         }
                      }
+                 }
-                     #if CONFIG_DEVMODE
+                 #if CONFIG_DEVMODE
-                     EngineChannel* pBegin = pSelectedChannel; // to detect endless loop
+                 EngineChannel* pBegin = pSelectedChannel; // to detect endless loop
-                     #endif // CONFIG_DEVMODE
+                 #endif // CONFIG_DEVMODE
-                     // did we find a 'stealable' voice?
+                 while (true) { // iterate through engine channels
-                     if (itSelectedVoice && itSelectedVoice->IsStealable()) {
+                     // get (next) oldest key
-                         // remember which voice we stole, so we can simply proceed on next voice stealing
+                     RTList<uint>::Iterator iuiSelectedKey = (this->iuiLastStolenKeyGlobally) ? ++this->iuiLastStolenKeyGlobally : pSelectedChannel->pActiveKeys->first();
-                         this->itLastStolenVoiceGlobally = itSelectedVoice;
+                     this->iuiLastStolenKeyGlobally = RTList<uint>::Iterator(); // to prevent endless loop (see line above)
-                     } else while (true) { // iterate through engine channels
+                     while (iuiSelectedKey) {
-                         // get (next) oldest key
+                         MidiKey* pSelectedKey = &pSelectedChannel->pMIDIKeyInfo[*iuiSelectedKey];
-                         RTList<uint>::Iterator iuiSelectedKey = (this->iuiLastStolenKeyGlobally) ? ++this->iuiLastStolenKeyGlobally : pSelectedChannel->pActiveKeys->first();
-                         this->iuiLastStolenKeyGlobally = RTList<uint>::Iterator(); // to prevent endless loop (see line above)
+                         for (NoteIterator itNote = pSelectedKey->pActiveNotes->first(),
-                         while (iuiSelectedKey) {
+                              itNotesEnd = pSelectedKey->pActiveNotes->end();
-                             MidiKey* pSelectedKey = &pSelectedChannel->pMIDIKeyInfo[*iuiSelectedKey];
+                              itNote != itNotesEnd; ++itNote)
-                             itSelectedVoice = pSelectedKey->pActiveVoices->first();
+                         {
+                             itSelectedVoice = itNote->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
+                                 // remember which voice of which note on which key on which engine channel we stole, so we can simply proceed on next voice stealing
                                  this->iuiLastStolenKeyGlobally  = iuiSelectedKey;
+                                 this->itLastStolenNoteGlobally  = itNote;
                                  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 = static_cast<EngineChannelBase<V, R, I>*>(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
+                         ++iuiSelectedKey; // get next key on current engine channel
                      }
+                     // get next engine channel
-                     // jump point if a 'stealable' voice was found
+                     iChannelIndex    = (iChannelIndex + 1) % engineChannels.size();
-                     stealable_voice_found:
+                     pSelectedChannel = static_cast<EngineChannelBase<V, R, I>*>(engineChannels[iChannelIndex]);
                      #if CONFIG_DEVMODE
-                     if (!itSelectedVoice->IsActive()) {
+                     if (pSelectedChannel == pBegin) {
-                         dmsg(1,("EngineBase: ERROR, tried to steal a voice which was not active !!!\n"));
+                         dmsg(1,("FATAL ERROR: voice stealing endless loop!\n"));
-                         return -1;
+                         dmsg(1,("VoiceSpawnsLeft=%d.\n", VoiceSpawnsLeft));
+                         dmsg(1,("Exiting.\n"));
+                         exit(-1);
                      }
                      #endif // CONFIG_DEVMODE
+                 }
-                     // now kill the selected voice
+                 // jump point if a 'stealable' voice was found
-                     itSelectedVoice->Kill(itNoteOnEvent);
+                 stealable_voice_found:
-                     --VoiceSpawnsLeft;
-                     return 0; // success
+                 #if CONFIG_DEVMODE
-                 }
+                 if (!itSelectedVoice->IsActive()) {
-                 else {
+                     dmsg(1,("EngineBase: ERROR, tried to steal a voice which was not active !!!\n"));
-                     dmsg(1,("Event pool emtpy!\n"));
                      return -1;
                  }
+                 #endif // CONFIG_DEVMODE
+                 // now kill the selected voice
+                 itSelectedVoice->Kill(itNoteOnEvent);
+                 --VoiceSpawnsLeft;
+                 return 0; // success
              }
              void HandleInstrumentChanges() {
-Line 790 
 namespace LinuxSampler {
+Line 1282 
 namespace LinuxSampler {
                          dmsg(5,("Engine: instrument change command received\n"));
                          cmd.bChangeInstrument = false;
                          pEngineChannel->pInstrument = cmd.pInstrument;
+                         pEngineChannel->pScript =
+                             cmd.pScript->bHasValidScript ? cmd.pScript : NULL;
                          instrumentChanged = true;
                          pEngineChannel->MarkAllActiveVoicesAsOrphans();
+                         // the script's "init" event handler is only executed
+                         // once (when the script is loaded or reloaded)
+                         if (pEngineChannel->pScript && pEngineChannel->pScript->handlerInit) {
+                             dmsg(5,("Engine: exec handlerInit %p\n", pEngineChannel->pScript->handlerInit));
+                             RTList<ScriptEvent>::Iterator itScriptEvent =
+                                 pEngineChannel->pScript->pEvents->allocAppend();
+                             itScriptEvent->cause = pEventGenerator->CreateEvent(0);
+                             itScriptEvent->cause.Type = (Event::type_t) -1; // some invalid type to avoid random event processing
+                             itScriptEvent->cause.pEngineChannel = pEngineChannel;
+                             itScriptEvent->cause.pMidiInputPort = pEngineChannel->GetMidiInputPort();
+                             itScriptEvent->handlers[0] = pEngineChannel->pScript->handlerInit;
+                             itScriptEvent->handlers[1] = NULL;
+                             itScriptEvent->currentHandler = 0;
+                             itScriptEvent->executionSlices = 0;
+                             itScriptEvent->ignoreAllWaitCalls = false;
+                             itScriptEvent->handlerType = VM_EVENT_HANDLER_INIT;
+                             VMExecStatus_t res;
+                             size_t instructionsCount = 0;
+                             const size_t maxInstructions = 200000; // aiming approx. 1 second max. (based on very roughly 5us / instruction)
+                             bool bWarningShown = false;
+                             do {
+                                 res = pScriptVM->exec(
+                                     pEngineChannel->pScript->parserContext, &*itScriptEvent
+                                 );
+                                 instructionsCount += itScriptEvent->execCtx->instructionsPerformed();
+                                 if (instructionsCount > maxInstructions && !bWarningShown) {
+                                     bWarningShown = true;
+                                     dmsg(0,("[ScriptVM] WARNING: \"init\" event handler of instrument script executing for long time!\n"));
+                                 }
+                             } while (res & VM_EXEC_SUSPENDED && !(res & VM_EXEC_ERROR));
+                             pEngineChannel->pScript->pEvents->free(itScriptEvent);
+                         }
                      }
                  }
-Line 843 
 namespace LinuxSampler {
+Line 1373 
 namespace LinuxSampler {
                      EngineChannelBase<V, R, I>* pEngineChannel =
                          static_cast<EngineChannelBase<V, R, I>*>(itVoiceStealEvent->pEngineChannel);;
                      if (!pEngineChannel->pInstrument) continue; // ignore if no instrument loaded
                      PoolVoiceIterator itNewVoice =
                          LaunchVoice(pEngineChannel, itVoiceStealEvent, itVoiceStealEvent->Param.Note.Layer, itVoiceStealEvent->Param.Note.ReleaseTrigger, false, false);
                      if (itNewVoice) {
+                         // usually there should already be a new Note object
+                         NoteIterator itNote = GetNotePool()->fromID(itVoiceStealEvent->Param.Note.ID);
+                         if (!itNote) { // should not happen, but just to be sure ...
+                             const note_id_t noteID = LaunchNewNote(pEngineChannel, itVoiceStealEvent);
+                             if (!noteID) {
+                                 dmsg(1,("Engine: Voice stealing failed; No Note object and Note pool empty!\n"));
+                                 continue;
+                             }
+                             itNote = GetNotePool()->fromID(noteID);
+                         }
+                         // move voice from whereever it was, to the new note's list of active voices
+                         itNewVoice = itNewVoice.moveToEndOf(itNote->pActiveVoices);
+                         // render audio of this new voice for the first time
                          itNewVoice->Render(Samples);
                          if (itNewVoice->IsActive()) { // still active
                              *(pEngineChannel->pRegionsInUse->allocAppend()) = itNewVoice->GetRegion();
-Line 883 
 namespace LinuxSampler {
+Line 1427 
 namespace LinuxSampler {
                   pChannel->FreeAllInactiveKyes();
                  // empty the engine channel's own event lists
-                 pChannel->ClearEventLists();
+                 // (only events of the current audio fragment cycle)
+                 pChannel->ClearEventListsOfCurrentFragment();
              }
              /**
-Line 948 
 namespace LinuxSampler {
+Line 1493 
 namespace LinuxSampler {
                                  case 0x1d: { // reverb send of note (Roland GS NRPN)
                                      const uint note = NrpnCtrlLSB;
                                      const float reverb = float(itControlChangeEvent->Param.CC.Value) / 127.0f;
-                                     dmsg(4,("Note Reverb Send NRPN received (note=%d,send=%d).\n", note, reverb));
+                                     dmsg(4,("Note Reverb Send NRPN received (note=%d,send=%f).\n", note, reverb));
                                      if (note < 128)
                                          pChannel->pMIDIKeyInfo[note].ReverbSend = reverb;
                                      break;
-Line 956 
 namespace LinuxSampler {
+Line 1501 
 namespace LinuxSampler {
                                  case 0x1e: { // chorus send of note (Roland GS NRPN)
                                      const uint note = NrpnCtrlLSB;
                                      const float chorus = float(itControlChangeEvent->Param.CC.Value) / 127.0f;
-                                     dmsg(4,("Note Chorus Send NRPN received (note=%d,send=%d).\n", note, chorus));
+                                     dmsg(4,("Note Chorus Send NRPN received (note=%d,send=%f).\n", note, chorus));
                                      if (note < 128)
                                          pChannel->pMIDIKeyInfo[note].ChorusSend = chorus;
                                      break;
-Line 1109 
 namespace LinuxSampler {
+Line 1654 
 namespace LinuxSampler {
              /**
               *  Assigns and triggers a new voice for the respective MIDI key.
               *
-              *  @param pEngineChannel - engine channel on which this event occured on
+              *  @param pEngineChannel - engine channel on which this event occurred on
               *  @param itNoteOnEvent - key, velocity and time stamp of the event
               */
-             virtual void ProcessNoteOn(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOnEvent) {
+             virtual void ProcessNoteOn(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOnEvent) OVERRIDE {
                  EngineChannelBase<V, R, I>* pChannel =
                          static_cast<EngineChannelBase<V, R, I>*>(pEngineChannel);
-                 //HACK: we should better add the transpose value only to the most mandatory places (like for retrieving the region and calculating the tuning), because otherwise voices will unintendedly survive when changing transpose while playing
-                 int k = itNoteOnEvent->Param.Note.Key + pChannel->GlobalTranspose;
-                 if (k < 0 || k > 127) return; //ignore keys outside the key range
-                 itNoteOnEvent->Param.Note.Key += pChannel->GlobalTranspose;
-                 int vel = itNoteOnEvent->Param.Note.Velocity;
                  const int key = itNoteOnEvent->Param.Note.Key;
+                 const int vel = itNoteOnEvent->Param.Note.Velocity;
+                 if (key < 0 || key > 127) return; // ignore event, key outside allowed key range
                  MidiKey* pKey = &pChannel->pMIDIKeyInfo[key];
-                 pChannel->listeners.PreProcessNoteOn(key, vel);
+                 // There are real MIDI note-on events (Event::type_note_on) and
+                 // programmatically spawned notes (Event::type_play_note). We have
+                 // to distinguish between them, since certain processing below
+                 // must only be done on real MIDI note-on events (i.e. for
+                 // correctly updating which MIDI keys are currently pressed down).
+                 const bool isRealMIDINoteOnEvent = itNoteOnEvent->Type == Event::type_note_on;
+                 if (isRealMIDINoteOnEvent)
+                     pChannel->listeners.PreProcessNoteOn(key, vel);
                  #if !CONFIG_PROCESS_MUTED_CHANNELS
                  if (pEngineChannel->GetMute()) { // skip if sampler channel is muted
-                     pChannel->listeners.PostProcessNoteOn(key, vel);
+                     if (isRealMIDINoteOnEvent)
+                         pChannel->listeners.PostProcessNoteOn(key, vel);
                      return;
                  }
                  #endif
                  if (!pChannel->pInstrument) {
-                     pChannel->listeners.PostProcessNoteOn(key, vel);
+                     if (isRealMIDINoteOnEvent)
+                         pChannel->listeners.PostProcessNoteOn(key, vel);
                      return; // ignore if no instrument loaded
                  }
-Line 1143 
 namespace LinuxSampler {
+Line 1695 
 namespace LinuxSampler {
                  RTList<Event>::Iterator itNoteOnEventOnKeyList = itNoteOnEvent.moveToEndOf(pKey->pEvents);
                  // if Solo Mode then kill all already active voices
-                 if (pChannel->SoloMode) {
+                 if (pChannel->SoloMode && isRealMIDINoteOnEvent) {
                      Pool<uint>::Iterator itYoungestKey = pChannel->pActiveKeys->last();
                      if (itYoungestKey) {
                          const int iYoungestKey = *itYoungestKey;
-Line 1151 
 namespace LinuxSampler {
+Line 1703 
 namespace LinuxSampler {
                          if (pOtherKey->Active) {
                              // get final portamento position of currently active voice
                              if (pChannel->PortamentoMode) {
-                                 VoiceIterator itVoice = pOtherKey->pActiveVoices->last();
+                                 NoteIterator itNote = pOtherKey->pActiveNotes->last();
-                                 if (itVoice) itVoice->UpdatePortamentoPos(itNoteOnEventOnKeyList);
+                                 if (itNote) {
+                                     VoiceIterator itVoice = itNote->pActiveVoices->last();
+                                     if (itVoice) itVoice->UpdatePortamentoPos(itNoteOnEventOnKeyList);
+                                 }
                              }
                              // kill all voices on the (other) key
-                             VoiceIterator itVoiceToBeKilled = pOtherKey->pActiveVoices->first();
+                             for (NoteIterator itNote = pOtherKey->pActiveNotes->first(); itNote; ++itNote) {
-                             VoiceIterator end               = pOtherKey->pActiveVoices->end();
+                                 VoiceIterator itVoiceToBeKilled = itNote->pActiveVoices->first();
-                             for (; itVoiceToBeKilled != end; ++itVoiceToBeKilled) {
+                                 VoiceIterator end               = itNote->pActiveVoices->end();
-                                 if (!(itVoiceToBeKilled->Type & Voice::type_release_trigger))
+                                 for (; itVoiceToBeKilled != end; ++itVoiceToBeKilled) {
-                                     itVoiceToBeKilled->Kill(itNoteOnEventOnKeyList);
+                                     if (!(itVoiceToBeKilled->Type & Voice::type_release_trigger))
+                                         itVoiceToBeKilled->Kill(itNoteOnEventOnKeyList);
+                                 }
                              }
                          }
                      }
-Line 1167 
 namespace LinuxSampler {
+Line 1724 
 namespace LinuxSampler {
                      pChannel->SoloKey = key;
                  }
-                 pChannel->ProcessKeySwitchChange(key);
+                 if (isRealMIDINoteOnEvent) {
+                     pChannel->ProcessKeySwitchChange(key);
-                 pKey->KeyPressed = true; // the MIDI key was now pressed down
+                     pKey->KeyPressed = true; // the MIDI key was now pressed down
-                 pKey->Velocity   = itNoteOnEventOnKeyList->Param.Note.Velocity;
+                     pChannel->KeyDown[key] = true; // just used as built-in %KEY_DOWN script variable
-                 pKey->NoteOnTime = FrameTime + itNoteOnEventOnKeyList->FragmentPos(); // will be used to calculate note length
+                     pKey->Velocity   = itNoteOnEventOnKeyList->Param.Note.Velocity;
+                     pKey->NoteOnTime = FrameTime + itNoteOnEventOnKeyList->FragmentPos(); // will be used to calculate note length
+                 }
                  // cancel release process of voices on this key if needed
-                 if (pKey->Active && !pChannel->SustainPedal) {
+                 if (pKey->Active && !pChannel->SustainPedal && isRealMIDINoteOnEvent) {
                      RTList<Event>::Iterator itCancelReleaseEvent = pKey->pEvents->allocAppend();
                      if (itCancelReleaseEvent) {
                          *itCancelReleaseEvent = *itNoteOnEventOnKeyList;         // copy event
-                         itCancelReleaseEvent->Type = Event::type_cancel_release; // transform event type
+                         itCancelReleaseEvent->Type = Event::type_cancel_release_key; // transform event type
                      }
                      else dmsg(1,("Event pool emtpy!\n"));
                  }
-Line 1189 
 namespace LinuxSampler {
+Line 1749 
 namespace LinuxSampler {
                  if (!pKey->Active && !pKey->VoiceTheftsQueued)
                      pKey->pEvents->free(itNoteOnEventOnKeyList);
-                 if (!pChannel->SoloMode || pChannel->PortamentoPos < 0.0f) pChannel->PortamentoPos = (float) key;
+                 if (isRealMIDINoteOnEvent && (!pChannel->SoloMode || pChannel->PortamentoPos < 0.0f))
+                     pChannel->PortamentoPos = (float) key;
+                 //NOTE: Hmm, I guess its a matter of taste whether round robin should be advanced only on real MIDI note-on events, isn't it?
                  if (pKey->pRoundRobinIndex) {
                      (*pKey->pRoundRobinIndex)++; // counter specific for the key or region
                      pChannel->RoundRobinIndex++; // common counter for the channel
                  }
-                 pChannel->listeners.PostProcessNoteOn(key, vel);
+                 if (isRealMIDINoteOnEvent)
+                     pChannel->listeners.PostProcessNoteOn(key, vel);
              }
              /**
-Line 1220 
 namespace LinuxSampler {
+Line 1785 
 namespace LinuxSampler {
               *  sustain pedal will be released or voice turned inactive by itself (e.g.
               *  due to completion of sample playback).
               *
-              *  @param pEngineChannel - engine channel on which this event occured on
+              *  @param pEngineChannel - engine channel on which this event occurred on
               *  @param itNoteOffEvent - key, velocity and time stamp of the event
               */
-             virtual void ProcessNoteOff(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOffEvent) {
+             virtual void ProcessNoteOff(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOffEvent) OVERRIDE {
                  EngineChannelBase<V, R, I>* pChannel = static_cast<EngineChannelBase<V, R, I>*>(pEngineChannel);
-                 int k = itNoteOffEvent->Param.Note.Key + pChannel->GlobalTranspose;
-                 if (k < 0 || k > 127) return; //ignore keys outside the key range
-                 //HACK: we should better add the transpose value only to the most mandatory places (like for retrieving the region and calculating the tuning), because otherwise voices will unintendedly survive when changing transpose while playing
-                 itNoteOffEvent->Param.Note.Key += pChannel->GlobalTranspose;
-                 int vel = itNoteOffEvent->Param.Note.Velocity;
                  const int iKey = itNoteOffEvent->Param.Note.Key;
+                 const int vel  = itNoteOffEvent->Param.Note.Velocity;
+                 if (iKey < 0 || iKey > 127) return; // ignore event, key outside allowed key range
                  MidiKey* pKey = &pChannel->pMIDIKeyInfo[iKey];
-                 pChannel->listeners.PreProcessNoteOff(iKey, vel);
+                 // There are real MIDI note-off events (Event::type_note_off) and
+                 // programmatically spawned notes (Event::type_stop_note). We have
+                 // to distinguish between them, since certain processing below
+                 // must only be done on real MIDI note-off events (i.e. for
+                 // correctly updating which MIDI keys are currently pressed down),
+                 // plus a stop-note event just releases voices of one particular
+                 // note, whereas a note-off event releases all voices on a
+                 // particular MIDI key instead.
+                 const bool isRealMIDINoteOffEvent = itNoteOffEvent->Type == Event::type_note_off;
+                 if (isRealMIDINoteOffEvent)
+                     pChannel->listeners.PreProcessNoteOff(iKey, vel);
                  #if !CONFIG_PROCESS_MUTED_CHANNELS
                  if (pEngineChannel->GetMute()) { // skip if sampler channel is muted
-                     pChannel->listeners.PostProcessNoteOff(iKey, vel);
+                     if (isRealMIDINoteOffEvent)
+                         pChannel->listeners.PostProcessNoteOff(iKey, vel);
                      return;
                  }
                  #endif
-                 pKey->KeyPressed = false; // the MIDI key was now released
+                 if (isRealMIDINoteOffEvent) {
+                     pKey->KeyPressed = false; // the MIDI key was now released
+                     pChannel->KeyDown[iKey] = false; // just used as built-in %KEY_DOWN script variable
+                 }
                  // move event to the key's own event list
                  RTList<Event>::Iterator itNoteOffEventOnKeyList = itNoteOffEvent.moveToEndOf(pKey->pEvents);
-                 bool bShouldRelease = pKey->Active && pChannel->ShouldReleaseVoice(itNoteOffEventOnKeyList->Param.Note.Key);
+                 if (isRealMIDINoteOffEvent) {
+                     bool bShouldRelease = pKey->Active && pChannel->ShouldReleaseVoice(itNoteOffEventOnKeyList->Param.Note.Key);
-                 // in case Solo Mode is enabled, kill all voices on this key and respawn a voice on the highest pressed key (if any)
+                     // in case Solo Mode is enabled, kill all voices on this key and respawn a voice on the highest pressed key (if any)
-                 if (pChannel->SoloMode && pChannel->pInstrument) { //TODO: this feels like too much code just for handling solo mode :P
+                     if (pChannel->SoloMode && pChannel->pInstrument) { //TODO: this feels like too much code just for handling solo mode :P
-                     bool bOtherKeysPressed = false;
+                         bool bOtherKeysPressed = false;
-                     if (iKey == pChannel->SoloKey) {
+                         if (iKey == pChannel->SoloKey) {
-                         pChannel->SoloKey = -1;
+                             pChannel->SoloKey = -1;
-                         // if there's still a key pressed down, respawn a voice (group) on the highest key
+                             // if there's still a key pressed down, respawn a voice (group) on the highest key
-                         for (int i = 127; i > 0; i--) {
+                             for (int i = 127; i > 0; i--) {
-                             MidiKey* pOtherKey = &pChannel->pMIDIKeyInfo[i];
+                                 MidiKey* pOtherKey = &pChannel->pMIDIKeyInfo[i];
-                             if (pOtherKey->KeyPressed) {
+                                 if (pOtherKey->KeyPressed) {
-                                 bOtherKeysPressed = true;
+                                     bOtherKeysPressed = true;
-                                 // make the other key the new 'currently active solo key'
+                                     // make the other key the new 'currently active solo key'
-                                 pChannel->SoloKey = i;
+                                     pChannel->SoloKey = i;
-                                 // get final portamento position of currently active voice
+                                     // get final portamento position of currently active voice
-                                 if (pChannel->PortamentoMode) {
+                                     if (pChannel->PortamentoMode) {
-                                     VoiceIterator itVoice = pKey->pActiveVoices->first();
+                                         NoteIterator itNote = pKey->pActiveNotes->first();
-                                     if (itVoice) itVoice->UpdatePortamentoPos(itNoteOffEventOnKeyList);
+                                         VoiceIterator itVoice = itNote->pActiveVoices->first();
-                                 }
+                                         if (itVoice) itVoice->UpdatePortamentoPos(itNoteOffEventOnKeyList);
-                                 // create a pseudo note on event
+                                     }
-                                 RTList<Event>::Iterator itPseudoNoteOnEvent = pOtherKey->pEvents->allocAppend();
+                                     // create a pseudo note on event
-                                 if (itPseudoNoteOnEvent) {
+                                     RTList<Event>::Iterator itPseudoNoteOnEvent = pOtherKey->pEvents->allocAppend();
-                                     // copy event
+                                     if (itPseudoNoteOnEvent) {
-                                     *itPseudoNoteOnEvent = *itNoteOffEventOnKeyList;
+                                         // copy event
-                                     // transform event to a note on event
+                                         *itPseudoNoteOnEvent = *itNoteOffEventOnKeyList;
-                                     itPseudoNoteOnEvent->Type                = Event::type_note_on;
+                                         // transform event to a note on event
-                                     itPseudoNoteOnEvent->Param.Note.Key      = i;
+                                         itPseudoNoteOnEvent->Type                = Event::type_note_on; //FIXME: should probably use Event::type_play_note instead (to avoid i.e. hanging notes)
-                                     itPseudoNoteOnEvent->Param.Note.Velocity = pOtherKey->Velocity;
+                                         itPseudoNoteOnEvent->Param.Note.Key      = i;
-                                     // allocate and trigger new voice(s) for the other key
+                                         itPseudoNoteOnEvent->Param.Note.Velocity = pOtherKey->Velocity;
-                                     TriggerNewVoices(pChannel, itPseudoNoteOnEvent, false);
+                                         // assign a new note to this note-on event
-                                     // if neither a voice was spawned or postponed then remove note on event from key again
+                                         if (LaunchNewNote(pChannel, itPseudoNoteOnEvent)) {
-                                     if (!pOtherKey->Active && !pOtherKey->VoiceTheftsQueued)
+                                             // allocate and trigger new voice(s) for the other key
-                                         pOtherKey->pEvents->free(itPseudoNoteOnEvent);
+                                             TriggerNewVoices(pChannel, itPseudoNoteOnEvent, false);
+                                         }
+                                         // if neither a voice was spawned or postponed then remove note on event from key again
+                                         if (!pOtherKey->Active && !pOtherKey->VoiceTheftsQueued)
+                                             pOtherKey->pEvents->free(itPseudoNoteOnEvent);
-                                 } else dmsg(1,("Could not respawn voice, no free event left\n"));
+                                     } else dmsg(1,("Could not respawn voice, no free event left\n"));
-                                 break; // done
+                                     break; // done
+                                 }
                              }
                          }
-                     }
+                         if (bOtherKeysPressed) {
-                     if (bOtherKeysPressed) {
+                             if (pKey->Active) { // kill all voices on this key
-                         if (pKey->Active) { // kill all voices on this key
+                                 bShouldRelease = false; // no need to release, as we kill it here
-                             bShouldRelease = false; // no need to release, as we kill it here
+                                 for (NoteIterator itNote = pKey->pActiveNotes->first(); itNote; ++itNote) {
-                             VoiceIterator itVoiceToBeKilled = pKey->pActiveVoices->first();
+                                     VoiceIterator itVoiceToBeKilled = itNote->pActiveVoices->first();
-                             VoiceIterator end               = pKey->pActiveVoices->end();
+                                     VoiceIterator end               = itNote->pActiveVoices->end();
-                             for (; itVoiceToBeKilled != end; ++itVoiceToBeKilled) {
+                                     for (; itVoiceToBeKilled != end; ++itVoiceToBeKilled) {
-                                 if (!(itVoiceToBeKilled->Type & Voice::type_release_trigger))
+                                         if (!(itVoiceToBeKilled->Type & Voice::type_release_trigger))
-                                     itVoiceToBeKilled->Kill(itNoteOffEventOnKeyList);
+                                             itVoiceToBeKilled->Kill(itNoteOffEventOnKeyList);
+                                     }
+                                 }
                              }
-                         }
+                         } else pChannel->PortamentoPos = -1.0f;
-                     } else pChannel->PortamentoPos = -1.0f;
+                     }
-                 }
-                 // if no solo mode (the usual case) or if solo mode and no other key pressed, then release voices on this key if needed
-                 if (bShouldRelease) {
-                     itNoteOffEventOnKeyList->Type = Event::type_release; // transform event type
-                     // spawn release triggered voice(s) if needed
+                     // if no solo mode (the usual case) or if solo mode and no other key pressed, then release voices on this key if needed
-                     if (pKey->ReleaseTrigger && pChannel->pInstrument) {
+                     if (bShouldRelease) {
-                         TriggerReleaseVoices(pChannel, itNoteOffEventOnKeyList);
+                         itNoteOffEventOnKeyList->Type = Event::type_release_key; // transform event type
-                         pKey->ReleaseTrigger = false;
+                         // spawn release triggered voice(s) if needed
+                         ProcessReleaseTrigger(pChannel, itNoteOffEventOnKeyList, pKey);
+                     }
+                 } else if (itNoteOffEventOnKeyList->Type == Event::type_stop_note) {
+                     // This programmatically caused event is caused by a call to
+                     // the built-in instrument script function note_off(). In
+                     // contrast to a real MIDI note-off event the stop-note
+                     // event just intends to release voices of one particular note.
+                     NoteBase* pNote = pChannel->pEngine->NoteByID( itNoteOffEventOnKeyList->Param.Note.ID );
+                     if (pNote) { // the requested note is still alive ...
+                         itNoteOffEventOnKeyList->Type = Event::type_release_note; // transform event type
+                     } else { // note is dead and gone ..
+                         pKey->pEvents->free(itNoteOffEventOnKeyList); // remove stop-note event from key again
+                         return; // prevent event to be removed a 2nd time below
                      }
                  }
-Line 1317 
 namespace LinuxSampler {
+Line 1909 
 namespace LinuxSampler {
                  if (!pKey->Active && !pKey->VoiceTheftsQueued)
                      pKey->pEvents->free(itNoteOffEventOnKeyList);
-                 pChannel->listeners.PostProcessNoteOff(iKey, vel);
+                 if (isRealMIDINoteOffEvent)
+                     pChannel->listeners.PostProcessNoteOff(iKey, vel);
+             }
+             /**
+              * Called on sustain pedal up events to check and if required,
+              * launch release trigger voices on the respective active key.
+              *
+              * @param pEngineChannel - engine channel on which this event occurred on
+              * @param itEvent - release trigger event (contains note number)
+              */
+             virtual void ProcessReleaseTrigger(EngineChannel* pEngineChannel, RTList<Event>::Iterator& itEvent) OVERRIDE {
+                 EngineChannelBase<V, R, I>* pChannel = static_cast<EngineChannelBase<V, R, I>*>(pEngineChannel);
+                 const int iKey = itEvent->Param.Note.Key;
+                 if (iKey < 0 || iKey > 127) return; // ignore event, key outside allowed key range
+                 MidiKey* pKey = &pChannel->pMIDIKeyInfo[iKey];
+                 ProcessReleaseTrigger(pChannel, itEvent, pKey);
+             }
+             /**
+              * Called on note-off and sustain pedal up events to check and if
+              * required, launch release trigger voices on the respective active
+              * key.
+              *
+              * @param pEngineChannel - engine channel on which this event occurred on
+              * @param itEvent - note off event / release trigger event
+              * @param pKey - key on which the release trigger voices shall be spawned
+              */
+             inline void ProcessReleaseTrigger(EngineChannelBase<V, R, I>* pChannel, RTList<Event>::Iterator& itEvent, MidiKey* pKey) {
+                 // spawn release triggered voice(s) if needed
+                 if (pKey->ReleaseTrigger && pChannel->pInstrument) {
+                     // assign a new note to this release event
+                     if (LaunchNewNote(pChannel, itEvent)) {
+                         // allocate and trigger new release voice(s)
+                         TriggerReleaseVoices(pChannel, itEvent);
+                     }
+                     pKey->ReleaseTrigger = false;
+                 }
+             }
+             /**
+              * Called on "kill note" events, which currently only happens on
+              * built-in real-time instrument script function fade_out(). This
+              * method only fulfills one task: moving the even to the Note's own
+              * event list so that its voices can process the kill event sample
+              * accurately.
+              */
+             void ProcessKillNote(EngineChannel* pEngineChannel, RTList<Event>::Iterator& itEvent) {
+                 EngineChannelBase<V, R, I>* pChannel = static_cast<EngineChannelBase<V, R, I>*>(pEngineChannel);
+                 NoteBase* pNote = pChannel->pEngine->NoteByID( itEvent->Param.Note.ID );
+                 if (!pNote || pNote->hostKey < 0 || pNote->hostKey >= 128) return;
+                 // move note kill event to its MIDI key
+                 MidiKey* pKey = &pChannel->pMIDIKeyInfo[pNote->hostKey];
+                 itEvent.moveToEndOf(pKey->pEvents);
+             }
+             /**
+              * Called on note synthesis parameter change events. These are
+              * internal events caused by calling built-in real-time instrument
+              * script functions like change_vol(), change_tune(), etc.
+              *
+              * This method performs two tasks:
+              *
+              * - It converts the event's relative values changes (Deltas) to
+              *   the respective final new synthesis parameter value (AbsValue),
+              *   for that particular moment of the event that is.
+              *
+              * - It moves the individual events to the Note's own event list
+              *   (or actually to the event list of the MIDI key), so that
+              *   voices can process those events sample accurately.
+              *
+              * @param pEngineChannel - engine channel on which this event occurred on
+              * @param itEvent - note synthesis parameter change event
+              */
+             virtual void ProcessNoteSynthParam(EngineChannel* pEngineChannel, RTList<Event>::Iterator& itEvent) {
+                 EngineChannelBase<V, R, I>* pChannel = static_cast<EngineChannelBase<V, R, I>*>(pEngineChannel);
+                 NoteBase* pNote = pChannel->pEngine->NoteByID( itEvent->Param.NoteSynthParam.NoteID );
+                 if (!pNote || pNote->hostKey < 0 || pNote->hostKey >= 128) return;
+                 const bool& relative = itEvent->Param.NoteSynthParam.Relative;
+                 switch (itEvent->Param.NoteSynthParam.Type) {
+                     case Event::synth_param_volume:
+                         if (relative)
+                             pNote->Override.Volume *= itEvent->Param.NoteSynthParam.Delta;
+                         else
+                             pNote->Override.Volume = itEvent->Param.NoteSynthParam.Delta;
+                         itEvent->Param.NoteSynthParam.AbsValue = pNote->Override.Volume;
+                         break;
+                     case Event::synth_param_volume_time:
+                         pNote->Override.VolumeTime = itEvent->Param.NoteSynthParam.AbsValue = itEvent->Param.NoteSynthParam.Delta;
+                         break;
+                     case Event::synth_param_volume_curve:
+                         itEvent->Param.NoteSynthParam.AbsValue = itEvent->Param.NoteSynthParam.Delta;
+                         pNote->Override.VolumeCurve = (fade_curve_t) itEvent->Param.NoteSynthParam.AbsValue;
+                         break;
+                     case Event::synth_param_pitch:
+                         if (relative)
+                             pNote->Override.Pitch *= itEvent->Param.NoteSynthParam.Delta;
+                         else
+                             pNote->Override.Pitch = itEvent->Param.NoteSynthParam.Delta;
+                         itEvent->Param.NoteSynthParam.AbsValue = pNote->Override.Pitch;
+                         break;
+                     case Event::synth_param_pitch_time:
+                         pNote->Override.PitchTime = itEvent->Param.NoteSynthParam.AbsValue = itEvent->Param.NoteSynthParam.Delta;
+                         break;
+                     case Event::synth_param_pitch_curve:
+                         itEvent->Param.NoteSynthParam.AbsValue = itEvent->Param.NoteSynthParam.Delta;
+                         pNote->Override.PitchCurve = (fade_curve_t) itEvent->Param.NoteSynthParam.AbsValue;
+                         break;
+                     case Event::synth_param_pan:
+                         if (relative) {
+                             pNote->Override.Pan = RTMath::RelativeSummedAvg(pNote->Override.Pan, itEvent->Param.NoteSynthParam.Delta, ++pNote->Override.PanSources);
+                         } else {
+                             pNote->Override.Pan = itEvent->Param.NoteSynthParam.Delta;
+                             pNote->Override.PanSources = 1; // only relevant on subsequent change_pan() instrument script calls on same note with 'relative' argument being set
+                         }
+                         itEvent->Param.NoteSynthParam.AbsValue = pNote->Override.Pan;
+                         break;
+                     case Event::synth_param_cutoff:
+                         pNote->Override.Cutoff = itEvent->Param.NoteSynthParam.AbsValue = itEvent->Param.NoteSynthParam.Delta;
+                         break;
+                     case Event::synth_param_resonance:
+                         pNote->Override.Resonance = itEvent->Param.NoteSynthParam.AbsValue = itEvent->Param.NoteSynthParam.Delta;
+                         break;
+                     case Event::synth_param_attack:
+                         pNote->Override.Attack = itEvent->Param.NoteSynthParam.AbsValue = itEvent->Param.NoteSynthParam.Delta;
+                         break;
+                     case Event::synth_param_decay:
+                         pNote->Override.Decay = itEvent->Param.NoteSynthParam.AbsValue = itEvent->Param.NoteSynthParam.Delta;
+                         break;
+                     case Event::synth_param_release:
+                         pNote->Override.Release = itEvent->Param.NoteSynthParam.AbsValue = itEvent->Param.NoteSynthParam.Delta;
+                         break;
+                     case Event::synth_param_amp_lfo_depth:
+                         pNote->Override.AmpLFODepth = itEvent->Param.NoteSynthParam.AbsValue = itEvent->Param.NoteSynthParam.Delta;
+                         break;
+                     case Event::synth_param_amp_lfo_freq:
+                         pNote->Override.AmpLFOFreq = itEvent->Param.NoteSynthParam.AbsValue = itEvent->Param.NoteSynthParam.Delta;
+                         break;
+                     case Event::synth_param_pitch_lfo_depth:
+                         pNote->Override.PitchLFODepth = itEvent->Param.NoteSynthParam.AbsValue = itEvent->Param.NoteSynthParam.Delta;
+                         break;
+                     case Event::synth_param_pitch_lfo_freq:
+                         pNote->Override.PitchLFOFreq = itEvent->Param.NoteSynthParam.AbsValue = itEvent->Param.NoteSynthParam.Delta;
+                         break;
+                 }
+                 // move note parameter event to its MIDI key
+                 MidiKey* pKey = &pChannel->pMIDIKeyInfo[pNote->hostKey];
+                 itEvent.moveToEndOf(pKey->pEvents);
              }
              /**
               *  Reset all voices and disk thread and clear input event queue and all
               *  control and status variables. This method is protected by a mutex.
               */
-             virtual void ResetInternal() {
+             virtual void ResetInternal() OVERRIDE {
-                 ResetInternalMutex.Lock();
+                 LockGuard lock(ResetInternalMutex);
                  // make sure that the engine does not get any sysex messages
                  // while it's reseting
-Line 1337 
 namespace LinuxSampler {
+Line 2085 
 namespace LinuxSampler {
                  pVoiceStealingQueue->clear();
                  itLastStolenVoice          = VoiceIterator();
                  itLastStolenVoiceGlobally  = VoiceIterator();
+                 itLastStolenNote           = NoteIterator();
+                 itLastStolenNoteGlobally   = NoteIterator();
                  iuiLastStolenKey           = RTList<uint>::Iterator();
                  iuiLastStolenKeyGlobally   = RTList<uint>::Iterator();
                  pLastStolenChannel         = NULL;
+                 // reset all notes
+                 pNotePool->clear();
+                 for (NoteIterator itNote = pNotePool->allocAppend(); itNote;
+                      itNote = pNotePool->allocAppend())
+                 {
+                     itNote->reset();
+                 }
+                 pNotePool->clear();
                  // reset all voices
+                 pVoicePool->clear();
                  for (VoiceIterator iterVoice = pVoicePool->allocAppend(); iterVoice == pVoicePool->last(); iterVoice = pVoicePool->allocAppend()) {
                      iterVoice->Reset();
                  }
                  pVoicePool->clear();
+                 // reset all engine channels
+                 for (int i = 0; i < engineChannels.size(); i++) {
+                     AbstractEngineChannel* pEngineChannel =
+                         static_cast<AbstractEngineChannel*>(engineChannels[i]);
+                     pEngineChannel->ResetInternal(false/*don't reset engine*/);
+                 }
                  // reset disk thread
                  if (pDiskThread) pDiskThread->Reset();
-Line 1354 
 namespace LinuxSampler {
+Line 2121 
 namespace LinuxSampler {
                  pEventQueue->init();
                  pSysexBuffer->init();
                  if (sysexDisabled) MidiInputPort::AddSysexListener(this);
-                 ResetInternalMutex.Unlock();
              }
              /**
-Line 1365 
 namespace LinuxSampler {
+Line 2131 
 namespace LinuxSampler {
               * @param pEngineChannel - engine channel on which all voices should be killed
               * @param itKillEvent    - event which caused this killing of all voices
               */
-             virtual void KillAllVoices(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itKillEvent) {
+             virtual void KillAllVoices(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itKillEvent) OVERRIDE {
                  EngineChannelBase<V, R, I>* pChannel = static_cast<EngineChannelBase<V, R, I>*>(pEngineChannel);
                  int count = pChannel->KillAllVoices(itKillEvent);
                  VoiceSpawnsLeft -= count; //FIXME: just a temporary workaround, we should check the cause in StealVoice() instead
-Line 1376 
 namespace LinuxSampler {
+Line 2142 
 namespace LinuxSampler {
               *  called by the ProcessNoteOn() method and by the voices itself
               *  (e.g. to spawn further voices on the same key for layered sounds).
               *
-              *  @param pEngineChannel      - engine channel on which this event occured on
+              *  @param pEngineChannel      - engine channel on which this event occurred 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)
-Line 1400 
 namespace LinuxSampler {
+Line 2166 
 namespace LinuxSampler {
                  bool                    HandleKeyGroupConflicts
              ) = 0;
-             virtual int GetMinFadeOutSamples() { return MinFadeOutSamples; }
+             virtual int GetMinFadeOutSamples() OVERRIDE { return MinFadeOutSamples; }
              int InitNewVoice (
                  EngineChannelBase<V, R, I>*  pChannel,
-Line 1419 
 namespace LinuxSampler {
+Line 2185 
 namespace LinuxSampler {
                      // launch the new voice
                      if (itNewVoice->Trigger(pChannel, itNoteOnEvent, pChannel->Pitch, pRegion, VoiceType, iKeyGroup) < 0) {
                          dmsg(4,("Voice not triggered\n"));
-                         pKey->pActiveVoices->free(itNewVoice);
+                         GetVoicePool()->free(itNewVoice);
                      }
                      else { // on success
                          --VoiceSpawnsLeft;
-Line 1450 
 namespace LinuxSampler {
+Line 2216 
 namespace LinuxSampler {
                  return -1;
              }
+             /**
+              * Checks whether scale tuning setting has been changed since last
+              * time this method was called, if yes, it recalculates the pitch
+              * for all active voices.
+              */
+             void ProcessScaleTuningChange() {
+                 const bool changed = ScaleTuningChanged.readAndReset();
+                 if (!changed) return;
+                 for (int i = 0; i < engineChannels.size(); i++) {
+                     EngineChannelBase<V, R, I>* channel =
+                         static_cast<EngineChannelBase<V, R, I>*>(engineChannels[i]);
+                     channel->OnScaleTuningChanged();
+                 }
+             }
          private:
+             Pool< Note<V> >* pNotePool;
+             Pool<note_id_t> noteIDPool;
              Pool<V>*    pVoicePool;            ///< Contains all voices that can be activated.
              Pool<RR*>   SuspendedRegions;
              Mutex       SuspendedRegionsMutex;

 Legend:



Removed from v.2410
 


changed lines


 
Added in v.3283
 Legend:



Removed from v.2410
 


changed lines


 
Added in v.3283
-Removed from v.2410
+Added in v.3283

	ViewVC Help
Powered by ViewVC