96 |
else dmsg(4,("This gig::Engine has now %d EngineChannels.\n",pEngine->engineChannels.size())); |
else dmsg(4,("This gig::Engine has now %d EngineChannels.\n",pEngine->engineChannels.size())); |
97 |
} |
} |
98 |
|
|
99 |
|
/** |
100 |
|
* Constructor |
101 |
|
*/ |
102 |
Engine::Engine() { |
Engine::Engine() { |
103 |
pAudioOutputDevice = NULL; |
pAudioOutputDevice = NULL; |
104 |
pDiskThread = NULL; |
pDiskThread = NULL; |
121 |
ResetInternal(); |
ResetInternal(); |
122 |
} |
} |
123 |
|
|
124 |
|
/** |
125 |
|
* Destructor |
126 |
|
*/ |
127 |
Engine::~Engine() { |
Engine::~Engine() { |
128 |
if (pDiskThread) { |
if (pDiskThread) { |
129 |
dmsg(1,("Stopping disk thread...")); |
dmsg(1,("Stopping disk thread...")); |
204 |
pEventQueue->init(); |
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) { |
void Engine::Connect(AudioOutputDevice* pAudioOut) { |
217 |
pAudioOutputDevice = pAudioOut; |
pAudioOutputDevice = pAudioOut; |
218 |
|
|
287 |
} |
} |
288 |
} |
} |
289 |
|
|
290 |
|
/** |
291 |
|
* Clear all engine global event lists. |
292 |
|
*/ |
293 |
void Engine::ClearEventLists() { |
void Engine::ClearEventLists() { |
294 |
pGlobalEvents->clear(); |
pGlobalEvents->clear(); |
295 |
} |
} |
417 |
return 0; |
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) { |
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 |
// 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.) |
// (these are the common events like NoteOn, NoteOff, ControlChange, etc.) |
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) { |
void Engine::RenderActiveVoices(EngineChannel* pEngineChannel, uint Samples) { |
471 |
RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first(); |
RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first(); |
472 |
RTList<uint>::Iterator end = pEngineChannel->pActiveKeys->end(); |
RTList<uint>::Iterator end = pEngineChannel->pActiveKeys->end(); |
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) { |
void Engine::RenderStolenVoices(uint Samples) { |
504 |
RTList<Event>::Iterator itVoiceStealEvent = pVoiceStealingQueue->first(); |
RTList<Event>::Iterator itVoiceStealEvent = pVoiceStealingQueue->first(); |
505 |
RTList<Event>::Iterator end = pVoiceStealingQueue->end(); |
RTList<Event>::Iterator end = pVoiceStealingQueue->end(); |
515 |
} |
} |
516 |
} |
} |
517 |
else dmsg(1,("gig::Engine: ERROR, voice stealing didn't work out!\n")); |
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) { |
void Engine::PostProcess(EngineChannel* pEngineChannel) { |
534 |
// free all keys which have no active voices left |
// free all keys which have no active voices left |
535 |
{ |
{ |
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++; |
pKey->RoundRobinIndex++; |
644 |
} |
} |
645 |
|
|
677 |
} |
} |
678 |
pKey->ReleaseTrigger = false; |
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 |
/** |
/** |
751 |
} |
} |
752 |
} |
} |
753 |
else if (VoiceStealing) { |
else if (VoiceStealing) { |
|
|
|
754 |
// try to steal one voice |
// try to steal one voice |
755 |
StealVoice(pEngineChannel, itNoteOnEvent); |
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 |
// put note-on event into voice-stealing queue, so it will be reprocessed after killed voice died |
758 |
RTList<Event>::Iterator itStealEvent = pVoiceStealingQueue->allocAppend(); |
RTList<Event>::Iterator itStealEvent = pVoiceStealingQueue->allocAppend(); |
759 |
if (itStealEvent) { |
if (itStealEvent) { |
760 |
*itStealEvent = *itNoteOnEvent; // copy event |
*itStealEvent = *itNoteOnEvent; // copy event |
761 |
itStealEvent->Param.Note.Layer = iLayer; |
itStealEvent->Param.Note.Layer = iLayer; |
762 |
itStealEvent->Param.Note.ReleaseTrigger = ReleaseTriggerVoice; |
itStealEvent->Param.Note.ReleaseTrigger = ReleaseTriggerVoice; |
763 |
|
pKey->VoiceTheftsQueued++; |
764 |
|
} |
765 |
|
else dmsg(1,("Voice stealing queue full!\n")); |
766 |
} |
} |
|
else dmsg(1,("Voice stealing queue full!\n")); |
|
767 |
} |
} |
768 |
|
|
769 |
return Pool<Voice>::Iterator(); // no free voice or error |
return Pool<Voice>::Iterator(); // no free voice or error |
777 |
* |
* |
778 |
* @param pEngineChannel - engine channel on which this event occured on |
* @param pEngineChannel - engine channel on which this event occured on |
779 |
* @param itNoteOnEvent - key, velocity and time stamp of the event |
* @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 |
void Engine::StealVoice(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOnEvent) { |
int Engine::StealVoice(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOnEvent) { |
783 |
if (!VoiceTheftsLeft) { |
if (!VoiceTheftsLeft) { |
784 |
dmsg(1,("Max. voice thefts per audio fragment reached (you may raise MAX_AUDIO_VOICES).\n")); |
dmsg(1,("Max. voice thefts per audio fragment reached (you may raise MAX_AUDIO_VOICES).\n")); |
785 |
return; |
return -1; |
786 |
} |
} |
787 |
if (!pEventPool->poolIsEmpty()) { |
if (!pEventPool->poolIsEmpty()) { |
788 |
|
|
835 |
case voice_steal_algo_none: |
case voice_steal_algo_none: |
836 |
default: { |
default: { |
837 |
dmsg(1,("No free voice (voice stealing disabled)!\n")); |
dmsg(1,("No free voice (voice stealing disabled)!\n")); |
838 |
return; |
return -1; |
839 |
} |
} |
840 |
} |
} |
841 |
|
|
858 |
} |
} |
859 |
|
|
860 |
//FIXME: can be removed, just a sanity check for debugging |
//FIXME: can be removed, just a sanity check for debugging |
861 |
if (!itSelectedVoice->IsActive()) dmsg(1,("gig::Engine: ERROR, tried to steal a voice which was not active !!!\n")); |
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 |
// now kill the selected voice |
867 |
itSelectedVoice->Kill(itNoteOnEvent); |
itSelectedVoice->Kill(itNoteOnEvent); |
870 |
itLastStolenVoice = itSelectedVoice; |
itLastStolenVoice = itSelectedVoice; |
871 |
|
|
872 |
--VoiceTheftsLeft; |
--VoiceTheftsLeft; |
873 |
|
|
874 |
|
return 0; // success |
875 |
|
} |
876 |
|
else { |
877 |
|
dmsg(1,("Event pool emtpy!\n")); |
878 |
|
return -1; |
879 |
} |
} |
|
else dmsg(1,("Event pool emtpy!\n")); |
|
880 |
} |
} |
881 |
|
|
882 |
/** |
/** |
935 |
void Engine::ProcessControlChange(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itControlChangeEvent) { |
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)); |
dmsg(4,("Engine::ContinuousController cc=%d v=%d\n", itControlChangeEvent->Param.CC.Controller, itControlChangeEvent->Param.CC.Value)); |
937 |
|
|
938 |
switch (itControlChangeEvent->Param.CC.Controller) { |
// 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 |
case 7: { // volume |
946 |
//TODO: not sample accurate yet |
//TODO: not sample accurate yet |
947 |
pEngineChannel->GlobalVolume = (float) itControlChangeEvent->Param.CC.Value / 127.0f; |
pEngineChannel->GlobalVolume = (float) itControlChangeEventOnCCList->Param.CC.Value / 127.0f; |
948 |
break; |
break; |
949 |
} |
} |
950 |
case 10: { // panpot |
case 10: { // panpot |
951 |
//TODO: not sample accurate yet |
//TODO: not sample accurate yet |
952 |
const int pan = (int) itControlChangeEvent->Param.CC.Value - 64; |
const int pan = (int) itControlChangeEventOnCCList->Param.CC.Value - 64; |
953 |
pEngineChannel->GlobalPanLeft = 1.0f - float(RTMath::Max(pan, 0)) / 63.0f; |
pEngineChannel->GlobalPanLeft = 1.0f - float(RTMath::Max(pan, 0)) / 63.0f; |
954 |
pEngineChannel->GlobalPanRight = 1.0f - float(RTMath::Min(pan, 0)) / -64.0f; |
pEngineChannel->GlobalPanRight = 1.0f - float(RTMath::Min(pan, 0)) / -64.0f; |
955 |
break; |
break; |
956 |
} |
} |
957 |
case 64: { // sustain |
case 64: { // sustain |
958 |
if (itControlChangeEvent->Param.CC.Value >= 64 && !pEngineChannel->SustainPedal) { |
if (itControlChangeEventOnCCList->Param.CC.Value >= 64 && !pEngineChannel->SustainPedal) { |
959 |
dmsg(4,("PEDAL DOWN\n")); |
dmsg(4,("PEDAL DOWN\n")); |
960 |
pEngineChannel->SustainPedal = true; |
pEngineChannel->SustainPedal = true; |
961 |
|
|
962 |
// cancel release process of voices if necessary |
// cancel release process of voices if necessary |
963 |
RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first(); |
RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first(); |
964 |
if (iuiKey) { |
for (; iuiKey; ++iuiKey) { |
965 |
itControlChangeEvent->Type = Event::type_cancel_release; // transform event type |
midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey]; |
966 |
while (iuiKey) { |
if (!pKey->KeyPressed) { |
967 |
midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey]; |
RTList<Event>::Iterator itNewEvent = pKey->pEvents->allocAppend(); |
968 |
++iuiKey; |
if (itNewEvent) { |
969 |
if (!pKey->KeyPressed) { |
*itNewEvent = *itControlChangeEventOnCCList; // copy event to the key's own event list |
970 |
RTList<Event>::Iterator itNewEvent = pKey->pEvents->allocAppend(); |
itNewEvent->Type = Event::type_cancel_release; // transform event type |
|
if (itNewEvent) *itNewEvent = *itControlChangeEvent; // copy event to the key's own event list |
|
|
else dmsg(1,("Event pool emtpy!\n")); |
|
971 |
} |
} |
972 |
|
else dmsg(1,("Event pool emtpy!\n")); |
973 |
} |
} |
974 |
} |
} |
975 |
} |
} |
976 |
if (itControlChangeEvent->Param.CC.Value < 64 && pEngineChannel->SustainPedal) { |
if (itControlChangeEventOnCCList->Param.CC.Value < 64 && pEngineChannel->SustainPedal) { |
977 |
dmsg(4,("PEDAL UP\n")); |
dmsg(4,("PEDAL UP\n")); |
978 |
pEngineChannel->SustainPedal = false; |
pEngineChannel->SustainPedal = false; |
979 |
|
|
980 |
// release voices if their respective key is not pressed |
// release voices if their respective key is not pressed |
981 |
RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first(); |
RTList<uint>::Iterator iuiKey = pEngineChannel->pActiveKeys->first(); |
982 |
if (iuiKey) { |
for (; iuiKey; ++iuiKey) { |
983 |
itControlChangeEvent->Type = Event::type_release; // transform event type |
midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey]; |
984 |
while (iuiKey) { |
if (!pKey->KeyPressed) { |
985 |
midi_key_info_t* pKey = &pEngineChannel->pMIDIKeyInfo[*iuiKey]; |
RTList<Event>::Iterator itNewEvent = pKey->pEvents->allocAppend(); |
986 |
++iuiKey; |
if (itNewEvent) { |
987 |
if (!pKey->KeyPressed) { |
*itNewEvent = *itControlChangeEventOnCCList; // copy event to the key's own event list |
988 |
RTList<Event>::Iterator itNewEvent = pKey->pEvents->allocAppend(); |
itNewEvent->Type = Event::type_release; // transform event type |
|
if (itNewEvent) *itNewEvent = *itControlChangeEvent; // copy event to the key's own event list |
|
|
else dmsg(1,("Event pool emtpy!\n")); |
|
989 |
} |
} |
990 |
|
else dmsg(1,("Event pool emtpy!\n")); |
991 |
} |
} |
992 |
} |
} |
993 |
} |
} |
994 |
break; |
break; |
995 |
} |
} |
|
} |
|
996 |
|
|
|
// update controller value in the engine's controller table |
|
|
pEngineChannel->ControllerTable[itControlChangeEvent->Param.CC.Controller] = itControlChangeEvent->Param.CC.Value; |
|
997 |
|
|
998 |
// move event from the unsorted event list to the control change event list |
// Channel Mode Messages |
999 |
itControlChangeEvent.moveToEndOf(pEngineChannel->pCCEvents); |
|
1000 |
|
case 120: { // all sound off |
1001 |
|
KillAllVoices(pEngineChannel, itControlChangeEventOnCCList); |
1002 |
|
break; |
1003 |
|
} |
1004 |
|
case 121: { // reset all controllers |
1005 |
|
pEngineChannel->ResetControllers(); |
1006 |
|
break; |
1007 |
|
} |
1008 |
|
case 123: { // all notes off |
1009 |
|
ReleaseAllVoices(pEngineChannel, itControlChangeEventOnCCList); |
1010 |
|
break; |
1011 |
|
} |
1012 |
|
} |
1013 |
} |
} |
1014 |
|
|
1015 |
/** |
/** |
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 |
* Initialize the parameter sequence for the modulation destination given by |
1145 |
* by 'dst' with the constant value given by val. |
* by 'dst' with the constant value given by val. |
1146 |
*/ |
*/ |
1192 |
} |
} |
1193 |
|
|
1194 |
String Engine::Version() { |
String Engine::Version() { |
1195 |
String s = "$Revision: 1.32 $"; |
String s = "$Revision: 1.33 $"; |
1196 |
return s.substr(11, s.size() - 13); // cut dollar signs, spaces and CVS macro keyword |
return s.substr(11, s.size() - 13); // cut dollar signs, spaces and CVS macro keyword |
1197 |
} |
} |
1198 |
|
|