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

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

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

revision 796 by persson, Sun Oct 30 08:35:13 2005 UTC revision 3561 by schoenebeck, Fri Aug 23 11:44:00 2019 UTC
# Line 3  Line 3 
3   *   LinuxSampler - modular, streaming capable sampler                     *   *   LinuxSampler - modular, streaming capable sampler                     *
4   *                                                                         *   *                                                                         *
5   *   Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck   *   *   Copyright (C) 2003, 2004 by Benno Senoner and Christian Schoenebeck   *
6   *   Copyright (C) 2005 Christian Schoenebeck                              *   *   Copyright (C) 2005 - 2008 Christian Schoenebeck                       *
7     *   Copyright (C) 2009 Christian Schoenebeck and Grigor Iliev             *
8     *   Copyright (C) 2010 - 2017 Christian Schoenebeck and Andreas Persson   *
9   *                                                                         *   *                                                                         *
10   *   This program is free software; you can redistribute it and/or modify  *   *   This program is free software; you can redistribute it and/or modify  *
11   *   it under the terms of the GNU General Public License as published by  *   *   it under the terms of the GNU General Public License as published by  *
# Line 24  Line 26 
26  #include "../../common/Features.h"  #include "../../common/Features.h"
27  #include "Synthesizer.h"  #include "Synthesizer.h"
28  #include "Profiler.h"  #include "Profiler.h"
29    #include "Engine.h"
30    #include "EngineChannel.h"
31    
32  #include "Voice.h"  #include "Voice.h"
33    
34  namespace LinuxSampler { namespace gig {  namespace LinuxSampler { namespace gig {
35    
     const float Voice::FILTER_CUTOFF_COEFF(CalculateFilterCutoffCoeff());  
   
     float Voice::CalculateFilterCutoffCoeff() {  
         return log(CONFIG_FILTER_CUTOFF_MAX / CONFIG_FILTER_CUTOFF_MIN);  
     }  
   
36      Voice::Voice() {      Voice::Voice() {
37          pEngine     = NULL;          pEngine = NULL;
38          pDiskThread = NULL;          pEG1 = &EG1;
39          PlaybackState = playback_state_end;          pEG2 = &EG2;
         pLFO1 = new LFOUnsigned(1.0f);  // amplitude EG (0..1 range)  
         pLFO2 = new LFOUnsigned(1.0f);  // filter EG (0..1 range)  
         pLFO3 = new LFOSigned(1200.0f); // pitch EG (-1200..+1200 range)  
         KeyGroup = 0;  
         SynthesisMode = 0; // set all mode bits to 0 first  
         // select synthesis implementation (currently either pure C++ or MMX+SSE(1))  
         #if CONFIG_ASM && ARCH_X86  
         SYNTHESIS_MODE_SET_IMPLEMENTATION(SynthesisMode, Features::supportsMMX() && Features::supportsSSE());  
         #else  
         SYNTHESIS_MODE_SET_IMPLEMENTATION(SynthesisMode, false);  
         #endif  
         SYNTHESIS_MODE_SET_PROFILING(SynthesisMode, Profiler::isEnabled());  
   
         finalSynthesisParameters.filterLeft.Reset();  
         finalSynthesisParameters.filterRight.Reset();  
40      }      }
41    
42      Voice::~Voice() {      Voice::~Voice() {
         if (pLFO1) delete pLFO1;  
         if (pLFO2) delete pLFO2;  
         if (pLFO3) delete pLFO3;  
43      }      }
44    
45      void Voice::SetEngine(Engine* pEngine) {      EngineChannel* Voice::GetGigEngineChannel() {
46          this->pEngine     = pEngine;          return static_cast<EngineChannel*>(pEngineChannel);
         this->pDiskThread = pEngine->pDiskThread;  
         dmsg(6,("Voice::SetEngine()\n"));  
47      }      }
48    
49      /**      void Voice::SetEngine(LinuxSampler::Engine* pEngine) {
50       *  Initializes and triggers the voice, a disk stream will be launched if          Engine* engine = static_cast<Engine*>(pEngine);
51       *  needed.          this->pEngine     = engine;
52       *          this->pDiskThread = engine->pDiskThread;
53       *  @param pEngineChannel - engine channel on which this voice was ordered          dmsg(6,("Voice::SetEngine()\n"));
54       *  @param itNoteOnEvent  - event that caused triggering of this voice      }
      *  @param PitchBend      - MIDI detune factor (-8192 ... +8191)  
      *  @param pDimRgn        - points to the dimension region which provides sample wave(s) and articulation data  
      *  @param VoiceType      - type of this voice  
      *  @param iKeyGroup      - a value > 0 defines a key group in which this voice is member of  
      *  @returns 0 on success, a value < 0 if the voice wasn't triggered  
      *           (either due to an error or e.g. because no region is  
      *           defined for the given key)  
      */  
     int Voice::Trigger(EngineChannel* pEngineChannel, Pool<Event>::Iterator& itNoteOnEvent, int PitchBend, ::gig::DimensionRegion* pDimRgn, type_t VoiceType, int iKeyGroup) {  
         this->pEngineChannel = pEngineChannel;  
         this->pDimRgn        = pDimRgn;  
   
         #if CONFIG_DEVMODE  
         if (itNoteOnEvent->FragmentPos() > pEngine->MaxSamplesPerCycle) { // just a sanity check for debugging  
             dmsg(1,("Voice::Trigger(): ERROR, TriggerDelay > Totalsamples\n"));  
         }  
         #endif // CONFIG_DEVMODE  
   
         Type            = VoiceType;  
         MIDIKey         = itNoteOnEvent->Param.Note.Key;  
         PlaybackState   = playback_state_init; // mark voice as triggered, but no audio rendered yet  
         Delay           = itNoteOnEvent->FragmentPos();  
         itTriggerEvent  = itNoteOnEvent;  
         itKillEvent     = Pool<Event>::Iterator();  
         KeyGroup        = iKeyGroup;  
         pSample         = pDimRgn->pSample; // sample won't change until the voice is finished  
   
         // calculate volume  
         const double velocityAttenuation = pDimRgn->GetVelocityAttenuation(itNoteOnEvent->Param.Note.Velocity);  
   
         Volume = velocityAttenuation / 32768.0f; // we downscale by 32768 to convert from int16 value range to DSP value range (which is -1.0..1.0)  
   
         Volume *= pDimRgn->SampleAttenuation;  
   
         // the volume of release triggered samples depends on note length  
         if (Type == type_release_trigger) {  
             float noteLength = float(pEngine->FrameTime + Delay -  
                                      pEngineChannel->pMIDIKeyInfo[MIDIKey].NoteOnTime) / pEngine->SampleRate;  
             float attenuation = 1 - 0.01053 * (256 >> pDimRgn->ReleaseTriggerDecay) * noteLength;  
             if (attenuation <= 0) return -1;  
             Volume *= attenuation;  
         }  
55    
56          // select channel mode (mono or stereo)      Voice::SampleInfo Voice::GetSampleInfo() {
57          SYNTHESIS_MODE_SET_CHANNELS(SynthesisMode, pSample->Channels == 2);          SampleInfo si;
58            si.SampleRate       = pSample->SamplesPerSecond;
59            si.ChannelCount     = pSample->Channels;
60            si.FrameSize        = pSample->FrameSize;
61            si.BitDepth         = pSample->BitDepth;
62            si.TotalFrameCount  = (uint)pSample->SamplesTotal;
63    
64          // get starting crossfade volume level          si.HasLoops       = pRegion->SampleLoops;
65          switch (pDimRgn->AttenuationController.type) {          si.LoopStart      = (si.HasLoops) ? pRegion->pSampleLoops[0].LoopStart  : 0;
66              case ::gig::attenuation_ctrl_t::type_channelaftertouch:          si.LoopLength     = (si.HasLoops) ? pRegion->pSampleLoops[0].LoopLength : 0;
67                  CrossfadeVolume = 1.0f; //TODO: aftertouch not supported yet          si.LoopPlayCount  = pSample->LoopPlayCount;
68                  break;          si.Unpitched      = !pRegion->PitchTrack;
             case ::gig::attenuation_ctrl_t::type_velocity:  
                 CrossfadeVolume = CrossfadeAttenuation(itNoteOnEvent->Param.Note.Velocity);  
                 break;  
             case ::gig::attenuation_ctrl_t::type_controlchange: //FIXME: currently not sample accurate  
                 CrossfadeVolume = CrossfadeAttenuation(pEngineChannel->ControllerTable[pDimRgn->AttenuationController.controller_number]);  
                 break;  
             case ::gig::attenuation_ctrl_t::type_none: // no crossfade defined  
             default:  
                 CrossfadeVolume = 1.0f;  
         }  
69    
70          PanLeft  = 1.0f - float(RTMath::Max(pDimRgn->Pan, 0)) /  63.0f;          return si;
71          PanRight = 1.0f - float(RTMath::Min(pDimRgn->Pan, 0)) / -64.0f;      }
72    
73          finalSynthesisParameters.dPos = pDimRgn->SampleStartOffset; // offset where we should start playback of sample (0 - 2000 sample points)      Voice::RegionInfo Voice::GetRegionInfo() {
74          Pos = pDimRgn->SampleStartOffset;          RegionInfo ri;
75            ri.UnityNote = pRegion->UnityNote;
76            ri.FineTune  = pRegion->FineTune;
77            ri.Pan       = pRegion->Pan;
78            ri.SampleStartOffset = pRegion->SampleStartOffset;
79    
80          // Check if the sample needs disk streaming or is too short for that          ri.EG2PreAttack        = pRegion->EG2PreAttack;
81          long cachedsamples = pSample->GetCache().Size / pSample->FrameSize;          ri.EG2Attack           = pRegion->EG2Attack;
82          DiskVoice          = cachedsamples < pSample->SamplesTotal;          ri.EG2Decay1           = pRegion->EG2Decay1;
83            ri.EG2Decay2           = pRegion->EG2Decay2;
84          if (DiskVoice) { // voice to be streamed from disk          ri.EG2Sustain          = pRegion->EG2Sustain;
85              MaxRAMPos = cachedsamples - (pEngine->MaxSamplesPerCycle << CONFIG_MAX_PITCH) / pSample->Channels; //TODO: this calculation is too pessimistic and may better be moved to Render() method, so it calculates MaxRAMPos dependent to the current demand of sample points to be rendered (e.g. in case of JACK)          ri.EG2InfiniteSustain  = pRegion->EG2InfiniteSustain;
86            ri.EG2Release          = pRegion->EG2Release;
             // check if there's a loop defined which completely fits into the cached (RAM) part of the sample  
             if (pSample->Loops && pSample->LoopEnd <= MaxRAMPos) {  
                 RAMLoop            = true;  
                 loop.uiTotalCycles = pSample->LoopPlayCount;  
                 loop.uiCyclesLeft  = pSample->LoopPlayCount;  
                 loop.uiStart       = pSample->LoopStart;  
                 loop.uiEnd         = pSample->LoopEnd;  
                 loop.uiSize        = pSample->LoopSize;  
             }  
             else RAMLoop = false;  
87    
88              if (pDiskThread->OrderNewStream(&DiskStreamRef, pSample, MaxRAMPos, !RAMLoop) < 0) {          ri.EG3Attack     = pRegion->EG3Attack;
89                  dmsg(1,("Disk stream order failed!\n"));          ri.EG3Depth      = pRegion->EG3Depth;
90                  KillImmediately();          ri.VCFEnabled    = pRegion->VCFEnabled;
91                  return -1;          ri.VCFType       = Filter::vcf_type_t(pRegion->VCFType);
92              }          ri.VCFResonance  = pRegion->VCFResonance;
             dmsg(4,("Disk voice launched (cached samples: %d, total Samples: %d, MaxRAMPos: %d, RAMLooping: %s)\n", cachedsamples, pSample->SamplesTotal, MaxRAMPos, (RAMLoop) ? "yes" : "no"));  
         }  
         else { // RAM only voice  
             MaxRAMPos = cachedsamples;  
             if (pSample->Loops) {  
                 RAMLoop           = true;  
                 loop.uiCyclesLeft = pSample->LoopPlayCount;  
             }  
             else RAMLoop = false;  
             dmsg(4,("RAM only voice launched (Looping: %s)\n", (RAMLoop) ? "yes" : "no"));  
         }  
93    
94            ri.ReleaseTriggerDecay = 0.01053 * (256 >> pRegion->ReleaseTriggerDecay);
95    
96          // calculate initial pitch value          return ri;
97          {      }
             double pitchbasecents = pDimRgn->FineTune + (int) pEngine->ScaleTuning[MIDIKey % 12];  
             if (pDimRgn->PitchTrack) pitchbasecents += (MIDIKey - (int) pDimRgn->UnityNote) * 100;  
             this->PitchBase = RTMath::CentsToFreqRatio(pitchbasecents) * (double(pSample->SamplesPerSecond) / double(pEngine->SampleRate));  
             this->PitchBend = RTMath::CentsToFreqRatio(((double) PitchBend / 8192.0) * 200.0); // pitchbend wheel +-2 semitones = 200 cents  
         }  
   
         // the length of the decay and release curves are dependent on the velocity  
         const double velrelease = 1 / pDimRgn->GetVelocityRelease(itNoteOnEvent->Param.Note.Velocity);  
   
         // setup EG 1 (VCA EG)  
         {  
             // get current value of EG1 controller  
             double eg1controllervalue;  
             switch (pDimRgn->EG1Controller.type) {  
                 case ::gig::eg1_ctrl_t::type_none: // no controller defined  
                     eg1controllervalue = 0;  
                     break;  
                 case ::gig::eg1_ctrl_t::type_channelaftertouch:  
                     eg1controllervalue = 0; // TODO: aftertouch not yet supported  
                     break;  
                 case ::gig::eg1_ctrl_t::type_velocity:  
                     eg1controllervalue = itNoteOnEvent->Param.Note.Velocity;  
                     break;  
                 case ::gig::eg1_ctrl_t::type_controlchange: // MIDI control change controller  
                     eg1controllervalue = pEngineChannel->ControllerTable[pDimRgn->EG1Controller.controller_number];  
                     break;  
             }  
             if (pDimRgn->EG1ControllerInvert) eg1controllervalue = 127 - eg1controllervalue;  
98    
99              // calculate influence of EG1 controller on EG1's parameters      Voice::InstrumentInfo Voice::GetInstrumentInfo() {
100              // (eg1attack is different from the others)          InstrumentInfo ii;
101              double eg1attack  = (pDimRgn->EG1ControllerAttackInfluence)  ?          ii.FineTune = GetGigEngineChannel()->pInstrument->FineTune;
102                  1 + 0.031 * (double) (pDimRgn->EG1ControllerAttackInfluence == 1 ?          ii.PitchbendRange = GetGigEngineChannel()->pInstrument->PitchbendRange;
                                       1 : 1 << pDimRgn->EG1ControllerAttackInfluence) * eg1controllervalue : 1.0;  
             double eg1decay   = (pDimRgn->EG1ControllerDecayInfluence)   ? 1 + 0.00775 * (double) (1 << pDimRgn->EG1ControllerDecayInfluence)   * eg1controllervalue : 1.0;  
             double eg1release = (pDimRgn->EG1ControllerReleaseInfluence) ? 1 + 0.00775 * (double) (1 << pDimRgn->EG1ControllerReleaseInfluence) * eg1controllervalue : 1.0;  
   
             EG1.trigger(pDimRgn->EG1PreAttack,  
                         pDimRgn->EG1Attack * eg1attack,  
                         pDimRgn->EG1Hold,  
                         pDimRgn->EG1Decay1 * eg1decay * velrelease,  
                         pDimRgn->EG1Decay2 * eg1decay * velrelease,  
                         pDimRgn->EG1InfiniteSustain,  
                         pDimRgn->EG1Sustain,  
                         pDimRgn->EG1Release * eg1release * velrelease,  
                         velocityAttenuation,  
                         pEngine->SampleRate / CONFIG_DEFAULT_SUBFRAGMENT_SIZE);  
         }  
103    
104            return ii;
105        }
106    
107          // setup EG 2 (VCF Cutoff EG)      double Voice::GetSampleAttenuation() {
108          {          return pRegion->SampleAttenuation;
109              // get current value of EG2 controller      }
             double eg2controllervalue;  
             switch (pDimRgn->EG2Controller.type) {  
                 case ::gig::eg2_ctrl_t::type_none: // no controller defined  
                     eg2controllervalue = 0;  
                     break;  
                 case ::gig::eg2_ctrl_t::type_channelaftertouch:  
                     eg2controllervalue = 0; // TODO: aftertouch not yet supported  
                     break;  
                 case ::gig::eg2_ctrl_t::type_velocity:  
                     eg2controllervalue = itNoteOnEvent->Param.Note.Velocity;  
                     break;  
                 case ::gig::eg2_ctrl_t::type_controlchange: // MIDI control change controller  
                     eg2controllervalue = pEngineChannel->ControllerTable[pDimRgn->EG2Controller.controller_number];  
                     break;  
             }  
             if (pDimRgn->EG2ControllerInvert) eg2controllervalue = 127 - eg2controllervalue;  
110    
111              // calculate influence of EG2 controller on EG2's parameters      double Voice::GetVelocityAttenuation(uint8_t MIDIKeyVelocity) {
112              double eg2attack  = (pDimRgn->EG2ControllerAttackInfluence)  ? 1 + 0.00775 * (double) (1 << pDimRgn->EG2ControllerAttackInfluence)  * eg2controllervalue : 1.0;          return pRegion->GetVelocityAttenuation(MIDIKeyVelocity);
113              double eg2decay   = (pDimRgn->EG2ControllerDecayInfluence)   ? 1 + 0.00775 * (double) (1 << pDimRgn->EG2ControllerDecayInfluence)   * eg2controllervalue : 1.0;      }
             double eg2release = (pDimRgn->EG2ControllerReleaseInfluence) ? 1 + 0.00775 * (double) (1 << pDimRgn->EG2ControllerReleaseInfluence) * eg2controllervalue : 1.0;  
   
             EG2.trigger(pDimRgn->EG2PreAttack,  
                         pDimRgn->EG2Attack * eg2attack,  
                         false,  
                         pDimRgn->EG2Decay1 * eg2decay * velrelease,  
                         pDimRgn->EG2Decay2 * eg2decay * velrelease,  
                         pDimRgn->EG2InfiniteSustain,  
                         pDimRgn->EG2Sustain,  
                         pDimRgn->EG2Release * eg2release * velrelease,  
                         velocityAttenuation,  
                         pEngine->SampleRate / CONFIG_DEFAULT_SUBFRAGMENT_SIZE);  
         }  
114    
115        double Voice::GetVelocityRelease(uint8_t MIDIKeyVelocity) {
116            return pRegion->GetVelocityRelease(MIDIKeyVelocity);
117        }
118    
119          // setup EG 3 (VCO EG)      void Voice::ProcessCCEvent(RTList<Event>::Iterator& itEvent) {
120          {          if (itEvent->Type == Event::type_control_change && itEvent->Param.CC.Controller) { // if (valid) MIDI control change event
121            double eg3depth = RTMath::CentsToFreqRatio(pDimRgn->EG3Depth);              if (pRegion->AttenuationController.type == ::gig::attenuation_ctrl_t::type_controlchange &&
122            EG3.trigger(eg3depth, pDimRgn->EG3Attack, pEngine->SampleRate / CONFIG_DEFAULT_SUBFRAGMENT_SIZE);                  itEvent->Param.CC.Controller == pRegion->AttenuationController.controller_number) {
123                    CrossfadeSmoother.update(AbstractEngine::CrossfadeCurve[CrossfadeAttenuation(itEvent->Param.CC.Value)]);
124                }
125          }          }
126        }
127    
128        void Voice::ProcessChannelPressureEvent(RTList<Event>::Iterator& itEvent) {
129          // setup LFO 1 (VCA LFO)          if (itEvent->Type == Event::type_channel_pressure) { // if (valid) MIDI channel pressure (aftertouch) event
130          {              if (pRegion->AttenuationController.type == ::gig::attenuation_ctrl_t::type_channelaftertouch) {
131              uint16_t lfo1_internal_depth;                  CrossfadeSmoother.update(AbstractEngine::CrossfadeCurve[CrossfadeAttenuation(itEvent->Param.ChannelPressure.Value)]);
             switch (pDimRgn->LFO1Controller) {  
                 case ::gig::lfo1_ctrl_internal:  
                     lfo1_internal_depth  = pDimRgn->LFO1InternalDepth;  
                     pLFO1->ExtController = 0; // no external controller  
                     bLFO1Enabled         = (lfo1_internal_depth > 0);  
                     break;  
                 case ::gig::lfo1_ctrl_modwheel:  
                     lfo1_internal_depth  = 0;  
                     pLFO1->ExtController = 1; // MIDI controller 1  
                     bLFO1Enabled         = (pDimRgn->LFO1ControlDepth > 0);  
                     break;  
                 case ::gig::lfo1_ctrl_breath:  
                     lfo1_internal_depth  = 0;  
                     pLFO1->ExtController = 2; // MIDI controller 2  
                     bLFO1Enabled         = (pDimRgn->LFO1ControlDepth > 0);  
                     break;  
                 case ::gig::lfo1_ctrl_internal_modwheel:  
                     lfo1_internal_depth  = pDimRgn->LFO1InternalDepth;  
                     pLFO1->ExtController = 1; // MIDI controller 1  
                     bLFO1Enabled         = (lfo1_internal_depth > 0 || pDimRgn->LFO1ControlDepth > 0);  
                     break;  
                 case ::gig::lfo1_ctrl_internal_breath:  
                     lfo1_internal_depth  = pDimRgn->LFO1InternalDepth;  
                     pLFO1->ExtController = 2; // MIDI controller 2  
                     bLFO1Enabled         = (lfo1_internal_depth > 0 || pDimRgn->LFO1ControlDepth > 0);  
                     break;  
                 default:  
                     lfo1_internal_depth  = 0;  
                     pLFO1->ExtController = 0; // no external controller  
                     bLFO1Enabled         = false;  
132              }              }
             if (bLFO1Enabled) pLFO1->trigger(pDimRgn->LFO1Frequency,  
                                              start_level_max,  
                                              lfo1_internal_depth,  
                                              pDimRgn->LFO1ControlDepth,  
                                              pDimRgn->LFO1FlipPhase,  
                                              pEngine->SampleRate / CONFIG_DEFAULT_SUBFRAGMENT_SIZE);  
133          }          }
134        }
135    
136        void Voice::ProcessPolyphonicKeyPressureEvent(RTList<Event>::Iterator& itEvent) {
137            // Not used so far
138        }
139    
140          // setup LFO 2 (VCF Cutoff LFO)      void Voice::ProcessCutoffEvent(RTList<Event>::Iterator& itEvent) {
141          {          int ccvalue = itEvent->Param.CC.Value;
142              uint16_t lfo2_internal_depth;          if (VCFCutoffCtrl.value == ccvalue) return;
143              switch (pDimRgn->LFO2Controller) {          VCFCutoffCtrl.value = ccvalue;
144                  case ::gig::lfo2_ctrl_internal:          if (pRegion->VCFCutoffControllerInvert)  ccvalue = 127 - ccvalue;
145                      lfo2_internal_depth  = pDimRgn->LFO2InternalDepth;          if (ccvalue < pRegion->VCFVelocityScale) ccvalue = pRegion->VCFVelocityScale;
146                      pLFO2->ExtController = 0; // no external controller          float cutoff = CutoffBase * float(ccvalue);
147                      bLFO2Enabled         = (lfo2_internal_depth > 0);          if (cutoff > 127.0f) cutoff = 127.0f;
                     break;  
                 case ::gig::lfo2_ctrl_modwheel:  
                     lfo2_internal_depth  = 0;  
                     pLFO2->ExtController = 1; // MIDI controller 1  
                     bLFO2Enabled         = (pDimRgn->LFO2ControlDepth > 0);  
                     break;  
                 case ::gig::lfo2_ctrl_foot:  
                     lfo2_internal_depth  = 0;  
                     pLFO2->ExtController = 4; // MIDI controller 4  
                     bLFO2Enabled         = (pDimRgn->LFO2ControlDepth > 0);  
                     break;  
                 case ::gig::lfo2_ctrl_internal_modwheel:  
                     lfo2_internal_depth  = pDimRgn->LFO2InternalDepth;  
                     pLFO2->ExtController = 1; // MIDI controller 1  
                     bLFO2Enabled         = (lfo2_internal_depth > 0 || pDimRgn->LFO2ControlDepth > 0);  
                     break;  
                 case ::gig::lfo2_ctrl_internal_foot:  
                     lfo2_internal_depth  = pDimRgn->LFO2InternalDepth;  
                     pLFO2->ExtController = 4; // MIDI controller 4  
                     bLFO2Enabled         = (lfo2_internal_depth > 0 || pDimRgn->LFO2ControlDepth > 0);  
                     break;  
                 default:  
                     lfo2_internal_depth  = 0;  
                     pLFO2->ExtController = 0; // no external controller  
                     bLFO2Enabled         = false;  
             }  
             if (bLFO2Enabled) pLFO2->trigger(pDimRgn->LFO2Frequency,  
                                              start_level_max,  
                                              lfo2_internal_depth,  
                                              pDimRgn->LFO2ControlDepth,  
                                              pDimRgn->LFO2FlipPhase,  
                                              pEngine->SampleRate / CONFIG_DEFAULT_SUBFRAGMENT_SIZE);  
         }  
