/[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 473 - (show annotations) (download)
Thu Mar 17 20:13:08 2005 UTC (14 years, 11 months ago) by schoenebeck
File size: 54812 byte(s)
* fixed event leak (events sent to inactive keys were not freed)
* implemented MIDI channel mode messages "All Sound Off", "Reset All
  Controller", "All Notes Off" (fixes bug #5)

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>(SYSEX_BUFFER_SIZE, 0);
107 pEventQueue = new RingBuffer<Event>(MAX_EVENTS_PER_FRAGMENT, 0);
108 pEventPool = new Pool<Event>(MAX_EVENTS_PER_FRAGMENT);
109 pVoicePool = new Pool<Voice>(MAX_AUDIO_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 }
123
124 /**
125 * Destructor
126 */
127 Engine::~Engine() {
128 if (pDiskThread) {
129 dmsg(1,("Stopping disk thread..."));
130 pDiskThread->StopThread();
131 delete pDiskThread;
132 dmsg(1,("OK\n"));
133 }
134 if (pEventQueue) delete pEventQueue;
135 if (pEventPool) delete pEventPool;
136 if (pVoicePool) {
137 pVoicePool->clear();
138 delete pVoicePool;
139 }
140 if (pEventGenerator) delete pEventGenerator;
141 if (pMainFilterParameters) delete[] pMainFilterParameters;
142 if (pBasicFilterParameters) delete[] pBasicFilterParameters;
143 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() {
150 dmsg(3,("gig::Engine: enabling\n"));
151 EngineDisabled.PushAndUnlock(false, 2); // set condition object 'EngineDisabled' to false (wait max. 2s)
152 dmsg(3,("gig::Engine: enabled (val=%d)\n", EngineDisabled.GetUnsafe()));
153 }
154
155 void Engine::Disable() {
156 dmsg(3,("gig::Engine: disabling\n"));
157 bool* pWasDisabled = EngineDisabled.PushAndUnlock(true, 2); // wait max. 2s
158 if (!pWasDisabled) dmsg(3,("gig::Engine warning: Timeout waiting to disable engine.\n"));
159 }
160
161 void Engine::DisableAndLock() {
162 dmsg(3,("gig::Engine: disabling\n"));
163 bool* pWasDisabled = EngineDisabled.Push(true, 2); // wait max. 2s
164 if (!pWasDisabled) dmsg(3,("gig::Engine warning: Timeout waiting to disable engine.\n"));
165 }
166
167 /**
168 * Reset all voices and disk thread and clear input event queue and all
169 * control and status variables.
170 */
171 void Engine::Reset() {
172 DisableAndLock();
173 ResetInternal();
174 Enable();
175 }
176
177 /**
178 * Reset all voices and disk thread and clear input event queue and all
179 * control and status variables. This method is not thread safe!
180 */
181 void Engine::ResetInternal() {
182 ActiveVoiceCount = 0;
183 ActiveVoiceCountMax = 0;
184
185 // reset voice stealing parameters
186 pVoiceStealingQueue->clear();
187 itLastStolenVoice = RTList<Voice>::Iterator();
188 iuiLastStolenKey = RTList<uint>::Iterator();
189 pLastStolenChannel = NULL;
190
191 // reset to normal chromatic scale (means equal temper)
192 memset(&ScaleTuning[0], 0x00, 12);
193
194 // reset all voices
195 for (RTList<Voice>::Iterator iterVoice = pVoicePool->allocAppend(); iterVoice == pVoicePool->last(); iterVoice = pVoicePool->allocAppend()) {
196 iterVoice->Reset();
197 }
198 pVoicePool->clear();
199
200 // reset disk thread
201 if (pDiskThread) pDiskThread->Reset();
202
203 // delete all input events
204 pEventQueue->init();
205 }
206
207 /**
208 * 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 pAudioOut - audio output device to connect to
215 */
216 void Engine::Connect(AudioOutputDevice* pAudioOut) {
217 pAudioOutputDevice = pAudioOut;
218
219 ResetInternal();
220
221 // inform audio driver for the need of two channels
222 try {
223 pAudioOutputDevice->AcquireChannels(2); // gig engine only stereo
224 }
225 catch (AudioOutputException e) {
226 String msg = "Audio output device unable to provide 2 audio channels, cause: " + e.Message();
227 throw LinuxSamplerException(msg);
228 }
229
230 this->MaxSamplesPerCycle = pAudioOutputDevice->MaxSamplesPerCycle();
231 this->SampleRate = pAudioOutputDevice->SampleRate();
232
233 // FIXME: audio drivers with varying fragment sizes might be a problem here
234 MaxFadeOutPos = MaxSamplesPerCycle - int(double(SampleRate) * EG_MIN_RELEASE_TIME) - 1;
235 if (MaxFadeOutPos < 0)
236 throw LinuxSamplerException("EG_MIN_RELEASE_TIME in EGADSR.h too big for current audio fragment size / sampling rate!");
237
238 // (re)create disk thread
239 if (this->pDiskThread) {
240 dmsg(1,("Stopping disk thread..."));
241 this->pDiskThread->StopThread();
242 delete this->pDiskThread;
243 dmsg(1,("OK\n"));
244 }
245 this->pDiskThread = new DiskThread(((pAudioOut->MaxSamplesPerCycle() << MAX_PITCH) << 1) + 6); //FIXME: assuming stereo
246 if (!pDiskThread) {
247 dmsg(0,("gig::Engine new diskthread = NULL\n"));
248 exit(EXIT_FAILURE);
249 }
250
251 for (RTList<Voice>::Iterator iterVoice = pVoicePool->allocAppend(); iterVoice == pVoicePool->last(); iterVoice = pVoicePool->allocAppend()) {
252 iterVoice->pDiskThread = this->pDiskThread;
253 dmsg(3,("d"));
254 }
255 pVoicePool->clear();
256
257 // (re)create event generator
258 if (pEventGenerator) delete pEventGenerator;
259 pEventGenerator = new EventGenerator(pAudioOut->SampleRate());
260
261 // (re)allocate synthesis parameter matrix
262 if (pSynthesisParameters[0]) free(pSynthesisParameters[0]);
263
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++)
270 pSynthesisParameters[dst] = pSynthesisParameters[dst - 1] + pAudioOut->MaxSamplesPerCycle();
271
272 // (re)allocate biquad filter parameter sequence
273 if (pBasicFilterParameters) delete[] pBasicFilterParameters;
274 if (pMainFilterParameters) delete[] pMainFilterParameters;
275 pBasicFilterParameters = new biquad_param_t[pAudioOut->MaxSamplesPerCycle()];
276 pMainFilterParameters = new biquad_param_t[pAudioOut->MaxSamplesPerCycle()];
277
278 dmsg(1,("Starting disk thread..."));
279 pDiskThread->StartThread();
280 dmsg(1,("OK\n"));
281
282 for (RTList<Voice>::Iterator iterVoice = pVoicePool->allocAppend(); iterVoice == pVoicePool->last(); iterVoice = pVoicePool->allocAppend()) {
283 if (!iterVoice->pDiskThread) {
284 dmsg(0,("Engine -> voice::trigger: !pDiskThread\n"));
285 exit(EXIT_FAILURE);
286 }
287 }
288 }
289
290 /**
291 * Clear all engine global event lists.
292 */
293 void Engine::ClearEventLists() {
294 pGlobalEvents->clear();
295 }
296
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 /**
334 * Let this engine proceed to render the given amount of sample points. The
335 * calculated audio data of all voices of this engine will be placed into
336 * the engine's audio sum buffer which has to be copied and eventually be
337 * converted to the appropriate value range by the audio output class (e.g.
338 * AlsaIO or JackIO) right after.
339 *
340 * @param Samples - number of sample points to be rendered
341 * @returns 0 on success
342 */
343 int Engine::RenderAudio(uint Samples) {
344 dmsg(5,("RenderAudio(Samples=%d)\n", Samples));
345
346 // return if engine disabled
347 if (EngineDisabled.Pop()) {
348 dmsg(5,("gig::Engine: engine disabled (val=%d)\n",EngineDisabled.GetUnsafe()));
349 return 0;
350 }
351
352 // update time of start and end of this audio fragment (as events' time stamps relate to this)
353 pEventGenerator->UpdateFragmentTime(Samples);
354
355 // get all events from the engine's global input event queue which belong to the current fragment
356 // (these are usually just SysEx messages)
357 ImportEvents(Samples);
358
359 // 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 MAX_AUDIO_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 = MAX_AUDIO_VOICES;
377
378 // reset internal voice counter (just for statistic of active voices)
379 ActiveVoiceCountTemp = 0;
380
381
382 // handle events on all engine channels
383 for (int i = 0; i < engineChannels.size(); i++) {
384 if (!engineChannels[i]->pInstrument) continue; // ignore if no instrument loaded
385 ProcessEvents(engineChannels[i], Samples);
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 // now that all ordinary voices on ALL engine channels are rendered, render new stolen voices
395 RenderStolenVoices(Samples);
396
397 // handle cleanup on all engine channels for the next audio fragment
398 for (int i = 0; i < engineChannels.size(); i++) {
399 if (!engineChannels[i]->pInstrument) continue; // ignore if no instrument loaded
400 PostProcess(engineChannels[i]);
401 }
402
403
404 // empty the engine's event list for the next audio fragment
405 ClearEventLists();
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;
418 }
419
420 /**
421 * Dispatch and handle all events in this audio fragment for the given
422 * engine channel.
423 *
424 * @param pEngineChannel - engine channel on which events should be
425 * processed
426 * @param Samples - amount of sample points to be processed in
427 * this audio fragment cycle
428 */
429 void Engine::ProcessEvents(EngineChannel* pEngineChannel, uint Samples) {
430 // get all events from the engine channels's input event queue which belong to the current fragment
431 // (these are the common events like NoteOn, NoteOff, ControlChange, etc.)
432 pEngineChannel->ImportEvents(Samples);
433
434 // process events
435 {
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 * Render all 'normal' voices (that is voices which were not stolen in
463 * this fragment) on the given engine channel.
464 *
465 * @param pEngineChannel - engine channel on which audio should be
466 * rendered
467 * @param Samples - amount of sample points to be rendered in
468 * this audio fragment cycle
469 */
470 void Engine::RenderActiveVoices(EngineChannel* pEngineChannel, uint Samples) {
471 RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first();
472 RTList<uint>::Iterator end = pEngineChannel->pActiveKeys->end();
473 while (iuiKey != end) { // iterate through all active keys
474 midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey];
475 ++iuiKey;
476
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 * Render all stolen voices (only voices which were stolen in this
492 * 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 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::RenderStolenVoices(uint Samples) {
504 RTList<Event>::Iterator itVoiceStealEvent = pVoiceStealingQueue->first();
505 RTList<Event>::Iterator end = pVoiceStealingQueue->end();
506 for (; itVoiceStealEvent != end; ++itVoiceStealEvent) {
507 EngineChannel* pEngineChannel = (EngineChannel*) itVoiceStealEvent->pEngineChannel;
508 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 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 // 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 MIDI input device whenever a MIDI system
562 * exclusive message has arrived.
563 *
564 * @param pData - pointer to sysex data
565 * @param Size - lenght of sysex data (in bytes)
566 */
567 void Engine::SendSysex(void* pData, uint Size) {
568 Event event = pEventGenerator->CreateEvent();
569 event.Type = Event::type_sysex;
570 event.Param.Sysex.Size = Size;
571 event.pEngineChannel = NULL; // as Engine global event
572 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,SYSEX_BUFFER_SIZE));
588 }
589 else dmsg(1,("Engine: Input event queue full!"));
590 }
591
592 /**
593 * Assigns and triggers a new voice for the respective MIDI key.
594 *
595 * @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(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOnEvent) {
599
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
613
614 // cancel release process of voices on this key if needed
615 if (pKey->Active && !pEngineChannel->SustainPedal) {
616 RTList<Event>::Iterator itCancelReleaseEvent = pKey->pEvents->allocAppend();
617 if (itCancelReleaseEvent) {
618 *itCancelReleaseEvent = *itNoteOnEvent; // copy event
619 itCancelReleaseEvent->Type = Event::type_cancel_release; // transform event type
620 }
621 else dmsg(1,("Event pool emtpy!\n"));
622 }
623
624 // move note on event to the key's own event list
625 RTList<Event>::Iterator itNoteOnEventOnKeyList = itNoteOnEvent.moveToEndOf(pKey->pEvents);
626
627 // allocate and trigger new voice(s) for the key
628 {
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 /**
647 * Releases the voices on the given key if sustain pedal is not pressed.
648 * If sustain is pressed, the release of the note will be postponed until
649 * sustain pedal will be released or voice turned inactive by itself (e.g.
650 * due to completion of sample playback).
651 *
652 * @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(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOffEvent) {
656 midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[itNoteOffEvent->Param.Note.Key];
657
658 pKey->KeyPressed = false; // the MIDI key was now released
659
660 // release voices on this key if needed
661 if (pKey->Active && !pEngineChannel->SustainPedal) {
662 itNoteOffEvent->Type = Event::type_release; // transform event type
663 }
664
665 // move event to the key's own event list
666 RTList<Event>::Iterator itNoteOffEventOnKeyList = itNoteOffEvent.moveToEndOf(pKey->pEvents);
667
668 // spawn release triggered voice(s) if needed
669 if (pKey->ReleaseTrigger) {
670 // first, get total amount of required voices (dependant on amount of layers)
671 ::gig::Region* pRegion = pEngineChannel->pInstrument->GetRegion(itNoteOffEventOnKeyList->Param.Note.Key);
672 if (pRegion) {
673 int voicesRequired = pRegion->Layers;
674 // now launch the required amount of voices
675 for (int i = 0; i < voicesRequired; i++)
676 LaunchVoice(pEngineChannel, itNoteOffEventOnKeyList, i, true, false); //FIXME: for the moment we don't perform voice stealing for release triggered samples
677 }
678 pKey->ReleaseTrigger = false;
679 }
680
681 // if neither a voice was spawned or postponed then remove note off event from key again
682 if (!pKey->Active && !pKey->VoiceTheftsQueued)
683 pKey->pEvents->free(itNoteOffEventOnKeyList);
684 }
685
686 /**
687 * Moves pitchbend event from the general (input) event list to the pitch
688 * event list.
689 *
690 * @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(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itPitchbendEvent) {
694 pEngineChannel->Pitch = itPitchbendEvent->Param.Pitch.Pitch; // store current pitch value
695 itPitchbendEvent.moveToEndOf(pEngineChannel->pSynthesisEvents[Event::destination_vco]);
696 }
697
698 /**
699 * Allocates and triggers a new voice. This method will usually be
700 * called by the ProcessNoteOn() method and by the voices itself
701 * (e.g. to spawn further voices on the same key for layered sounds).
702 *
703 * @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
706 * in case of layered sounds of course)
707 * @param ReleaseTriggerVoice - if new voice is a release triggered voice
708 * (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 Pool<Voice>::Iterator Engine::LaunchVoice(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOnEvent, int iLayer, bool ReleaseTriggerVoice, bool VoiceStealing) {
717 midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[itNoteOnEvent->Param.Note.Key];
718
719 // allocate a new voice for the key
720 Pool<Voice>::Iterator itNewVoice = pKey->pActiveVoices->allocAppend();
721 if (itNewVoice) {
722 // launch the new voice
723 if (itNewVoice->Trigger(pEngineChannel, itNoteOnEvent, pEngineChannel->Pitch, pEngineChannel->pInstrument, iLayer, ReleaseTriggerVoice, VoiceStealing) < 0) {
724 dmsg(4,("Voice not triggered\n"));
725 pKey->pActiveVoices->free(itNewVoice);
726 }
727 else { // on success
728 uint** ppKeyGroup = NULL;
729 if (itNewVoice->KeyGroup) { // if this voice / key belongs to a key group
730 ppKeyGroup = &pEngineChannel->ActiveKeyGroups[itNewVoice->KeyGroup];
731 if (*ppKeyGroup) { // if there's already an active key in that key group
732 midi_key_info_t* pOtherKey = &pEngineChannel->pMIDIKeyInfo[**ppKeyGroup];
733 // kill all voices on the (other) key
734 RTList<Voice>::Iterator itVoiceToBeKilled = pOtherKey->pActiveVoices->first();
735 RTList<Voice>::Iterator end = pOtherKey->pActiveVoices->end();
736 for (; itVoiceToBeKilled != end; ++itVoiceToBeKilled) {
737 if (itVoiceToBeKilled->Type != Voice::type_release_trigger) itVoiceToBeKilled->Kill(itNoteOnEvent);
738 }
739 }
740 }
741 if (!pKey->Active) { // mark as active key
742 pKey->Active = true;
743 pKey->itSelf = pEngineChannel->pActiveKeys->allocAppend();
744 *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 MAX_AUDIO_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 (VOICE_STEAL_ALGORITHM) {
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
834 // 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 }
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 }
880 }
881
882 /**
883 * Removes the given voice from the MIDI key's list of active voices.
884 * This method will be called when a voice went inactive, e.g. because
885 * it finished to playback its sample, finished its release stage or
886 * just was killed.
887 *
888 * @param pEngineChannel - engine channel on which this event occured on
889 * @param itVoice - points to the voice to be freed
890 */
891 void Engine::FreeVoice(EngineChannel* pEngineChannel, Pool<Voice>::Iterator& itVoice) {
892 if (itVoice) {
893 midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[itVoice->MIDIKey];
894
895 uint keygroup = itVoice->KeyGroup;
896
897 // free the voice object
898 pVoicePool->free(itVoice);
899
900 // if no other voices left and member of a key group, remove from key group
901 if (pKey->pActiveVoices->isEmpty() && keygroup) {
902 uint** ppKeyGroup = &pEngineChannel->ActiveKeyGroups[keygroup];
903 if (*ppKeyGroup == &*pKey->itSelf) *ppKeyGroup = NULL; // remove key from key group
904 }
905 }
906 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,
930 * modulation wheel, aftertouch).
931 *
932 * @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(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itControlChangeEvent) {
936 dmsg(4,("Engine::ContinuousController cc=%d v=%d\n", itControlChangeEvent->Param.CC.Controller, itControlChangeEvent->Param.CC.Value));
937
938 // update controller value in the engine channel's controller table
939 pEngineChannel->ControllerTable[itControlChangeEvent->Param.CC.Controller] = itControlChangeEvent->Param.CC.Value;
940
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"));
960 pEngineChannel->SustainPedal = true;
961
962 // cancel release process of voices if necessary
963 RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first();
964 for (; iuiKey; ++iuiKey) {
965 midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey];
966 if (!pKey->KeyPressed) {
967 RTList<Event>::Iterator itNewEvent = pKey->pEvents->allocAppend();
968 if (itNewEvent) {
969 *itNewEvent = *itControlChangeEventOnCCList; // copy event to the key's own event list
970 itNewEvent->Type = Event::type_cancel_release; // transform event type
971 }
972 else dmsg(1,("Event pool emtpy!\n"));
973 }
974 }
975 }
976 if (itControlChangeEventOnCCList->Param.CC.Value < 64 && pEngineChannel->SustainPedal) {
977 dmsg(4,("PEDAL UP\n"));
978 pEngineChannel->SustainPedal = false;
979
980 // release voices if their respective key is not pressed
981 RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first();
982 for (; iuiKey; ++iuiKey) {
983 midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey];
984 if (!pKey->KeyPressed) {
985 RTList<Event>::Iterator itNewEvent = pKey->pEvents->allocAppend();
986 if (itNewEvent) {
987 *itNewEvent = *itControlChangeEventOnCCList; // copy event to the key's own event list
988 itNewEvent->Type = Event::type_release; // transform event type
989 }
990 else dmsg(1,("Event pool emtpy!\n"));
991 }
992 }
993 }
994 break;
995 }
996
997
998 // Channel Mode Messages
999
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 * Reacts on MIDI system exclusive messages.
1017 *
1018 * @param itSysexEvent - sysex data size and time stamp of the sysex event
1019 */
1020 void Engine::ProcessSysex(Pool<Event>::Iterator& itSysexEvent) {
1021 RingBuffer<uint8_t>::NonVolatileReader reader = pSysexBuffer->get_non_volatile_reader();
1022
1023 uint8_t exclusive_status, id;
1024 if (!reader.pop(&exclusive_status)) goto free_sysex_data;
1025 if (!reader.pop(&id)) goto free_sysex_data;
1026 if (exclusive_status != 0xF0) goto free_sysex_data;
1027
1028 switch (id) {
1029 case 0x41: { // Roland
1030 uint8_t device_id, model_id, cmd_id;
1031 if (!reader.pop(&device_id)) goto free_sysex_data;
1032 if (!reader.pop(&model_id)) goto free_sysex_data;
1033 if (!reader.pop(&cmd_id)) goto free_sysex_data;
1034 if (model_id != 0x42 /*GS*/) goto free_sysex_data;
1035 if (cmd_id != 0x12 /*DT1*/) goto free_sysex_data;
1036
1037 // command address
1038 uint8_t addr[3]; // 2 byte addr MSB, followed by 1 byte addr LSB)
1039 const RingBuffer<uint8_t>::NonVolatileReader checksum_reader = reader; // so we can calculate the check sum later
1040 if (reader.read(&addr[0], 3) != 3) goto free_sysex_data;
1041 if (addr[0] == 0x40 && addr[1] == 0x00) { // System Parameters
1042 }
1043 else if (addr[0] == 0x40 && addr[1] == 0x01) { // Common Parameters
1044 }
1045 else if (addr[0] == 0x40 && (addr[1] & 0xf0) == 0x10) { // Part Parameters (1)
1046 switch (addr[3]) {
1047 case 0x40: { // scale tuning
1048 uint8_t scale_tunes[12]; // detuning of all 12 semitones of an octave
1049 if (reader.read(&scale_tunes[0], 12) != 12) goto free_sysex_data;
1050 uint8_t checksum;
1051 if (!reader.pop(&checksum)) goto free_sysex_data;
1052 if (GSCheckSum(checksum_reader, 12) != checksum) goto free_sysex_data;
1053 for (int i = 0; i < 12; i++) scale_tunes[i] -= 64;
1054 AdjustScale((int8_t*) scale_tunes);
1055 break;
1056 }
1057 }
1058 }
1059 else if (addr[0] == 0x40 && (addr[1] & 0xf0) == 0x20) { // Part Parameters (2)
1060 }
1061 else if (addr[0] == 0x41) { // Drum Setup Parameters
1062 }
1063 break;
1064 }
1065 }
1066
1067 free_sysex_data: // finally free sysex data
1068 pSysexBuffer->increment_read_ptr(itSysexEvent->Param.Sysex.Size);
1069 }
1070
1071 /**
1072 * Calculates the Roland GS sysex check sum.
1073 *
1074 * @param AddrReader - reader which currently points to the first GS
1075 * command address byte of the GS sysex message in
1076 * question
1077 * @param DataSize - size of the GS message data (in bytes)
1078 */
1079 uint8_t Engine::GSCheckSum(const RingBuffer<uint8_t>::NonVolatileReader AddrReader, uint DataSize) {
1080 RingBuffer<uint8_t>::NonVolatileReader reader = AddrReader;
1081 uint bytes = 3 /*addr*/ + DataSize;
1082 uint8_t addr_and_data[bytes];
1083 reader.read(&addr_and_data[0], bytes);
1084 uint8_t sum = 0;
1085 for (uint i = 0; i < bytes; i++) sum += addr_and_data[i];
1086 return 128 - sum % 128;
1087 }
1088
1089 /**
1090 * Allows to tune each of the twelve semitones of an octave.
1091 *
1092 * @param ScaleTunes - detuning of all twelve semitones (in cents)
1093 */
1094 void Engine::AdjustScale(int8_t ScaleTunes[12]) {
1095 memcpy(&this->ScaleTuning[0], &ScaleTunes[0], 12); //TODO: currently not sample accurate
1096 }
1097
1098 /**
1099 * Releases all voices on an engine channel. All voices will go into
1100 * the release stage and thus it might take some time (e.g. dependant to
1101 * their envelope release time) until they actually die.
1102 *
1103 * @param pEngineChannel - engine channel on which all voices should be released
1104 * @param itReleaseEvent - event which caused this releasing of all voices
1105 */
1106 void Engine::ReleaseAllVoices(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itReleaseEvent) {
1107 RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first();
1108 while (iuiKey) {
1109 midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey];
1110 ++iuiKey;
1111 // append a 'release' event to the key's own event list
1112 RTList<Event>::Iterator itNewEvent = pKey->pEvents->allocAppend();
1113 if (itNewEvent) {
1114 *itNewEvent = *itReleaseEvent; // copy original event (to the key's event list)
1115 itNewEvent->Type = Event::type_release; // transform event type
1116 }
1117 else dmsg(1,("Event pool emtpy!\n"));
1118 }
1119 }
1120
1121 /**
1122 * Kills all voices on an engine channel as soon as possible. Voices
1123 * won't get into release state, their volume level will be ramped down
1124 * as fast as possible.
1125 *
1126 * @param pEngineChannel - engine channel on which all voices should be killed
1127 * @param itKillEvent - event which caused this killing of all voices
1128 */
1129 void Engine::KillAllVoices(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itKillEvent) {
1130 RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first();
1131 RTList<uint>::Iterator end = pEngineChannel->pActiveKeys->end();
1132 while (iuiKey != end) { // iterate through all active keys
1133 midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey];
1134 ++iuiKey;
1135 RTList<Voice>::Iterator itVoice = pKey->pActiveVoices->first();
1136 RTList<Voice>::Iterator itVoicesEnd = pKey->pActiveVoices->end();
1137 for (; itVoice != itVoicesEnd; ++itVoice) { // iterate through all voices on this key
1138 itVoice->Kill(itKillEvent);
1139 }
1140 }
1141 }
1142
1143 /**
1144 * Initialize the parameter sequence for the modulation destination given by
1145 * by 'dst' with the constant value given by val.
1146 */
1147 void Engine::ResetSynthesisParameters(Event::destination_t dst, float val) {
1148 int maxsamples = pAudioOutputDevice->MaxSamplesPerCycle();
1149 float* m = &pSynthesisParameters[dst][0];
1150 for (int i = 0; i < maxsamples; i += 4) {
1151 m[i] = val;
1152 m[i+1] = val;
1153 m[i+2] = val;
1154 m[i+3] = val;
1155 }
1156 }
1157
1158 uint Engine::VoiceCount() {
1159 return ActiveVoiceCount;
1160 }
1161
1162 uint Engine::VoiceCountMax() {
1163 return ActiveVoiceCountMax;
1164 }
1165
1166 bool Engine::DiskStreamSupported() {
1167 return true;
1168 }
1169
1170 uint Engine::DiskStreamCount() {
1171 return (pDiskThread) ? pDiskThread->ActiveStreamCount : 0;
1172 }
1173
1174 uint Engine::DiskStreamCountMax() {
1175 return (pDiskThread) ? pDiskThread->ActiveStreamCountMax : 0;
1176 }
1177
1178 String Engine::DiskStreamBufferFillBytes() {
1179 return pDiskThread->GetBufferFillBytes();
1180 }
1181
1182 String Engine::DiskStreamBufferFillPercentage() {
1183 return pDiskThread->GetBufferFillPercentage();
1184 }
1185
1186 String Engine::EngineName() {
1187 return "GigEngine";
1188 }
1189
1190 String Engine::Description() {
1191 return "Gigasampler Engine";
1192 }
1193
1194 String Engine::Version() {
1195 String s = "$Revision: 1.33 $";
1196 return s.substr(11, s.size() - 13); // cut dollar signs, spaces and CVS macro keyword
1197 }
1198
1199 }} // namespace LinuxSampler::gig

  ViewVC Help
Powered by ViewVC