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

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

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

revision 285 by schoenebeck, Thu Oct 14 21:31:26 2004 UTC revision 3034 by schoenebeck, Mon Oct 31 00:05:00 2016 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 - 2016 Christian Schoenebeck                       *
7   *                                                                         *   *                                                                         *
8   *   This program is free software; you can redistribute it and/or modify  *   *   This program is free software; you can redistribute it and/or modify  *
9   *   it under the terms of the GNU General Public License as published by  *   *   it under the terms of the GNU General Public License as published by  *
# Line 22  Line 23 
23    
24  #include "EGADSR.h"  #include "EGADSR.h"
25    
26    #include "../../common/global_private.h"
27    
28  namespace LinuxSampler { namespace gig {  namespace LinuxSampler { namespace gig {
29    
30      const float EGADSR::FadeOutCoeff(CalculateFadeOutCoeff());      void EGADSR::update(event_t Event, uint SampleRate) {
31            if (atEnd(Event)) return;
32    
33      float EGADSR::CalculateFadeOutCoeff() {          if (Event == event_hold_end) HoldAttack = false;
34          const float sampleRate = 44100.0; // even if the sample rate will be 192kHz it won't hurt at all  
35          const float killSteps  = EG_MIN_RELEASE_TIME * sampleRate;          switch (Stage) {
36          return -1.0f / killSteps;              case stage_attack:
37      }                  switch (Event) {
38                        case event_release:
39      EGADSR::EGADSR(gig::Engine* pEngine, Event::destination_t ModulationDestination) {                          enterReleasePart1Stage();
40          this->pEngine = pEngine;                          break;
41          this->ModulationDestination = ModulationDestination;                      case event_stage_end:
42          Stage = stage_end;                          if (HoldAttack)
43          Level = 0.0;                              enterAttackHoldStage();
44      }                          else
45                                enterDecay1Part1Stage(SampleRate);
46      /**                          break;
47       * Will be called by the voice for every audio fragment to let the EG                      default: ; // noop
      * queue it's modulation changes for the current audio fragment.  
      *  
      * @param TotalSamples  - total number of sample points to be rendered in this  
      *                        audio fragment cycle by the audio engine  
      * @param pEvents       - event list with "release" and "cancel release" events  
      * @param itTriggerEvent - event that caused triggering of the voice (only if  
      *                        the voice was triggered in the current audio  
      *                        fragment, NULL otherwise)  
      * @param SamplePos     - current playback position  
      * @param CurrentPitch  - current pitch value for playback  
      * @param itKillEvent   - (optional) event which caused this voice to be killed  
      */  
     void EGADSR::Process(uint TotalSamples, RTList<Event>* pEvents, RTList<Event>::Iterator itTriggerEvent, double SamplePos, double CurrentPitch, RTList<Event>::Iterator itKillEvent) {  
         // skip all events which occured before this voice was triggered  
         RTList<Event>::Iterator itTransitionEvent = (itTriggerEvent) ? ++itTriggerEvent : pEvents->first();  
   
         // if the voice was killed in this fragment we only process the time before this kill event, then switch to 'stage_fadeout'  
         int Samples = (itKillEvent) ? RTMath::Min(itKillEvent->FragmentPos(), pEngine->MaxFadeOutPos) : (int) TotalSamples;  
   
         int iSample = TriggerDelay;  
         while (iSample < TotalSamples) {  
   
             // if the voice was killed in this fragment and we already processed the time before this kill event  
             if (itKillEvent && iSample >= Samples) Stage = stage_fadeout;  
   
             switch (Stage) {  
                 case stage_attack: {  
                     TriggerDelay = 0;  
                     int to_process   = RTMath::Min(AttackStepsLeft, Samples - iSample);  
                     int process_end  = iSample + to_process;  
                     AttackStepsLeft -= to_process;  
                     while (iSample < process_end) {  
                         Level += AttackCoeff;  
                         pEngine->pSynthesisParameters[ModulationDestination][iSample++] *= Level;  
                     }  
                     if (iSample == TotalSamples) { // postpone last transition event for the next audio fragment  
                         RTList<Event>::Iterator itLastEvent = pEvents->last();  
                         if (itLastEvent) ReleasePostponed = (itLastEvent->Type == Event::type_release);  
                     }  
                     if (!AttackStepsLeft) Stage = (ReleasePostponed) ? stage_release : (HoldAttack) ? stage_attack_hold : stage_decay1;  
                     break;  
48                  }                  }
49                  case stage_attack_hold: {                  break;
50                      if (SamplePos >= LoopStart) {              case stage_attack_hold:
51                          Stage = stage_decay1;                  switch (Event) {
52                        case event_stage_end: {// just refresh time
53                            const int intMax = (unsigned int) -1 >> 1;
54                            StepsLeft = intMax; // we use the highest possible value
55                          break;                          break;
56                      }                      }
57                      int holdstepsleft = (int) (LoopStart - SamplePos / CurrentPitch); // FIXME: just an approximation, inaccuracy grows with higher audio fragment size, sufficient for usual fragment sizes though                      case event_hold_end:
58                      int to_process    = RTMath::Min(holdstepsleft, Samples - iSample);                          enterDecay1Part1Stage(SampleRate);
59                      int process_end   = iSample + to_process;                          break;
60                      if (itTransitionEvent && itTransitionEvent->FragmentPos() <= process_end) {                      case event_release:
61                          process_end       = itTransitionEvent->FragmentPos();                          enterReleasePart1Stage();
62                          Stage             = (itTransitionEvent->Type == Event::type_release) ? stage_release : (InfiniteSustain) ? stage_sustain : stage_decay2;                          break;
63                          ++itTransitionEvent;                      default: ; // noop
                     }  
                     else if (to_process == holdstepsleft) Stage = stage_decay1;  
                     while (iSample < process_end) {  
                         pEngine->pSynthesisParameters[ModulationDestination][iSample++] *= Level;  
                     }  
                     break;  
64                  }                  }
65                  case stage_decay1: {                  break;
66                      int to_process   = RTMath::Min(Samples - iSample, Decay1StepsLeft);              case stage_decay1_part1:
67                      int process_end  = iSample + to_process;                  switch (Event) {
68                      if (itTransitionEvent && itTransitionEvent->FragmentPos() <= process_end) {                      case event_stage_end:
69                          process_end       = itTransitionEvent->FragmentPos();                          enterDecay1Part2Stage(SampleRate);
70                          Stage             = (itTransitionEvent->Type == Event::type_release) ? stage_release : (InfiniteSustain) ? stage_sustain : stage_decay2;                          break;
71                          ++itTransitionEvent;                      case event_release:
72                      }                          enterReleasePart1Stage();
73                      else {                          break;
74                          Decay1StepsLeft -= to_process;                      default: ; // noop
                         if (!Decay1StepsLeft) Stage = (InfiniteSustain) ? stage_sustain : stage_decay2;  
                     }  
                     while (iSample < process_end) {  
                         Level += Level * Decay1Coeff;  
                         pEngine->pSynthesisParameters[ModulationDestination][iSample++] *= Level;  
                     }  
                     break;  
75                  }                  }
76                  case stage_decay2: {                  break;
77                      int process_end;              case stage_decay1_part2:
78                      if (itTransitionEvent && itTransitionEvent->Type == Event::type_release && itTransitionEvent->FragmentPos() <= Samples) {                  switch (Event) {
79                          process_end       = itTransitionEvent->FragmentPos();                      case event_release:
80                          ++itTransitionEvent;                          enterReleasePart1Stage();
81                          Stage             = stage_release; // switch to release stage soon                          break;
82                      }                      case event_stage_end:
83                      else process_end = Samples;                          if (Level < CONFIG_EG_BOTTOM)
84                      while (iSample < process_end) {                              enterEndStage();
85                          Level += Level * Decay2Coeff;                          else if (InfiniteSustain)
86                          pEngine->pSynthesisParameters[ModulationDestination][iSample++] *= Level;                              enterSustainStage();
87                      }                          else
88                      if (Level <= EG_ENVELOPE_LIMIT) Stage = stage_fadeout;                              enterDecay2Stage(SampleRate);
89                      break;                          break;
90                        default: ; // noop
91                  }                  }
92                  case stage_sustain: {                  break;
93                      int process_end;              case stage_decay2:
94                      if (itTransitionEvent && itTransitionEvent->Type == Event::type_release && itTransitionEvent->FragmentPos() <= Samples) {                  switch (Event) {
95                          process_end       = itTransitionEvent->FragmentPos();                      case event_stage_end:
96                          ++itTransitionEvent;                          enterFadeOutStage();
97                          Stage             = stage_release; // switch to release stage soon                          break;
98                      }                      case event_release:
99                      else process_end = Samples;                          enterReleasePart1Stage();
100                      while (iSample < process_end) {                          break;
101                         pEngine->pSynthesisParameters[ModulationDestination][iSample++] *= Level;                      case event_hold_end:
102                      }                          enterDecay1Part1Stage(SampleRate);
103                      break;                          break;
104                        default: ; // noop
105                  }                  }
106                  case stage_release: {                  break;
107                      int process_end;              case stage_sustain:
108                      if (itTransitionEvent && itTransitionEvent->Type == Event::type_cancel_release && itTransitionEvent->FragmentPos() <= Samples) {                  switch (Event) {
109                          process_end       = itTransitionEvent->FragmentPos();                      case event_stage_end: {// just refresh time
110                          ++itTransitionEvent;                          const int intMax = (unsigned int) -1 >> 1;
111                          Stage             = (InfiniteSustain) ? stage_sustain : stage_decay2; // switch back to sustain / decay2 stage soon                          StepsLeft = intMax; // we use the highest possible value
112                      }                          break;
                     else process_end = Samples;  
                     while (iSample < process_end) {  
                         Level += Level * ReleaseCoeff;  
                         pEngine->pSynthesisParameters[ModulationDestination][iSample++] *= Level;  
113                      }                      }
114                      if (Level <= EG_ENVELOPE_LIMIT) Stage = stage_fadeout;                      case event_release:
115                      break;                          enterReleasePart1Stage();
116                            break;
117                        case event_hold_end:
118                            enterDecay1Part1Stage(SampleRate);
119                            break;
120                        default: ; // noop
121                  }                  }
122                  case stage_fadeout: {                  break;
123                      int to_process   = RTMath::Min(int(Level / (-FadeOutCoeff)), TotalSamples - iSample);              case stage_release_part1:
124                      int process_end  = iSample + to_process;                  switch (Event) {
125                      while (iSample < process_end) {                      case event_stage_end:
126                          Level += FadeOutCoeff;                          enterReleasePart2Stage();
127                          pEngine->pSynthesisParameters[ModulationDestination][iSample++] *= Level;                          break;
128                      }                      case event_cancel_release:
129                      Stage = stage_end;                          if (InfiniteSustain)
130                      if (Level > -FadeOutCoeff) dmsg(1,("EGADSR: Warning, final fade out level too high, may result in click sound!\n"));                              enterSustainStage();
131                  } //Fall through here instead of breaking otherwise we can get back into stage_fadeout and loop forever!                          else
132                  case stage_end: {                              enterDecay2Stage(SampleRate);
133                      while (iSample < TotalSamples) {                          break;
134                          pEngine->pSynthesisParameters[ModulationDestination][iSample++] = 0.0f;                      default: ; // noop
                     }  
                     break;  
135                  }                  }
136              }                  break;
137          }              case stage_release_part2:
138                    switch (Event) {
139          if (itKillEvent && Stage != stage_end) {                      case event_stage_end:
140              dmsg(1,("EGADSR: VOICE KILLING NOT COMPLETED !!!\n"));                          enterFadeOutStage();
141              dmsg(1,("EGADSR: Stage=%d,iSample=%d,Samples=%d, TotalSamples=%d, MaxFadoutPos=%d\n",Stage,iSample,Samples,TotalSamples,pEngine->MaxFadeOutPos));                          break;
142                        case event_cancel_release:
143                            if (InfiniteSustain)
144                                enterSustainStage();
145                            else
146                                enterDecay2Stage(SampleRate);
147                            break;
148                        default: ; // noop
149                    }
150                    break;
151                case stage_fadeout:
152                case stage_end:
153                    ; // noop
154          }          }
155      }      }
156    
157      /**      void EGADSR::trigger(uint PreAttack, float AttackTime, bool HoldAttack, float Decay1Time, double Decay2Time, bool InfiniteSustain, uint SustainLevel, float ReleaseTime, float Volume, uint SampleRate) {
158       * Will be called by the voice when the key / voice was triggered.          this->SustainLevel     = SustainLevel / 1000.0;
      *  
      * @param PreAttack       - Preattack value for the envelope (0 - 1000 permille)  
      * @param AttackTime      - Attack time for the envelope (0.000 - 60.000s)  
      * @param HoldAttack      - If true, Decay1 will be postponed until the sample reached the sample loop start.  
      * @param LoopStart       - Sample position where sample loop starts (if any)  
      * @param Decay1Time      - Decay1 time of the sample amplitude EG (0.000 - 60.000s).  
      * @param Decay2Time      - Only if !InfiniteSustain: 2nd decay stage time of the sample amplitude EG (0.000 - 60.000s).  
      * @param InfiniteSustain - If true, instead of going into Decay2 phase, Decay1 level will be hold until note will be released.  
      * @param SustainLevel    - Sustain level of the sample amplitude EG (0 - 1000 permille).  
      * @param ReleaseTIme     - Release time for the envelope (0.000 - 60.000s)  
      * @param Delay           - Number of sample points triggering should be delayed.  
      */  
     void EGADSR::Trigger(uint PreAttack, double AttackTime, bool HoldAttack, long LoopStart, double Decay1Time, double Decay2Time, bool InfiniteSustain, uint SustainLevel, double ReleaseTime, uint Delay) {  
         this->TriggerDelay     = Delay;  
         this->Stage            = stage_attack;  
         this->SustainLevel     = (SustainLevel) ? (SustainLevel > EG_ENVELOPE_LIMIT) ? (float) SustainLevel / 1000.0 : EG_ENVELOPE_LIMIT : 1.0;  
159          this->InfiniteSustain  = InfiniteSustain;          this->InfiniteSustain  = InfiniteSustain;
160          this->HoldAttack       = HoldAttack;          this->HoldAttack       = HoldAttack;
         this->LoopStart        = LoopStart;  
         this->ReleasePostponed = false;  
161    
162          // calculate attack stage parameters (lin. curve)          this->Decay1Time = Decay1Time;
163          AttackStepsLeft = (long) (AttackTime * pEngine->pAudioOutputDevice->SampleRate());          this->Decay2Time = Decay2Time;
164          if (AttackStepsLeft) {  
165              Level       = (float) PreAttack / 1000.0;          invVolume = 1 / Volume;
166              AttackCoeff = (1.0 - Level) / AttackStepsLeft;          ExpOffset = (0.25 - 1 / 3.55) * invVolume;
167    
168            // calculate release stage parameters (lin+exp curve)
169            if (ReleaseTime < CONFIG_EG_MIN_RELEASE_TIME) ReleaseTime = CONFIG_EG_MIN_RELEASE_TIME;  // to avoid click sounds at the end of the sample playback
170            const float ReleaseStepsLeft = (long) (ReleaseTime * SampleRate);
171            ReleaseSlope  = 1.365 * (0 - 1) / ReleaseStepsLeft;
172            ReleaseCoeff  = ReleaseSlope * invVolume;
173            ReleaseSlope  *= 3.55;
174            ReleaseCoeff2 = exp(ReleaseSlope);
175            ReleaseCoeff3 = ExpOffset * (1 - ReleaseCoeff2);
176            ReleaseLevel2 = 0.25 * invVolume;
177    
178            enterFirstStage();
179            enterAttackStage(PreAttack, AttackTime, SampleRate);
180        }
181    
182        void EGADSR::enterAttackStage(const uint PreAttack, const float AttackTime, const uint SampleRate) {
183            Stage   = stage_attack;
184            Segment = segment_lin;
185    
186            if (AttackTime >= 1e-8) {
187                // Measurements of GSt output shows that the real attack time
188                // is about 65.5% of the value specified in the gig file.
189                // The minimum attack value used is 0.0316.
190                StepsLeft = int(0.655f * RTMath::Max(AttackTime, 0.0316f) * SampleRate);
191                Level = (float) PreAttack / 1000.0;
192                Coeff = 0.896f * (1.0f - Level) / StepsLeft; // max level is a bit lower if attack != 0
193            } else { // attack is zero - immediately jump to the next stage
194                Level = 1.029f; // a bit higher than max sustain
195                if (HoldAttack) enterAttackHoldStage();
196                else            enterDecay1Part1Stage(SampleRate);
197          }          }
198          else {      }
199              Level       = 1.0;  
200              AttackCoeff = 0.0;      void EGADSR::enterAttackHoldStage() {
201            Stage     = stage_attack_hold;
202            Segment   = segment_lin;
203            Coeff     = 0.0f; // don't rise anymore
204            const int intMax = (unsigned int) -1 >> 1;
205            StepsLeft = intMax; // we use the highest value possible (we refresh StepsLeft in update() in case)
206        }
207    
208        void EGADSR::enterDecay1Part1Stage(const uint SampleRate) {
209            // The decay1 and release stage both consist of two parts,
210            // first a linear curve, f, followed by an exponential curve,
211            // g:
212            //
213            // f(x + d) = f(x) + Coeff
214            // g(x + d) = Coeff2 * g(x) + Coeff3
215            //
216            // (where d is 1/SampleRate). The transition from f to g is
217            // done when f(x) has reached Level2 = 25% of full volume.
218            StepsLeft = (int) (Decay1Time * SampleRate);
219            if (StepsLeft && Level > SustainLevel) {
220                Stage        = stage_decay1_part1;
221                Segment      = segment_lin;
222                Decay1Slope = (1.347f * SustainLevel - 1.361f) / StepsLeft;
223                Coeff        = Decay1Slope * invVolume;
224                Decay1Level2 = 0.25 * invVolume;
225                StepsLeft = int((RTMath::Max(Decay1Level2, SustainLevel) - Level) / Coeff);
226                if (StepsLeft <= 0) enterDecay1Part2Stage(SampleRate);
227            } else {
228                if (InfiniteSustain) enterSustainStage();
229                else                 enterDecay2Stage(SampleRate);
230          }          }
231        }
232    
233          // calculate decay1 stage parameters (exp. curve)      void EGADSR::enterDecay1Part2Stage(const uint SampleRate) {
234          Decay1StepsLeft = (long) (Decay1Time * pEngine->pAudioOutputDevice->SampleRate());          if (SustainLevel < Decay1Level2) {
235          Decay1Coeff     = (Decay1StepsLeft) ? exp(log(this->SustainLevel) / (double) Decay1StepsLeft) - 1.0              Stage   = stage_decay1_part2;
236                                              : 0.0;              Segment = segment_exp;
237                Decay1Slope *= 3.55;
238          // calculate decay2 stage parameters (exp. curve)              Coeff  = exp(Decay1Slope);
239          if (!InfiniteSustain) {              Offset = ExpOffset * (1 - Coeff);
240              if (Decay2Time < EG_MIN_RELEASE_TIME) Decay2Time = EG_MIN_RELEASE_TIME;              StepsLeft = int(log((SustainLevel - ExpOffset) / (Level - ExpOffset)) / Decay1Slope);
241              long Decay2Steps = (long) (Decay2Time * pEngine->pAudioOutputDevice->SampleRate());              if (StepsLeft > 0) return;
             Decay2Coeff      = (Decay2Steps) ? exp((log(EG_ENVELOPE_LIMIT) - log(this->SustainLevel)) / Decay2Steps + log(this->SustainLevel)) - this->SustainLevel  
                                              : 0.0;  
242          }          }
243            if (InfiniteSustain) enterSustainStage();
244            else                 enterDecay2Stage(SampleRate);
245        }
246    
247        void EGADSR::enterDecay2Stage(const uint SampleRate) {
248            Stage      = stage_decay2;
249            Segment    = segment_lin;
250            Decay2Time = RTMath::Max(Decay2Time, 0.05f);
251            StepsLeft  = (int) (Decay2Time * SampleRate);
252            Coeff      = (-1.03 / StepsLeft) * invVolume;
253            //FIXME: do we really have to calculate 'StepsLeft' two times?
254            StepsLeft  = int((CONFIG_EG_BOTTOM - Level) / Coeff);
255            if (StepsLeft <= 0) enterEndStage();
256        }
257    
258          // calculate release stage parameters (exp. curve)      void EGADSR::enterSustainStage() {
259          if (ReleaseTime < EG_MIN_RELEASE_TIME) ReleaseTime = EG_MIN_RELEASE_TIME;  // to avoid click sounds at the end of the sample playback          Stage   = stage_sustain;
260          ReleaseStepsLeft = (long) (ReleaseTime * pEngine->pAudioOutputDevice->SampleRate());          Segment = segment_lin;
261          ReleaseCoeff     = exp((log(EG_ENVELOPE_LIMIT) - log(this->SustainLevel)) / ReleaseStepsLeft + log(this->SustainLevel)) - this->SustainLevel;          Coeff   = 0.0f; // don't change the envelope level in this stage
262            const int intMax = (unsigned int) -1 >> 1;
263            StepsLeft = intMax; // we use the highest value possible (we refresh StepsLeft in update() in case)
264        }
265    
266        void EGADSR::enterReleasePart1Stage() {
267            Stage     = stage_release_part1;
268            Segment   = segment_lin;
269            StepsLeft = int((ReleaseLevel2 - Level) / ReleaseCoeff);
270            Coeff     = ReleaseCoeff;
271            if (StepsLeft <= 0) enterReleasePart2Stage();
272        }
273    
274          dmsg(4,("PreAttack=%d, AttackLength=%d, AttackCoeff=%f, Decay1Coeff=%f, Decay2Coeff=%f, ReleaseLength=%d, ReleaseCoeff=%f\n",      void EGADSR::enterReleasePart2Stage() {
275                  PreAttack, AttackStepsLeft, AttackCoeff, Decay1Coeff, Decay2Coeff, ReleaseStepsLeft, ReleaseCoeff));          Stage     = stage_release_part2;
276            Segment   = segment_exp;
277            StepsLeft = int(log((CONFIG_EG_BOTTOM - ExpOffset) / (Level - ExpOffset)) / ReleaseSlope);
278            Coeff     = ReleaseCoeff2;
279            Offset    = ReleaseCoeff3;
280            if (StepsLeft <= 0) enterFadeOutStage();
281      }      }
282    
283  }} // namespace LinuxSampler::gig  }} // namespace LinuxSampler::gig
Legend:
Removed from v.285  
changed lines
  Added in v.3034
  ViewVC Help
Powered by ViewVC