148    
149            VCFCutoffCtrl.fvalue = cutoff; // needed for initialization of fFinalCutoff next time
150            fFinalCutoff = cutoff;
151        }
152    
153          // setup LFO 3 (VCO LFO)      double Voice::CalculateCrossfadeVolume(uint8_t MIDIKeyVelocity) {
154          {          float crossfadeVolume;
155              uint16_t lfo3_internal_depth;          switch (pRegion->AttenuationController.type) {
156              switch (pDimRgn->LFO3Controller) {              case ::gig::attenuation_ctrl_t::type_channelaftertouch:
157                  case ::gig::lfo3_ctrl_internal:                  crossfadeVolume = Engine::CrossfadeCurve[CrossfadeAttenuation(GetGigEngineChannel()->ControllerTable[128])];
158                      lfo3_internal_depth  = pDimRgn->LFO3InternalDepth;                  break;
159                      pLFO3->ExtController = 0; // no external controller              case ::gig::attenuation_ctrl_t::type_velocity:
160                      bLFO3Enabled         = (lfo3_internal_depth > 0);                  crossfadeVolume = Engine::CrossfadeCurve[CrossfadeAttenuation(MIDIKeyVelocity)];
161                      break;                  break;
162                  case ::gig::lfo3_ctrl_modwheel:              case ::gig::attenuation_ctrl_t::type_controlchange: //FIXME: currently not sample accurate
163                      lfo3_internal_depth  = 0;                  crossfadeVolume = Engine::CrossfadeCurve[CrossfadeAttenuation(GetGigEngineChannel()->ControllerTable[pRegion->AttenuationController.controller_number])];
164                      pLFO3->ExtController = 1; // MIDI controller 1                  break;
165                      bLFO3Enabled         = (pDimRgn->LFO3ControlDepth > 0);              case ::gig::attenuation_ctrl_t::type_none: // no crossfade defined
166                      break;              default:
167                  case ::gig::lfo3_ctrl_aftertouch:                  crossfadeVolume = 1.0f;
                     lfo3_internal_depth  = 0;  
                     pLFO3->ExtController = 0; // TODO: aftertouch not implemented yet  
                     bLFO3Enabled         = false; // see TODO comment in line above  
                     break;  
                 case ::gig::lfo3_ctrl_internal_modwheel:  
                     lfo3_internal_depth  = pDimRgn->LFO3InternalDepth;  
                     pLFO3->ExtController = 1; // MIDI controller 1  
                     bLFO3Enabled         = (lfo3_internal_depth > 0 || pDimRgn->LFO3ControlDepth > 0);  
                     break;  
                 case ::gig::lfo3_ctrl_internal_aftertouch:  
                     lfo3_internal_depth  = pDimRgn->LFO3InternalDepth;  
                     pLFO1->ExtController = 0; // TODO: aftertouch not implemented yet  
                     bLFO3Enabled         = (lfo3_internal_depth > 0 /*|| pDimRgn->LFO3ControlDepth > 0*/); // see TODO comment in line above  
                     break;  
                 default:  
                     lfo3_internal_depth  = 0;  
                     pLFO3->ExtController = 0; // no external controller  
                     bLFO3Enabled         = false;  
             }  
             if (bLFO3Enabled) pLFO3->trigger(pDimRgn->LFO3Frequency,  
                                              start_level_mid,  
                                              lfo3_internal_depth,  
                                              pDimRgn->LFO3ControlDepth,  
                                              false,  
                                              pEngine->SampleRate / CONFIG_DEFAULT_SUBFRAGMENT_SIZE);  
168          }          }
169    
170            return crossfadeVolume;
171        }
172    
173          #if CONFIG_FORCE_FILTER      double Voice::GetEG1ControllerValue(uint8_t MIDIKeyVelocity) {
174          const bool bUseFilter = true;          double eg1controllervalue = 0;
175          #else // use filter only if instrument file told so          switch (pRegion->EG1Controller.type) {
176          const bool bUseFilter = pDimRgn->VCFEnabled;              case ::gig::eg1_ctrl_t::type_none: // no controller defined
177          #endif // CONFIG_FORCE_FILTER                  eg1controllervalue = 0;
178          SYNTHESIS_MODE_SET_FILTER(SynthesisMode, bUseFilter);                  break;
179          if (bUseFilter) {              case ::gig::eg1_ctrl_t::type_channelaftertouch:
180              #ifdef CONFIG_OVERRIDE_CUTOFF_CTRL                  eg1controllervalue = GetGigEngineChannel()->ControllerTable[128];
181              VCFCutoffCtrl.controller = CONFIG_OVERRIDE_CUTOFF_CTRL;                  break;
182              #else // use the one defined in the instrument file              case ::gig::eg1_ctrl_t::type_velocity:
183              switch (pDimRgn->VCFCutoffController) {                  eg1controllervalue = MIDIKeyVelocity;
184                  case ::gig::vcf_cutoff_ctrl_modwheel:                  break;
185                      VCFCutoffCtrl.controller = 1;              case ::gig::eg1_ctrl_t::type_controlchange: // MIDI control change controller
186                      break;                  eg1controllervalue = GetGigEngineChannel()->ControllerTable[pRegion->EG1Controller.controller_number];
187                  case ::gig::vcf_cutoff_ctrl_effect1:                  break;
188                      VCFCutoffCtrl.controller = 12;          }
189                      break;          if (pRegion->EG1ControllerInvert) eg1controllervalue = 127 - eg1controllervalue;
                 case ::gig::vcf_cutoff_ctrl_effect2:  
                     VCFCutoffCtrl.controller = 13;  
                     break;  
                 case ::gig::vcf_cutoff_ctrl_breath:  
                     VCFCutoffCtrl.controller = 2;  
                     break;  
                 case ::gig::vcf_cutoff_ctrl_foot:  
                     VCFCutoffCtrl.controller = 4;  
                     break;  
                 case ::gig::vcf_cutoff_ctrl_sustainpedal:  
                     VCFCutoffCtrl.controller = 64;  
                     break;  
                 case ::gig::vcf_cutoff_ctrl_softpedal:  
                     VCFCutoffCtrl.controller = 67;  
                     break;  
                 case ::gig::vcf_cutoff_ctrl_genpurpose7:  
                     VCFCutoffCtrl.controller = 82;  
                     break;  
                 case ::gig::vcf_cutoff_ctrl_genpurpose8:  
                     VCFCutoffCtrl.controller = 83;  
                     break;  
                 case ::gig::vcf_cutoff_ctrl_aftertouch: //TODO: not implemented yet  
                 case ::gig::vcf_cutoff_ctrl_none:  
                 default:  
                     VCFCutoffCtrl.controller = 0;  
                     break;  
             }  
             #endif // CONFIG_OVERRIDE_CUTOFF_CTRL  
   
             #ifdef CONFIG_OVERRIDE_RESONANCE_CTRL  
             VCFResonanceCtrl.controller = CONFIG_OVERRIDE_RESONANCE_CTRL;  
             #else // use the one defined in the instrument file  
             switch (pDimRgn->VCFResonanceController) {  
                 case ::gig::vcf_res_ctrl_genpurpose3:  
                     VCFResonanceCtrl.controller = 18;  
                     break;  
                 case ::gig::vcf_res_ctrl_genpurpose4:  
                     VCFResonanceCtrl.controller = 19;  
                     break;  
                 case ::gig::vcf_res_ctrl_genpurpose5:  
                     VCFResonanceCtrl.controller = 80;  
                     break;  
                 case ::gig::vcf_res_ctrl_genpurpose6:  
                     VCFResonanceCtrl.controller = 81;  
                     break;  
                 case ::gig::vcf_res_ctrl_none:  
                 default:  
                     VCFResonanceCtrl.controller = 0;  
             }  
             #endif // CONFIG_OVERRIDE_RESONANCE_CTRL  
