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

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

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

revision 242 by schoenebeck, Wed Sep 15 13:59:08 2004 UTC revision 554 by schoenebeck, Thu May 19 19:25:14 2005 UTC
# Line 3  Line 3 
3   *   LinuxSampler - modular, streaming capable sampler                     *   *   LinuxSampler - modular, streaming capable sampler                     *
4   *                                                                         *   *                                                                         *
5   *   Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck   *   *   Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck   *
6     *   Copyright (C) 2005 Christian Schoenebeck                              *
7   *                                                                         *   *                                                                         *
8   *   This program is free software; you can redistribute it and/or modify  *   *   This program is free software; you can redistribute it and/or modify  *
9   *   it under the terms of the GNU General Public License as published by  *   *   it under the terms of the GNU General Public License as published by  *
# Line 23  Line 24 
24  #include <sstream>  #include <sstream>
25  #include "DiskThread.h"  #include "DiskThread.h"
26  #include "Voice.h"  #include "Voice.h"
27    #include "EGADSR.h"
28    #include "../EngineFactory.h"
29    
30  #include "Engine.h"  #include "Engine.h"
31    
32    #if defined(__APPLE__)
33    # include <stdlib.h>
34    #else
35    # include <malloc.h>
36    #endif
37    
38  namespace LinuxSampler { namespace gig {  namespace LinuxSampler { namespace gig {
39    
40      InstrumentResourceManager Engine::Instruments;      InstrumentResourceManager Engine::instruments;
41    
42        std::map<AudioOutputDevice*,Engine*> Engine::engines;
43    
44        /**
45         * Get a gig::Engine object for the given gig::EngineChannel and the
46         * given AudioOutputDevice. All engine channels which are connected to
47         * the same audio output device will use the same engine instance. This
48         * method will be called by a gig::EngineChannel whenever it's
49         * connecting to a audio output device.
50         *
51         * @param pChannel - engine channel which acquires an engine object
52         * @param pDevice  - the audio output device \a pChannel is connected to
53         */
54        Engine* Engine::AcquireEngine(LinuxSampler::gig::EngineChannel* pChannel, AudioOutputDevice* pDevice) {
55            Engine* pEngine = NULL;
56            // check if there's already an engine for the given audio output device
57            if (engines.count(pDevice)) {
58                dmsg(4,("Using existing gig::Engine.\n"));
59                pEngine = engines[pDevice];
60            } else { // create a new engine (and disk thread) instance for the given audio output device
61                dmsg(4,("Creating new gig::Engine.\n"));
62                pEngine = (Engine*) EngineFactory::Create("gig");
63                pEngine->Connect(pDevice);
64                engines[pDevice] = pEngine;
65            }
66            // register engine channel to the engine instance
67            pEngine->engineChannels.add(pChannel);
68            // remember index in the ArrayList
69            pChannel->iEngineIndexSelf = pEngine->engineChannels.size() - 1;
70            dmsg(4,("This gig::Engine has now %d EngineChannels.\n",pEngine->engineChannels.size()));
71            return pEngine;
72        }
73    
74        /**
75         * Once an engine channel is disconnected from an audio output device,
76         * it wil immediately call this method to unregister itself from the
77         * engine instance and if that engine instance is not used by any other
78         * engine channel anymore, then that engine instance will be destroyed.
79         *
80         * @param pChannel - engine channel which wants to disconnect from it's
81         *                   engine instance
82         * @param pDevice  - audio output device \a pChannel was connected to
83         */
84        void Engine::FreeEngine(LinuxSampler::gig::EngineChannel* pChannel, AudioOutputDevice* pDevice) {
85            dmsg(4,("Disconnecting EngineChannel from gig::Engine.\n"));
86            Engine* pEngine = engines[pDevice];
87            // unregister EngineChannel from the Engine instance
88            pEngine->engineChannels.remove(pChannel);
89            // if the used Engine instance is not used anymore, then destroy it
90            if (pEngine->engineChannels.empty()) {
91                pDevice->Disconnect(pEngine);
92                engines.erase(pDevice);
93                delete pEngine;
94                dmsg(4,("Destroying gig::Engine.\n"));
95            }
96            else dmsg(4,("This gig::Engine has now %d EngineChannels.\n",pEngine->engineChannels.size()));
97        }
98    
99        /**
100         * Constructor
101         */
102      Engine::Engine() {      Engine::Engine() {
         pRIFF              = NULL;  
         pGig               = NULL;  
         pInstrument        = NULL;  
103          pAudioOutputDevice = NULL;          pAudioOutputDevice = NULL;
104          pDiskThread        = NULL;          pDiskThread        = NULL;
105          pEventGenerator    = NULL;          pEventGenerator    = NULL;
106          pEventQueue        = new RingBuffer<Event>(MAX_EVENTS_PER_FRAGMENT);          pSysexBuffer       = new RingBuffer<uint8_t>(CONFIG_SYSEX_BUFFER_SIZE, 0);
107          pEventPool         = new RTELMemoryPool<Event>(MAX_EVENTS_PER_FRAGMENT);          pEventQueue        = new RingBuffer<Event>(CONFIG_MAX_EVENTS_PER_FRAGMENT, 0);
108          pVoicePool         = new RTELMemoryPool<Voice>(MAX_AUDIO_VOICES);          pEventPool         = new Pool<Event>(CONFIG_MAX_EVENTS_PER_FRAGMENT);
109          pActiveKeys        = new RTELMemoryPool<uint>(128);          pVoicePool         = new Pool<Voice>(CONFIG_MAX_VOICES);
110          pEvents            = new RTEList<Event>(pEventPool);          pVoiceStealingQueue = new RTList<Event>(pEventPool);
111          pCCEvents          = new RTEList<Event>(pEventPool);          pGlobalEvents      = new RTList<Event>(pEventPool);
112          for (uint i = 0; i < Event::destination_count; i++) {          for (RTList<Voice>::Iterator iterVoice = pVoicePool->allocAppend(); iterVoice == pVoicePool->last(); iterVoice = pVoicePool->allocAppend()) {
113              pSynthesisEvents[i] = new RTEList<Event>(pEventPool);              iterVoice->SetEngine(this);
         }  
         for (uint i = 0; i < 128; i++) {  
             pMIDIKeyInfo[i].pActiveVoices  = new RTEList<Voice>(pVoicePool);  
             pMIDIKeyInfo[i].KeyPressed     = false;  
             pMIDIKeyInfo[i].Active         = false;  
             pMIDIKeyInfo[i].ReleaseTrigger = false;  
             pMIDIKeyInfo[i].pSelf          = NULL;  
             pMIDIKeyInfo[i].pEvents        = new RTEList<Event>(pEventPool);  
         }  
         for (Voice* pVoice = pVoicePool->alloc(); pVoice; pVoice = pVoicePool->alloc()) {  
             pVoice->SetEngine(this);  
114          }          }
115          pVoicePool->clear();          pVoicePool->clear();
116    
# Line 63  namespace LinuxSampler { namespace gig { Line 118  namespace LinuxSampler { namespace gig {
118          pBasicFilterParameters  = NULL;          pBasicFilterParameters  = NULL;
119          pMainFilterParameters   = NULL;          pMainFilterParameters   = NULL;
120    
         InstrumentIdx = -1;  
         InstrumentStat = -1;  
   
         AudioDeviceChannelLeft  = -1;  
         AudioDeviceChannelRight = -1;  
   
121          ResetInternal();          ResetInternal();
122      }      }
123    
124        /**
125         * Destructor
126         */
127      Engine::~Engine() {      Engine::~Engine() {
128          if (pDiskThread) {          if (pDiskThread) {
129                dmsg(1,("Stopping disk thread..."));
130              pDiskThread->StopThread();              pDiskThread->StopThread();
131              delete pDiskThread;              delete pDiskThread;
132                dmsg(1,("OK\n"));
133          }          }
         if (pGig)  delete pGig;  
         if (pRIFF) delete pRIFF;  
         for (uint i = 0; i < 128; i++) {  
             if (pMIDIKeyInfo[i].pActiveVoices) delete pMIDIKeyInfo[i].pActiveVoices;  
             if (pMIDIKeyInfo[i].pEvents)       delete pMIDIKeyInfo[i].pEvents;  
         }  
         for (uint i = 0; i < Event::destination_count; i++) {  
             if (pSynthesisEvents[i]) delete pSynthesisEvents[i];  
         }  
         delete[] pSynthesisEvents;  
         if (pEvents)     delete pEvents;  
         if (pCCEvents)   delete pCCEvents;  
134          if (pEventQueue) delete pEventQueue;          if (pEventQueue) delete pEventQueue;
135          if (pEventPool)  delete pEventPool;          if (pEventPool)  delete pEventPool;
136          if (pVoicePool)  delete pVoicePool;          if (pVoicePool) {
137          if (pActiveKeys) delete pActiveKeys;              pVoicePool->clear();
138                delete pVoicePool;
139            }
140          if (pEventGenerator) delete pEventGenerator;          if (pEventGenerator) delete pEventGenerator;
141          if (pMainFilterParameters) delete[] pMainFilterParameters;          if (pMainFilterParameters) delete[] pMainFilterParameters;
142          if (pBasicFilterParameters) delete[] pBasicFilterParameters;          if (pBasicFilterParameters) delete[] pBasicFilterParameters;
143          if (pSynthesisParameters[0]) delete[] pSynthesisParameters[0];          if (pSynthesisParameters[0]) free(pSynthesisParameters[0]);
144            if (pVoiceStealingQueue) delete pVoiceStealingQueue;
145            if (pSysexBuffer) delete pSysexBuffer;
146            EngineFactory::Destroy(this);
147      }      }
148    
149      void Engine::Enable() {      void Engine::Enable() {
# Line 123  namespace LinuxSampler { namespace gig { Line 170  namespace LinuxSampler { namespace gig {
170       */       */
171      void Engine::Reset() {      void Engine::Reset() {
172          DisableAndLock();          DisableAndLock();
   
         //if (pAudioOutputDevice->IsPlaying()) { // if already running  
             /*  
             // signal audio thread not to enter render part anymore  
             SuspensionRequested = true;  
             // sleep until wakened by audio thread  
             pthread_mutex_lock(&__render_state_mutex);  
             pthread_cond_wait(&__render_exit_condition, &__render_state_mutex);  
             pthread_mutex_unlock(&__render_state_mutex);  
             */  
         //}  
   
         //if (wasplaying) pAudioOutputDevice->Stop();  
   
173          ResetInternal();          ResetInternal();
   
         // signal audio thread to continue with rendering  
         //SuspensionRequested = false;  
174          Enable();          Enable();
175      }      }
176    
# Line 149  namespace LinuxSampler { namespace gig { Line 179  namespace LinuxSampler { namespace gig {
179       *  control and status variables. This method is not thread safe!       *  control and status variables. This method is not thread safe!
180       */       */
181      void Engine::ResetInternal() {      void Engine::ResetInternal() {
         Pitch               = 0;  
         SustainPedal        = false;  
182          ActiveVoiceCount    = 0;          ActiveVoiceCount    = 0;
183          ActiveVoiceCountMax = 0;          ActiveVoiceCountMax = 0;
         GlobalVolume        = 1.0;  
184    
185          // set all MIDI controller values to zero          // reset voice stealing parameters
186          memset(ControllerTable, 0x00, 128);          pVoiceStealingQueue->clear();
187            itLastStolenVoice  = RTList<Voice>::Iterator();
188            iuiLastStolenKey   = RTList<uint>::Iterator();
189            pLastStolenChannel = NULL;
190    
191          // reset key info          // reset to normal chromatic scale (means equal temper)
192          for (uint i = 0; i < 128; i++) {          memset(&ScaleTuning[0], 0x00, 12);
             pMIDIKeyInfo[i].pActiveVoices->clear();  
             pMIDIKeyInfo[i].pEvents->clear();  
             pMIDIKeyInfo[i].KeyPressed     = false;  
             pMIDIKeyInfo[i].Active         = false;  
             pMIDIKeyInfo[i].ReleaseTrigger = false;  
             pMIDIKeyInfo[i].pSelf          = NULL;  
         }  
   
         // reset all key groups  
         map<uint,uint*>::iterator iter = ActiveKeyGroups.begin();  
         for (; iter != ActiveKeyGroups.end(); iter++) iter->second = NULL;  
193    
194          // reset all voices          // reset all voices
195          for (Voice* pVoice = pVoicePool->alloc(); pVoice; pVoice = pVoicePool->alloc()) {          for (RTList<Voice>::Iterator iterVoice = pVoicePool->allocAppend(); iterVoice == pVoicePool->last(); iterVoice = pVoicePool->allocAppend()) {
196              pVoice->Reset();              iterVoice->Reset();
197          }          }
198          pVoicePool->clear();          pVoicePool->clear();
199    
         // free all active keys  
         pActiveKeys->clear();  
   
200          // reset disk thread          // reset disk thread
201          if (pDiskThread) pDiskThread->Reset();          if (pDiskThread) pDiskThread->Reset();
202    
# Line 189  namespace LinuxSampler { namespace gig { Line 205  namespace LinuxSampler { namespace gig {
205      }      }
206    
207      /**      /**
208       *  Load an instrument from a .gig file.       * Connect this engine instance with the given audio output device.
209         * This method will be called when an Engine instance is created.
210         * All of the engine's data structures which are dependant to the used
211         * audio output device / driver will be (re)allocated and / or
212         * adjusted appropriately.
213       *       *
214       *  @param FileName   - file name of the Gigasampler instrument file       * @param pAudioOut - audio output device to connect to
      *  @param Instrument - index of the instrument in the .gig file  
      *  @throws LinuxSamplerException  on error  
      *  @returns          detailed description of the method call result  
      */  
     void Engine::LoadInstrument(const char* FileName, uint Instrument) {  
   
         DisableAndLock();  
   
         ResetInternal(); // reset engine  
   
         // free old instrument  
         if (pInstrument) {  
             // give old instrument back to instrument manager  
             Instruments.HandBack(pInstrument, this);  
         }  
   
         InstrumentFile = FileName;  
         InstrumentIdx = Instrument;  
         InstrumentStat = 0;  
   
         // delete all key groups  
         ActiveKeyGroups.clear();  
   
         // request gig instrument from instrument manager  
         try {  
             instrument_id_t instrid;  
             instrid.FileName    = FileName;  
             instrid.iInstrument = Instrument;  
             pInstrument = Instruments.Borrow(instrid, this);  
             if (!pInstrument) {  
                 InstrumentStat = -1;  
                 dmsg(1,("no instrument loaded!!!\n"));  
                 exit(EXIT_FAILURE);  
             }  
         }  
         catch (RIFF::Exception e) {  
             InstrumentStat = -2;  
             String msg = "gig::Engine error: Failed to load instrument, cause: " + e.Message;  
             throw LinuxSamplerException(msg);  
         }  
         catch (InstrumentResourceManagerException e) {  
             InstrumentStat = -3;  
             String msg = "gig::Engine error: Failed to load instrument, cause: " + e.Message();  
             throw LinuxSamplerException(msg);  
         }  
         catch (...) {  
             InstrumentStat = -4;  
             throw LinuxSamplerException("gig::Engine error: Failed to load instrument, cause: Unknown exception while trying to parse gig file.");  
         }  
   
         // rebuild ActiveKeyGroups map with key groups of current instrument  
         for (::gig::Region* pRegion = pInstrument->GetFirstRegion(); pRegion; pRegion = pInstrument->GetNextRegion())  
             if (pRegion->KeyGroup) ActiveKeyGroups[pRegion->KeyGroup] = NULL;  
   
         InstrumentStat = 100;  
   
         // inform audio driver for the need of two channels  
         try {  
             if (pAudioOutputDevice) pAudioOutputDevice->AcquireChannels(2); // gig Engine only stereo  
         }  
         catch (AudioOutputException e) {  
             String msg = "Audio output device unable to provide 2 audio channels, cause: " + e.Message();  
             throw LinuxSamplerException(msg);  
         }  
   
         Enable();  
     }  
   
     /**  
      * Will be called by the InstrumentResourceManager when the instrument  
      * we are currently using in this engine is going to be updated, so we  
      * can stop playback before that happens.  
215       */       */
     void Engine::ResourceToBeUpdated(::gig::Instrument* pResource, void*& pUpdateArg) {  
         dmsg(3,("gig::Engine: Received instrument update message.\n"));  
         DisableAndLock();  
         ResetInternal();  
         this->pInstrument = NULL;  
     }  
   
     /**  
      * Will be called by the InstrumentResourceManager when the instrument  
      * update process was completed, so we can continue with playback.  
      */  
     void Engine::ResourceUpdated(::gig::Instrument* pOldResource, ::gig::Instrument* pNewResource, void* pUpdateArg) {  
         this->pInstrument = pNewResource; //TODO: there are couple of engine parameters we should update here as well if the instrument was updated (see LoadInstrument())  
         Enable();  
     }  
   
216      void Engine::Connect(AudioOutputDevice* pAudioOut) {      void Engine::Connect(AudioOutputDevice* pAudioOut) {
217          pAudioOutputDevice = pAudioOut;          pAudioOutputDevice = pAudioOut;
218    
# Line 295  namespace LinuxSampler { namespace gig { Line 227  namespace LinuxSampler { namespace gig {
227              throw LinuxSamplerException(msg);              throw LinuxSamplerException(msg);
228          }          }
229    
230          this->AudioDeviceChannelLeft  = 0;          this->MaxSamplesPerCycle = pAudioOutputDevice->MaxSamplesPerCycle();
231          this->AudioDeviceChannelRight = 1;          this->SampleRate         = pAudioOutputDevice->SampleRate();
232          this->pOutputLeft             = pAudioOutputDevice->Channel(0)->Buffer();  
233          this->pOutputRight            = pAudioOutputDevice->Channel(1)->Buffer();          // FIXME: audio drivers with varying fragment sizes might be a problem here
234          this->MaxSamplesPerCycle      = pAudioOutputDevice->MaxSamplesPerCycle();          MaxFadeOutPos = MaxSamplesPerCycle - int(double(SampleRate) * CONFIG_EG_MIN_RELEASE_TIME) - 1;
235          this->SampleRate              = pAudioOutputDevice->SampleRate();          if (MaxFadeOutPos < 0)
236                throw LinuxSamplerException("CONFIG_EG_MIN_RELEASE_TIME too big for current audio fragment size / sampling rate!");
237    
238          // (re)create disk thread          // (re)create disk thread
239          if (this->pDiskThread) {          if (this->pDiskThread) {
240                dmsg(1,("Stopping disk thread..."));
241              this->pDiskThread->StopThread();              this->pDiskThread->StopThread();
242              delete this->pDiskThread;              delete this->pDiskThread;
243                dmsg(1,("OK\n"));
244          }          }
245          this->pDiskThread = new DiskThread(((pAudioOut->MaxSamplesPerCycle() << MAX_PITCH) << 1) + 6); //FIXME: assuming stereo          this->pDiskThread = new DiskThread(((pAudioOut->MaxSamplesPerCycle() << CONFIG_MAX_PITCH) << 1) + 6); //FIXME: assuming stereo
246          if (!pDiskThread) {          if (!pDiskThread) {
247              dmsg(0,("gig::Engine  new diskthread = NULL\n"));              dmsg(0,("gig::Engine  new diskthread = NULL\n"));
248              exit(EXIT_FAILURE);              exit(EXIT_FAILURE);
249          }          }
250    
251          for (Voice* pVoice = pVoicePool->alloc(); pVoice; pVoice = pVoicePool->alloc()) {          for (RTList<Voice>::Iterator iterVoice = pVoicePool->allocAppend(); iterVoice == pVoicePool->last(); iterVoice = pVoicePool->allocAppend()) {
252              pVoice->pDiskThread = this->pDiskThread;              iterVoice->pDiskThread = this->pDiskThread;
253              dmsg(3,("d"));              dmsg(3,("d"));
254          }          }
255          pVoicePool->clear();          pVoicePool->clear();
# Line 324  namespace LinuxSampler { namespace gig { Line 259  namespace LinuxSampler { namespace gig {
259          pEventGenerator = new EventGenerator(pAudioOut->SampleRate());          pEventGenerator = new EventGenerator(pAudioOut->SampleRate());
260    
261          // (re)allocate synthesis parameter matrix          // (re)allocate synthesis parameter matrix
262          if (pSynthesisParameters[0]) delete[] pSynthesisParameters[0];          if (pSynthesisParameters[0]) free(pSynthesisParameters[0]);
263          pSynthesisParameters[0] = new float[Event::destination_count * pAudioOut->MaxSamplesPerCycle()];  
264            #if defined(__APPLE__)
265            pSynthesisParameters[0] = (float *) malloc(Event::destination_count * sizeof(float) * pAudioOut->MaxSamplesPerCycle());
266            #else
267            pSynthesisParameters[0] = (float *) memalign(16,(Event::destination_count * sizeof(float) * pAudioOut->MaxSamplesPerCycle()));
268            #endif
269          for (int dst = 1; dst < Event::destination_count; dst++)          for (int dst = 1; dst < Event::destination_count; dst++)
270              pSynthesisParameters[dst] = pSynthesisParameters[dst - 1] + pAudioOut->MaxSamplesPerCycle();              pSynthesisParameters[dst] = pSynthesisParameters[dst - 1] + pAudioOut->MaxSamplesPerCycle();
271    
# Line 339  namespace LinuxSampler { namespace gig { Line 279  namespace LinuxSampler { namespace gig {
279          pDiskThread->StartThread();          pDiskThread->StartThread();
280          dmsg(1,("OK\n"));          dmsg(1,("OK\n"));
281    
282          for (Voice* pVoice = pVoicePool->first(); pVoice; pVoice = pVoicePool->next()) {          for (RTList<Voice>::Iterator iterVoice = pVoicePool->allocAppend(); iterVoice == pVoicePool->last(); iterVoice = pVoicePool->allocAppend()) {
283              if (!pVoice->pDiskThread) {              if (!iterVoice->pDiskThread) {
284                  dmsg(0,("Engine -> voice::trigger: !pDiskThread\n"));                  dmsg(0,("Engine -> voice::trigger: !pDiskThread\n"));
285                  exit(EXIT_FAILURE);                  exit(EXIT_FAILURE);
286              }              }
287          }          }
288      }      }
289    
290      void Engine::DisconnectAudioOutputDevice() {      /**
291          if (pAudioOutputDevice) { // if clause to prevent disconnect loops       * Clear all engine global event lists.
292              AudioOutputDevice* olddevice = pAudioOutputDevice;       */
293              pAudioOutputDevice = NULL;      void Engine::ClearEventLists() {
294              olddevice->Disconnect(this);          pGlobalEvents->clear();
295              AudioDeviceChannelLeft  = -1;      }
296              AudioDeviceChannelRight = -1;  
297        /**
298         * Copy all events from the engine's global input queue buffer to the
299         * engine's internal event list. This will be done at the beginning of
300         * each audio cycle (that is each RenderAudio() call) to distinguish
301         * all global events which have to be processed in the current audio
302         * cycle. These events are usually just SysEx messages. Every
303         * EngineChannel has it's own input event queue buffer and event list
304         * to handle common events like NoteOn, NoteOff and ControlChange
305         * events.
306         *
307         * @param Samples - number of sample points to be processed in the
308         *                  current audio cycle
309         */
310        void Engine::ImportEvents(uint Samples) {
311            RingBuffer<Event>::NonVolatileReader eventQueueReader = pEventQueue->get_non_volatile_reader();
312            Event* pEvent;
313            while (true) {
314                // get next event from input event queue
315                if (!(pEvent = eventQueueReader.pop())) break;
316                // if younger event reached, ignore that and all subsequent ones for now
317                if (pEvent->FragmentPos() >= Samples) {
318                    eventQueueReader--;
319                    dmsg(2,("Younger Event, pos=%d ,Samples=%d!\n",pEvent->FragmentPos(),Samples));
320                    pEvent->ResetFragmentPos();
321                    break;
322                }
323                // copy event to internal event list
324                if (pGlobalEvents->poolIsEmpty()) {
325                    dmsg(1,("Event pool emtpy!\n"));
326                    break;
327                }
328                *pGlobalEvents->allocAppend() = *pEvent;
329          }          }
330            eventQueueReader.free(); // free all copied events from input queue
331      }      }
332    
333      /**      /**
# Line 370  namespace LinuxSampler { namespace gig { Line 343  namespace LinuxSampler { namespace gig {
343      int Engine::RenderAudio(uint Samples) {      int Engine::RenderAudio(uint Samples) {
344          dmsg(5,("RenderAudio(Samples=%d)\n", Samples));          dmsg(5,("RenderAudio(Samples=%d)\n", Samples));
345    
346          // return if no instrument loaded or engine disabled          // return if engine disabled
347          if (EngineDisabled.Pop()) {          if (EngineDisabled.Pop()) {
348              dmsg(5,("gig::Engine: engine disabled (val=%d)\n",EngineDisabled.GetUnsafe()));              dmsg(5,("gig::Engine: engine disabled (val=%d)\n",EngineDisabled.GetUnsafe()));
349              return 0;              return 0;
350          }          }
         if (!pInstrument) {  
             dmsg(5,("gig::Engine: no instrument loaded\n"));  
             return 0;  
         }  
   
351    
352          // empty the event lists for the new fragment          // update time of start and end of this audio fragment (as events' time stamps relate to this)
353          pEvents->clear();          pEventGenerator->UpdateFragmentTime(Samples);
         pCCEvents->clear();  
         for (uint i = 0; i < Event::destination_count; i++) {  
             pSynthesisEvents[i]->clear();  
         }  
354    
355          // read and copy events from input queue          // get all events from the engine's global input event queue which belong to the current fragment
356          Event event = pEventGenerator->CreateEvent();          // (these are usually just SysEx messages)
357          while (true) {          ImportEvents(Samples);
358              if (!pEventQueue->pop(&event)) break;  
359              pEvents->alloc_assign(event);          // process engine global events (these are currently only MIDI System Exclusive messages)
360            {
361                RTList<Event>::Iterator itEvent = pGlobalEvents->first();
362                RTList<Event>::Iterator end     = pGlobalEvents->end();
363                for (; itEvent != end; ++itEvent) {
364                    switch (itEvent->Type) {
365                        case Event::type_sysex:
366                            dmsg(5,("Engine: Sysex received\n"));
367                            ProcessSysex(itEvent);
368                            break;
369                    }
370                }
371          }          }
372    
373            // We only allow a maximum of CONFIG_MAX_VOICES voices to be stolen
374            // in each audio fragment. All subsequent request for spawning new
375            // voices in the same audio fragment will be ignored.
376            VoiceTheftsLeft = CONFIG_MAX_VOICES;
377    
378          // update time of start and end of this audio fragment (as events' time stamps relate to this)          // reset internal voice counter (just for statistic of active voices)
379          pEventGenerator->UpdateFragmentTime(Samples);          ActiveVoiceCountTemp = 0;
380    
381    
382          // process events          // handle events on all engine channels
383          Event* pNextEvent = pEvents->first();          for (int i = 0; i < engineChannels.size(); i++) {
384          while (pNextEvent) {              if (!engineChannels[i]->pInstrument) continue; // ignore if no instrument loaded
385              Event* pEvent = pNextEvent;              ProcessEvents(engineChannels[i], Samples);
             pEvents->set_current(pEvent);  
             pNextEvent = pEvents->next();  
             switch (pEvent->Type) {  
                 case Event::type_note_on:  
                     dmsg(5,("Audio Thread: Note on received\n"));  
                     ProcessNoteOn(pEvent);  
                     break;  
                 case Event::type_note_off:  
                     dmsg(5,("Audio Thread: Note off received\n"));  
                     ProcessNoteOff(pEvent);  
                     break;  
                 case Event::type_control_change:  
                     dmsg(5,("Audio Thread: MIDI CC received\n"));  
                     ProcessControlChange(pEvent);  
                     break;  
                 case Event::type_pitchbend:  
                     dmsg(5,("Audio Thread: Pitchbend received\n"));  
                     ProcessPitchbend(pEvent);  
                     break;  
             }  
386          }          }
387    
388            // render all 'normal', active voices on all engine channels
389            for (int i = 0; i < engineChannels.size(); i++) {
390                if (!engineChannels[i]->pInstrument) continue; // ignore if no instrument loaded
391                RenderActiveVoices(engineChannels[i], Samples);
392            }
393    
394          // render audio from all active voices          // now that all ordinary voices on ALL engine channels are rendered, render new stolen voices
395          int active_voices = 0;          RenderStolenVoices(Samples);
         uint* piKey = pActiveKeys->first();  
         while (piKey) { // iterate through all active keys  
             midi_key_info_t* pKey = &pMIDIKeyInfo[*piKey];  
             pActiveKeys->set_current(piKey);  
             piKey = pActiveKeys->next();  
   
             Voice* pVoiceNext = pKey->pActiveVoices->first();  
             while (pVoiceNext) { // iterate through all voices on this key  
                 // already get next voice on key  
                 Voice* pVoice = pVoiceNext;  
                 pKey->pActiveVoices->set_current(pVoice);  
                 pVoiceNext = pKey->pActiveVoices->next();  
396    
397                  // now render current voice          // handle cleanup on all engine channels for the next audio fragment
398                  pVoice->Render(Samples);          for (int i = 0; i < engineChannels.size(); i++) {
399                  if (pVoice->IsActive()) active_voices++; // still active              if (!engineChannels[i]->pInstrument) continue; // ignore if no instrument loaded
400                  else { // voice reached end, is now inactive              PostProcess(engineChannels[i]);
                     KillVoiceImmediately(pVoice); // remove voice from the list of active voices  
                 }  
             }  
             pKey->pEvents->clear(); // free all events on the key  
401          }          }
402    
403    
404          // write that to the disk thread class so that it can print it          // empty the engine's event list for the next audio fragment
405          // on the console for debugging purposes          ClearEventLists();
         ActiveVoiceCount = active_voices;  
         if (ActiveVoiceCount > ActiveVoiceCountMax) ActiveVoiceCountMax = ActiveVoiceCount;  
406    
407            // reset voice stealing for the next audio fragment
408            pVoiceStealingQueue->clear();
409            itLastStolenVoice  = RTList<Voice>::Iterator();
410            iuiLastStolenKey   = RTList<uint>::Iterator();
411            pLastStolenChannel = NULL;
412    
413            // just some statistics about this engine instance
414            ActiveVoiceCount = ActiveVoiceCountTemp;
415            if (ActiveVoiceCount > ActiveVoiceCountMax) ActiveVoiceCountMax = ActiveVoiceCount;
416    
417          return 0;          return 0;
418      }      }
419    
420      /**      /**
421       *  Will be called by the MIDIIn Thread to let the audio thread trigger a new       * Dispatch and handle all events in this audio fragment for the given
422       *  voice for the given key.       * engine channel.
423       *       *
424       *  @param Key      - MIDI key number of the triggered key       * @param pEngineChannel - engine channel on which events should be
425       *  @param Velocity - MIDI velocity value of the triggered key       *                         processed
426         * @param Samples        - amount of sample points to be processed in
427         *                         this audio fragment cycle
428       */       */
429      void Engine::SendNoteOn(uint8_t Key, uint8_t Velocity) {      void Engine::ProcessEvents(EngineChannel* pEngineChannel, uint Samples) {
430          Event event    = pEventGenerator->CreateEvent();          // get all events from the engine channels's input event queue which belong to the current fragment
431          event.Type     = Event::type_note_on;          // (these are the common events like NoteOn, NoteOff, ControlChange, etc.)
432          event.Key      = Key;          pEngineChannel->ImportEvents(Samples);
433          event.Velocity = Velocity;  
434          if (this->pEventQueue->write_space() > 0) this->pEventQueue->push(&event);          // process events
435          else dmsg(1,("Engine: Input event queue full!"));          {
436                RTList<Event>::Iterator itEvent = pEngineChannel->pEvents->first();
437                RTList<Event>::Iterator end     = pEngineChannel->pEvents->end();
438                for (; itEvent != end; ++itEvent) {
439                    switch (itEvent->Type) {
440                        case Event::type_note_on:
441                            dmsg(5,("Engine: Note on received\n"));
442                            ProcessNoteOn((EngineChannel*)itEvent->pEngineChannel, itEvent);
443                            break;
444                        case Event::type_note_off:
445                            dmsg(5,("Engine: Note off received\n"));
446                            ProcessNoteOff((EngineChannel*)itEvent->pEngineChannel, itEvent);
447                            break;
448                        case Event::type_control_change:
449                            dmsg(5,("Engine: MIDI CC received\n"));
450                            ProcessControlChange((EngineChannel*)itEvent->pEngineChannel, itEvent);
451                            break;
452                        case Event::type_pitchbend:
453                            dmsg(5,("Engine: Pitchbend received\n"));
454                            ProcessPitchbend((EngineChannel*)itEvent->pEngineChannel, itEvent);
455                            break;
456                    }
457                }
458            }
459      }      }
460    
461      /**      /**
462       *  Will be called by the MIDIIn Thread to signal the audio thread to release       * Render all 'normal' voices (that is voices which were not stolen in
463       *  voice(s) on the given key.       * this fragment) on the given engine channel.
464       *       *
465       *  @param Key      - MIDI key number of the released key       * @param pEngineChannel - engine channel on which audio should be
466       *  @param Velocity - MIDI release velocity value of the released key       *                         rendered
467         * @param Samples        - amount of sample points to be rendered in
468         *                         this audio fragment cycle
469       */       */
470      void Engine::SendNoteOff(uint8_t Key, uint8_t Velocity) {      void Engine::RenderActiveVoices(EngineChannel* pEngineChannel, uint Samples) {
471          Event event    = pEventGenerator->CreateEvent();          RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first();
472          event.Type     = Event::type_note_off;          RTList<uint>::Iterator end    = pEngineChannel->pActiveKeys->end();
473          event.Key      = Key;          while (iuiKey != end) { // iterate through all active keys
474          event.Velocity = Velocity;              midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey];
475          if (this->pEventQueue->write_space() > 0) this->pEventQueue->push(&event);              ++iuiKey;
476          else dmsg(1,("Engine: Input event queue full!"));  
477                RTList<Voice>::Iterator itVoice     = pKey->pActiveVoices->first();
478                RTList<Voice>::Iterator itVoicesEnd = pKey->pActiveVoices->end();
479                for (; itVoice != itVoicesEnd; ++itVoice) { // iterate through all voices on this key
480                    // now render current voice
481                    itVoice->Render(Samples);
482                    if (itVoice->IsActive()) ActiveVoiceCountTemp++; // still active
483                    else { // voice reached end, is now inactive
484                        FreeVoice(pEngineChannel, itVoice); // remove voice from the list of active voices
485                    }
486                }
487            }
488      }      }
489    
490      /**      /**
491       *  Will be called by the MIDIIn Thread to signal the audio thread to change       * Render all stolen voices (only voices which were stolen in this
492       *  the pitch value for all voices.       * fragment) on the given engine channel. Stolen voices are rendered
493         * after all normal voices have been rendered; this is needed to render
494         * audio of those voices which were selected for voice stealing until
495         * the point were the stealing (that is the take over of the voice)
496         * actually happened.
497       *       *
498       *  @param Pitch - MIDI pitch value (-8192 ... +8191)       * @param pEngineChannel - engine channel on which audio should be
499         *                         rendered
500         * @param Samples        - amount of sample points to be rendered in
501         *                         this audio fragment cycle
502       */       */
503      void Engine::SendPitchbend(int Pitch) {      void Engine::RenderStolenVoices(uint Samples) {
504          Event event = pEventGenerator->CreateEvent();          RTList<Event>::Iterator itVoiceStealEvent = pVoiceStealingQueue->first();
505          event.Type  = Event::type_pitchbend;          RTList<Event>::Iterator end               = pVoiceStealingQueue->end();
506          event.Pitch = Pitch;          for (; itVoiceStealEvent != end; ++itVoiceStealEvent) {
507          if (this->pEventQueue->write_space() > 0) this->pEventQueue->push(&event);              EngineChannel* pEngineChannel = (EngineChannel*) itVoiceStealEvent->pEngineChannel;
508          else dmsg(1,("Engine: Input event queue full!"));              Pool<Voice>::Iterator itNewVoice =
509                    LaunchVoice(pEngineChannel, itVoiceStealEvent, itVoiceStealEvent->Param.Note.Layer, itVoiceStealEvent->Param.Note.ReleaseTrigger, false);
510                if (itNewVoice) {
511                    itNewVoice->Render(Samples);
512                    if (itNewVoice->IsActive()) ActiveVoiceCountTemp++; // still active
513                    else { // voice reached end, is now inactive
514                        FreeVoice(pEngineChannel, itNewVoice); // remove voice from the list of active voices
515                    }
516                }
517                else dmsg(1,("gig::Engine: ERROR, voice stealing didn't work out!\n"));
518    
519                // we need to clear the key's event list explicitly here in case key was never active
520                midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[itVoiceStealEvent->Param.Note.Key];
521                pKey->VoiceTheftsQueued--;
522                if (!pKey->Active && !pKey->VoiceTheftsQueued) pKey->pEvents->clear();
523            }
524        }
525    
526        /**
527         * Free all keys which have turned inactive in this audio fragment, from
528         * the list of active keys and clear all event lists on that engine
529         * channel.
530         *
531         * @param pEngineChannel - engine channel to cleanup
532         */
533        void Engine::PostProcess(EngineChannel* pEngineChannel) {
534            // free all keys which have no active voices left
535            {
536                RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first();
537                RTList<uint>::Iterator end    = pEngineChannel->pActiveKeys->end();
538                while (iuiKey != end) { // iterate through all active keys
539                    midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey];
540                    ++iuiKey;
541                    if (pKey->pActiveVoices->isEmpty()) FreeKey(pEngineChannel, pKey);
542                    #if CONFIG_DEVMODE
543                    else { // FIXME: should be removed before the final release (purpose: just a sanity check for debugging)
544                        RTList<Voice>::Iterator itVoice     = pKey->pActiveVoices->first();
545                        RTList<Voice>::Iterator itVoicesEnd = pKey->pActiveVoices->end();
546                        for (; itVoice != itVoicesEnd; ++itVoice) { // iterate through all voices on this key
547                            if (itVoice->itKillEvent) {
548                                dmsg(1,("gig::Engine: ERROR, killed voice survived !!!\n"));
549                            }
550                        }
551                    }
552                    #endif // CONFIG_DEVMODE
553                }
554            }
555    
556            // empty the engine channel's own event lists
557            pEngineChannel->ClearEventLists();
558      }      }
559    
560      /**      /**
561       *  Will be called by the MIDIIn Thread to signal the audio thread that a       *  Will be called by the MIDI input device whenever a MIDI system
562       *  continuous controller value has changed.       *  exclusive message has arrived.
563       *       *
564       *  @param Controller - MIDI controller number of the occured control change       *  @param pData - pointer to sysex data
565       *  @param Value      - value of the control change       *  @param Size  - lenght of sysex data (in bytes)
566       */       */
567      void Engine::SendControlChange(uint8_t Controller, uint8_t Value) {      void Engine::SendSysex(void* pData, uint Size) {
568          Event event      = pEventGenerator->CreateEvent();          Event event             = pEventGenerator->CreateEvent();
569          event.Type       = Event::type_control_change;          event.Type              = Event::type_sysex;
570          event.Controller = Controller;          event.Param.Sysex.Size  = Size;
571          event.Value      = Value;          event.pEngineChannel    = NULL; // as Engine global event
572          if (this->pEventQueue->write_space() > 0) this->pEventQueue->push(&event);          if (pEventQueue->write_space() > 0) {
573                if (pSysexBuffer->write_space() >= Size) {
574                    // copy sysex data to input buffer
575                    uint toWrite = Size;
576                    uint8_t* pPos = (uint8_t*) pData;
577                    while (toWrite) {
578                        const uint writeNow = RTMath::Min(toWrite, pSysexBuffer->write_space_to_end());
579                        pSysexBuffer->write(pPos, writeNow);
580                        toWrite -= writeNow;
581                        pPos    += writeNow;
582    
583                    }
584                    // finally place sysex event into input event queue
585                    pEventQueue->push(&event);
586                }
587                else dmsg(1,("Engine: Sysex message too large (%d byte) for input buffer (%d byte)!",Size,CONFIG_SYSEX_BUFFER_SIZE));
588            }
589          else dmsg(1,("Engine: Input event queue full!"));          else dmsg(1,("Engine: Input event queue full!"));
590      }      }
591    
592      /**      /**
593       *  Assigns and triggers a new voice for the respective MIDI key.       *  Assigns and triggers a new voice for the respective MIDI key.
594       *       *
595       *  @param pNoteOnEvent - key, velocity and time stamp of the event       *  @param pEngineChannel - engine channel on which this event occured on
596         *  @param itNoteOnEvent - key, velocity and time stamp of the event
597       */       */
598      void Engine::ProcessNoteOn(Event* pNoteOnEvent) {      void Engine::ProcessNoteOn(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOnEvent) {
599          midi_key_info_t* pKey = &pMIDIKeyInfo[pNoteOnEvent->Key];  
600            const int key = itNoteOnEvent->Param.Note.Key;
601    
602            // Change key dimension value if key is in keyswitching area
603            {
604                const ::gig::Instrument* pInstrument = pEngineChannel->pInstrument;
605                if (key >= pInstrument->DimensionKeyRange.low && key <= pInstrument->DimensionKeyRange.high)
606                    pEngineChannel->CurrentKeyDimension = ((key - pInstrument->DimensionKeyRange.low) * 128) /
607                        (pInstrument->DimensionKeyRange.high - pInstrument->DimensionKeyRange.low + 1);
608            }
609    
610            midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[key];
611    
612          pKey->KeyPressed = true; // the MIDI key was now pressed down          pKey->KeyPressed = true; // the MIDI key was now pressed down
613    
614          // cancel release process of voices on this key if needed          // cancel release process of voices on this key if needed
615          if (pKey->Active && !SustainPedal) {          if (pKey->Active && !pEngineChannel->SustainPedal) {
616              Event* pCancelReleaseEvent = pKey->pEvents->alloc();              RTList<Event>::Iterator itCancelReleaseEvent = pKey->pEvents->allocAppend();
617              if (pCancelReleaseEvent) {              if (itCancelReleaseEvent) {
618                  *pCancelReleaseEvent = *pNoteOnEvent;                  *itCancelReleaseEvent = *itNoteOnEvent;                  // copy event
619                  pCancelReleaseEvent->Type = Event::type_cancel_release; // transform event type                  itCancelReleaseEvent->Type = Event::type_cancel_release; // transform event type
620              }              }
621              else dmsg(1,("Event pool emtpy!\n"));              else dmsg(1,("Event pool emtpy!\n"));
622          }          }
623    
624          // allocate and trigger a new voice for the key          // move note on event to the key's own event list
625          LaunchVoice(pNoteOnEvent);          RTList<Event>::Iterator itNoteOnEventOnKeyList = itNoteOnEvent.moveToEndOf(pKey->pEvents);
626    
627          // finally move note on event to the key's own event list          // allocate and trigger new voice(s) for the key
628          pEvents->move(pNoteOnEvent, pKey->pEvents);          {
629                // first, get total amount of required voices (dependant on amount of layers)
630                ::gig::Region* pRegion = pEngineChannel->pInstrument->GetRegion(itNoteOnEventOnKeyList->Param.Note.Key);
631                if (pRegion) {
632                    int voicesRequired = pRegion->Layers;
633                    // now launch the required amount of voices
634                    for (int i = 0; i < voicesRequired; i++)
635                        LaunchVoice(pEngineChannel, itNoteOnEventOnKeyList, i, false, true);
636                }
637            }
638    
639            // if neither a voice was spawned or postponed then remove note on event from key again
640            if (!pKey->Active && !pKey->VoiceTheftsQueued)
641                pKey->pEvents->free(itNoteOnEventOnKeyList);
642    
643            pKey->RoundRobinIndex++;
644      }      }
645    
646      /**      /**
# Line 557  namespace LinuxSampler { namespace gig { Line 649  namespace LinuxSampler { namespace gig {
649       *  sustain pedal will be released or voice turned inactive by itself (e.g.       *  sustain pedal will be released or voice turned inactive by itself (e.g.
650       *  due to completion of sample playback).       *  due to completion of sample playback).
651       *       *
652       *  @param pNoteOffEvent - key, velocity and time stamp of the event       *  @param pEngineChannel - engine channel on which this event occured on
653         *  @param itNoteOffEvent - key, velocity and time stamp of the event
654       */       */
655      void Engine::ProcessNoteOff(Event* pNoteOffEvent) {      void Engine::ProcessNoteOff(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOffEvent) {
656          midi_key_info_t* pKey = &pMIDIKeyInfo[pNoteOffEvent->Key];          midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[itNoteOffEvent->Param.Note.Key];
657    
658          pKey->KeyPressed = false; // the MIDI key was now released          pKey->KeyPressed = false; // the MIDI key was now released
659    
660          // release voices on this key if needed          // release voices on this key if needed
661          if (pKey->Active && !SustainPedal) {          if (pKey->Active && !pEngineChannel->SustainPedal) {
662              pNoteOffEvent->Type = Event::type_release; // transform event type              itNoteOffEvent->Type = Event::type_release; // transform event type
         }  
663    
664          // spawn release triggered voice(s) if needed              // move event to the key's own event list
665          if (pKey->ReleaseTrigger) {              RTList<Event>::Iterator itNoteOffEventOnKeyList = itNoteOffEvent.moveToEndOf(pKey->pEvents);
666              LaunchVoice(pNoteOffEvent, 0, true);  
667              pKey->ReleaseTrigger = false;              // spawn release triggered voice(s) if needed
668          }              if (pKey->ReleaseTrigger) {
669                    // first, get total amount of required voices (dependant on amount of layers)
670                    ::gig::Region* pRegion = pEngineChannel->pInstrument->GetRegion(itNoteOffEventOnKeyList->Param.Note.Key);
671                    if (pRegion) {
672                        int voicesRequired = pRegion->Layers;
673                        // now launch the required amount of voices
674                        for (int i = 0; i < voicesRequired; i++)
675                            LaunchVoice(pEngineChannel, itNoteOffEventOnKeyList, i, true, false); //FIXME: for the moment we don't perform voice stealing for release triggered samples
676                    }
677                    pKey->ReleaseTrigger = false;
678                }
679    
680          // move event to the key's own event list              // if neither a voice was spawned or postponed then remove note off event from key again
681          pEvents->move(pNoteOffEvent, pKey->pEvents);              if (!pKey->Active && !pKey->VoiceTheftsQueued)
682                    pKey->pEvents->free(itNoteOffEventOnKeyList);
683            }
684      }      }
685    
686      /**      /**
687       *  Moves pitchbend event from the general (input) event list to the pitch       *  Moves pitchbend event from the general (input) event list to the pitch
688       *  event list.       *  event list.
689       *       *
690       *  @param pPitchbendEvent - absolute pitch value and time stamp of the event       *  @param pEngineChannel - engine channel on which this event occured on
691         *  @param itPitchbendEvent - absolute pitch value and time stamp of the event
692       */       */
693      void Engine::ProcessPitchbend(Event* pPitchbendEvent) {      void Engine::ProcessPitchbend(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itPitchbendEvent) {
694          this->Pitch = pPitchbendEvent->Pitch; // store current pitch value          pEngineChannel->Pitch = itPitchbendEvent->Param.Pitch.Pitch; // store current pitch value
695          pEvents->move(pPitchbendEvent, pSynthesisEvents[Event::destination_vco]);          itPitchbendEvent.moveToEndOf(pEngineChannel->pSynthesisEvents[Event::destination_vco]);
696      }      }
697    
698      /**      /**
# Line 595  namespace LinuxSampler { namespace gig { Line 700  namespace LinuxSampler { namespace gig {
700       *  called by the ProcessNoteOn() method and by the voices itself       *  called by the ProcessNoteOn() method and by the voices itself
701       *  (e.g. to spawn further voices on the same key for layered sounds).       *  (e.g. to spawn further voices on the same key for layered sounds).
702       *       *
703       *  @param pNoteOnEvent        - key, velocity and time stamp of the event       *  @param pEngineChannel      - engine channel on which this event occured on
704         *  @param itNoteOnEvent       - key, velocity and time stamp of the event
705       *  @param iLayer              - layer index for the new voice (optional - only       *  @param iLayer              - layer index for the new voice (optional - only
706       *                               in case of layered sounds of course)       *                               in case of layered sounds of course)
707       *  @param ReleaseTriggerVoice - if new voice is a release triggered voice       *  @param ReleaseTriggerVoice - if new voice is a release triggered voice
708       *                               (optional, default = false)       *                               (optional, default = false)
709         *  @param VoiceStealing       - if voice stealing should be performed
710         *                               when there is no free voice
711         *                               (optional, default = true)
712         *  @returns pointer to new voice or NULL if there was no free voice or
713         *           if the voice wasn't triggered (for example when no region is
714         *           defined for the given key).
715       */       */
716      void Engine::LaunchVoice(Event* pNoteOnEvent, int iLayer, bool ReleaseTriggerVoice) {      Pool<Voice>::Iterator Engine::LaunchVoice(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOnEvent, int iLayer, bool ReleaseTriggerVoice, bool VoiceStealing) {
717          midi_key_info_t* pKey = &pMIDIKeyInfo[pNoteOnEvent->Key];          midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[itNoteOnEvent->Param.Note.Key];
718    
719          // allocate a new voice for the key          // allocate a new voice for the key
720          Voice* pNewVoice = pKey->pActiveVoices->alloc();          Pool<Voice>::Iterator itNewVoice = pKey->pActiveVoices->allocAppend();
721          if (pNewVoice) {          if (itNewVoice) {
722              // launch the new voice              // launch the new voice
723              if (pNewVoice->Trigger(pNoteOnEvent, this->Pitch, this->pInstrument, iLayer, ReleaseTriggerVoice) < 0) {              if (itNewVoice->Trigger(pEngineChannel, itNoteOnEvent, pEngineChannel->Pitch, pEngineChannel->pInstrument, iLayer, ReleaseTriggerVoice, VoiceStealing) < 0) {
724                  dmsg(1,("Triggering new voice failed!\n"));                  dmsg(4,("Voice not triggered\n"));
725                  pKey->pActiveVoices->free(pNewVoice);                  pKey->pActiveVoices->free(itNewVoice);
726              }              }
727              else { // on success              else { // on success
728                  uint** ppKeyGroup = NULL;                  uint** ppKeyGroup = NULL;
729                  if (pNewVoice->KeyGroup) { // if this voice / key belongs to a key group                  if (itNewVoice->KeyGroup) { // if this voice / key belongs to a key group
730                      ppKeyGroup = &ActiveKeyGroups[pNewVoice->KeyGroup];                      ppKeyGroup = &pEngineChannel->ActiveKeyGroups[itNewVoice->KeyGroup];
731                      if (*ppKeyGroup) { // if there's already an active key in that key group                      if (*ppKeyGroup) { // if there's already an active key in that key group
732                          midi_key_info_t* pOtherKey = &pMIDIKeyInfo[**ppKeyGroup];                          midi_key_info_t* pOtherKey = &pEngineChannel->pMIDIKeyInfo[**ppKeyGroup];
733                          // kill all voices on the (other) key                          // kill all voices on the (other) key
734                          Voice* pVoiceToBeKilled = pOtherKey->pActiveVoices->first();                          RTList<Voice>::Iterator itVoiceToBeKilled = pOtherKey->pActiveVoices->first();
735                          while (pVoiceToBeKilled) {                          RTList<Voice>::Iterator end               = pOtherKey->pActiveVoices->end();
736                              Voice* pVoiceToBeKilledNext = pOtherKey->pActiveVoices->next();                          for (; itVoiceToBeKilled != end; ++itVoiceToBeKilled) {
737                              if (pVoiceToBeKilled->Type != Voice::type_release_trigger) pVoiceToBeKilled->Kill(pNoteOnEvent);                              if (itVoiceToBeKilled->Type != Voice::type_release_trigger) itVoiceToBeKilled->Kill(itNoteOnEvent);
                             pOtherKey->pActiveVoices->set_current(pVoiceToBeKilled);  
                             pVoiceToBeKilled = pVoiceToBeKilledNext;  
738                          }                          }
739                      }                      }
740                  }                  }
741                  if (!pKey->Active) { // mark as active key                  if (!pKey->Active) { // mark as active key
742                      pKey->Active = true;                      pKey->Active = true;
743                      pKey->pSelf  = pActiveKeys->alloc();                      pKey->itSelf = pEngineChannel->pActiveKeys->allocAppend();
744                      *pKey->pSelf = pNoteOnEvent->Key;                      *pKey->itSelf = itNoteOnEvent->Param.Note.Key;
745                    }
746                    if (itNewVoice->KeyGroup) {
747                        *ppKeyGroup = &*pKey->itSelf; // put key as the (new) active key to its key group
748                    }
749                    if (itNewVoice->Type == Voice::type_release_trigger_required) pKey->ReleaseTrigger = true; // mark key for the need of release triggered voice(s)
750                    return itNewVoice; // success
751                }
752            }
753            else if (VoiceStealing) {
754                // try to steal one voice
755                int result = StealVoice(pEngineChannel, itNoteOnEvent);
756                if (!result) { // voice stolen successfully
757                    // put note-on event into voice-stealing queue, so it will be reprocessed after killed voice died
758                    RTList<Event>::Iterator itStealEvent = pVoiceStealingQueue->allocAppend();
759                    if (itStealEvent) {
760                        *itStealEvent = *itNoteOnEvent; // copy event
761                        itStealEvent->Param.Note.Layer = iLayer;
762                        itStealEvent->Param.Note.ReleaseTrigger = ReleaseTriggerVoice;
763                        pKey->VoiceTheftsQueued++;
764                    }
765                    else dmsg(1,("Voice stealing queue full!\n"));
766                }
767            }
768    
769            return Pool<Voice>::Iterator(); // no free voice or error
770        }
771    
772        /**
773         *  Will be called by LaunchVoice() method in case there are no free
774         *  voices left. This method will select and kill one old voice for
775         *  voice stealing and postpone the note-on event until the selected
776         *  voice actually died.
777         *
778         *  @param pEngineChannel - engine channel on which this event occured on
779         *  @param itNoteOnEvent - key, velocity and time stamp of the event
780         *  @returns 0 on success, a value < 0 if no active voice could be picked for voice stealing
781         */
782        int Engine::StealVoice(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOnEvent) {
783            if (!VoiceTheftsLeft) {
784                dmsg(1,("Max. voice thefts per audio fragment reached (you may raise CONFIG_MAX_VOICES).\n"));
785                return -1;
786            }
787            if (!pEventPool->poolIsEmpty()) {
788    
789                RTList<Voice>::Iterator itSelectedVoice;
790    
791                // Select one voice for voice stealing
792                switch (CONFIG_VOICE_STEAL_ALGO) {
793    
794                    // try to pick the oldest voice on the key where the new
795                    // voice should be spawned, if there is no voice on that
796                    // key, or no voice left to kill there, then procceed with
797                    // 'oldestkey' algorithm
798                    case voice_steal_algo_oldestvoiceonkey: {
799                    #if 0 // FIXME: broken
800                        midi_key_info_t* pSelectedKey = &pEngineChannel->pMIDIKeyInfo[itNoteOnEvent->Param.Note.Key];
801                        if (this->itLastStolenVoice) {
802                            itSelectedVoice = this->itLastStolenVoice;
803                            ++itSelectedVoice;
804                        }
805                        else { // no voice stolen in this audio fragment cycle yet
806                            itSelectedVoice = pSelectedKey->pActiveVoices->first();
807                        }
808                        if (itSelectedVoice) {
809                            iuiSelectedKey = pSelectedKey->itSelf;
810                            break; // selection succeeded
811                        }
812                    #endif
813                    } // no break - intentional !
814    
815                    // try to pick the oldest voice on the oldest active key
816                    // (caution: must stay after 'oldestvoiceonkey' algorithm !)
817                    case voice_steal_algo_oldestkey: {
818                        if (this->itLastStolenVoice) {
819                            itSelectedVoice = this->itLastStolenVoice;
820                            ++itSelectedVoice;
821                            if (itSelectedVoice) break; // selection succeeded
822                            RTList<uint>::Iterator iuiSelectedKey = this->iuiLastStolenKey;
823                            ++iuiSelectedKey;
824                            if (iuiSelectedKey) {
825                                this->iuiLastStolenKey = iuiSelectedKey;
826                                midi_key_info_t* pSelectedKey = &pEngineChannel->pMIDIKeyInfo[*iuiSelectedKey];
827                                itSelectedVoice = pSelectedKey->pActiveVoices->first();
828                                break; // selection succeeded
829                            }
830                        }
831                        break;
832                  }                  }
833                  if (pNewVoice->KeyGroup) {  
834                      *ppKeyGroup = pKey->pSelf; // put key as the (new) active key to its key group                  // don't steal anything
835                    case voice_steal_algo_none:
836                    default: {
837                        dmsg(1,("No free voice (voice stealing disabled)!\n"));
838                        return -1;
839                  }                  }
                 if (pNewVoice->Type == Voice::type_release_trigger_required) pKey->ReleaseTrigger = true; // mark key for the need of release triggered voice(s)  
840              }              }
841    
842                // steal oldest voice on the oldest key from this or any other engine channel
843                if (!itSelectedVoice) {
844                    EngineChannel* pSelectedChannel = (pLastStolenChannel) ? pLastStolenChannel : pEngineChannel;
845                    int iChannelIndex = pSelectedChannel->iEngineIndexSelf;
846                    while (true) {
847                        RTList<uint>::Iterator iuiSelectedKey = pSelectedChannel->pActiveKeys->first();
848                        if (iuiSelectedKey) {
849                            midi_key_info_t* pSelectedKey = &pSelectedChannel->pMIDIKeyInfo[*iuiSelectedKey];
850                            itSelectedVoice    = pSelectedKey->pActiveVoices->first();
851                            iuiLastStolenKey   = iuiSelectedKey;
852                            pLastStolenChannel = pSelectedChannel;
853                            break; // selection succeeded
854                        }
855                        iChannelIndex    = (iChannelIndex + 1) % engineChannels.size();
856                        pSelectedChannel =  engineChannels[iChannelIndex];
857                    }
858                }
859    
860                //FIXME: can be removed, just a sanity check for debugging
861                if (!itSelectedVoice->IsActive()) {
862                    dmsg(1,("gig::Engine: ERROR, tried to steal a voice which was not active !!!\n"));
863                    return -1;
864                }
865    
866                // now kill the selected voice
867                itSelectedVoice->Kill(itNoteOnEvent);
868    
869                // remember which voice we stole, so we can simply proceed for the next voice stealing
870                itLastStolenVoice = itSelectedVoice;
871    
872                --VoiceTheftsLeft;
873    
874                return 0; // success
875            }
876            else {
877                dmsg(1,("Event pool emtpy!\n"));
878                return -1;
879          }          }
         else std::cerr << "No free voice!" << std::endl << std::flush;  
