diff --git a/docs/dev_note/vst3_dev.html b/docs/dev_note/vst3_dev.html index 5d34eac0..cc73083d 100644 --- a/docs/dev_note/vst3_dev.html +++ b/docs/dev_note/vst3_dev.html @@ -5,7 +5,7 @@ - +
+ Update: 2019-12-09 +
+IterativeSinCluster is an additive synthesizer. This synth computes 512 sine waves for each note to make tone cluster.
+ +The package includes following builds:
+IterativeSinCluster requires CPU to support AVX2 instructions.
+macOS build isn’t tested because I don’t have Mac. If you found a bug, please file a issue to GitHub repository or send email to ryukau@gmail.com
.
Linux build is built on Ubuntu 18.0.4 and tested on Bitwig 3.0.3 and Reaper 5.983. Both seems to have problem to display GUI, therefore GUI is currently disabled for Linux build.
+Place IterativeSinCluster.vst3
directory to:
/Program Files/Common Files/VST3/
for Windows.$HOME/.vst3/
for Linux./Users/$USERNAME/Library/Audio/Plug-ins/VST3/
for macOS.DAW may provides additional VST3 directory. For more information, please refer to the manual of the DAW.
+On Ubuntu 18.0.4, those packages are required.
+ +If DAW doesn’t recognize the plugin, take a look at Package Requirements
section of the link below and make sure all the VST3 related package is installed.
REAPER 5.983 on Linux may not recognize IterativeSinCluster. A workaround is to delete a file ~/.config/REAPER/reaper-vstplugins64.ini
and restart REAPER.
Knob and slider can do:
+Both controls output gain. Peak value of output will be Boost * Gain
.
It’s possible that output gain becomes too small while changing gain of Note
, Chord
, Overtone
. Boost
can be useful in this situation.
Parameters for gain envelope.
+A
: Attack time which is the length from note-on to reaching peak value.D
: Decay time which is the length from peak value to reaching sustain level.S
: Sustain level which is the gain after decay.R
: Release time which is the length from note-off to the gain reaching to 0.Change attack curve of gain envelope.
+Cutoff freqeuncy can be changed by Semi
, which is relative to a note frequency. For example, if the note is C4 and Semi
is 12.000, cutoff frequency is set to C4 + 12 semitone = C5
.
Low
shelving changes Gain
of sine waves less than or equal to cutoff frequency specified by Semi
.High
shelving changes Gain
of sine waves greater than or equal to cutoff frequency specified by Semi
.When checked, the synth enables rendering of sine waves over nyquist frequency.
+Roughly speaking, nyquist frequency is the highest frequency that can be reconstructed from recorded digital signal. When generating sound, it’s possible to set value that is higher than nyquist frequency. However, the result may contain unexpected frequency due to a phenomenon called aliasing. Add Aliasing
is option to add those aliasing noise.
When checked, negate sign of Semi
. For example, 7.000 becomes -7.000.
Note octave.
+ET
stands for equal temperament. This parameter can be used to change tuning of Semi
and Milli
.
Note that this parameter is not to change tuning of notes sent from plugin host. Only affect to internal parameters.
+Change sine wave frequency.
+Equation is noteFrequency * (1 + fmod(Multiply * pitch, Modulo))
. pitch
is calculated from Note
, Chord
and Overtone
. fmod(a, b)
is a function that returns reminder of a / b
.
Time length to change some parameter value to current one. Unit is in second.
+List of parameters related to Smooth
. *
represents wild card.
Gain
section.Chord.Pan
Chorus
section, except Key Follow
.Other parameter uses the value obtained from the timing of note-on for entire duration of a note.
+Maximum polyphony. Lowering the number of this option reduces CPU load.
+When checked, reset random seed for each note-on.
+Random seed. This value change random number sequence.
+Amount of randomization to sine wave gain. Randomization is done for each note-on.
+Amount of randomization to sine wave pitch. Randomization is done for each note-on.
+Change sine wave gain and pitch.
+1 Note
have 16 Overtone
. 1 Chord
consists of 8 Note
. 4 Chord
are available to use.
Common parameters for Note
and Chord
.
Gain
: Sine wave gain.Semi
: Distance from note frequency. Unit is semitone.Milli
: Distance from note frequency. Unit is 1 / 1000 semitone, or 1 / 10 cent.Leftmost of Overtone
is gain of fundamental frequency (1st overtone) of a note. For each bar from left represents 1st, 2nd, 3rd, … , 16th overtone gain.
Below is the summary of calculation of sine wave frequency.
+function toneToPitch(semi, milli):
+ return 2 ^ (1000 * semi + milli) / (ET * 1000)
+
+for each Chord:
+ chordPitch = toneToPitch(Chord.semi, Chord.milli)
+ for each Note:
+ notePitch = toneToPitch(Note.semi, Note.milli)
+ for each Overtone:
+ frequency = midiNoteFrequency
+ * (1 + mod(Multiply * Overtone * notePitch * chordPitch, Modulo))
+Change Dry/Wet mix ratio.
+Chorus LFO frequency.
+Change stereo spread.
+Amount of modulation from LFO to delay time. There are three delays in this chorus.
+Delay time.
+LFO phase.
+Phase difference between delays.
+Feedback of delay.
+When checked, change delay time relative to note frequency.
+IterativeSinCluster is licensed under GPLv3. Complete licenses are linked below.
+ +If the link above doesn’t work, please send email to ryukau@gmail.com
.
VST is a trademark of Steinberg Media Technologies GmbH, registered in Europe and other countries.
+ + + + +