190    
191              #ifndef CONFIG_OVERRIDE_FILTER_TYPE          return eg1controllervalue;
192              finalSynthesisParameters.filterLeft.SetType(pDimRgn->VCFType);      }
             finalSynthesisParameters.filterRight.SetType(pDimRgn->VCFType);  
             #else // override filter type  
             FilterLeft.SetType(CONFIG_OVERRIDE_FILTER_TYPE);  
             FilterRight.SetType(CONFIG_OVERRIDE_FILTER_TYPE);  
             #endif // CONFIG_OVERRIDE_FILTER_TYPE  
   
             VCFCutoffCtrl.value    = pEngineChannel->ControllerTable[VCFCutoffCtrl.controller];  
             VCFResonanceCtrl.value = pEngineChannel->ControllerTable[VCFResonanceCtrl.controller];  
   
             // calculate cutoff frequency  
             float cutoff = pDimRgn->GetVelocityCutoff(itNoteOnEvent->Param.Note.Velocity);  
             if (pDimRgn->VCFKeyboardTracking) {  
                 cutoff *= exp((itNoteOnEvent->Param.Note.Key - pDimRgn->VCFKeyboardTrackingBreakpoint) * 0.057762265f); // (ln(2) / 12)  
             }  
             CutoffBase = cutoff;  
