src/calf/organ.h

   1 /* Calf DSP Library
   2  * Drawbar organ emulator.
   3  *
   4  * Copyright (C) 2007 Krzysztof Foltman
   5  *
   6  * This program is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Lesser General Public
   8  * License as published by the Free Software Foundation; either
   9  * version 2 of the License, or (at your option) any later version.
  10  *
  11  * This program is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * Lesser General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Lesser General
  17  * Public License along with this program; if not, write to the
  18  * Free Software Foundation, Inc., 59 Temple Place, Suite 330,
  19  * Boston, MA 02111-1307, USA.
  20  */
  21
  22 #ifndef __CALF_ORGAN_H
  23 #define __CALF_ORGAN_H
  24
  25 #include "synth.h"
  26 #include "envelope.h"
  27 #include "metadata.h"
  28
  29 #define ORGAN_KEYTRACK_POINTS 4
  30
  31 namespace dsp
  32 {
  33
  34 struct organ_parameters {
  35     enum { FilterCount = 2, EnvCount = 3 };
  36     struct organ_filter_parameters
  37     {
  38         float cutoff;
  39         float resonance;
  40         float envmod[organ_parameters::EnvCount];
  41         float keyf;
  42     };
  43
  44     struct organ_env_parameters
  45     {
  46         float attack, decay, sustain, release, velscale, ampctl;
  47     };
  48
  49     //////////////////////////////////////////////////////////////////////////
  50     // these parameters are binary-copied from control ports (order is important!)
  51
  52     float drawbars[9];
  53     float harmonics[9];
  54     float waveforms[9];
  55     float detune[9];
  56     float phase[9];
  57     float pan[9];
  58     float routing[9];
  59     float foldover;
  60     float percussion_time;
  61     float percussion_level;
  62     float percussion_wave;
  63     float percussion_harmonic;
  64     float percussion_vel2amp;
  65     float percussion_fm_time;
  66     float percussion_fm_depth;
  67     float percussion_fm_wave;
  68     float percussion_fm_harmonic;
  69     float percussion_vel2fm;
  70     float percussion_trigger;
  71     float percussion_stereo;
  72     float filter_chain;
  73     float master;
  74
  75     organ_filter_parameters filters[organ_parameters::FilterCount];
  76     organ_env_parameters envs[organ_parameters::EnvCount];
  77     float lfo_rate;
  78     float lfo_amt;
  79     float lfo_wet;
  80     float lfo_phase;
  81     float lfo_mode;
  82
  83     float global_transpose;
  84     float global_detune;
  85
  86     float polyphony;
  87
  88     float quad_env;
  89
  90     float dummy_mapcurve;
  91
  92     //////////////////////////////////////////////////////////////////////////
  93     // these parameters are calculated
  94
  95     double perc_decay_const, perc_fm_decay_const;
  96     float multiplier[9];
  97     int phaseshift[9];
  98     float cutoff;
  99     unsigned int foldvalue;
 100     float pitch_bend;
 101
 102     float percussion_keytrack[ORGAN_KEYTRACK_POINTS][2];
 103
 104     organ_parameters() : pitch_bend(1.0f) {}
 105
 106     inline int get_percussion_wave() { return dsp::fastf2i_drm(percussion_wave); }
 107     inline int get_percussion_fm_wave() { return dsp::fastf2i_drm(percussion_fm_wave); }
 108 };
 109
 110 #define ORGAN_WAVE_BITS 12
 111 #define ORGAN_WAVE_SIZE 4096
 112 #define ORGAN_BIG_WAVE_BITS 17
 113 #define ORGAN_BIG_WAVE_SIZE 131072
 114 /// 2^ORGAN_BIG_WAVE_SHIFT = how many (quasi)periods per sample
 115 #define ORGAN_BIG_WAVE_SHIFT 5
 116
 117 class organ_voice_base: public calf_plugins::organ_enums
 118 {
 119 public:
 120     typedef waveform_family<ORGAN_WAVE_BITS> small_wave_family;
 121     typedef waveform_family<ORGAN_BIG_WAVE_BITS> big_wave_family;
 122 public:
 123     organ_parameters *parameters;
 124 protected:
 125     static small_wave_family (*waves)[wave_count_small];
 126     static big_wave_family (*big_waves)[wave_count_big];
 127
 128     // dsp::sine_table<float, ORGAN_WAVE_SIZE, 1> sine_wave;
 129     int note;
 130     dsp::decay amp;
 131     /// percussion FM carrier amplitude envelope
 132     dsp::decay pamp;
 133     /// percussion FM modulator amplitude envelope
 134     dsp::decay fm_amp;
 135     dsp::fixed_point<int64_t, 20> pphase, dpphase;
 136     dsp::fixed_point<int64_t, 20> modphase, moddphase;
 137     float fm_keytrack;
 138     int &sample_rate_ref;
 139     bool &released_ref;
 140     /// pamp per-sample (linear) step during release stage (calculated on release so that it will take 30ms for it to go from "current value at release point" to 0)
 141     float rel_age_const;
 142
 143     organ_voice_base(organ_parameters *_parameters, int &_sample_rate_ref, bool &_released_ref);
 144
 145     inline float wave(float *data, dsp::fixed_point<int, 20> ph) {
 146         return ph.lerp_table_lookup_float(data);
 147     }
 148     inline float big_wave(float *data, dsp::fixed_point<int64_t, 20> &ph) {
 149         // wrap to fit within the wave
 150         return ph.lerp_table_lookup_float_mask(data, ORGAN_BIG_WAVE_SIZE - 1);
 151     }
 152 public:
 153     static inline small_wave_family &get_wave(int wave) {
 154         return (*waves)[wave];
 155     }
 156     static inline big_wave_family &get_big_wave(int wave) {
 157         return (*big_waves)[wave];
 158     }
 159     static void precalculate_waves(calf_plugins::progress_report_iface *reporter);
 160     void update_pitch()
 161     {
 162         float phase = dsp::midi_note_to_phase(note, 100 * parameters->global_transpose + parameters->global_detune, sample_rate_ref);
 163         dpphase.set((long int) (phase * parameters->percussion_harmonic * parameters->pitch_bend));
 164         moddphase.set((long int) (phase * parameters->percussion_fm_harmonic * parameters->pitch_bend));
 165     }
 166     // this doesn't really have a voice interface
 167     void render_percussion_to(float (*buf)[2], int nsamples);
 168     void perc_note_on(int note, int vel);
 169     void perc_note_off(int note, int vel);
 170     void perc_reset()
 171     {
 172         pphase = 0;
 173         modphase = 0;
 174         dpphase = 0;
 175         moddphase = 0;
 176         note = -1;
 177     }
 178 };
 179
 180 class organ_vibrato
 181 {
 182 protected:
 183     enum { VibratoSize = 6 };
 184     float vibrato_x1[VibratoSize][2], vibrato_y1[VibratoSize][2];
 185     float lfo_phase;
 186     dsp::onepole<float> vibrato[2];
 187 public:
 188     void reset();
 189     void process(organ_parameters *parameters, float (*data)[2], unsigned int len, float sample_rate);
 190 };
 191
 192 class organ_voice: public dsp::voice, public organ_voice_base {
 193 protected:
 194     enum { Channels = 2, BlockSize = 64, EnvCount = organ_parameters::EnvCount, FilterCount = organ_parameters::FilterCount };
 195     union {
 196         float output_buffer[BlockSize][Channels];
 197         float aux_buffers[3][BlockSize][Channels];
 198     };
 199     dsp::fixed_point<int64_t, 52> phase, dphase;
 200     dsp::biquad_d1<float> filterL[2], filterR[2];
 201     adsr envs[EnvCount];
 202     dsp::inertia<dsp::linear_ramp> expression;
 203     organ_vibrato vibrato;
 204     float velocity;
 205     bool perc_released;
 206     /// The envelopes have ended and the voice is in final fadeout stage
 207     bool finishing;
 208
 209 public:
 210     organ_voice()
 211     : organ_voice_base(NULL, sample_rate, perc_released),
 212     expression(dsp::linear_ramp(16)) {
 213     }
 214
 215     void reset() {
 216         vibrato.reset();
 217         phase = 0;
 218         for (int i = 0; i < FilterCount; i++)
 219         {
 220             filterL[i].reset();
 221             filterR[i].reset();
 222         }
 223     }
 224
 225     void note_on(int note, int vel) {
 226         stolen = false;
 227         finishing = false;
 228         perc_released = false;
 229         released = false;
 230         reset();
 231         this->note = note;
 232         const float sf = 0.001f;
 233         for (int i = 0; i < EnvCount; i++)
 234         {
 235             organ_parameters::organ_env_parameters &p = parameters->envs[i];
 236             envs[i].set(sf * p.attack, sf * p.decay, p.sustain, sf * p.release, sample_rate / BlockSize);
 237             envs[i].note_on();
 238         }
 239         update_pitch();
 240         velocity = vel * 1.0 / 127.0;
 241         amp.set(1.0f);
 242         perc_note_on(note, vel);
 243     }
 244
 245     void note_off(int /* vel */) {
 246         // reset age to 0 (because decay will turn from exponential to linear, necessary because of error cumulation prevention)
 247         perc_released = true;
 248         if (pamp.get_active())
 249         {
 250             pamp.reinit();
 251         }
 252         rel_age_const = pamp.get() * ((1.0/44100.0)/0.03);
 253         for (int i = 0; i < EnvCount; i++)
 254             envs[i].note_off();
 255     }
 256
 257     virtual void steal() {
 258         perc_released = true;
 259         finishing = true;
 260         stolen = true;
 261     }
 262
 263     void render_block();
 264
 265     virtual int get_current_note() {
 266         return note;
 267     }
 268     virtual bool get_active() {
 269         return (note != -1) && (amp.get_active() || (use_percussion() && pamp.get_active()));
 270     }
 271     void update_pitch();
 272     inline bool use_percussion()
 273     {
 274         return dsp::fastf2i_drm(parameters->percussion_trigger) == perctrig_polyphonic;
 275     }
 276 };
 277
 278 /// Not a true voice, just something with similar-ish interface.
 279 class percussion_voice: public organ_voice_base {
 280 public:
 281     int sample_rate;
 282     bool released;
 283
 284     percussion_voice(organ_parameters *_parameters)
 285     : organ_voice_base(_parameters, sample_rate, released)
 286     , released(false)
 287     {
 288     }
 289
 290     bool get_active() {
 291         return (note != -1) && pamp.get_active();
 292     }
 293     bool get_noticable() {
 294         return (note != -1) && (pamp.get() > 0.2 * parameters->percussion_level);
 295     }
 296     void setup(int sr) {
 297         sample_rate = sr;
 298     }
 299 };
 300
 301 struct drawbar_organ: public dsp::basic_synth, public calf_plugins::organ_enums {
 302     organ_parameters *parameters;
 303     percussion_voice percussion;
 304     organ_vibrato global_vibrato;
 305
 306      drawbar_organ(organ_parameters *_parameters)
 307     : parameters(_parameters)
 308     , percussion(_parameters) {
 309     }
 310     void render_separate(float *output[], int nsamples)
 311     {
 312         float buf[4096][2];
 313         dsp::zero(&buf[0][0], 2 * nsamples);
 314         basic_synth::render_to(buf, nsamples);
 315         if (dsp::fastf2i_drm(parameters->lfo_mode) == organ_voice_base::lfomode_global)
 316         {
 317             for (int i = 0; i < nsamples; i += 64)
 318                 global_vibrato.process(parameters, buf + i, std::min(64, nsamples - i), sample_rate);
 319         }
 320         if (percussion.get_active())
 321             percussion.render_percussion_to(buf, nsamples);
 322         float gain = parameters->master * (1.0 / 8);
 323         for (int i=0; i<nsamples; i++) {
 324             output[0][i] = gain*buf[i][0];
 325             output[1][i] = gain*buf[i][1];
 326         }
 327     }
 328     dsp::voice *alloc_voice() {
 329         block_voice<organ_voice> *v = new block_voice<organ_voice>();
 330         v->parameters = parameters;
 331         return v;
 332     }
 333     virtual void percussion_note_on(int note, int vel) {
 334         percussion.perc_note_on(note, vel);
 335     }
 336     virtual void params_changed() = 0;
 337     virtual void setup(int sr) {
 338         basic_synth::setup(sr);
 339         percussion.setup(sr);
 340         parameters->cutoff = 0;
 341         params_changed();
 342         global_vibrato.reset();
 343     }
 344     void update_params();
 345     void control_change(int controller, int value)
 346     {
 347 #if 0
 348         if (controller == 11)
 349         {
 350             parameters->cutoff = value / 64.0 - 1;
 351         }
 352 #endif
 353         dsp::basic_synth::control_change(controller, value);
 354     }
 355     void pitch_bend(int amt);
 356     virtual bool check_percussion() {
 357         switch(dsp::fastf2i_drm(parameters->percussion_trigger))
 358         {
 359             case organ_voice_base::perctrig_first:
 360                 return active_voices.empty();
 361             case organ_voice_base::perctrig_each:
 362             default:
 363                 return true;
 364             case organ_voice_base::perctrig_eachplus:
 365                 return !percussion.get_noticable();
 366             case organ_voice_base::perctrig_polyphonic:
 367                 return false;
 368         }
 369     }
 370 };
 371
 372 };
 373
 374 #endif