880      }      }
881    
882      /**      /**
883       *  Immediately kills the voice given with pVoice (no matter if sustain is       *  Removes the given voice from the MIDI key's list of active voices.
884       *  pressed or not) and removes it from the MIDI key's list of active voice.       *  This method will be called when a voice went inactive, e.g. because
885       *  This method will e.g. be called if a voice went inactive by itself.       *  it finished to playback its sample, finished its release stage or
886         *  just was killed.
887       *       *
888       *  @param pVoice - points to the voice to be killed       *  @param pEngineChannel - engine channel on which this event occured on
889         *  @param itVoice - points to the voice to be freed
890       */       */
891      void Engine::KillVoiceImmediately(Voice* pVoice) {      void Engine::FreeVoice(EngineChannel* pEngineChannel, Pool<Voice>::Iterator& itVoice) {
892          if (pVoice) {          if (itVoice) {
893              if (pVoice->IsActive()) pVoice->KillImmediately();              midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[itVoice->MIDIKey];
894    
895              midi_key_info_t* pKey = &pMIDIKeyInfo[pVoice->MIDIKey];              uint keygroup = itVoice->KeyGroup;
896    
897              // free the voice object              // free the voice object
898              pVoicePool->free(pVoice);              pVoicePool->free(itVoice);
899    
900              // check if there are no voices left on the MIDI key and update the key info if so              // if no other voices left and member of a key group, remove from key group
901              if (pKey->pActiveVoices->is_empty()) {              if (pKey->pActiveVoices->isEmpty() && keygroup) {
902                  if (pVoice->KeyGroup) { // if voice / key belongs to a key group                  uint** ppKeyGroup = &pEngineChannel->ActiveKeyGroups[keygroup];
903                      uint** ppKeyGroup = &ActiveKeyGroups[pVoice->KeyGroup];                  if (*ppKeyGroup == &*pKey->itSelf) *ppKeyGroup = NULL; // remove key from key group
                     if (*ppKeyGroup == pKey->pSelf) *ppKeyGroup = NULL; // remove key from key group  
                 }  
                 pKey->Active = false;  
                 pActiveKeys->free(pKey->pSelf); // remove key from list of active keys  
                 pKey->pSelf = NULL;  
                 pKey->ReleaseTrigger = false;  
                 dmsg(3,("Key has no more voices now\n"));  
904              }              }
905          }          }
906          else std::cerr << "Couldn't release voice! (pVoice == NULL)\n" << std::flush;          else std::cerr << "Couldn't release voice! (!itVoice)\n" << std::flush;
907        }
908    
909        /**
910         *  Called when there's no more voice left on a key, this call will
911         *  update the key info respectively.
912         *
913         *  @param pEngineChannel - engine channel on which this event occured on
914         *  @param pKey - key which is now inactive
915         */
916        void Engine::FreeKey(EngineChannel* pEngineChannel, midi_key_info_t* pKey) {
917            if (pKey->pActiveVoices->isEmpty()) {
918                pKey->Active = false;
919                pEngineChannel->pActiveKeys->free(pKey->itSelf); // remove key from list of active keys
920                pKey->itSelf = RTList<uint>::Iterator();
921                pKey->ReleaseTrigger = false;
922                pKey->pEvents->clear();
923                dmsg(3,("Key has no more voices now\n"));
924            }
925            else dmsg(1,("gig::Engine: Oops, tried to free a key which contains voices.\n"));
926      }      }
927    
928      /**      /**
929       *  Reacts on supported control change commands (e.g. pitch bend wheel,       *  Reacts on supported control change commands (e.g. pitch bend wheel,
930       *  modulation wheel, aftertouch).       *  modulation wheel, aftertouch).
931       *       *
932       *  @param pControlChangeEvent - controller, value and time stamp of the event       *  @param pEngineChannel - engine channel on which this event occured on
933         *  @param itControlChangeEvent - controller, value and time stamp of the event
934       */       */
935      void Engine::ProcessControlChange(Event* pControlChangeEvent) {      void Engine::ProcessControlChange(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itControlChangeEvent) {
936          dmsg(4,("Engine::ContinuousController cc=%d v=%d\n", pControlChangeEvent->Controller, pControlChangeEvent->Value));          dmsg(4,("Engine::ContinuousController cc=%d v=%d\n", itControlChangeEvent->Param.CC.Controller, itControlChangeEvent->Param.CC.Value));
937    
938          switch (pControlChangeEvent->Controller) {          // update controller value in the engine channel's controller table
939              case 64: {          pEngineChannel->ControllerTable[itControlChangeEvent->Param.CC.Controller] = itControlChangeEvent->Param.CC.Value;
940                  if (pControlChangeEvent->Value >= 64 && !SustainPedal) {  
941            // move event from the unsorted event list to the control change event list
942            Pool<Event>::Iterator itControlChangeEventOnCCList = itControlChangeEvent.moveToEndOf(pEngineChannel->pCCEvents);
943    
944            switch (itControlChangeEventOnCCList->Param.CC.Controller) {
945                case 7: { // volume
946                    //TODO: not sample accurate yet
947                    pEngineChannel->GlobalVolume = (float) itControlChangeEventOnCCList->Param.CC.Value / 127.0f;
948                    break;
949                }
950                case 10: { // panpot
951                    //TODO: not sample accurate yet
952                    const int pan = (int) itControlChangeEventOnCCList->Param.CC.Value - 64;
953                    pEngineChannel->GlobalPanLeft  = 1.0f - float(RTMath::Max(pan, 0)) /  63.0f;
954                    pEngineChannel->GlobalPanRight = 1.0f - float(RTMath::Min(pan, 0)) / -64.0f;
955                    break;
956                }
957                case 64: { // sustain
958                    if (itControlChangeEventOnCCList->Param.CC.Value >= 64 && !pEngineChannel->SustainPedal) {
959                      dmsg(4,("PEDAL DOWN\n"));                      dmsg(4,("PEDAL DOWN\n"));
960                      SustainPedal = true;                      pEngineChannel->SustainPedal = true;
961    
962                      // cancel release process of voices if necessary                      // cancel release process of voices if necessary
963                      uint* piKey = pActiveKeys->first();                      RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first();
964                      if (piKey) {                      for (; iuiKey; ++iuiKey) {
965                          pControlChangeEvent->Type = Event::type_cancel_release; // transform event type                          midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey];
966                          while (piKey) {                          if (!pKey->KeyPressed) {
967                              midi_key_info_t* pKey = &pMIDIKeyInfo[*piKey];                              RTList<Event>::Iterator itNewEvent = pKey->pEvents->allocAppend();
968                              pActiveKeys->set_current(piKey);                              if (itNewEvent) {
969                              piKey = pActiveKeys->next();                                  *itNewEvent = *itControlChangeEventOnCCList; // copy event to the key's own event list
970                              if (!pKey->KeyPressed) {                                  itNewEvent->Type = Event::type_cancel_release; // transform event type
                                 Event* pNewEvent = pKey->pEvents->alloc();  
                                 if (pNewEvent) *pNewEvent = *pControlChangeEvent; // copy event to the key's own event list  
                                 else dmsg(1,("Event pool emtpy!\n"));  
971                              }                              }
972                                else dmsg(1,("Event pool emtpy!\n"));
973                          }                          }
974                      }                      }
975                  }                  }
976                  if (pControlChangeEvent->Value < 64 && SustainPedal) {                  if (itControlChangeEventOnCCList->Param.CC.Value < 64 && pEngineChannel->SustainPedal) {
977                      dmsg(4,("PEDAL UP\n"));                      dmsg(4,("PEDAL UP\n"));
978                      SustainPedal = false;                      pEngineChannel->SustainPedal = false;
979    
980                      // release voices if their respective key is not pressed                      // release voices if their respective key is not pressed
981                      uint* piKey = pActiveKeys->first();                      RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first();
982                      if (piKey) {                      for (; iuiKey; ++iuiKey) {
983                          pControlChangeEvent->Type = Event::type_release; // transform event type                          midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey];
984                          while (piKey) {                          if (!pKey->KeyPressed) {
985                              midi_key_info_t* pKey = &pMIDIKeyInfo[*piKey];                              RTList<Event>::Iterator itNewEvent = pKey->pEvents->allocAppend();
986                              pActiveKeys->set_current(piKey);                              if (itNewEvent) {
987                              piKey = pActiveKeys->next();                                  *itNewEvent = *itControlChangeEventOnCCList; // copy event to the key's own event list
988                              if (!pKey->KeyPressed) {                                  itNewEvent->Type = Event::type_release; // transform event type
                                 Event* pNewEvent = pKey->pEvents->alloc();  
                                 if (pNewEvent) *pNewEvent = *pControlChangeEvent; // copy event to the key's own event list  
                                 else dmsg(1,("Event pool emtpy!\n"));  
989                              }                              }
990                                else dmsg(1,("Event pool emtpy!\n"));
991                          }                          }
992                      }                      }
993                  }                  }
994                  break;                  break;
995              }              }
         }  
996    
         // update controller value in the engine's controller table  
         ControllerTable[pControlChangeEvent->Controller] = pControlChangeEvent->Value;  
997    
998          // move event from the unsorted event list to the control change event list              // Channel Mode Messages
999          pEvents->move(pControlChangeEvent, pCCEvents);  
1000                case 120: { // all sound off
1001                    KillAllVoices(pEngineChannel, itControlChangeEventOnCCList);
1002                    break;
1003                }
1004                case 121: { // reset all controllers
1005                    pEngineChannel->ResetControllers();
1006                    break;
1007                }
1008                case 123: { // all notes off
1009                    ReleaseAllVoices(pEngineChannel, itControlChangeEventOnCCList);
1010                    break;
1011                }
1012            }
1013      }      }
1014    
1015      /**      /**
1016       * Initialize the parameter sequence for the modulation destination given by       *  Reacts on MIDI system exclusive messages.
1017       * by 'dst' with the constant value given by val.       *
1018         *  @param itSysexEvent - sysex data size and time stamp of the sysex event
1019       */       */
1020      void Engine::ResetSynthesisParameters(Event::destination_t dst, float val) {      void Engine::ProcessSysex(Pool<Event>::Iterator& itSysexEvent) {
1021          int maxsamples = pAudioOutputDevice->MaxSamplesPerCycle();          RingBuffer<uint8_t>::NonVolatileReader reader = pSysexBuffer->get_non_volatile_reader();
1022          float* m = &pSynthesisParameters[dst][0];  
1023          for (int i = 0; i < maxsamples; i += 4) {          uint8_t exclusive_status, id;
1024             m[i]   = val;          if (!reader.pop(&exclusive_status)) goto free_sysex_data;
1025             m[i+1] = val;          if (!reader.pop(&id))               goto free_sysex_data;
1026             m[i+2] = val;          if (exclusive_status != 0xF0)       goto free_sysex_data;
1027             m[i+3] = val;  
1028            switch (id) {
1029                case 0x41: { // Roland
1030                    dmsg(3,("Roland Sysex\n"));
1031                    uint8_t device_id, model_id, cmd_id;
1032                    if (!reader.pop(&device_id)) goto free_sysex_data;
1033                    if (!reader.pop(&model_id))  goto free_sysex_data;
1034                    if (!reader.pop(&cmd_id))    goto free_sysex_data;
1035                    if (model_id != 0x42 /*GS*/) goto free_sysex_data;
1036                    if (cmd_id != 0x12 /*DT1*/)  goto free_sysex_data;
1037    
1038                    // command address
1039                    uint8_t addr[3]; // 2 byte addr MSB, followed by 1 byte addr LSB)
1040                    const RingBuffer<uint8_t>::NonVolatileReader checksum_reader = reader; // so we can calculate the check sum later
1041                    if (reader.read(&addr[0], 3) != 3) goto free_sysex_data;
1042                    if (addr[0] == 0x40 && addr[1] == 0x00) { // System Parameters
1043                        dmsg(3,("\tSystem Parameter\n"));
1044                    }
1045                    else if (addr[0] == 0x40 && addr[1] == 0x01) { // Common Parameters
1046                        dmsg(3,("\tCommon Parameter\n"));
1047                    }
1048                    else if (addr[0] == 0x40 && (addr[1] & 0xf0) == 0x10) { // Part Parameters (1)
1049                        dmsg(3,("\tPart Parameter\n"));
1050                        switch (addr[2]) {
1051                            case 0x40: { // scale tuning
1052                                dmsg(3,("\t\tScale Tuning\n"));
1053                                uint8_t scale_tunes[12]; // detuning of all 12 semitones of an octave
1054                                if (reader.read(&scale_tunes[0], 12) != 12) goto free_sysex_data;
1055                                uint8_t checksum;
1056                                if (!reader.pop(&checksum)) goto free_sysex_data;
1057                                // some are not sending a GS checksum, so we ignore it for now
1058                                //if (GSCheckSum(checksum_reader, 12)) goto free_sysex_data;
1059                                for (int i = 0; i < 12; i++) scale_tunes[i] -= 64;
1060                                AdjustScale((int8_t*) scale_tunes);
1061                                dmsg(3,("\t\t\tNew scale applied.\n"));
1062                                break;
1063                            }
1064                        }
1065                    }
1066                    else if (addr[0] == 0x40 && (addr[1] & 0xf0) == 0x20) { // Part Parameters (2)
1067                    }
1068                    else if (addr[0] == 0x41) { // Drum Setup Parameters
1069                    }
1070                    break;
1071                }
1072          }          }
1073    
1074            free_sysex_data: // finally free sysex data
1075            pSysexBuffer->increment_read_ptr(itSysexEvent->Param.Sysex.Size);
1076      }      }
1077    
1078      float Engine::Volume() {      /**
1079          return GlobalVolume;       * Calculates the Roland GS sysex check sum.
1080         *
1081         * @param AddrReader - reader which currently points to the first GS
1082         *                     command address byte of the GS sysex message in
1083         *                     question
1084         * @param DataSize   - size of the GS message data (in bytes)
1085         */
1086        uint8_t Engine::GSCheckSum(const RingBuffer<uint8_t>::NonVolatileReader AddrReader, uint DataSize) {
1087            RingBuffer<uint8_t>::NonVolatileReader reader = AddrReader;
1088            uint bytes = 3 /*addr*/ + DataSize;
1089            uint8_t addr_and_data[bytes];
1090            reader.read(&addr_and_data[0], bytes);
1091            uint8_t sum = 0;
1092            for (uint i = 0; i < bytes; i++) sum += addr_and_data[i];
1093            return 128 - sum % 128;
1094      }      }
1095    
1096      void Engine::Volume(float f) {      /**
1097          GlobalVolume = f;       * Allows to tune each of the twelve semitones of an octave.
1098         *
1099         * @param ScaleTunes - detuning of all twelve semitones (in cents)
1100         */
1101        void Engine::AdjustScale(int8_t ScaleTunes[12]) {
1102            memcpy(&this->ScaleTuning[0], &ScaleTunes[0], 12); //TODO: currently not sample accurate
1103      }      }
1104    
1105      uint Engine::Channels() {      /**
1106          return 2;       * Releases all voices on an engine channel. All voices will go into
1107         * the release stage and thus it might take some time (e.g. dependant to
1108         * their envelope release time) until they actually die.
1109         *
1110         * @param pEngineChannel - engine channel on which all voices should be released
1111         * @param itReleaseEvent - event which caused this releasing of all voices
1112         */
1113        void Engine::ReleaseAllVoices(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itReleaseEvent) {
1114            RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first();
1115            while (iuiKey) {
1116                midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey];
1117                ++iuiKey;
1118                // append a 'release' event to the key's own event list
1119                RTList<Event>::Iterator itNewEvent = pKey->pEvents->allocAppend();
1120                if (itNewEvent) {
1121                    *itNewEvent = *itReleaseEvent; // copy original event (to the key's event list)
1122                    itNewEvent->Type = Event::type_release; // transform event type
1123                }
1124                else dmsg(1,("Event pool emtpy!\n"));
1125            }
1126      }      }
1127    
1128      void Engine::SetOutputChannel(uint EngineAudioChannel, uint AudioDeviceChannel) {      /**
1129          AudioChannel* pChannel = pAudioOutputDevice->Channel(AudioDeviceChannel);       * Kills all voices on an engine channel as soon as possible. Voices
1130          if (!pChannel) throw AudioOutputException("Invalid audio output device channel " + ToString(AudioDeviceChannel));       * won't get into release state, their volume level will be ramped down
1131          switch (EngineAudioChannel) {       * as fast as possible.
1132              case 0: // left output channel       *
1133                  pOutputLeft = pChannel->Buffer();       * @param pEngineChannel - engine channel on which all voices should be killed
1134                  AudioDeviceChannelLeft = AudioDeviceChannel;       * @param itKillEvent    - event which caused this killing of all voices
1135                  break;       */
1136              case 1: // right output channel      void Engine::KillAllVoices(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itKillEvent) {
1137                  pOutputRight = pChannel->Buffer();          RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first();
1138                  AudioDeviceChannelRight = AudioDeviceChannel;          RTList<uint>::Iterator end    = pEngineChannel->pActiveKeys->end();
1139                  break;          while (iuiKey != end) { // iterate through all active keys
1140              default:              midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey];
1141                  throw AudioOutputException("Invalid engine audio channel " + ToString(EngineAudioChannel));              ++iuiKey;
1142                RTList<Voice>::Iterator itVoice     = pKey->pActiveVoices->first();
1143                RTList<Voice>::Iterator itVoicesEnd = pKey->pActiveVoices->end();
1144                for (; itVoice != itVoicesEnd; ++itVoice) { // iterate through all voices on this key
1145                    itVoice->Kill(itKillEvent);
1146                }
1147          }          }
1148      }      }
1149    
1150      int Engine::OutputChannel(uint EngineAudioChannel) {      /**
1151          switch (EngineAudioChannel) {       * Initialize the parameter sequence for the modulation destination given by
1152              case 0: // left channel       * by 'dst' with the constant value given by val.
1153                  return AudioDeviceChannelLeft;       */
1154              case 1: // right channel      void Engine::ResetSynthesisParameters(Event::destination_t dst, float val) {
1155                  return AudioDeviceChannelRight;          int maxsamples = pAudioOutputDevice->MaxSamplesPerCycle();
1156              default:          float* m = &pSynthesisParameters[dst][0];
1157                  throw AudioOutputException("Invalid engine audio channel " + ToString(EngineAudioChannel));          for (int i = 0; i < maxsamples; i += 4) {
1158               m[i]   = val;
1159               m[i+1] = val;
1160               m[i+2] = val;
1161               m[i+3] = val;
1162          }          }
1163      }      }
1164    
# Line 820  namespace LinuxSampler { namespace gig { Line 1191  namespace LinuxSampler { namespace gig {
1191      }      }
1192    
1193      String Engine::EngineName() {      String Engine::EngineName() {
1194          return "GigEngine";          return LS_GIG_ENGINE_NAME;
     }  
   
     String Engine::InstrumentFileName() {  
         return InstrumentFile;  
     }  
   
     int Engine::InstrumentIndex() {  
         return InstrumentIdx;  
     }  
   
     int Engine::InstrumentStatus() {  
         return InstrumentStat;  
1195      }      }
1196    
1197      String Engine::Description() {      String Engine::Description() {
# Line 840  namespace LinuxSampler { namespace gig { Line 1199  namespace LinuxSampler { namespace gig {
1199      }      }
1200    
1201      String Engine::Version() {      String Engine::Version() {
1202          String s = "$Revision: 1.11 $";          String s = "$Revision: 1.37 $";
1203          return s.substr(11, s.size() - 13); // cut dollar signs, spaces and CVS macro keyword          return s.substr(11, s.size() - 13); // cut dollar signs, spaces and CVS macro keyword
1204      }      }
1205    

Legend:
Removed from v.242  
changed lines
  Added in v.554

  ViewVC Help
Powered by ViewVC