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

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

Parent Directory Parent Directory | Revision Log Revision Log


Revision 659 - (show annotations) (download)
Thu Jun 16 21:35:30 2005 UTC (13 years, 2 months ago) by schoenebeck
File size: 59523 byte(s)
* don't reset scale tuning on instrument or audio output device change

1 /***************************************************************************
2 * *
3 * LinuxSampler - modular, streaming capable sampler *
4 * *
5 * 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 *
9 * it under the terms of the GNU General Public License as published by *
10 * the Free Software Foundation; either version 2 of the License, or *
11 * (at your option) any later version. *
12 * *
13 * This program is distributed in the hope that it will be useful, *
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
16 * GNU General Public License for more details. *
17 * *
18 * You should have received a copy of the GNU General Public License *
19 * along with this program; if not, write to the Free Software *
20 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, *
21 * MA 02111-1307 USA *
22 ***************************************************************************/
23
24 #include <sstream>
25 #include "DiskThread.h"
26 #include "Voice.h"
27 #include "EGADSR.h"
28 #include "../EngineFactory.h"
29
30 #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 {
39
40 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() {
103 pAudioOutputDevice = NULL;
104 pDiskThread = NULL;
105 pEventGenerator = NULL;
106 pSysexBuffer = new RingBuffer<uint8_t>(CONFIG_SYSEX_BUFFER_SIZE, 0);
107 pEventQueue = new RingBuffer<Event>(CONFIG_MAX_EVENTS_PER_FRAGMENT, 0);
108 pEventPool = new Pool<Event>(CONFIG_MAX_EVENTS_PER_FRAGMENT);
109 pVoicePool = new Pool<Voice>(CONFIG_MAX_VOICES);
110 pVoiceStealingQueue = new RTList<Event>(pEventPool);
111 pGlobalEvents = new RTList<Event>(pEventPool);
112 for (RTList<Voice>::Iterator iterVoice = pVoicePool->allocAppend(); iterVoice == pVoicePool->last(); iterVoice = pVoicePool->allocAppend()) {
113 iterVoice->SetEngine(this);
114 }
115 pVoicePool->clear();
116
117 pSynthesisParameters[0] = NULL; // we allocate when an audio device is connected
118 pBasicFilterParameters = NULL;
119 pMainFilterParameters = NULL;
120
121 ResetInternal();
122 ResetScaleTuning();
123 }
124
125 /**
126 * Destructor
127 */
128 Engine::~Engine() {
129 if (pDiskThread) {
130 dmsg(1,("Stopping disk thread..."));
131 pDiskThread->StopThread();
132 delete pDiskThread;
133 dmsg(1,("OK\n"));
134 }
135 if (pEventQueue) delete pEventQueue;
136 if (pEventPool) delete pEventPool;
137 if (pVoicePool) {
138 pVoicePool->clear();
139 delete pVoicePool;
140 }
141 if (pEventGenerator) delete pEventGenerator;
142 if (pMainFilterParameters) delete[] pMainFilterParameters;
143 if (pBasicFilterParameters) delete[] pBasicFilterParameters;
144 if (pSynthesisParameters[0]) free(pSynthesisParameters[0]);
145 if (pVoiceStealingQueue) delete pVoiceStealingQueue;
146 if (pSysexBuffer) delete pSysexBuffer;
147 EngineFactory::Destroy(this);
148 }
149
150 void Engine::Enable() {
151 dmsg(3,("gig::Engine: enabling\n"));
152 EngineDisabled.PushAndUnlock(false, 2); // set condition object 'EngineDisabled' to false (wait max. 2s)
153 dmsg(3,("gig::Engine: enabled (val=%d)\n", EngineDisabled.GetUnsafe()));
154 }
155
156 void Engine::Disable() {
157 dmsg(3,("gig::Engine: disabling\n"));
158 bool* pWasDisabled = EngineDisabled.PushAndUnlock(true, 2); // wait max. 2s
159 if (!pWasDisabled) dmsg(3,("gig::Engine warning: Timeout waiting to disable engine.\n"));
160 }
161
162 void Engine::DisableAndLock() {
163 dmsg(3,("gig::Engine: disabling\n"));
164 bool* pWasDisabled = EngineDisabled.Push(true, 2); // wait max. 2s
165 if (!pWasDisabled) dmsg(3,("gig::Engine warning: Timeout waiting to disable engine.\n"));
166 }
167
168 /**
169 * Reset all voices and disk thread and clear input event queue and all
170 * control and status variables.
171 */
172 void Engine::Reset() {
173 DisableAndLock();
174 ResetInternal();
175 ResetScaleTuning();
176 Enable();
177 }
178
179 /**
180 * Reset all voices and disk thread and clear input event queue and all
181 * control and status variables. This method is not thread safe!
182 */
183 void Engine::ResetInternal() {
184 ActiveVoiceCount = 0;
185 ActiveVoiceCountMax = 0;
186
187 // reset voice stealing parameters
188 pVoiceStealingQueue->clear();
189 itLastStolenVoice = RTList<Voice>::Iterator();
190 itLastStolenVoiceGlobally = RTList<Voice>::Iterator();
191 iuiLastStolenKey = RTList<uint>::Iterator();
192 iuiLastStolenKeyGlobally = RTList<uint>::Iterator();
193 pLastStolenChannel = NULL;
194
195 // reset all voices
196 for (RTList<Voice>::Iterator iterVoice = pVoicePool->allocAppend(); iterVoice == pVoicePool->last(); iterVoice = pVoicePool->allocAppend()) {
197 iterVoice->Reset();
198 }
199 pVoicePool->clear();
200
201 // reset disk thread
202 if (pDiskThread) pDiskThread->Reset();
203
204 // delete all input events
205 pEventQueue->init();
206 }
207
208 /**
209 * Reset to normal, chromatic scale (means equal tempered).
210 */
211 void Engine::ResetScaleTuning() {
212 memset(&ScaleTuning[0], 0x00, 12);
213 }
214
215 /**
216 * Connect this engine instance with the given audio output device.
217 * This method will be called when an Engine instance is created.
218 * All of the engine's data structures which are dependant to the used
219 * audio output device / driver will be (re)allocated and / or
220 * adjusted appropriately.
221 *
222 * @param pAudioOut - audio output device to connect to
223 */
224 void Engine::Connect(AudioOutputDevice* pAudioOut) {
225 pAudioOutputDevice = pAudioOut;
226
227 ResetInternal();
228
229 // inform audio driver for the need of two channels
230 try {
231 pAudioOutputDevice->AcquireChannels(2); // gig engine only stereo
232 }
233 catch (AudioOutputException e) {
234 String msg = "Audio output device unable to provide 2 audio channels, cause: " + e.Message();
235 throw LinuxSamplerException(msg);
236 }
237
238 this->MaxSamplesPerCycle = pAudioOutputDevice->MaxSamplesPerCycle();
239 this->SampleRate = pAudioOutputDevice->SampleRate();
240
241 // FIXME: audio drivers with varying fragment sizes might be a problem here
242 MaxFadeOutPos = MaxSamplesPerCycle - int(double(SampleRate) * CONFIG_EG_MIN_RELEASE_TIME) - 1;
243 if (MaxFadeOutPos < 0)
244 throw LinuxSamplerException("CONFIG_EG_MIN_RELEASE_TIME too big for current audio fragment size / sampling rate!");
245
246 // (re)create disk thread
247 if (this->pDiskThread) {
248 dmsg(1,("Stopping disk thread..."));
249 this->pDiskThread->StopThread();
250 delete this->pDiskThread;
251 dmsg(1,("OK\n"));
252 }
253 this->pDiskThread = new DiskThread(((pAudioOut->MaxSamplesPerCycle() << CONFIG_MAX_PITCH) << 1) + 6); //FIXME: assuming stereo
254 if (!pDiskThread) {
255 dmsg(0,("gig::Engine new diskthread = NULL\n"));
256 exit(EXIT_FAILURE);
257 }
258
259 for (RTList<Voice>::Iterator iterVoice = pVoicePool->allocAppend(); iterVoice == pVoicePool->last(); iterVoice = pVoicePool->allocAppend()) {
260 iterVoice->pDiskThread = this->pDiskThread;
261 dmsg(3,("d"));
262 }
263 pVoicePool->clear();
264
265 // (re)create event generator
266 if (pEventGenerator) delete pEventGenerator;
267 pEventGenerator = new EventGenerator(pAudioOut->SampleRate());
268
269 // (re)allocate synthesis parameter matrix
270 if (pSynthesisParameters[0]) free(pSynthesisParameters[0]);
271
272 #if defined(__APPLE__)
273 pSynthesisParameters[0] = (float *) malloc(Event::destination_count * sizeof(float) * pAudioOut->MaxSamplesPerCycle());
274 #else
275 pSynthesisParameters[0] = (float *) memalign(16,(Event::destination_count * sizeof(float) * pAudioOut->MaxSamplesPerCycle()));
276 #endif
277 for (int dst = 1; dst < Event::destination_count; dst++)
278 pSynthesisParameters[dst] = pSynthesisParameters[dst - 1] + pAudioOut->MaxSamplesPerCycle();
279
280 // (re)allocate biquad filter parameter sequence
281 if (pBasicFilterParameters) delete[] pBasicFilterParameters;
282 if (pMainFilterParameters) delete[] pMainFilterParameters;
283 pBasicFilterParameters = new biquad_param_t[pAudioOut->MaxSamplesPerCycle()];
284 pMainFilterParameters = new biquad_param_t[pAudioOut->MaxSamplesPerCycle()];
285
286 dmsg(1,("Starting disk thread..."));
287 pDiskThread->StartThread();
288 dmsg(1,("OK\n"));
289
290 for (RTList<Voice>::Iterator iterVoice = pVoicePool->allocAppend(); iterVoice == pVoicePool->last(); iterVoice = pVoicePool->allocAppend()) {
291 if (!iterVoice->pDiskThread) {
292 dmsg(0,("Engine -> voice::trigger: !pDiskThread\n"));
293 exit(EXIT_FAILURE);
294 }
295 }
296 }
297
298 /**
299 * Clear all engine global event lists.
300 */
301 void Engine::ClearEventLists() {
302 pGlobalEvents->clear();
303 }
304
305 /**
306 * Copy all events from the engine's global input queue buffer to the
307 * engine's internal event list. This will be done at the beginning of
308 * each audio cycle (that is each RenderAudio() call) to distinguish
309 * all global events which have to be processed in the current audio
310 * cycle. These events are usually just SysEx messages. Every
311 * EngineChannel has it's own input event queue buffer and event list
312 * to handle common events like NoteOn, NoteOff and ControlChange
313 * events.
314 *
315 * @param Samples - number of sample points to be processed in the
316 * current audio cycle
317 */
318 void Engine::ImportEvents(uint Samples) {
319 RingBuffer<Event>::NonVolatileReader eventQueueReader = pEventQueue->get_non_volatile_reader();
320 Event* pEvent;
321 while (true) {
322 // get next event from input event queue
323 if (!(pEvent = eventQueueReader.pop())) break;
324 // if younger event reached, ignore that and all subsequent ones for now
325 if (pEvent->FragmentPos() >= Samples) {
326 eventQueueReader--;
327 dmsg(2,("Younger Event, pos=%d ,Samples=%d!\n",pEvent->FragmentPos(),Samples));
328 pEvent->ResetFragmentPos();
329 break;
330 }
331 // copy event to internal event list
332 if (pGlobalEvents->poolIsEmpty()) {
333 dmsg(1,("Event pool emtpy!\n"));
334 break;
335 }
336 *pGlobalEvents->allocAppend() = *pEvent;
337 }
338 eventQueueReader.free(); // free all copied events from input queue
339 }
340
341 /**
342 * Let this engine proceed to render the given amount of sample points. The
343 * calculated audio data of all voices of this engine will be placed into
344 * the engine's audio sum buffer which has to be copied and eventually be
345 * converted to the appropriate value range by the audio output class (e.g.
346 * AlsaIO or JackIO) right after.
347 *
348 * @param Samples - number of sample points to be rendered
349 * @returns 0 on success
350 */
351 int Engine::RenderAudio(uint Samples) {
352 dmsg(5,("RenderAudio(Samples=%d)\n", Samples));
353
354 // return if engine disabled
355 if (EngineDisabled.Pop()) {
356 dmsg(5,("gig::Engine: engine disabled (val=%d)\n",EngineDisabled.GetUnsafe()));
357 return 0;
358 }
359
360 // update time of start and end of this audio fragment (as events' time stamps relate to this)
361 pEventGenerator->UpdateFragmentTime(Samples);
362
363 // get all events from the engine's global input event queue which belong to the current fragment
364 // (these are usually just SysEx messages)
365 ImportEvents(Samples);
366
367 // process engine global events (these are currently only MIDI System Exclusive messages)
368 {
369 RTList<Event>::Iterator itEvent = pGlobalEvents->first();
370 RTList<Event>::Iterator end = pGlobalEvents->end();
371 for (; itEvent != end; ++itEvent) {
372 switch (itEvent->Type) {
373 case Event::type_sysex:
374 dmsg(5,("Engine: Sysex received\n"));
375 ProcessSysex(itEvent);
376 break;
377 }
378 }
379 }
380
381 // We only allow a maximum of CONFIG_MAX_VOICES voices to be stolen
382 // in each audio fragment. All subsequent request for spawning new
383 // voices in the same audio fragment will be ignored.
384 VoiceTheftsLeft = CONFIG_MAX_VOICES;
385
386 // reset internal voice counter (just for statistic of active voices)
387 ActiveVoiceCountTemp = 0;
388
389
390 // handle events on all engine channels
391 for (int i = 0; i < engineChannels.size(); i++) {
392 if (!engineChannels[i]->pInstrument) continue; // ignore if no instrument loaded
393 ProcessEvents(engineChannels[i], Samples);
394 }
395
396 // render all 'normal', active voices on all engine channels
397 for (int i = 0; i < engineChannels.size(); i++) {
398 if (!engineChannels[i]->pInstrument) continue; // ignore if no instrument loaded
399 RenderActiveVoices(engineChannels[i], Samples);
400 }
401
402 // now that all ordinary voices on ALL engine channels are rendered, render new stolen voices
403 RenderStolenVoices(Samples);
404
405 // handle cleanup on all engine channels for the next audio fragment
406 for (int i = 0; i < engineChannels.size(); i++) {
407 if (!engineChannels[i]->pInstrument) continue; // ignore if no instrument loaded
408 PostProcess(engineChannels[i]);
409 }
410
411
412 // empty the engine's event list for the next audio fragment
413 ClearEventLists();
414
415 // reset voice stealing for the next audio fragment
416 pVoiceStealingQueue->clear();
417
418 // just some statistics about this engine instance
419 ActiveVoiceCount = ActiveVoiceCountTemp;
420 if (ActiveVoiceCount > ActiveVoiceCountMax) ActiveVoiceCountMax = ActiveVoiceCount;
421
422 FrameTime += Samples;
423
424 return 0;
425 }
426
427 /**
428 * Dispatch and handle all events in this audio fragment for the given
429 * engine channel.
430 *
431 * @param pEngineChannel - engine channel on which events should be
432 * processed
433 * @param Samples - amount of sample points to be processed in
434 * this audio fragment cycle
435 */
436 void Engine::ProcessEvents(EngineChannel* pEngineChannel, uint Samples) {
437 // get all events from the engine channels's input event queue which belong to the current fragment
438 // (these are the common events like NoteOn, NoteOff, ControlChange, etc.)
439 pEngineChannel->ImportEvents(Samples);
440
441 // process events
442 {
443 RTList<Event>::Iterator itEvent = pEngineChannel->pEvents->first();
444 RTList<Event>::Iterator end = pEngineChannel->pEvents->end();
445 for (; itEvent != end; ++itEvent) {
446 switch (itEvent->Type) {
447 case Event::type_note_on:
448 dmsg(5,("Engine: Note on received\n"));
449 ProcessNoteOn((EngineChannel*)itEvent->pEngineChannel, itEvent);
450 break;
451 case Event::type_note_off:
452 dmsg(5,("Engine: Note off received\n"));
453 ProcessNoteOff((EngineChannel*)itEvent->pEngineChannel, itEvent);
454 break;
455 case Event::type_control_change:
456 dmsg(5,("Engine: MIDI CC received\n"));
457 ProcessControlChange((EngineChannel*)itEvent->pEngineChannel, itEvent);
458 break;
459 case Event::type_pitchbend:
460 dmsg(5,("Engine: Pitchbend received\n"));
461 ProcessPitchbend((EngineChannel*)itEvent->pEngineChannel, itEvent);
462 break;
463 }
464 }
465 }
466
467 // reset voice stealing for the next engine channel (or next audio fragment)
468 itLastStolenVoice = RTList<Voice>::Iterator();
469 itLastStolenVoiceGlobally = RTList<Voice>::Iterator();
470 iuiLastStolenKey = RTList<uint>::Iterator();
471 iuiLastStolenKeyGlobally = RTList<uint>::Iterator();
472 pLastStolenChannel = NULL;
473 }
474
475 /**
476 * Render all 'normal' voices (that is voices which were not stolen in
477 * this fragment) on the given engine channel.
478 *
479 * @param pEngineChannel - engine channel on which audio should be
480 * rendered
481 * @param Samples - amount of sample points to be rendered in
482 * this audio fragment cycle
483 */
484 void Engine::RenderActiveVoices(EngineChannel* pEngineChannel, uint Samples) {
485 RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first();
486 RTList<uint>::Iterator end = pEngineChannel->pActiveKeys->end();
487 while (iuiKey != end) { // iterate through all active keys
488 midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey];
489 ++iuiKey;
490
491 RTList<Voice>::Iterator itVoice = pKey->pActiveVoices->first();
492 RTList<Voice>::Iterator itVoicesEnd = pKey->pActiveVoices->end();
493 for (; itVoice != itVoicesEnd; ++itVoice) { // iterate through all voices on this key
494 // now render current voice
495 itVoice->Render(Samples);
496 if (itVoice->IsActive()) ActiveVoiceCountTemp++; // still active
497 else { // voice reached end, is now inactive
498 FreeVoice(pEngineChannel, itVoice); // remove voice from the list of active voices
499 }
500 }
501 }
502 }
503
504 /**
505 * Render all stolen voices (only voices which were stolen in this
506 * fragment) on the given engine channel. Stolen voices are rendered
507 * after all normal voices have been rendered; this is needed to render
508 * audio of those voices which were selected for voice stealing until
509 * the point were the stealing (that is the take over of the voice)
510 * actually happened.
511 *
512 * @param pEngineChannel - engine channel on which audio should be
513 * rendered
514 * @param Samples - amount of sample points to be rendered in
515 * this audio fragment cycle
516 */
517 void Engine::RenderStolenVoices(uint Samples) {
518 RTList<Event>::Iterator itVoiceStealEvent = pVoiceStealingQueue->first();
519 RTList<Event>::Iterator end = pVoiceStealingQueue->end();
520 for (; itVoiceStealEvent != end; ++itVoiceStealEvent) {
521 EngineChannel* pEngineChannel = (EngineChannel*) itVoiceStealEvent->pEngineChannel;
522 Pool<Voice>::Iterator itNewVoice =
523 LaunchVoice(pEngineChannel, itVoiceStealEvent, itVoiceStealEvent->Param.Note.Layer, itVoiceStealEvent->Param.Note.ReleaseTrigger, false);
524 if (itNewVoice) {
525 itNewVoice->Render(Samples);
526 if (itNewVoice->IsActive()) ActiveVoiceCountTemp++; // still active
527 else { // voice reached end, is now inactive
528 FreeVoice(pEngineChannel, itNewVoice); // remove voice from the list of active voices
529 }
530 }
531 else dmsg(1,("gig::Engine: ERROR, voice stealing didn't work out!\n"));
532
533 // we need to clear the key's event list explicitly here in case key was never active
534 midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[itVoiceStealEvent->Param.Note.Key];
535 pKey->VoiceTheftsQueued--;
536 if (!pKey->Active && !pKey->VoiceTheftsQueued) pKey->pEvents->clear();
537 }
538 }
539
540 /**
541 * Free all keys which have turned inactive in this audio fragment, from
542 * the list of active keys and clear all event lists on that engine
543 * channel.
544 *
545 * @param pEngineChannel - engine channel to cleanup
546 */
547 void Engine::PostProcess(EngineChannel* pEngineChannel) {
548 // free all keys which have no active voices left
549 {
550 RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first();
551 RTList<uint>::Iterator end = pEngineChannel->pActiveKeys->end();
552 while (iuiKey != end) { // iterate through all active keys
553 midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey];
554 ++iuiKey;
555 if (pKey->pActiveVoices->isEmpty()) FreeKey(pEngineChannel, pKey);
556 #if CONFIG_DEVMODE
557 else { // just a sanity check for debugging
558 RTList<Voice>::Iterator itVoice = pKey->pActiveVoices->first();
559 RTList<Voice>::Iterator itVoicesEnd = pKey->pActiveVoices->end();
560 for (; itVoice != itVoicesEnd; ++itVoice) { // iterate through all voices on this key
561 if (itVoice->itKillEvent) {
562 dmsg(1,("gig::Engine: ERROR, killed voice survived !!!\n"));
563 }
564 }
565 }
566 #endif // CONFIG_DEVMODE
567 }
568 }
569
570 // empty the engine channel's own event lists
571 pEngineChannel->ClearEventLists();
572 }
573
574 /**
575 * Will be called by the MIDI input device whenever a MIDI system
576 * exclusive message has arrived.
577 *
578 * @param pData - pointer to sysex data
579 * @param Size - lenght of sysex data (in bytes)
580 */
581 void Engine::SendSysex(void* pData, uint Size) {
582 Event event = pEventGenerator->CreateEvent();
583 event.Type = Event::type_sysex;
584 event.Param.Sysex.Size = Size;
585 event.pEngineChannel = NULL; // as Engine global event
586 if (pEventQueue->write_space() > 0) {
587 if (pSysexBuffer->write_space() >= Size) {
588 // copy sysex data to input buffer
589 uint toWrite = Size;
590 uint8_t* pPos = (uint8_t*) pData;
591 while (toWrite) {
592 const uint writeNow = RTMath::Min(toWrite, pSysexBuffer->write_space_to_end());
593 pSysexBuffer->write(pPos, writeNow);
594 toWrite -= writeNow;
595 pPos += writeNow;
596
597 }
598 // finally place sysex event into input event queue
599 pEventQueue->push(&event);
600 }
601 else dmsg(1,("Engine: Sysex message too large (%d byte) for input buffer (%d byte)!",Size,CONFIG_SYSEX_BUFFER_SIZE));
602 }
603 else dmsg(1,("Engine: Input event queue full!"));
604 }
605
606 /**
607 * Assigns and triggers a new voice for the respective MIDI key.
608 *
609 * @param pEngineChannel - engine channel on which this event occured on
610 * @param itNoteOnEvent - key, velocity and time stamp of the event
611 */
612 void Engine::ProcessNoteOn(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOnEvent) {
613
614 const int key = itNoteOnEvent->Param.Note.Key;
615
616 // Change key dimension value if key is in keyswitching area
617 {
618 const ::gig::Instrument* pInstrument = pEngineChannel->pInstrument;
619 if (key >= pInstrument->DimensionKeyRange.low && key <= pInstrument->DimensionKeyRange.high)
620 pEngineChannel->CurrentKeyDimension = ((key - pInstrument->DimensionKeyRange.low) * 128) /
621 (pInstrument->DimensionKeyRange.high - pInstrument->DimensionKeyRange.low + 1);
622 }
623
624 midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[key];
625
626 pKey->KeyPressed = true; // the MIDI key was now pressed down
627 pKey->Velocity = itNoteOnEvent->Param.Note.Velocity;
628 pKey->NoteOnTime = FrameTime + itNoteOnEvent->FragmentPos(); // will be used to calculate note length
629
630 // cancel release process of voices on this key if needed
631 if (pKey->Active && !pEngineChannel->SustainPedal) {
632 RTList<Event>::Iterator itCancelReleaseEvent = pKey->pEvents->allocAppend();
633 if (itCancelReleaseEvent) {
634 *itCancelReleaseEvent = *itNoteOnEvent; // copy event
635 itCancelReleaseEvent->Type = Event::type_cancel_release; // transform event type
636 }
637 else dmsg(1,("Event pool emtpy!\n"));
638 }
639
640 // move note on event to the key's own event list
641 RTList<Event>::Iterator itNoteOnEventOnKeyList = itNoteOnEvent.moveToEndOf(pKey->pEvents);
642
643 // allocate and trigger new voice(s) for the key
644 {
645 // first, get total amount of required voices (dependant on amount of layers)
646 ::gig::Region* pRegion = pEngineChannel->pInstrument->GetRegion(itNoteOnEventOnKeyList->Param.Note.Key);
647 if (pRegion) {
648 int voicesRequired = pRegion->Layers;
649 // now launch the required amount of voices
650 for (int i = 0; i < voicesRequired; i++)
651 LaunchVoice(pEngineChannel, itNoteOnEventOnKeyList, i, false, true);
652 }
653 }
654
655 // if neither a voice was spawned or postponed then remove note on event from key again
656 if (!pKey->Active && !pKey->VoiceTheftsQueued)
657 pKey->pEvents->free(itNoteOnEventOnKeyList);
658
659 pKey->RoundRobinIndex++;
660 }
661
662 /**
663 * Releases the voices on the given key if sustain pedal is not pressed.
664 * If sustain is pressed, the release of the note will be postponed until
665 * sustain pedal will be released or voice turned inactive by itself (e.g.
666 * due to completion of sample playback).
667 *
668 * @param pEngineChannel - engine channel on which this event occured on
669 * @param itNoteOffEvent - key, velocity and time stamp of the event
670 */
671 void Engine::ProcessNoteOff(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOffEvent) {
672 midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[itNoteOffEvent->Param.Note.Key];
673
674 pKey->KeyPressed = false; // the MIDI key was now released
675
676 // release voices on this key if needed
677 if (pKey->Active && !pEngineChannel->SustainPedal) {
678 itNoteOffEvent->Type = Event::type_release; // transform event type
679
680 // move event to the key's own event list
681 RTList<Event>::Iterator itNoteOffEventOnKeyList = itNoteOffEvent.moveToEndOf(pKey->pEvents);
682
683 // spawn release triggered voice(s) if needed
684 if (pKey->ReleaseTrigger) {
685 // first, get total amount of required voices (dependant on amount of layers)
686 ::gig::Region* pRegion = pEngineChannel->pInstrument->GetRegion(itNoteOffEventOnKeyList->Param.Note.Key);
687 if (pRegion) {
688 int voicesRequired = pRegion->Layers;
689
690 // MIDI note-on velocity is used instead of note-off velocity
691 itNoteOffEventOnKeyList->Param.Note.Velocity = pKey->Velocity;
692
693 // now launch the required amount of voices
694 for (int i = 0; i < voicesRequired; i++)
695 LaunchVoice(pEngineChannel, itNoteOffEventOnKeyList, i, true, false); //FIXME: for the moment we don't perform voice stealing for release triggered samples
696 }
697 pKey->ReleaseTrigger = false;
698 }
699
700 // if neither a voice was spawned or postponed then remove note off event from key again
701 if (!pKey->Active && !pKey->VoiceTheftsQueued)
702 pKey->pEvents->free(itNoteOffEventOnKeyList);
703 }
704 }
705
706 /**
707 * Moves pitchbend event from the general (input) event list to the pitch
708 * event list.
709 *
710 * @param pEngineChannel - engine channel on which this event occured on
711 * @param itPitchbendEvent - absolute pitch value and time stamp of the event
712 */
713 void Engine::ProcessPitchbend(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itPitchbendEvent) {
714 pEngineChannel->Pitch = itPitchbendEvent->Param.Pitch.Pitch; // store current pitch value
715 itPitchbendEvent.moveToEndOf(pEngineChannel->pSynthesisEvents[Event::destination_vco]);
716 }
717
718 /**
719 * Allocates and triggers a new voice. This method will usually be
720 * called by the ProcessNoteOn() method and by the voices itself
721 * (e.g. to spawn further voices on the same key for layered sounds).
722 *
723 * @param pEngineChannel - engine channel on which this event occured on
724 * @param itNoteOnEvent - key, velocity and time stamp of the event
725 * @param iLayer - layer index for the new voice (optional - only
726 * in case of layered sounds of course)
727 * @param ReleaseTriggerVoice - if new voice is a release triggered voice
728 * (optional, default = false)
729 * @param VoiceStealing - if voice stealing should be performed
730 * when there is no free voice
731 * (optional, default = true)
732 * @returns pointer to new voice or NULL if there was no free voice or
733 * if the voice wasn't triggered (for example when no region is
734 * defined for the given key).
735 */
736 Pool<Voice>::Iterator Engine::LaunchVoice(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOnEvent, int iLayer, bool ReleaseTriggerVoice, bool VoiceStealing) {
737 midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[itNoteOnEvent->Param.Note.Key];
738
739 // allocate a new voice for the key
740 Pool<Voice>::Iterator itNewVoice = pKey->pActiveVoices->allocAppend();
741 if (itNewVoice) {
742 // launch the new voice
743 if (itNewVoice->Trigger(pEngineChannel, itNoteOnEvent, pEngineChannel->Pitch, pEngineChannel->pInstrument, iLayer, ReleaseTriggerVoice, VoiceStealing) < 0) {
744 dmsg(4,("Voice not triggered\n"));
745 pKey->pActiveVoices->free(itNewVoice);
746 }
747 else { // on success
748 uint** ppKeyGroup = NULL;
749 if (itNewVoice->KeyGroup) { // if this voice / key belongs to a key group
750 ppKeyGroup = &pEngineChannel->ActiveKeyGroups[itNewVoice->KeyGroup];
751 if (*ppKeyGroup) { // if there's already an active key in that key group
752 midi_key_info_t* pOtherKey = &pEngineChannel->pMIDIKeyInfo[**ppKeyGroup];
753 // kill all voices on the (other) key
754 RTList<Voice>::Iterator itVoiceToBeKilled = pOtherKey->pActiveVoices->first();
755 RTList<Voice>::Iterator end = pOtherKey->pActiveVoices->end();
756 for (; itVoiceToBeKilled != end; ++itVoiceToBeKilled) {
757 if (itVoiceToBeKilled->Type != Voice::type_release_trigger) itVoiceToBeKilled->Kill(itNoteOnEvent);
758 }
759 }
760 }
761 if (!pKey->Active) { // mark as active key
762 pKey->Active = true;
763 pKey->itSelf = pEngineChannel->pActiveKeys->allocAppend();
764 *pKey->itSelf = itNoteOnEvent->Param.Note.Key;
765 }
766 if (itNewVoice->KeyGroup) {
767 *ppKeyGroup = &*pKey->itSelf; // put key as the (new) active key to its key group
768 }
769 if (itNewVoice->Type == Voice::type_release_trigger_required) pKey->ReleaseTrigger = true; // mark key for the need of release triggered voice(s)
770 return itNewVoice; // success
771 }
772 }
773 else if (VoiceStealing) {
774 // try to steal one voice
775 int result = StealVoice(pEngineChannel, itNoteOnEvent);
776 if (!result) { // voice stolen successfully
777 // put note-on event into voice-stealing queue, so it will be reprocessed after killed voice died
778 RTList<Event>::Iterator itStealEvent = pVoiceStealingQueue->allocAppend();
779 if (itStealEvent) {
780 *itStealEvent = *itNoteOnEvent; // copy event
781 itStealEvent->Param.Note.Layer = iLayer;
782 itStealEvent->Param.Note.ReleaseTrigger = ReleaseTriggerVoice;
783 pKey->VoiceTheftsQueued++;
784 }
785 else dmsg(1,("Voice stealing queue full!\n"));
786 }
787 }
788
789 return Pool<Voice>::Iterator(); // no free voice or error
790 }
791
792 /**
793 * Will be called by LaunchVoice() method in case there are no free
794 * voices left. This method will select and kill one old voice for
795 * voice stealing and postpone the note-on event until the selected
796 * voice actually died.
797 *
798 * @param pEngineChannel - engine channel on which this event occured on
799 * @param itNoteOnEvent - key, velocity and time stamp of the event
800 * @returns 0 on success, a value < 0 if no active voice could be picked for voice stealing
801 */
802 int Engine::StealVoice(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOnEvent) {
803 if (!VoiceTheftsLeft) {
804 dmsg(1,("Max. voice thefts per audio fragment reached (you may raise CONFIG_MAX_VOICES).\n"));
805 return -1;
806 }
807 if (!pEventPool->poolIsEmpty()) {
808
809 RTList<Voice>::Iterator itSelectedVoice;
810
811 // Select one voice for voice stealing
812 switch (CONFIG_VOICE_STEAL_ALGO) {
813
814 // try to pick the oldest voice on the key where the new
815 // voice should be spawned, if there is no voice on that
816 // key, or no voice left to kill, then procceed with
817 // 'oldestkey' algorithm
818 case voice_steal_algo_oldestvoiceonkey: {
819 midi_key_info_t* pSelectedKey = &pEngineChannel->pMIDIKeyInfo[itNoteOnEvent->Param.Note.Key];
820 itSelectedVoice = pSelectedKey->pActiveVoices->first();
821 // proceed iterating if voice was created in this fragment cycle
822 while (itSelectedVoice && !itSelectedVoice->hasRendered()) ++itSelectedVoice;
823 // if we haven't found a voice then proceed with algorithm 'oldestkey'
824 if (itSelectedVoice && itSelectedVoice->hasRendered()) break;
825 } // no break - intentional !
826
827 // try to pick the oldest voice on the oldest active key
828 // from the same engine channel
829 // (caution: must stay after 'oldestvoiceonkey' algorithm !)
830 case voice_steal_algo_oldestkey: {
831 // if we already stole in this fragment, try to proceed on same key
832 if (this->itLastStolenVoice) {
833 itSelectedVoice = this->itLastStolenVoice;
834 do {
835 ++itSelectedVoice;
836 } while (itSelectedVoice && !itSelectedVoice->hasRendered()); // proceed iterating if voice was created in this fragment cycle
837 // found a "stealable" voice ?
838 if (itSelectedVoice && itSelectedVoice->hasRendered()) {
839 // remember which voice we stole, so we can simply proceed on next voice stealing
840 this->itLastStolenVoice = itSelectedVoice;
841 break; // selection succeeded
842 }
843 }
844 // get (next) oldest key
845 RTList<uint>::Iterator iuiSelectedKey = (this->iuiLastStolenKey) ? ++this->iuiLastStolenKey : pEngineChannel->pActiveKeys->first();
846 while (iuiSelectedKey) {
847 midi_key_info_t* pSelectedKey = &pEngineChannel->pMIDIKeyInfo[*iuiSelectedKey];
848 itSelectedVoice = pSelectedKey->pActiveVoices->first();
849 // proceed iterating if voice was created in this fragment cycle
850 while (itSelectedVoice && !itSelectedVoice->hasRendered()) ++itSelectedVoice;
851 // found a "stealable" voice ?
852 if (itSelectedVoice && itSelectedVoice->hasRendered()) {
853 // remember which voice on which key we stole, so we can simply proceed on next voice stealing
854 this->iuiLastStolenKey = iuiSelectedKey;
855 this->itLastStolenVoice = itSelectedVoice;
856 break; // selection succeeded
857 }
858 ++iuiSelectedKey; // get next oldest key
859 }
860 break;
861 }
862
863 // don't steal anything
864 case voice_steal_algo_none:
865 default: {
866 dmsg(1,("No free voice (voice stealing disabled)!\n"));
867 return -1;
868 }
869 }
870
871 // if we couldn't steal a voice from the same engine channel then
872 // steal oldest voice on the oldest key from any other engine channel
873 // (the smaller engine channel number, the higher priority)
874 if (!itSelectedVoice || !itSelectedVoice->hasRendered()) {
875 EngineChannel* pSelectedChannel;
876 int iChannelIndex;
877 // select engine channel
878 if (pLastStolenChannel) {
879 pSelectedChannel = pLastStolenChannel;
880 iChannelIndex = pSelectedChannel->iEngineIndexSelf;
881 } else { // pick the engine channel followed by this engine channel
882 iChannelIndex = (pEngineChannel->iEngineIndexSelf + 1) % engineChannels.size();
883 pSelectedChannel = engineChannels[iChannelIndex];
884 }
885 // iterate through engine channels
886 while (true) {
887 // if we already stole in this fragment, try to proceed on same key
888 if (this->itLastStolenVoiceGlobally) {
889 itSelectedVoice = this->itLastStolenVoiceGlobally;
890 do {
891 ++itSelectedVoice;
892 } while (itSelectedVoice && !itSelectedVoice->hasRendered()); // proceed iterating if voice was created in this fragment cycle
893 // break if selection succeeded
894 if (itSelectedVoice && itSelectedVoice->hasRendered()) {
895 // remember which voice we stole, so we can simply proceed on next voice stealing
896 this->itLastStolenVoiceGlobally = itSelectedVoice;
897 break; // selection succeeded
898 }
899 }
900 // get (next) oldest key
901 RTList<uint>::Iterator iuiSelectedKey = (this->iuiLastStolenKey) ? ++this->iuiLastStolenKey : pSelectedChannel->pActiveKeys->first();
902 while (iuiSelectedKey) {
903 midi_key_info_t* pSelectedKey = &pEngineChannel->pMIDIKeyInfo[*iuiSelectedKey];
904 itSelectedVoice = pSelectedKey->pActiveVoices->first();
905 // proceed iterating if voice was created in this fragment cycle
906 while (itSelectedVoice && !itSelectedVoice->hasRendered()) ++itSelectedVoice;
907 // found a "stealable" voice ?
908 if (itSelectedVoice && itSelectedVoice->hasRendered()) {
909 // remember which voice on which key on which engine channel we stole, so we can simply proceed on next voice stealing
910 this->iuiLastStolenKeyGlobally = iuiSelectedKey;
911 this->itLastStolenVoiceGlobally = itSelectedVoice;
912 this->pLastStolenChannel = pSelectedChannel;
913 break; // selection succeeded
914 }
915 ++iuiSelectedKey; // get next key on current engine channel
916 }
917 // get next engine channel
918 iChannelIndex = (iChannelIndex + 1) % engineChannels.size();
919 pSelectedChannel = engineChannels[iChannelIndex];
920 }
921 }
922
923 #if CONFIG_DEVMODE
924 if (!itSelectedVoice->IsActive()) {
925 dmsg(1,("gig::Engine: ERROR, tried to steal a voice which was not active !!!\n"));
926 return -1;
927 }
928 #endif // CONFIG_DEVMODE
929
930 // now kill the selected voice
931 itSelectedVoice->Kill(itNoteOnEvent);
932
933 --VoiceTheftsLeft;
934
935 return 0; // success
936 }
937 else {
938 dmsg(1,("Event pool emtpy!\n"));
939 return -1;
940 }
941 }
942
943 /**
944 * Removes the given voice from the MIDI key's list of active voices.
945 * This method will be called when a voice went inactive, e.g. because
946 * it finished to playback its sample, finished its release stage or
947 * just was killed.
948 *
949 * @param pEngineChannel - engine channel on which this event occured on
950 * @param itVoice - points to the voice to be freed
951 */
952 void Engine::FreeVoice(EngineChannel* pEngineChannel, Pool<Voice>::Iterator& itVoice) {
953 if (itVoice) {
954 midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[itVoice->MIDIKey];
955
956 uint keygroup = itVoice->KeyGroup;
957
958 // free the voice object
959 pVoicePool->free(itVoice);
960
961 // if no other voices left and member of a key group, remove from key group
962 if (pKey->pActiveVoices->isEmpty() && keygroup) {
963 uint** ppKeyGroup = &pEngineChannel->ActiveKeyGroups[keygroup];
964 if (*ppKeyGroup == &*pKey->itSelf) *ppKeyGroup = NULL; // remove key from key group
965 }
966 }
967 else std::cerr << "Couldn't release voice! (!itVoice)\n" << std::flush;
968 }
969
970 /**
971 * Called when there's no more voice left on a key, this call will
972 * update the key info respectively.
973 *
974 * @param pEngineChannel - engine channel on which this event occured on
975 * @param pKey - key which is now inactive
976 */
977 void Engine::FreeKey(EngineChannel* pEngineChannel, midi_key_info_t* pKey) {
978 if (pKey->pActiveVoices->isEmpty()) {
979 pKey->Active = false;
980 pEngineChannel->pActiveKeys->free(pKey->itSelf); // remove key from list of active keys
981 pKey->itSelf = RTList<uint>::Iterator();
982 pKey->ReleaseTrigger = false;
983 pKey->pEvents->clear();
984 dmsg(3,("Key has no more voices now\n"));
985 }
986 else dmsg(1,("gig::Engine: Oops, tried to free a key which contains voices.\n"));
987 }
988
989 /**
990 * Reacts on supported control change commands (e.g. pitch bend wheel,
991 * modulation wheel, aftertouch).
992 *
993 * @param pEngineChannel - engine channel on which this event occured on
994 * @param itControlChangeEvent - controller, value and time stamp of the event
995 */
996 void Engine::ProcessControlChange(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itControlChangeEvent) {
997 dmsg(4,("Engine::ContinuousController cc=%d v=%d\n", itControlChangeEvent->Param.CC.Controller, itControlChangeEvent->Param.CC.Value));
998
999 // update controller value in the engine channel's controller table
1000 pEngineChannel->ControllerTable[itControlChangeEvent->Param.CC.Controller] = itControlChangeEvent->Param.CC.Value;
1001
1002 // move event from the unsorted event list to the control change event list
1003 Pool<Event>::Iterator itControlChangeEventOnCCList = itControlChangeEvent.moveToEndOf(pEngineChannel->pCCEvents);
1004
1005 switch (itControlChangeEventOnCCList->Param.CC.Controller) {
1006 case 7: { // volume
1007 //TODO: not sample accurate yet
1008 pEngineChannel->GlobalVolume = (float) itControlChangeEventOnCCList->Param.CC.Value / 127.0f;
1009 break;
1010 }
1011 case 10: { // panpot
1012 //TODO: not sample accurate yet
1013 const int pan = (int) itControlChangeEventOnCCList->Param.CC.Value - 64;
1014 pEngineChannel->GlobalPanLeft = 1.0f - float(RTMath::Max(pan, 0)) / 63.0f;
1015 pEngineChannel->GlobalPanRight = 1.0f - float(RTMath::Min(pan, 0)) / -64.0f;
1016 break;
1017 }
1018 case 64: { // sustain
1019 if (itControlChangeEventOnCCList->Param.CC.Value >= 64 && !pEngineChannel->SustainPedal) {
1020 dmsg(4,("PEDAL DOWN\n"));
1021 pEngineChannel->SustainPedal = true;
1022
1023 // cancel release process of voices if necessary
1024 RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first();
1025 for (; iuiKey; ++iuiKey) {
1026 midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey];
1027 if (!pKey->KeyPressed) {
1028 RTList<Event>::Iterator itNewEvent = pKey->pEvents->allocAppend();
1029 if (itNewEvent) {
1030 *itNewEvent = *itControlChangeEventOnCCList; // copy event to the key's own event list
1031 itNewEvent->Type = Event::type_cancel_release; // transform event type
1032 }
1033 else dmsg(1,("Event pool emtpy!\n"));
1034 }
1035 }
1036 }
1037 if (itControlChangeEventOnCCList->Param.CC.Value < 64 && pEngineChannel->SustainPedal) {
1038 dmsg(4,("PEDAL UP\n"));
1039 pEngineChannel->SustainPedal = false;
1040
1041 // release voices if their respective key is not pressed
1042 RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first();
1043 for (; iuiKey; ++iuiKey) {
1044 midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey];
1045 if (!pKey->KeyPressed) {
1046 RTList<Event>::Iterator itNewEvent = pKey->pEvents->allocAppend();
1047 if (itNewEvent) {
1048 *itNewEvent = *itControlChangeEventOnCCList; // copy event to the key's own event list
1049 itNewEvent->Type = Event::type_release; // transform event type
1050 }
1051 else dmsg(1,("Event pool emtpy!\n"));
1052 }
1053 }
1054 }
1055 break;
1056 }
1057
1058
1059 // Channel Mode Messages
1060
1061 case 120: { // all sound off
1062 KillAllVoices(pEngineChannel, itControlChangeEventOnCCList);
1063 break;
1064 }
1065 case 121: { // reset all controllers
1066 pEngineChannel->ResetControllers();
1067 break;
1068 }
1069 case 123: { // all notes off
1070 ReleaseAllVoices(pEngineChannel, itControlChangeEventOnCCList);
1071 break;
1072 }
1073 }
1074 }
1075
1076 /**
1077 * Reacts on MIDI system exclusive messages.
1078 *
1079 * @param itSysexEvent - sysex data size and time stamp of the sysex event
1080 */
1081 void Engine::ProcessSysex(Pool<Event>::Iterator& itSysexEvent) {
1082 RingBuffer<uint8_t>::NonVolatileReader reader = pSysexBuffer->get_non_volatile_reader();
1083
1084 uint8_t exclusive_status, id;
1085 if (!reader.pop(&exclusive_status)) goto free_sysex_data;
1086 if (!reader.pop(&id)) goto free_sysex_data;
1087 if (exclusive_status != 0xF0) goto free_sysex_data;
1088
1089 switch (id) {
1090 case 0x41: { // Roland
1091 dmsg(3,("Roland Sysex\n"));
1092 uint8_t device_id, model_id, cmd_id;
1093 if (!reader.pop(&device_id)) goto free_sysex_data;
1094 if (!reader.pop(&model_id)) goto free_sysex_data;
1095 if (!reader.pop(&cmd_id)) goto free_sysex_data;
1096 if (model_id != 0x42 /*GS*/) goto free_sysex_data;
1097 if (cmd_id != 0x12 /*DT1*/) goto free_sysex_data;
1098
1099 // command address
1100 uint8_t addr[3]; // 2 byte addr MSB, followed by 1 byte addr LSB)
1101 const RingBuffer<uint8_t>::NonVolatileReader checksum_reader = reader; // so we can calculate the check sum later
1102 if (reader.read(&addr[0], 3) != 3) goto free_sysex_data;
1103 if (addr[0] == 0x40 && addr[1] == 0x00) { // System Parameters
1104 dmsg(3,("\tSystem Parameter\n"));
1105 }
1106 else if (addr[0] == 0x40 && addr[1] == 0x01) { // Common Parameters
1107 dmsg(3,("\tCommon Parameter\n"));
1108 }
1109 else if (addr[0] == 0x40 && (addr[1] & 0xf0) == 0x10) { // Part Parameters (1)
1110 dmsg(3,("\tPart Parameter\n"));
1111 switch (addr[2]) {
1112 case 0x40: { // scale tuning
1113 dmsg(3,("\t\tScale Tuning\n"));
1114 uint8_t scale_tunes[12]; // detuning of all 12 semitones of an octave
1115 if (reader.read(&scale_tunes[0], 12) != 12) goto free_sysex_data;
1116 uint8_t checksum;
1117 if (!reader.pop(&checksum)) goto free_sysex_data;
1118 #if CONFIG_ASSERT_GS_SYSEX_CHECKSUM
1119 if (GSCheckSum(checksum_reader, 12)) goto free_sysex_data;
1120 #endif // CONFIG_ASSERT_GS_SYSEX_CHECKSUM
1121 for (int i = 0; i < 12; i++) scale_tunes[i] -= 64;
1122 AdjustScale((int8_t*) scale_tunes);
1123 dmsg(3,("\t\t\tNew scale applied.\n"));
1124 break;
1125 }
1126 }
1127 }
1128 else if (addr[0] == 0x40 && (addr[1] & 0xf0) == 0x20) { // Part Parameters (2)
1129 }
1130 else if (addr[0] == 0x41) { // Drum Setup Parameters
1131 }
1132 break;
1133 }
1134 }
1135
1136 free_sysex_data: // finally free sysex data
1137 pSysexBuffer->increment_read_ptr(itSysexEvent->Param.Sysex.Size);
1138 }
1139
1140 /**
1141 * Calculates the Roland GS sysex check sum.
1142 *
1143 * @param AddrReader - reader which currently points to the first GS
1144 * command address byte of the GS sysex message in
1145 * question
1146 * @param DataSize - size of the GS message data (in bytes)
1147 */
1148 uint8_t Engine::GSCheckSum(const RingBuffer<uint8_t>::NonVolatileReader AddrReader, uint DataSize) {
1149 RingBuffer<uint8_t>::NonVolatileReader reader = AddrReader;
1150 uint bytes = 3 /*addr*/ + DataSize;
1151 uint8_t addr_and_data[bytes];
1152 reader.read(&addr_and_data[0], bytes);
1153 uint8_t sum = 0;
1154 for (uint i = 0; i < bytes; i++) sum += addr_and_data[i];
1155 return 128 - sum % 128;
1156 }
1157
1158 /**
1159 * Allows to tune each of the twelve semitones of an octave.
1160 *
1161 * @param ScaleTunes - detuning of all twelve semitones (in cents)
1162 */
1163 void Engine::AdjustScale(int8_t ScaleTunes[12]) {
1164 memcpy(&this->ScaleTuning[0], &ScaleTunes[0], 12); //TODO: currently not sample accurate
1165 }
1166
1167 /**
1168 * Releases all voices on an engine channel. All voices will go into
1169 * the release stage and thus it might take some time (e.g. dependant to
1170 * their envelope release time) until they actually die.
1171 *
1172 * @param pEngineChannel - engine channel on which all voices should be released
1173 * @param itReleaseEvent - event which caused this releasing of all voices
1174 */
1175 void Engine::ReleaseAllVoices(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itReleaseEvent) {
1176 RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first();
1177 while (iuiKey) {
1178 midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey];
1179 ++iuiKey;
1180 // append a 'release' event to the key's own event list
1181 RTList<Event>::Iterator itNewEvent = pKey->pEvents->allocAppend();
1182 if (itNewEvent) {
1183 *itNewEvent = *itReleaseEvent; // copy original event (to the key's event list)
1184 itNewEvent->Type = Event::type_release; // transform event type
1185 }
1186 else dmsg(1,("Event pool emtpy!\n"));
1187 }
1188 }
1189
1190 /**
1191 * Kills all voices on an engine channel as soon as possible. Voices
1192 * won't get into release state, their volume level will be ramped down
1193 * as fast as possible.
1194 *
1195 * @param pEngineChannel - engine channel on which all voices should be killed
1196 * @param itKillEvent - event which caused this killing of all voices
1197 */
1198 void Engine::KillAllVoices(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itKillEvent) {
1199 RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first();
1200 RTList<uint>::Iterator end = pEngineChannel->pActiveKeys->end();
1201 while (iuiKey != end) { // iterate through all active keys
1202 midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey];
1203 ++iuiKey;
1204 RTList<Voice>::Iterator itVoice = pKey->pActiveVoices->first();
1205 RTList<Voice>::Iterator itVoicesEnd = pKey->pActiveVoices->end();
1206 for (; itVoice != itVoicesEnd; ++itVoice) { // iterate through all voices on this key
1207 itVoice->Kill(itKillEvent);
1208 }
1209 }
1210 }
1211
1212 /**
1213 * Initialize the parameter sequence for the modulation destination given by
1214 * by 'dst' with the constant value given by val.
1215 */
1216 void Engine::ResetSynthesisParameters(Event::destination_t dst, float val) {
1217 int maxsamples = pAudioOutputDevice->MaxSamplesPerCycle();
1218 float* m = &pSynthesisParameters[dst][0];
1219 for (int i = 0; i < maxsamples; i += 4) {
1220 m[i] = val;
1221 m[i+1] = val;
1222 m[i+2] = val;
1223 m[i+3] = val;
1224 }
1225 }
1226
1227 uint Engine::VoiceCount() {
1228 return ActiveVoiceCount;
1229 }
1230
1231 uint Engine::VoiceCountMax() {
1232 return ActiveVoiceCountMax;
1233 }
1234
1235 bool Engine::DiskStreamSupported() {
1236 return true;
1237 }
1238
1239 uint Engine::DiskStreamCount() {
1240 return (pDiskThread) ? pDiskThread->ActiveStreamCount : 0;
1241 }
1242
1243 uint Engine::DiskStreamCountMax() {
1244 return (pDiskThread) ? pDiskThread->ActiveStreamCountMax : 0;
1245 }
1246
1247 String Engine::DiskStreamBufferFillBytes() {
1248 return pDiskThread->GetBufferFillBytes();
1249 }
1250
1251 String Engine::DiskStreamBufferFillPercentage() {
1252 return pDiskThread->GetBufferFillPercentage();
1253 }
1254
1255 String Engine::EngineName() {
1256 return LS_GIG_ENGINE_NAME;
1257 }
1258
1259 String Engine::Description() {
1260 return "Gigasampler Engine";
1261 }
1262
1263 String Engine::Version() {
1264 String s = "$Revision: 1.42 $";
1265 return s.substr(11, s.size() - 13); // cut dollar signs, spaces and CVS macro keyword
1266 }
1267
1268 }} // namespace LinuxSampler::gig

  ViewVC Help
Powered by ViewVC