Readme and Install files lifting.
[Faustine.git] / interpretor / faust-0.9.47mr3 / examples / faust-stk / modalBar.dsp
1 declare name "Modal Bar";
2 declare description "Nonlinear Modal percussive instruments";
3 declare author "Romain Michon (rmichon@ccrma.stanford.edu)";
4 declare copyright "Romain Michon";
5 declare version "1.0";
6 declare licence "STK-4.3"; // Synthesis Tool Kit 4.3 (MIT style license);
7 declare description "A number of different struck bar instruments. Presets numbers: 0->Marimba, 1->Vibraphone, 2->Agogo, 3->Wood1, 4->Reso, 5->Wood2, 6->Beats, 7->2Fix; 8->Clump";
8
9 import("music.lib");
10 import("instrument.lib");
11
12 //==================== GUI SPECIFICATION ================
13
14 freq = nentry("h:Basic_Parameters/freq [1][unit:Hz] [tooltip:Tone frequency]",440,20,20000,1);
15 gain = nentry("h:Basic_Parameters/gain [1][tooltip:Gain (value between 0 and 1)]",0.8,0,1,0.01);
16 gate = button("h:Basic_Parameters/gate [1][tooltip:noteOn = 1, noteOff = 0]");
17
18 stickHardness = hslider("h:Physical_and_Nonlinearity/v:Physical_Parameters/Stick_Hardness
19 [2][tooltip:A value between 0 and 1]",0.25,0,1,0.01);
20 reson = nentry("h:Physical_and_Nonlinearity/v:Physical_Parameters/Resonance
21 [2][tooltip:A value between 0 and 1]",1,0,1,1);
22 presetNumber = nentry("h:Physical_and_Nonlinearity/v:Physical_Parameters/Preset
23 [2][tooltip:0->Marimba, 1->Vibraphone, 2->Agogo, 3->Wood1, 4->Reso, 5->Wood2, 6->Beats, 7->2Fix; 8->Clump]",1,0,8,1);
24
25 typeModulation = nentry("h:Physical_and_Nonlinearity/v:Nonlinear_Filter_Parameters/Modulation_Type
26 [3][tooltip: 0=theta is modulated by the incoming signal; 1=theta is modulated by the averaged incoming signal;
27 2=theta is modulated by the squared incoming signal; 3=theta is modulated by a sine wave of frequency freqMod;
28 4=theta is modulated by a sine wave of frequency freq;]",0,0,4,1);
29 nonLinearity = hslider("h:Physical_and_Nonlinearity/v:Nonlinear_Filter_Parameters/Nonlinearity
30 [3][tooltip:Nonlinearity factor (value between 0 and 1)]",0,0,1,0.01);
31 frequencyMod = hslider("h:Physical_and_Nonlinearity/v:Nonlinear_Filter_Parameters/Modulation_Frequency
32 [3][unit:Hz][tooltip:Frequency of the sine wave for the modulation of theta (works if Modulation Type=3)]",220,20,1000,0.1);
33 nonLinAttack = hslider("h:Physical_and_Nonlinearity/v:Nonlinear_Filter_Parameters/Nonlinearity_Attack
34 [3][unit:s][Attack duration of the nonlinearity]",0.1,0,2,0.01);
35
36 vibratoFreq = hslider("h:Envelopes_and_Vibrato/v:Vibrato_Parameters/Vibrato_Freq
37 [4][unit:Hz]",6,1,15,0.1);
38 vibratoGain = hslider("h:Envelopes_and_Vibrato/v:Vibrato_Parameters/Vibrato_Gain
39 [4][tooltip:A value between 0 and 1]",0.1,0,1,0.01);
40
41 //==================== SIGNAL PROCESSING ================
42
43 //----------------------- Nonlinear filter ----------------------------
44 //nonlinearities are created by the nonlinear passive allpass ladder filter declared in filter.lib
45
46 //nonlinear filter order
47 nlfOrder = 6;
48
49 //nonLinearModultor is declared in instrument.lib, it adapts allpassnn from filter.lib
50 //for using it with waveguide instruments
51 NLFM = nonLinearModulator((nonLinearity : smooth(0.999)),1,freq,
52 typeModulation,(frequencyMod : smooth(0.999)),nlfOrder);
53
54 //----------------------- Synthesis parameters computing and functions declaration ----------------------------
55
56 //stereoizer is declared in instrument.lib and implement a stereo spacialisation in function of
57 //the frequency period in number of samples
58 stereo = stereoizer(SR/freq);
59
60 //check if the vibraphone is used
61 vibratoOn = presetNumber == 1;
62
63 //vibrato
64 vibrato = 1 + osc(vibratoFreq)*vibratoGain*vibratoOn;
65
66 //filter bank output gain
67 directGain = loadPreset(presetNumber,3,2);
68
69 //modal values for the filter bank
70 loadPreset = ffunction(float loadPreset (int,int,int), <modalBar.h>,"");
71
72 //filter bank using biquad filters
73 biquadBank = _ <: sum(i, 4, oneFilter(i))
74 with{
75 condition(x) = x<0 <: *(-x),((-(1))*-1)*x*freq :> +;
76 dampCondition = (gate < 1) & (reson != 1);
77
78 //the filter coefficients are interpolated when changing of preset
79 oneFilter(j,y) = (loadPreset(presetNumber,0,j : smooth(0.999)) : condition),
80 loadPreset(presetNumber,1,j : smooth(0.999))*(1-(gain*0.03*dampCondition)),
81 y*(loadPreset(presetNumber,2,j) : smooth(0.999)) : bandPassH;
82 };
83
84 //one pole filter with pole set at 0.9 for pre-filtering, onePole is declared in instrument.lib
85 sourceFilter = onePole(b0,a1)
86 with{
87 b0 = 1 - 0.9;
88 a1 = -0.9;
89 };
90
91 //excitation signal
92 excitation = counterSamples < (marmstk1TableSize*rate) : *(marmstk1Wave*gate)
93 with{
94 //readMarmstk1 and marmstk1TableSize are both declared in instrument.lib
95 marmstk1 = time%marmstk1TableSize : int : readMarmstk1;
96
97 dataRate(readRate) = readRate : (+ : decimal) ~ _ : *(float(marmstk1TableSize));
98
99 //the reading rate of the stick table is defined in function of the stickHardness
100 rate = 0.25*pow(4,stickHardness);
101
102 counterSamples = (*(gate)+1)~_ : -(1);
103 marmstk1Wave = rdtable(marmstk1TableSize,marmstk1,int(dataRate(rate)*gate));
104 };
105
106 process = excitation : sourceFilter : *(gain) <:
107 //resonance
108 (biquadBank <: -(*(directGain))) + (directGain*_) :
109 //vibrato for the vibraphone
110 *(vibrato) : NLFM*0.6 : stereo : instrReverb;