193    
194              int cvalue;      Voice::EGInfo Voice::CalculateEG1ControllerInfluence(double eg1ControllerValue) {
195              if (VCFCutoffCtrl.controller) {          EGInfo eg;
196                  cvalue = pEngineChannel->ControllerTable[VCFCutoffCtrl.controller];          // (eg1attack is different from the others)
197                  if (pDimRgn->VCFCutoffControllerInvert) cvalue = 127 - cvalue;          if (pRegion->EG1Attack < 1e-8 && // attack in gig == 0
198                  // VCFVelocityScale in this case means Minimum cutoff              (pRegion->EG1ControllerAttackInfluence == 0 ||
199                  if (cvalue < pDimRgn->VCFVelocityScale) cvalue = pDimRgn->VCFVelocityScale;               eg1ControllerValue <= 10)) { // strange GSt special case
200              }              eg.Attack = 0; // this will force the attack to be 0 in the call to EG1.trigger
201              else {          } else {
202                  cvalue = pDimRgn->VCFCutoff;              eg.Attack  = (pRegion->EG1ControllerAttackInfluence)  ?
203              }                  1 + 0.031 * (double) (pRegion->EG1ControllerAttackInfluence == 1 ?
204              cutoff *= float(cvalue) * 0.00787402f; // (1 / 127)                                        1 : 1 << pRegion->EG1ControllerAttackInfluence) * eg1ControllerValue : 1.0;
205              if (cutoff > 1.0) cutoff = 1.0;          }
206              cutoff = (cutoff < 0.5 ? cutoff * 4826 - 1 : cutoff * 5715 - 449);          eg.Decay   = (pRegion->EG1ControllerDecayInfluence)   ? 1 + 0.00775 * (double) (1 << pRegion->EG1ControllerDecayInfluence)   * eg1ControllerValue : 1.0;
207              if (cutoff < 1.0) cutoff = 1.0;          eg.Release = (pRegion->EG1ControllerReleaseInfluence) ? 1 + 0.00775 * (double) (1 << pRegion->EG1ControllerReleaseInfluence) * eg1ControllerValue : 1.0;
208    
209            return eg;
210        }
211    
212        double Voice::GetEG2ControllerValue(uint8_t MIDIKeyVelocity) {
213            double eg2controllervalue = 0;
214            switch (pRegion->EG2Controller.type) {
215                case ::gig::eg2_ctrl_t::type_none: // no controller defined
216                    eg2controllervalue = 0;
217                    break;
218                case ::gig::eg2_ctrl_t::type_channelaftertouch:
219                    eg2controllervalue = GetGigEngineChannel()->ControllerTable[128];
220                    break;
221                case ::gig::eg2_ctrl_t::type_velocity:
222                    eg2controllervalue = MIDIKeyVelocity;
223                    break;
224                case ::gig::eg2_ctrl_t::type_controlchange: // MIDI control change controller
225                    eg2controllervalue = GetGigEngineChannel()->ControllerTable[pRegion->EG2Controller.controller_number];
226                    break;
227            }
228            if (pRegion->EG2ControllerInvert) eg2controllervalue = 127 - eg2controllervalue;
229    
230              // calculate resonance          return eg2controllervalue;
231              float resonance = (float) (VCFResonanceCtrl.controller ? VCFResonanceCtrl.value : pDimRgn->VCFResonance) * 0.00787f; // 0.0..1.0      }
232    
233              VCFCutoffCtrl.fvalue    = cutoff - 1.0;      Voice::EGInfo Voice::CalculateEG2ControllerInfluence(double eg2ControllerValue) {
234              VCFResonanceCtrl.fvalue = resonance;          EGInfo eg;
235          }          eg.Attack  = (pRegion->EG2ControllerAttackInfluence)  ? 1 + 0.00775 * (double) (1 << pRegion->EG2ControllerAttackInfluence)  * eg2ControllerValue : 1.0;
236          else {          eg.Decay   = (pRegion->EG2ControllerDecayInfluence)   ? 1 + 0.00775 * (double) (1 << pRegion->EG2ControllerDecayInfluence)   * eg2ControllerValue : 1.0;
237              VCFCutoffCtrl.controller    = 0;          eg.Release = (pRegion->EG2ControllerReleaseInfluence) ? 1 + 0.00775 * (double) (1 << pRegion->EG2ControllerReleaseInfluence) * eg2ControllerValue : 1.0;
             VCFResonanceCtrl.controller = 0;  
         }  
238    
239          return 0; // success          return eg;
240      }      }
241    
242      /**      void Voice::InitLFO1() {
243       *  Renders the audio data for this voice for the current audio fragment.          uint16_t lfo1_internal_depth;
244       *  The sample input data can either come from RAM (cached sample or sample          switch (pRegion->LFO1Controller) {
245       *  part) or directly from disk. The output signal will be rendered by              case ::gig::lfo1_ctrl_internal:
246       *  resampling / interpolation. If this voice is a disk streaming voice and                  lfo1_internal_depth  = pRegion->LFO1InternalDepth;
247       *  the voice completely played back the cached RAM part of the sample, it                  pLFO1->ExtController = 0; // no external controller
248       *  will automatically switch to disk playback for the next RenderAudio()                  bLFO1Enabled         = (lfo1_internal_depth > 0);
249       *  call.                  break;
250       *              case ::gig::lfo1_ctrl_modwheel:
251       *  @param Samples - number of samples to be rendered in this audio fragment cycle                  lfo1_internal_depth  = 0;
252       */                  pLFO1->ExtController = 1; // MIDI controller 1
253      void Voice::Render(uint Samples) {                  bLFO1Enabled         = (pRegion->LFO1ControlDepth > 0);
254                    break;
255          // select default values for synthesis mode bits              case ::gig::lfo1_ctrl_breath:
256          SYNTHESIS_MODE_SET_LOOP(SynthesisMode, false);                  lfo1_internal_depth  = 0;
257                    pLFO1->ExtController = 2; // MIDI controller 2
258          switch (this->PlaybackState) {                  bLFO1Enabled         = (pRegion->LFO1ControlDepth > 0);
259                    break;
260              case playback_state_init:              case ::gig::lfo1_ctrl_internal_modwheel:
261                  this->PlaybackState = playback_state_ram; // we always start playback from RAM cache and switch then to disk if needed                  lfo1_internal_depth  = pRegion->LFO1InternalDepth;
262                  // no break - continue with playback_state_ram                  pLFO1->ExtController = 1; // MIDI controller 1
263                    bLFO1Enabled         = (lfo1_internal_depth > 0 || pRegion->LFO1ControlDepth > 0);
264              case playback_state_ram: {                  break;
265                      if (RAMLoop) SYNTHESIS_MODE_SET_LOOP(SynthesisMode, true); // enable looping              case ::gig::lfo1_ctrl_internal_breath:
266                    lfo1_internal_depth  = pRegion->LFO1InternalDepth;
267                      // render current fragment                  pLFO1->ExtController = 2; // MIDI controller 2
268                      Synthesize(Samples, (sample_t*) pSample->GetCache().pStart, Delay);                  bLFO1Enabled         = (lfo1_internal_depth > 0 || pRegion->LFO1ControlDepth > 0);
269                    break;
270                      if (DiskVoice) {              default:
271                          // check if we reached the allowed limit of the sample RAM cache                  lfo1_internal_depth  = 0;
272                          if (finalSynthesisParameters.dPos > MaxRAMPos) {                  pLFO1->ExtController = 0; // no external controller
273                              dmsg(5,("Voice: switching to disk playback (Pos=%f)\n", finalSynthesisParameters.dPos));                  bLFO1Enabled         = false;
274                              this->PlaybackState = playback_state_disk;          }
275                          }          if (bLFO1Enabled) {
276                      } else if (finalSynthesisParameters.dPos >= pSample->GetCache().Size / pSample->FrameSize) {              pLFO1->trigger(pRegion->LFO1Frequency,
277                          this->PlaybackState = playback_state_end;                             start_level_min,
278                      }                             lfo1_internal_depth,
279                  }                             pRegion->LFO1ControlDepth,
280                  break;                             pRegion->LFO1FlipPhase,
281                               pEngine->SampleRate / CONFIG_DEFAULT_SUBFRAGMENT_SIZE);
282              case playback_state_disk: {              pLFO1->updateByMIDICtrlValue(pLFO1->ExtController ? GetGigEngineChannel()->ControllerTable[pLFO1->ExtController] : 0);
283                      if (!DiskStreamRef.pStream) {              pLFO1->setScriptDepthFactor(
284                          // check if the disk thread created our ordered disk stream in the meantime                  pNote->Override.AmpLFODepth.Value,
285                          DiskStreamRef.pStream = pDiskThread->AskForCreatedStream(DiskStreamRef.OrderID);                  pNote->Override.AmpLFODepth.Final
286                          if (!DiskStreamRef.pStream) {              );
287                              std::cout << stderr << "Disk stream not available in time!" << std::endl << std::flush;              if (pNote->Override.AmpLFOFreq.isFinal())
288                              KillImmediately();                  pLFO1->setScriptFrequencyFinal(
289                              return;                      pNote->Override.AmpLFOFreq.Value, pEngine->SampleRate / CONFIG_DEFAULT_SUBFRAGMENT_SIZE
290                          }                  );
291                          DiskStreamRef.pStream->IncrementReadPos(pSample->Channels * (int(finalSynthesisParameters.dPos) - MaxRAMPos));              else
292                          finalSynthesisParameters.dPos -= int(finalSynthesisParameters.dPos);                  pLFO1->setScriptFrequencyFactor(
293                          RealSampleWordsLeftToRead = -1; // -1 means no silence has been added yet                      pNote->Override.AmpLFOFreq.Value, pEngine->SampleRate / CONFIG_DEFAULT_SUBFRAGMENT_SIZE
294                      }                  );
   
                     const int sampleWordsLeftToRead = DiskStreamRef.pStream->GetReadSpace();  
   
                     // add silence sample at the end if we reached the end of the stream (for the interpolator)  
                     if (DiskStreamRef.State == Stream::state_end) {  
                         const int maxSampleWordsPerCycle = (pEngine->MaxSamplesPerCycle << CONFIG_MAX_PITCH) * pSample->Channels + 6; // +6 for the interpolator algorithm  
                         if (sampleWordsLeftToRead <= maxSampleWordsPerCycle) {  
                             // remember how many sample words there are before any silence has been added  
                             if (RealSampleWordsLeftToRead < 0) RealSampleWordsLeftToRead = sampleWordsLeftToRead;  
                             DiskStreamRef.pStream->WriteSilence(maxSampleWordsPerCycle - sampleWordsLeftToRead);  
                         }  
                     }  
   
                     sample_t* ptr = DiskStreamRef.pStream->GetReadPtr(); // get the current read_ptr within the ringbuffer where we read the samples from  
   
                     // render current audio fragment  
                     Synthesize(Samples, ptr, Delay);  
   
                     const int iPos = (int) finalSynthesisParameters.dPos;  
                     const int readSampleWords = iPos * pSample->Channels; // amount of sample words actually been read  
                     DiskStreamRef.pStream->IncrementReadPos(readSampleWords);  
                     finalSynthesisParameters.dPos -= iPos; // just keep fractional part of playback position  
   
                     // change state of voice to 'end' if we really reached the end of the sample data  
                     if (RealSampleWordsLeftToRead >= 0) {  
                         RealSampleWordsLeftToRead -= readSampleWords;  
                         if (RealSampleWordsLeftToRead <= 0) this->PlaybackState = playback_state_end;  
                     }  
                 }  
                 break;  
   
             case playback_state_end:  
                 std::cerr << "gig::Voice::Render(): entered with playback_state_end, this is a bug!\n" << std::flush;  
                 break;  
         }  
   
         // Reset delay  
         Delay = 0;  
   
         itTriggerEvent = Pool<Event>::Iterator();  
   
         // If sample stream or release stage finished, kill the voice  
         if (PlaybackState == playback_state_end || EG1.getSegmentType() == EGADSR::segment_end) KillImmediately();  
     }  
   
     /**  
      *  Resets voice variables. Should only be called if rendering process is  
      *  suspended / not running.  
      */  
     void Voice::Reset() {  
         finalSynthesisParameters.filterLeft.Reset();  
         finalSynthesisParameters.filterRight.Reset();  
         DiskStreamRef.pStream = NULL;  
         DiskStreamRef.hStream = 0;  
         DiskStreamRef.State   = Stream::state_unused;  
         DiskStreamRef.OrderID = 0;  
         PlaybackState = playback_state_end;  
         itTriggerEvent = Pool<Event>::Iterator();  
         itKillEvent    = Pool<Event>::Iterator();  
     }  
   
     /**  
      * Process given list of MIDI note on, note off and sustain pedal events  
      * for the given time.  
      *  
      * @param itEvent - iterator pointing to the next event to be processed  
      * @param End     - youngest time stamp where processing should be stopped  
      */  
     void Voice::processTransitionEvents(RTList<Event>::Iterator& itEvent, uint End) {  
         for (; itEvent && itEvent->FragmentPos() <= End; ++itEvent) {  
             if (itEvent->Type == Event::type_release) {  
                 EG1.update(EGADSR::event_release, pEngine->SampleRate / CONFIG_DEFAULT_SUBFRAGMENT_SIZE);  
                 EG2.update(EGADSR::event_release, pEngine->SampleRate / CONFIG_DEFAULT_SUBFRAGMENT_SIZE);  
             } else if (itEvent->Type == Event::type_cancel_release) {  
                 EG1.update(EGADSR::event_cancel_release, pEngine->SampleRate / CONFIG_DEFAULT_SUBFRAGMENT_SIZE);  
                 EG2.update(EGADSR::event_cancel_release, pEngine->SampleRate / CONFIG_DEFAULT_SUBFRAGMENT_SIZE);  
             }  
295          }          }
296      }      }
297    
298      /**      void Voice::InitLFO2() {
299       * Process given list of MIDI control change and pitch bend events for          uint16_t lfo2_internal_depth;
300       * the given time.          switch (pRegion->LFO2Controller) {
301       *              case ::gig::lfo2_ctrl_internal:
302       * @param itEvent - iterator pointing to the next event to be processed                  lfo2_internal_depth  = pRegion->LFO2InternalDepth;
303       * @param End     - youngest time stamp where processing should be stopped                  pLFO2->ExtController = 0; // no external controller
304       */                  bLFO2Enabled         = (lfo2_internal_depth > 0);
305      void Voice::processCCEvents(RTList<Event>::Iterator& itEvent, uint End) {                  break;
306          for (; itEvent && itEvent->FragmentPos() <= End; ++itEvent) {              case ::gig::lfo2_ctrl_modwheel:
307              if (itEvent->Type == Event::type_control_change &&                  lfo2_internal_depth  = 0;
308                  itEvent->Param.CC.Controller) { // if (valid) MIDI control change event                  pLFO2->ExtController = 1; // MIDI controller 1
309                  if (itEvent->Param.CC.Controller == VCFCutoffCtrl.controller) {                  bLFO2Enabled         = (pRegion->LFO2ControlDepth > 0);
310                      processCutoffEvent(itEvent);                  break;
311                  }              case ::gig::lfo2_ctrl_foot:
312                  if (itEvent->Param.CC.Controller == VCFResonanceCtrl.controller) {                  lfo2_internal_depth  = 0;
313                      processResonanceEvent(itEvent);                  pLFO2->ExtController = 4; // MIDI controller 4
314                  }                  bLFO2Enabled         = (pRegion->LFO2ControlDepth > 0);
315                  if (itEvent->Param.CC.Controller == pLFO1->ExtController) {                  break;
316                      pLFO1->update(itEvent->Param.CC.Value);              case ::gig::lfo2_ctrl_internal_modwheel:
317                  }                  lfo2_internal_depth  = pRegion->LFO2InternalDepth;
318                  if (itEvent->Param.CC.Controller == pLFO2->ExtController) {                  pLFO2->ExtController = 1; // MIDI controller 1
319                      pLFO2->update(itEvent->Param.CC.Value);                  bLFO2Enabled         = (lfo2_internal_depth > 0 || pRegion->LFO2ControlDepth > 0);
320                  }                  break;
321                  if (itEvent->Param.CC.Controller == pLFO3->ExtController) {              case ::gig::lfo2_ctrl_internal_foot:
322                      pLFO3->update(itEvent->Param.CC.Value);                  lfo2_internal_depth  = pRegion->LFO2InternalDepth;
323                  }                  pLFO2->ExtController = 4; // MIDI controller 4
324                  if (pDimRgn->AttenuationController.type == ::gig::attenuation_ctrl_t::type_controlchange &&                  bLFO2Enabled         = (lfo2_internal_depth > 0 || pRegion->LFO2ControlDepth > 0);
325                      itEvent->Param.CC.Controller == pDimRgn->AttenuationController.controller_number) {                  break;
326                      processCrossFadeEvent(itEvent);              default:
327                  }                  lfo2_internal_depth  = 0;
328              } else if (itEvent->Type == Event::type_pitchbend) { // if pitch bend event                  pLFO2->ExtController = 0; // no external controller
329                  processPitchEvent(itEvent);                  bLFO2Enabled         = false;
330              }          }
331            if (bLFO2Enabled) {
332                pLFO2->trigger(pRegion->LFO2Frequency,
333                               start_level_max,
334                               lfo2_internal_depth,
335                               pRegion->LFO2ControlDepth,
336                               pRegion->LFO2FlipPhase,
337                               pEngine->SampleRate / CONFIG_DEFAULT_SUBFRAGMENT_SIZE);
338                pLFO2->updateByMIDICtrlValue(pLFO2->ExtController ? GetGigEngineChannel()->ControllerTable[pLFO2->ExtController] : 0);
339                pLFO2->setScriptDepthFactor(
340                    pNote->Override.CutoffLFODepth.Value,
341                    pNote->Override.CutoffLFODepth.Final
342                );
343                if (pNote->Override.CutoffLFOFreq.isFinal())
344                    pLFO2->setScriptFrequencyFinal(pNote->Override.CutoffLFOFreq.Value, pEngine->SampleRate / CONFIG_DEFAULT_SUBFRAGMENT_SIZE);
345                else
346                    pLFO2->setScriptFrequencyFactor(pNote->Override.CutoffLFOFreq.Value, pEngine->SampleRate / CONFIG_DEFAULT_SUBFRAGMENT_SIZE);
347          }          }
348      }      }
349    
350      void Voice::processPitchEvent(RTList<Event>::Iterator& itEvent) {      void Voice::InitLFO3() {
351          const float pitch = RTMath::CentsToFreqRatio(((double) itEvent->Param.Pitch.Pitch / 8192.0) * 200.0); // +-two semitones = +-200 cents          uint16_t lfo3_internal_depth;
352          finalSynthesisParameters.fFinalPitch *= pitch;          switch (pRegion->LFO3Controller) {
353          PitchBend = pitch;              case ::gig::lfo3_ctrl_internal:
354      }                  lfo3_internal_depth  = pRegion->LFO3InternalDepth;
355                    pLFO3->ExtController = 0; // no external controller
356      void Voice::processCrossFadeEvent(RTList<Event>::Iterator& itEvent) {                  bLFO3Enabled         = (lfo3_internal_depth > 0);
357          CrossfadeVolume = CrossfadeAttenuation(itEvent->Param.CC.Value);                  break;
358          #if CONFIG_PROCESS_MUTED_CHANNELS              case ::gig::lfo3_ctrl_modwheel:
359          const float effectiveVolume = CrossfadeVolume * Volume * (pEngineChannel->GetMute() ? 0 : pEngineChannel->GlobalVolume);                  lfo3_internal_depth  = 0;
360          #else                  pLFO3->ExtController = 1; // MIDI controller 1
361          const float effectiveVolume = CrossfadeVolume * Volume * pEngineChannel->GlobalVolume;                  bLFO3Enabled         = (pRegion->LFO3ControlDepth > 0);
362          #endif                  break;
363          fFinalVolume = effectiveVolume;              case ::gig::lfo3_ctrl_aftertouch:
364                    lfo3_internal_depth  = 0;
365                    pLFO3->ExtController = CTRL_TABLE_IDX_AFTERTOUCH;
366                    bLFO3Enabled         = true;
367                    break;
368                case ::gig::lfo3_ctrl_internal_modwheel:
369                    lfo3_internal_depth  = pRegion->LFO3InternalDepth;
370                    pLFO3->ExtController = 1; // MIDI controller 1
371                    bLFO3Enabled         = (lfo3_internal_depth > 0 || pRegion->LFO3ControlDepth > 0);
372                    break;
373                case ::gig::lfo3_ctrl_internal_aftertouch:
374                    lfo3_internal_depth  = pRegion->LFO3InternalDepth;
375                    pLFO3->ExtController = CTRL_TABLE_IDX_AFTERTOUCH;
376                    bLFO3Enabled         = (lfo3_internal_depth > 0 || pRegion->LFO3ControlDepth > 0);
377                    break;
378                default:
379                    lfo3_internal_depth  = 0;
380                    pLFO3->ExtController = 0; // no external controller
381                    bLFO3Enabled         = false;
382            }
383            if (bLFO3Enabled) {
384                pLFO3->trigger(pRegion->LFO3Frequency,
385                               start_level_mid,
386                               lfo3_internal_depth,
387                               pRegion->LFO3ControlDepth,
388                               false,
389                               pEngine->SampleRate / CONFIG_DEFAULT_SUBFRAGMENT_SIZE);
390                pLFO3->updateByMIDICtrlValue(pLFO3->ExtController ? GetGigEngineChannel()->ControllerTable[pLFO3->ExtController] : 0);
391                pLFO3->setScriptDepthFactor(
392                    pNote->Override.PitchLFODepth.Value,
393                    pNote->Override.PitchLFODepth.Final
394                );
395                if (pNote->Override.PitchLFOFreq.isFinal())
396                    pLFO3->setScriptFrequencyFinal(pNote->Override.PitchLFOFreq.Value, pEngine->SampleRate / CONFIG_DEFAULT_SUBFRAGMENT_SIZE);
397                else
398                    pLFO3->setScriptFrequencyFactor(pNote->Override.PitchLFOFreq.Value, pEngine->SampleRate / CONFIG_DEFAULT_SUBFRAGMENT_SIZE);
399            }
400      }      }
401    
402      void Voice::processCutoffEvent(RTList<Event>::Iterator& itEvent) {      float Voice::CalculateCutoffBase(uint8_t MIDIKeyVelocity) {
403          int ccvalue = itEvent->Param.CC.Value;          float cutoff = pRegion->GetVelocityCutoff(MIDIKeyVelocity);
404          if (VCFCutoffCtrl.value == ccvalue) return;          if (pRegion->VCFKeyboardTracking) {
405          VCFCutoffCtrl.value == ccvalue;              cutoff *= RTMath::CentsToFreqRatioUnlimited((MIDIKey() - pRegion->VCFKeyboardTrackingBreakpoint) * 100);
406          if (pDimRgn->VCFCutoffControllerInvert)  ccvalue = 127 - ccvalue;          }
407          if (ccvalue < pDimRgn->VCFVelocityScale) ccvalue = pDimRgn->VCFVelocityScale;          return cutoff;
408          float cutoff = CutoffBase * float(ccvalue) * 0.00787402f; // (1 / 127)      }
409          if (cutoff > 1.0) cutoff = 1.0;  
410          cutoff = (cutoff < 0.5 ? cutoff * 4826 - 1 : cutoff * 5715 - 449);      float Voice::CalculateFinalCutoff(float cutoffBase) {
411          if (cutoff < 1.0) cutoff = 1.0;          int cvalue;
412            if (VCFCutoffCtrl.controller) {
413                cvalue = GetGigEngineChannel()->ControllerTable[VCFCutoffCtrl.controller];
414                if (pRegion->VCFCutoffControllerInvert) cvalue = 127 - cvalue;
415                // VCFVelocityScale in this case means Minimum cutoff
416                if (cvalue < pRegion->VCFVelocityScale) cvalue = pRegion->VCFVelocityScale;
417            }
418            else {
419                cvalue = pRegion->VCFCutoff;
420            }
421            float fco = cutoffBase * float(cvalue);
422            if (fco > 127.0f) fco = 127.0f;
423    
424          VCFCutoffCtrl.fvalue = cutoff - 1.0; // needed for initialization of fFinalCutoff next time          return fco;
         fFinalCutoff = cutoff;  
425      }      }
426    
427      void Voice::processResonanceEvent(RTList<Event>::Iterator& itEvent) {      uint8_t Voice::GetVCFCutoffCtrl() {
428          // convert absolute controller value to differential          uint8_t ctrl;
429          const int ctrldelta = itEvent->Param.CC.Value - VCFResonanceCtrl.value;          switch (pRegion->VCFCutoffController) {
430          VCFResonanceCtrl.value = itEvent->Param.CC.Value;              case ::gig::vcf_cutoff_ctrl_modwheel:
431          const float resonancedelta = (float) ctrldelta * 0.00787f; // 0.0..1.0                  ctrl = 1;
432          fFinalResonance += resonancedelta;                  break;
433          // needed for initialization of parameter              case ::gig::vcf_cutoff_ctrl_effect1:
434          VCFResonanceCtrl.fvalue = itEvent->Param.CC.Value * 0.00787f;                  ctrl = 12;
435      }                  break;
436                case ::gig::vcf_cutoff_ctrl_effect2:
437      /**                  ctrl = 13;
438       *  Synthesizes the current audio fragment for this voice.                  break;
439       *              case ::gig::vcf_cutoff_ctrl_breath:
440       *  @param Samples - number of sample points to be rendered in this audio                  ctrl = 2;
441       *                   fragment cycle                  break;
442       *  @param pSrc    - pointer to input sample data              case ::gig::vcf_cutoff_ctrl_foot:
443       *  @param Skip    - number of sample points to skip in output buffer                  ctrl = 4;
444       */                  break;
445      void Voice::Synthesize(uint Samples, sample_t* pSrc, uint Skip) {              case ::gig::vcf_cutoff_ctrl_sustainpedal:
446          finalSynthesisParameters.pOutLeft  = &pEngineChannel->pOutputLeft[Skip];                  ctrl = 64;
447          finalSynthesisParameters.pOutRight = &pEngineChannel->pOutputRight[Skip];                  break;
448          finalSynthesisParameters.pSrc      = pSrc;              case ::gig::vcf_cutoff_ctrl_softpedal:
449                    ctrl = 67;
450          RTList<Event>::Iterator itCCEvent = pEngineChannel->pEvents->first();                  break;
451          RTList<Event>::Iterator itNoteEvent = pEngineChannel->pMIDIKeyInfo[MIDIKey].pEvents->first();              case ::gig::vcf_cutoff_ctrl_genpurpose7:
452                    ctrl = 82;
453          if (Skip) { // skip events that happened before this voice was triggered                  break;
454              while (itCCEvent && itCCEvent->FragmentPos() <= Skip) ++itCCEvent;              case ::gig::vcf_cutoff_ctrl_genpurpose8:
455              while (itNoteEvent && itNoteEvent->FragmentPos() <= Skip) ++itNoteEvent;                  ctrl = 83;
456          }                  break;
457                case ::gig::vcf_cutoff_ctrl_aftertouch:
458          uint killPos;                  ctrl = CTRL_TABLE_IDX_AFTERTOUCH;
459          if (itKillEvent) killPos = RTMath::Min(itKillEvent->FragmentPos(), pEngine->MaxFadeOutPos);                  break;
460                case ::gig::vcf_cutoff_ctrl_none:
461          uint i = Skip;              default:
462          while (i < Samples) {                  ctrl = 0;
463              int iSubFragmentEnd = RTMath::Min(i + CONFIG_DEFAULT_SUBFRAGMENT_SIZE, Samples);                  break;
464            }
             // initialize all final synthesis parameters  
             finalSynthesisParameters.fFinalPitch = PitchBase * PitchBend;  
             #if CONFIG_PROCESS_MUTED_CHANNELS  
             fFinalVolume = this->Volume * this->CrossfadeVolume * (pEngineChannel->GetMute() ? 0 : pEngineChannel->GlobalVolume);  
             #else  
             fFinalVolume = this->Volume * this->CrossfadeVolume * pEngineChannel->GlobalVolume;  
             #endif  
             fFinalCutoff    = VCFCutoffCtrl.fvalue;  
             fFinalResonance = VCFResonanceCtrl.fvalue;  
   
             // process MIDI control change and pitchbend events for this subfragment  
             processCCEvents(itCCEvent, iSubFragmentEnd);  
   
             // process transition events (note on, note off & sustain pedal)  
             processTransitionEvents(itNoteEvent, iSubFragmentEnd);  
   
             // if the voice was killed in this subfragment switch EG1 to fade out stage  
             if (itKillEvent && killPos <= iSubFragmentEnd) {  
                 EG1.enterFadeOutStage();  
                 itKillEvent = Pool<Event>::Iterator();  
             }  
   
             // process envelope generators  
             switch (EG1.getSegmentType()) {  
                 case EGADSR::segment_lin:  
                     fFinalVolume *= EG1.processLin();  
                     break;  
                 case EGADSR::segment_exp:  
                     fFinalVolume *= EG1.processExp();  
                     break;  
                 case EGADSR::segment_end:  
                     fFinalVolume *= EG1.getLevel();  
                     break; // noop  
             }  
             switch (EG2.getSegmentType()) {  
                 case EGADSR::segment_lin:  
                     fFinalCutoff *= EG2.processLin();  
                     break;  
                 case EGADSR::segment_exp:  
                     fFinalCutoff *= EG2.processExp();  
                     break;  
                 case EGADSR::segment_end:  
                     fFinalCutoff *= EG2.getLevel();  
                     break; // noop  
             }  
             if (EG3.active()) finalSynthesisParameters.fFinalPitch *= RTMath::CentsToFreqRatio(EG3.render());  
   
             // process low frequency oscillators  
             if (bLFO1Enabled) fFinalVolume *= pLFO1->render();  
             if (bLFO2Enabled) fFinalCutoff *= pLFO2->render();  
             if (bLFO3Enabled) finalSynthesisParameters.fFinalPitch *= RTMath::CentsToFreqRatio(pLFO3->render());  
   
             // if filter enabled then update filter coefficients  
             if (SYNTHESIS_MODE_GET_FILTER(SynthesisMode)) {  
                 finalSynthesisParameters.filterLeft.SetParameters(fFinalCutoff + 1.0, fFinalResonance, pEngine->SampleRate);  
                 finalSynthesisParameters.filterRight.SetParameters(fFinalCutoff + 1.0, fFinalResonance, pEngine->SampleRate);  
             }  
   
             // do we need resampling?  
             const float __PLUS_ONE_CENT  = 1.000577789506554859250142541782224725466f;  
             const float __MINUS_ONE_CENT = 0.9994225441413807496009516495583113737666f;  
             const bool bResamplingRequired = !(finalSynthesisParameters.fFinalPitch <= __PLUS_ONE_CENT &&  
                                                finalSynthesisParameters.fFinalPitch >= __MINUS_ONE_CENT);  
             SYNTHESIS_MODE_SET_INTERPOLATE(SynthesisMode, bResamplingRequired);  
   
             // prepare final synthesis parameters structure  
             finalSynthesisParameters.fFinalVolumeLeft  = fFinalVolume * PanLeft;  
             finalSynthesisParameters.fFinalVolumeRight = fFinalVolume * PanRight;  
             finalSynthesisParameters.uiToGo            = iSubFragmentEnd - i;  
   
             // render audio for one subfragment  
             RunSynthesisFunction(SynthesisMode, &finalSynthesisParameters, &loop);  
   
             const double newPos = Pos + (iSubFragmentEnd - i) * finalSynthesisParameters.fFinalPitch;  
   
             // increment envelopes' positions  
             if (EG1.active()) {  
   
                 // if sample has a loop and loop start has been reached in this subfragment, send a special event to EG1 to let it finish the attack hold stage  
                 if (pSample->Loops && Pos <= pSample->LoopStart && pSample->LoopStart < newPos) {  
                     EG1.update(EGADSR::event_hold_end, pEngine->SampleRate / CONFIG_DEFAULT_SUBFRAGMENT_SIZE);  
                 }  
465    
466                  EG1.increment(1);          return ctrl;
467                  if (!EG1.toStageEndLeft()) EG1.update(EGADSR::event_stage_end, pEngine->SampleRate / CONFIG_DEFAULT_SUBFRAGMENT_SIZE);      }
             }  
             if (EG2.active()) {  
                 EG2.increment(1);  
                 if (!EG2.toStageEndLeft()) EG2.update(EGADSR::event_stage_end, pEngine->SampleRate / CONFIG_DEFAULT_SUBFRAGMENT_SIZE);  
             }  
             EG3.increment(1);  
             if (!EG3.toEndLeft()) EG3.update(); // neutralize envelope coefficient if end reached  
468    
469              Pos = newPos;      uint8_t Voice::GetVCFResonanceCtrl() {
470              i = iSubFragmentEnd;          uint8_t ctrl;
471            switch (pRegion->VCFResonanceController) {
472                case ::gig::vcf_res_ctrl_genpurpose3:
473                    ctrl = 18;
474                    break;
475                case ::gig::vcf_res_ctrl_genpurpose4:
476                    ctrl = 19;
477                    break;
478                case ::gig::vcf_res_ctrl_genpurpose5:
479                    ctrl = 80;
480                    break;
481                case ::gig::vcf_res_ctrl_genpurpose6:
482                    ctrl = 81;
483                    break;
484                case ::gig::vcf_res_ctrl_none:
485                default:
486                    ctrl = 0;
487          }          }
     }  
488    
489      /**          return ctrl;
490       *  Immediately kill the voice. This method should not be used to kill      }
      *  a normal, active voice, because it doesn't take care of things like  
      *  fading down the volume level to avoid clicks and regular processing  
      *  until the kill event actually occured!  
      *  
      *  @see Kill()  
      */  
     void Voice::KillImmediately() {  
         if (DiskVoice && DiskStreamRef.State != Stream::state_unused) {  
             pDiskThread->OrderDeletionOfStream(&DiskStreamRef);  
         }  
         Reset();  
     }  
   
     /**  
      *  Kill the voice in regular sense. Let the voice render audio until  
      *  the kill event actually occured and then fade down the volume level  
      *  very quickly and let the voice die finally. Unlike a normal release  
      *  of a voice, a kill process cannot be cancalled and is therefore  
      *  usually used for voice stealing and key group conflicts.  
      *  
      *  @param itKillEvent - event which caused the voice to be killed  
      */  
     void Voice::Kill(Pool<Event>::Iterator& itKillEvent) {  
         #if CONFIG_DEVMODE  
         if (!itKillEvent) dmsg(1,("gig::Voice::Kill(): ERROR, !itKillEvent !!!\n"));  
         if (itKillEvent && !itKillEvent.isValid()) dmsg(1,("gig::Voice::Kill(): ERROR, itKillEvent invalid !!!\n"));  
         #endif // CONFIG_DEVMODE  
491    
492          if (itTriggerEvent && itKillEvent->FragmentPos() <= itTriggerEvent->FragmentPos()) return;      void Voice::TriggerEG1(const EGInfo& egInfo, double velrelease, double velocityAttenuation, uint sampleRate, uint8_t velocity) {
493          this->itKillEvent = itKillEvent;          EG1.setStateOptions(
494                pRegion->EG1Options.AttackCancel,
495                pRegion->EG1Options.AttackHoldCancel,
496                pRegion->EG1Options.Decay1Cancel,
497                pRegion->EG1Options.Decay2Cancel,
498                pRegion->EG1Options.ReleaseCancel
499            );
500            EG1.trigger(pRegion->EG1PreAttack,
501                        RTMath::Max(pRegion->EG1Attack, 0.0316) * egInfo.Attack,
502                        pRegion->EG1Hold,
503                        pRegion->EG1Decay1 * egInfo.Decay * velrelease,
504                        pRegion->EG1Decay2 * egInfo.Decay * velrelease,
505                        pRegion->EG1InfiniteSustain,
506                        (pNote && pNote->Override.Sustain.Final) ?
507                            pNote->Override.Sustain.Value :
508                            pRegion->EG1Sustain * (pNote ? pNote->Override.Sustain.Value : 1.f),
509                        RTMath::Max(pRegion->EG1Release * velrelease, 0.014) * egInfo.Release,
510                        velocityAttenuation,
511                        sampleRate / CONFIG_DEFAULT_SUBFRAGMENT_SIZE);
512        }
513    
514        void Voice::TriggerEG2(const EGInfo& egInfo, double velrelease, double velocityAttenuation, uint sampleRate, uint8_t velocity) {
515            EG2.setStateOptions(
516                pRegion->EG2Options.AttackCancel,
517                pRegion->EG2Options.AttackHoldCancel,
518                pRegion->EG2Options.Decay1Cancel,
519                pRegion->EG2Options.Decay2Cancel,
520                pRegion->EG2Options.ReleaseCancel
521            );
522            EG2.trigger(uint(RgnInfo.EG2PreAttack),
523                        RgnInfo.EG2Attack * egInfo.Attack,
524                        false,
525                        RgnInfo.EG2Decay1 * egInfo.Decay * velrelease,
526                        RgnInfo.EG2Decay2 * egInfo.Decay * velrelease,
527                        RgnInfo.EG2InfiniteSustain,
528                        uint(RgnInfo.EG2Sustain),
529                        RgnInfo.EG2Release * egInfo.Release * velrelease,
530                        velocityAttenuation,
531                        sampleRate / CONFIG_DEFAULT_SUBFRAGMENT_SIZE);
532        }
533    
534        void Voice::ProcessGroupEvent(RTList<Event>::Iterator& itEvent) {
535            dmsg(4,("Voice %p processGroupEvents event type=%d", (void*)this, itEvent->Type));
536    
537            // TODO: The SustainPedal condition could be wrong, maybe the
538            // check should be if this Voice is in release stage or is a
539            // release sample instead. Need to test this in GSt.
540            // -- Andreas
541            //
542            // Commented sustain pedal check out. I don't think voices of the same
543            // note should be stopped at all, because it doesn't sound naturally
544            // with a drumkit.
545            // -- Christian, 2013-01-08
546            if (itEvent->Param.Note.Key != HostKey() /*||
547                !GetGigEngineChannel()->SustainPedal*/) {
548                dmsg(4,("Voice %p - kill", (void*)this));
549    
550                // kill the voice fast
551                pEG1->enterFadeOutStage();
552            }
553        }
554    
555        void Voice::CalculateFadeOutCoeff(float FadeOutTime, float SampleRate) {
556            EG1.CalculateFadeOutCoeff(FadeOutTime, SampleRate);
557        }
558    
559        int Voice::CalculatePan(uint8_t pan) {
560            int p;
561            // Gst behaviour: -64 and 63 are special cases
562            if (RgnInfo.Pan == -64)     p = pan * 2 - 127;
563            else if (RgnInfo.Pan == 63) p = pan * 2;
564            else                        p = pan + RgnInfo.Pan;
565    
566            if (p < 0) return 0;
567            if (p > 127) return 127;
568            return p;
569        }
570    
571        release_trigger_t Voice::GetReleaseTriggerFlags() {
572            release_trigger_t flags =
573                (pRegion->NoNoteOffReleaseTrigger) ?
574                    release_trigger_none : release_trigger_noteoff; //HACK: currently this method is actually only called by EngineBase if it already knows that this voice requires release trigger, so I took the short way instead of checking (again) the existence of a ::gig::dimension_releasetrigger
575            switch (pRegion->SustainReleaseTrigger) {
576                case ::gig::sust_rel_trg_none:
577                    break;
578                case ::gig::sust_rel_trg_maxvelocity:
579                    flags |= release_trigger_sustain_maxvelocity;
580                    break;
581                case ::gig::sust_rel_trg_keyvelocity:
582                    flags |= release_trigger_sustain_keyvelocity;
583                    break;
584            }
585            return flags;
586      }      }
587    
588  }} // namespace LinuxSampler::gig  }} // namespace LinuxSampler::gig
Legend:
Removed from v.796  
changed lines
  Added in v.3561
  ViewVC Help
Powered by ViewVC